matplotlib.axes.Axes.axline

Axes.axline(xy1, xy2=None, *, slope=None, **kwargs)[source]

Добавление прямой линии бесконечной длины.

Линия может быть определена двумя точками xy1 и xy2 или одной точкой xy1 и уклоном.

Это рисует прямую линию "на экране", независимо от масштабов осей x и y, и поэтому также подходит для рисования экспоненциальных спадов на полулогарифмических графиках, степенных закономерностей на логарифмических графиках и т. д. Однако уклон следует использовать только с линейными масштабами; для других масштабов он не имеет четкого смысла, и поэтому поведение не определено. Пожалуйста, укажите линию с помощью точек xy1, xy2 для нелинейных масштабов.

Аргумент transform применяется только к точкам xy1, xy2. Уклон (если задан) всегда находится в координатах данных. Это может быть использовано, например, с ax.transAxes для рисования линий сетки с фиксированным уклоном.

Параметры

xy1, xy2(float, float)

Точки, через которые должна проходить линия. Нужно указать либо xy2, либо уклон.

уклонfloat, необязательно

Уклон линии. Нужно указать либо xy2, либо уклон.

Возвращает

Line2D

Другие параметры

**kwargs

Допустимые значения kwargs — свойства Line2D

Свойство	Описание
agg_filter	функция фильтра, которая принимает массив float (m, n, 3) и значение dpi и возвращает массив float (m, n, 3)
alpha	скаляр или None
animated	bool
antialiased или aa	bool
clip_box	Bbox
clip_on	bool
clip_path	Patch или (Path, Transform) или None
color или c	цвет
dash_capstyle	CapStyle или {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
dashes	последовательность чисел с плавающей точкой (периоды черного и белого цвета в точках) или (None, None)
data	массив (2, N) или два одномерных массива
drawstyle или ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
figure	Figure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gid	строка
in_layout	bool
label	объект
linestyle или ls	{'-', '--', '-.', ':', '', (смещение, последовательность включения-выключения), ...}
linewidth или lw	число с плавающей точкой
marker	строка стиля маркера, Path или MarkerStyle
markeredgecolor или mec	цвет
markeredgewidth или mew	число с плавающей точкой
markerfacecolor или mfc	цвет
markerfacecoloralt или mfcalt	цвет
markersize или ms	число с плавающей точкой
markevery	None или целое число или (целое число, целое число) или срез или список [целое число] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список [bool]
path_effects	AbstractPathEffect
picker	число с плавающей точкой или вызываемая функция [[Artist, Event], кортеж[bool, dict]]
pickradius	число с плавающей точкой
rasterized	bool
sketch_params	(масштаб: число с плавающей точкой, длина: число с плавающей точкой, случайность: число с плавающей точкой)
snap	bool или None
solid_capstyle	CapStyle или {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle или {'miter', 'round', 'bevel'}
transform	неизвестно
url	строка
visible	bool
xdata	одномерный массив
ydata	одномерный массив
zorder	число с плавающей точкой

См. также

axhline

для горизонтальных линий

axvline

для вертикальных линий

Примеры

Нарисовать толстую красную линию, проходящую через (0, 0) и (1, 1):

>>> axline((0, 0), (1, 1), linewidth=4, color='r')

Примеры использования matplotlib.axes.Axes.axline