matplotlib.axes.Axes.axhline

Axes.axhline(y=0, xmin=0, xmax=1, **kwargs)[исходный код]

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

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

Параметры:

yfloat, по умолчанию: 0: Положение по y в координатах данных.
xminfloat, по умолчанию: 0: Начальное положение по x в координатах области Axes. Значение должно находиться в диапазоне от 0 до 1: 0 соответствует крайней левой точке графика, а 1 — крайней правой.
xmaxfloat, по умолчанию: 1: Конечное положение по x в координатах области Axes. Значение должно находиться в диапазоне от 0 до 1: 0 соответствует крайней левой точке графика, а 1 — крайней правой.

Возвращает:

Line2D

Объект Line2D, заданный двумя точками (xmin, y), (xmax, y). Преобразование настроено так, что x задаётся в координатах области Axes, а 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` или `aa`	bool
`clip_box`	`BboxBase` или None
`clip_on`	bool
`clip_path`	Patch или (Path, Transform) или None
`color` или `c`	цвет
`dash_capstyle`	`CapStyle` или {'butt', 'projecting', 'round'}
`dash_joinstyle`	`JoinStyle` или {'miter', 'round', 'bevel'}
`dashes`	последовательность float (включённые/выключенные участки линии в пунктах) или (None, None)
`data`	массив (2, N) или два одномерных массива
`drawstyle` или `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` или `ls`	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
`linewidth` или `lw`	float
`marker`	строка стиля маркера, `Path` или `MarkerStyle`
`markeredgecolor` или `mec`	цвет
`markeredgewidth` или `mew`	float
`markerfacecolor` или `mfc`	цвет
`markerfacecoloralt` или `mfcalt`	цвет
`markersize` или `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: Добавляет линию с произвольным наклоном.

Примеры

нарисовать толстую красную горизонтальную линию при '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.axes.Axes.axhline`

Курсор-перекрестие

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

Заливка области между двумя линиями

Заливка областей, заданных логической маской, с помощью fill_between

Временная шкала с линиями, датами и текстом

Построение доверительного эллипса для двумерного набора данных

Двухсторонняя гистограмма

Многострочный текст

Базовая линия текста usetex

matplotlib.axes.Axes.axhline

Примеры

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

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