matplotlib.axes.Axes.axvline
- Axes.axvline(x=0, ymin=0, ymax=1, **kwargs)[исходный код]
-
Добавляет вертикальную линию, охватывающую всю область Axes или её часть.
Примечание. Если требуется задать пределы по оси y в координатах данных, используйте вместо этого
vlines.- Параметры:
-
- xfloat, по умолчанию: 0
-
Положение по оси x в координатах данных.
- yminfloat, по умолчанию: 0
-
Начальное положение по оси y в координатах области построения. Значение должно находиться в диапазоне от 0 до 1: 0 соответствует нижней границе графика, 1 — верхней.
- ymaxfloat, по умолчанию: 1
-
Конечное положение по оси y в координатах области построения. Значение должно находиться в диапазоне от 0 до 1: 0 соответствует нижней границе графика, 1 — верхней.
- Возвращает:
-
Line2D-
Line2D, заданный двумя точками(x, ymin),(x, ymax). Преобразование настроено так, что x задаётся в координатах данных, а y — в координатах области построения.Это по-прежнему обычная линия, а вертикальной она становится только потому, что для обеих точек используются одинаковые значения x. Поэтому, чтобы впоследствии изменить значение x, необходимо задать два значения
line.set_xdata([3, 3]).
- Другие параметры:
-
- **kwargs
-
Допустимые именованные аргументы — свойства
Line2D, за исключением 'transform':Свойство
Описание
функция фильтра, принимающая массив float формы (m, n, 3) и значение dpi и возвращающая массив формы (m, n, 3) и два смещения от нижнего левого угла изображения
float или None
bool
antialiasedилиaabool
BboxBaseили Nonebool
Patch или (Path, Transform) или None
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}последовательность значений float (включение/выключение линии в пунктах) или (None, None)
массив формы (2, N) или два одномерных массива
{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}, по умолчанию: 'default'
{'full', 'left', 'right', 'bottom', 'top', 'none'}
цвет или None
str
bool
object
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
float
строка со стилем маркера,
PathилиMarkerStylemarkeredgecolorилиmecmarkeredgewidthилиmewfloat
markerfacecolorилиmfcmarkersizeилиmsfloat
None, int, (int, int), slice, list[int], float, (float, float) или list[bool]
bool
список объектов
AbstractPathEffectfloat или callable[[Artist, Event], tuple[bool, dict]]
float
bool
(scale: float, length: float, randomness: float)
bool или None
CapStyleили {'butt', 'projecting', 'round'}JoinStyleили {'miter', 'round', 'bevel'}неизвестно
str
bool
одномерный массив
одномерный массив
float
См. также
Примеры
-
нарисовать толстую красную вертикальную линию при 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.axes.Axes.axvline
Диаграмма SkewT-logP: использование преобразований и пользовательских проекций
Построение доверительного эллипса для двумерного набора данных
© 2012–2026 Matplotlib Development Team. All rights reserved.
Licensed under the Matplotlib License Agreement.
https://matplotlib.org/stable/api/_as_gen/matplotlib.axes.Axes.axvline.html