matplotlib.pyplot.axline

matplotlib.pyplot.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 или целое число или (целое число, целое число) или срез или список [целое число] или число с плавающей точкой или (число с плавающей точкой, число с плавающей точкой) или список [логическое значение]
path_effects	AbstractPathEffect
picker	число с плавающей точкой или вызываемая функция [[Artist, Event], кортеж [логическое значение, словарь]]
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.pyplot.axline