Python matplotlib axvspan用法及代码示例

本文简要介绍 python 语言中 matplotlib.pyplot.axvspan 的用法。

用法

matplotlib.pyplot.axvspan(xmin, xmax, ymin=0, ymax=1, **kwargs)

在轴上添加一个垂直跨度(矩形)。

矩形从 xmin 水平跨越到 xmax，默认情况下，整个 y 轴垂直跨越。 y-span可以使用轴单位的ymin(默认：0)和ymax(默认：1)设置；例如ymin = 0.5 始终指 y 轴的中间，而与 set_ylim 设置的限制无关。

参数：

xmin 浮点数

跨度的下 x 坐标，以数据单位表示。

xmax 浮点数

跨度的上 x 坐标，以数据单位表示。

ymin 浮点数，默认值：0

跨度的下 y 坐标，以 y 轴单位 (0-1) 为单位。

ymax 浮点数，默认值：1

跨度的上 y 坐标，以 y 轴单位 (0-1) 为单位。

返回：

Polygon

从 (xmin, ymin) 到 (xmax, ymax) 的垂直跨度(矩形)。

其他参数：

**kwargs Polygon 属性

属性	说明
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	标量或无
animated	bool
antialiased 或 aa	布尔或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clip_box	BboxBase 或无
clip_on	bool
clip_path	补丁或(路径，变换)或无
closed	bool
color	color
edgecolor 或 ec	颜色或无
facecolor 或 fc	颜色或无
figure	Figure
fill	bool
gid	str
matplotlib.patches.Patch.set_hatch	{'/'、'\'、'|'、'-'、'+'、'x', 'o'、'O'、'.'、'*'}
in_layout	bool
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或 ls	{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
linewidth 或 lw	浮点数或无
mouseover	bool
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或可调用
rasterized	bool
sketch_params	(比例：浮点数，长度：浮点数，随机性：浮点数)
snap	布尔或无
transform	Transform
url	str
visible	bool
xy	(N, 2) 类似数组
zorder	float

例子

从 x = 1.25 到 x = 1.55 绘制一个垂直的绿色半透明矩形，跨越轴的 y 范围。

>>> axvspan(1.25, 1.55, facecolor='g', alpha=0.5)