matplotlib.axes.Axes.axline
- Axes.axline(xy1, xy2=None, *, slope=None, **kwargs)[source]
-
Добавление бесконечно длинной прямой линии.
Линия может быть определена либо двумя точками xy1 и xy2, либо одной точкой xy1 и slope.
Это рисует прямую линию «на экране», независимо от масштабов x и y, и поэтому также подходит для рисования экспоненциальных спадов в полулогарифмических графиках, степенных закономерностей в логарифмических графиках и т. д. Однако slope следует использовать только с линейными масштабами; он не имеет четкого значения для всех остальных масштабов, и поэтому поведение неопределено. Для нелинейных масштабов укажите линию, используя точки xy1, xy2.
Ключевое слово transform относится только к точкам xy1, xy2. slope (если указан) всегда в координатах данных. Это можно использовать, например, с
ax.transAxesдля рисования линий сетки с фиксированным наклоном.- Параметры:
-
- xy1, xy2(float, float)
-
Точки, через которые должна пройти линия. Должно быть указано либо xy2, либо slope.
- slopefloat, необязательно
-
Наклон линии. Должно быть указано либо xy2, либо slope.
- Возвращаемое значение:
-
Line2D
- Другие параметры:
-
- **kwargs
-
Допустимые значения kwargs — свойства
Line2D
Свойство
Описание
функция фильтра, которая принимает массив float (m, n, 3) и значение dpi, и возвращает массив (m, n, 3) и два смещения от нижнего левого угла изображения
скаляр или None
bool
antialiasedили aabool
bool
Объект Patch или (Path, Transform) или None
colorили cцвет
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}последовательность чисел с плавающей точкой (перо/пробел в точках) или (None, None)
массив (2, N) или два одномерных массива
drawstyleили ds{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
цвет или None
строка
bool
объект
linestyleили ls{'-', '--', '-.', ':', '', (смещение, последовательность включения/выключения), ...}
linewidthили lwчисло с плавающей точкой
строка стиля маркера,
PathилиMarkerStylemarkeredgecolorили mecцвет
markeredgewidthили mewчисло с плавающей точкой
markerfacecolorили mfcцвет
markerfacecoloraltили mfcaltцвет
markersizeили msчисло с плавающей точкой
None или целое число или (целое число, целое число) или срез или список целых чисел или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список булевых значений
bool
число с плавающей точкой или вызываемая функция [[Artist, Event], tuple[bool, dict]]
неизвестно
bool
(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
bool или None
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}неизвестно
строка
bool
одномерный массив
-
Примеры
Нарисуйте толстую красную линию, проходящую через (0, 0) и (1, 1):
>>> axline((0, 0), (1, 1), linewidth=4, color='r')
Примеры использования matplotlib.axes.Axes.axline
© 2012–2023 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/3.7.5/api/_as_gen/matplotlib.axes.Axes.axline.html