matplotlib.pyplot.axvspan#
- matplotlib.pyplot.axvspan(xmin, xmax, ymin=0, ymax=1, **kwargs)[source]#
在 Axes 上添加一个垂直跨度(矩形)。
该矩形水平方向从 xmin 延伸到 xmax,垂直方向默认延伸整个 y 轴。y 轴的范围可以使用 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)。
- 返回:
矩形
从 (xmin, ymin) 到 (xmax, ymax) 的垂直范围(矩形)。
- 其他参数:
- **kwargs
Rectangle
属性 属性
描述
一个过滤函数,它接受一个 (m, n, 3) 浮点数组和一个 dpi 值,并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
浮点数或 None
未知
布尔值
布尔值或 None
(左,下,宽,高)
CapStyle
或 {'butt', 'projecting', 'round'}BboxBase
或 None布尔值
Patch 或 (Path, Transform) 或 None
颜色 或 None
颜色 或 None
布尔值
字符串
{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
未知
未知
布尔值
JoinStyle
或 {'miter', 'round', 'bevel'}对象
{'-', '--', '-.', ':', '', (offset, on-off-seq), ...}
浮点数或 None
布尔值
None 或 布尔值 或 浮点数 或 可调用对象
布尔值
(scale: 浮点数, length: 浮点数, randomness: 浮点数)
布尔值或 None
字符串
布尔值
未知
未知
(浮点数, 浮点数)
未知
浮点数
- **kwargs
另请参阅
axhspan
在坐标轴上添加一个水平范围。
备注
注意
这是 pyplot 包装器,用于
axes.Axes.axvspan
。示例
绘制一个垂直的、绿色的、半透明矩形,x 范围从 1.25 到 1.55,并跨越坐标轴的 y 范围。
>>> axvspan(1.25, 1.55, facecolor='g', alpha=0.5)