概述
axvline
函数作用是绘制一条以子图高度比例为长度单位的垂直线。
axhline
函数作用与axvline
函数类似,绘制一条以子图宽度比例为长度单位的水平线。
axvline
函数的签名为:
matplotlib.pyplot.axvline(x=0, ymin=0, ymax=1, **kwargs)
其中:
x
:垂直线在x
轴上的位置。浮点数,默认值为0
。ymin
:垂直线在y
轴方向上的起始值。浮点数,默认值为0
。取值范围为[0,1]
,0
表示子图底部,1
表示子图顶部。值可以超出[0,1]
,但是超出部分不会正常显示。ymax
:垂直线在y
轴方向上的终止值。浮点数,默认值为1
。取值范围为[0,1]
,0
表示子图底部,1
表示子图顶部。**kwargs
:除'transform'
之外的Line2D
属性。
axvline
函数的返回值为Line2D
对象。
axhline
函数的签名与axvline
函数类似:
matplotlib.pyplot.axhline(y=0, xmin=0, xmax=1, **kwargs)
案例:演示axvline
函数
import matplotlib.pyplot as plt
# 演示默认参数
plt.subplot(221)
plt.axvline()
plt.xlim(-1, 1)
plt.subplot(222)
# 演示参数x
plt.axvline(0.5)
plt.subplot(223)
# 演示参数x,ymin,ymax
plt.axvline(0.5, 0.2, 0.7)
plt.subplot(224)
# 演示**kwargs参数
plt.axvline(0.5, 0.2, 0.7, linewidth=2, color="r")
plt.show()
axvline/axhline
与vlines/hlines
的区别
axvline/axhline
绘制一条线,返回值为Line2D
对象。vlines/hlines
绘制一组线返回值为LineCollection
对象,相当于Line2D
对象的集合。axvline/axhline
绘制的直线默认是跨越整个子图的,即便更改线的长度,单位是子图高度/宽度的比例([0,1]
),是相对值。vlines/hlines
绘制的直线需要指定长度,长度单位是对应坐标轴的单位,是绝对值。