Spec-Zone.ru › Matplotlib

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':

Свойство

Описание

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

См. также

vlines

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

axvspan

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

axline

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

Примеры

  • нарисовать толстую красную вертикальную линию при 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: использование преобразований и пользовательских проекций

Диаграмма SkewT-logP: использование преобразований и пользовательских проекций

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

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

Построение областей, охватывающих Axes

Построение областей, охватывающих Axes

Дополнительная ось

Дополнительная ось

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

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

Жизненный цикл графика

Жизненный цикл графика

Аннотации

Аннотации

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API