matplotlib.axes.Axes.fill_betweenx

Axes.fill_betweenx(y, x1, x2=0, where=None, step=None, interpolate=False, *, data=None, **kwargs)

填充两条垂直曲线之间的区域。

曲线由点 (y, x1) 和 (y, x2) 定义。这会创建一个或多个描述填充区域的图形。

你可以使用 where 来排除某些垂直部分进行填充。

默认情况下，边缘直接连接给定的点。如果填充应为阶跃函数，即在 y 之间为常数，请使用 step。

参数:

y数组 (长度 N)

定义曲线的节点的y坐标。

x1数组（长度为N）或标量

定义第一条曲线的节点的x坐标。

x2数组（长度 N）或标量，默认值：0

定义第二条曲线的节点的x坐标。

哪里布尔数组（长度为 N），可选

定义 哪里 排除一些垂直区域不被填充。填充区域由坐标 y[where] 定义。更准确地说，如果 where[i] 和 where[i+1]，则在 y[i] 和 y[i+1] 之间填充。请注意，此定义意味着在 where 中两个 False 值之间的孤立 True 值不会导致填充。由于相邻的 False 值，True 位置的两侧仍未填充。

插值bool, 默认: False

此选项仅在使用 where 且两条曲线相交时相关。

从语义上讲，where 通常用于 x1 > x2 或类似情况。默认情况下，定义填充区域的多边形的节点只会放置在 y 数组中的位置。这样的多边形无法在接近交点处描述上述语义。包含交点的 y 段仅被简单地裁剪。

将 interpolate 设置为 True 将计算实际的交点，并将填充区域延伸至该点。

步骤{'pre', 'post', 'mid'}, 可选

如果填充应为阶跃函数，即在 y 之间为常数，则定义 step。该值确定阶跃发生的位置：

• 'pre': y 值从每个 x 位置开始向左持续延伸，即区间 (x[i-1], x[i]] 的值为 y[i]。

• 'post': y 值从每个 x 位置开始向右持续延伸，即区间 [x[i], x[i+1]) 的值为 y[i]。

• 'mid': 步骤发生在 x 位置之间的中间。

返回:

PolyCollection

包含绘制多边形的 PolyCollection。

其他参数:

数据可索引对象，可选

如果给出，以下参数也接受一个字符串 s，如果 s 是 data 中的一个键，则解释为 data[s]：

y, x1, x2, where

**kwargs

所有其他的关键字参数都会传递给 PolyCollection。它们控制 Polygon 的属性：

属性	描述
agg_filter	一个过滤函数，它接收一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和两个从图像左下角开始的偏移量
alpha	类数组或标量或无
animated	布尔
抗锯齿 或 aa 或 antialiaseds	布尔值或布尔值列表
数组	类数组或无
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
颜色	color 或 RGBA 元组列表
edgecolor 或 ec 或 edgecolors	color 或 color 列表 或 'face'
facecolor 或 facecolors 或 fc	color 或 color 列表
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	布尔
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
标签	对象
linestyle 或虚线或线型或 ls	str 或 tuple 或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
鼠标悬停	布尔
norm	Normalize 或 str 或 None
offset_transform 或 transOffset	Transform
偏移量	(N, 2) 或 (2,) 数组类
path_effects	AbstractPathEffect 的列表
路径	类数组列表
picker	None 或 bool 或 float 或 callable
pickradius	float
光栅化	布尔
sizes	numpy.ndarray 或 None
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
urls	list of str or None
verts	类数组列表
verts_and_codes	未知
可见	布尔
zorder	float

参见

fill_between

填充两组 y 值之间的区域。

fill_betweenx

填充两组 x 值之间的区域。

使用 matplotlib.axes.Axes.fill_betweenx 的示例

填充两条垂直线之间的区域

Fill the area between two vertical lines