matplotlib.pyplot.axvline

matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, **kwargs)[исходный код]

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

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

Параметры:

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

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

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

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

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

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

Возвращает:

Line2D

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

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

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

**kwargs

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

Свойство	Описание
agg_filter	функция фильтра, принимающая массив чисел с плавающей точкой размером (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	unknown
url	str
visible	bool
xdata	одномерный массив
ydata	одномерный массив
zorder	float

См. также

vlines

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

axvspan

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

axline

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

Примечания

Примечание

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

Примеры

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

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

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

  >>> axvline(x=1)
  

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

  >>> axvline(x=.5, ymin=0.25, ymax=0.75)
  

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

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

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