matplotlib.pyplot.axhline

matplotlib.pyplot.axhline(y=0, xmin=0, xmax=1, **kwargs)[source]

Добавляет горизонтальную линию, проходящую по всей области Axes или по её части.

Примечание. Если нужно задать пределы по оси x в координатах данных, используйте вместо этого hlines.

Параметры:

yfloat, по умолчанию: 0

Положение по оси y в координатах данных.

xminfloat, по умолчанию: 0

Начальное положение по оси x в координатах области осей. Должно находиться в диапазоне от 0 до 1, где 0 — крайняя левая точка графика, а 1 — крайняя правая.

xmaxfloat, по умолчанию: 1

Конечное положение по оси x в координатах области осей. Должно находиться в диапазоне от 0 до 1, где 0 — крайняя левая точка графика, а 1 — крайняя правая.

Возвращает:

Line2D

Объект Line2D, заданный двумя точками (xmin, y), (xmax, y). Преобразование настроено так, что x задаётся в координатах области осей, а y — в координатах данных.

Это по-прежнему обычная линия, и горизонтальной она становится только благодаря одинаковым значениям y для обеих точек. Поэтому, если позднее нужно изменить значение y, необходимо указать два значения line.set_ydata([3, 3]).

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

**kwargs

Допустимы именованные аргументы, соответствующие свойствам Line2D, кроме 'transform':

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

См. также

hlines

Добавляет горизонтальные линии в координатах данных.

axhspan

Добавляет горизонтальную полосу (прямоугольник) поперёк оси.

axline

Добавляет линию с произвольным наклоном.

Примечания

Примечание

Это обёртка pyplot для axes.Axes.axhline.

Примеры

• нарисовать толстую красную горизонтальную линию при 'y' = 0, проходящую по всему диапазону x:

  >>> axhline(linewidth=4, color='r')
  

• нарисовать горизонтальную линию по умолчанию при 'y' = 1, проходящую по всему диапазону x:

  >>> axhline(y=1)
  

• нарисовать горизонтальную линию по умолчанию при 'y' = .5, проходящую по средней половине диапазона x:

  >>> axhline(y=.5, xmin=0.25, xmax=0.75)
  

Примеры использования matplotlib.pyplot.axhline

Бесконечные линии

Бесконечные линии

Демонстрация Zorder

Демонстрация Zorder