matplotlib.pyplot.axvline

matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, **kwargs)

添加一条垂直线，跨越整个或部分坐标轴。

注意：如果你想在数据坐标中设置y轴限制，请使用vlines代替。

参数:

xfloat, default: 0

x位置，位于数据坐标。

yminfloat, default: 0

起始y位置，位于坐标轴坐标。应介于0和1之间，其中0表示绘图底部，1表示绘图顶部。

ymaxfloat, default: 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	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	浮点数或 None
animated	布尔值
antialiased or aa	布尔值
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
color or c	color
dash_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
dash_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
dashes	浮点数序列（点中的开/关墨迹）或 (None, None)
data	(2, N) 数组或两个一维数组
drawstyle or ds	{'default', 'steps', 'steps-pre', 'steps-mid', 'steps-post'}，默认值: 'default'
figure	Figure or SubFigure
fillstyle	{'full', 'left', 'right', 'bottom', 'top', 'none'}
gapcolor	颜色 或 None
gid	str
in_layout	布尔值
label	object
linestyle or ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth or lw	浮点数
marker	marker style string, Path or MarkerStyle
markeredgecolor or mec	color
markeredgewidth or mew	浮点数
markerfacecolor or mfc	color
markerfacecoloralt or mfcalt	color
markersize or ms	浮点数
markevery	None 或 int 或 (int, int) 或 slice 或 list[int] 或 float 或 (float, float) 或 list[bool]
mouseover	布尔值
path_effects	list of AbstractPathEffect
picker	浮点数或 callable[[Artist, Event], tuple[bool, dict]]
pickradius	浮点数
rasterized	布尔值
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
solid_capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
solid_joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
transform	未知
url	str
visible	布尔值
xdata	一维数组
ydata	一维数组
zorder	浮点数

另请参阅

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的示例

无限线条

无限线条