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类数组

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

x1类数组或浮点数

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

x2类数组或浮点数，默认值：0

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

where布尔值类数组, 可选

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

interpolate布尔值, 默认值: False

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

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

将 interpolate 设置为 True 将计算实际交点并将填充区域扩展到该点。

step{'pre', 'post', 'mid'}, 可选

如果填充应为阶梯函数（即 y 之间保持常数），则定义 step。该值决定了阶梯发生的位置

• 'pre'：x 值从每个 y 位置向左连续不变，即区间 (y[i-1], y[i]] 的值为 x[i]。

• 'post'：y 值从每个 y 位置向右连续不变，即区间 [y[i], y[i+1]) 的值为 x[i]。

• 'mid'：阶梯发生在 y 位置的中间。

返回:

FillBetweenPolyCollection

一个 FillBetweenPolyCollection，包含绘制的多边形。

其他参数:

data可索引对象，可选

如果给定，以下参数也接受字符串 s，如果 s 是 data 中的键，则将其解释为 data[s]

y, x1, x2, where

**kwargs

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

属性	描述
agg_filter	一个过滤函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
alpha	类数组或浮点数或 None
animated	布尔值
antialiased 或 aa 或 antialiaseds	布尔值或布尔值列表
array	类数组或 None
capstyle	CapStyle 或 {'butt', 'projecting', 'round'}
clim	(vmin: 浮点数, vmax: 浮点数)
clip_box	BboxBase 或 None
clip_on	布尔值
clip_path	Patch 或 (Path, Transform) 或 None
cmap	Colormap 或 字符串 或 None
color	颜色 或 RGBA 元组列表
data	类数组
edgecolor 或 ec 或 edgecolors	颜色 或 颜色列表 或 'face'
facecolor 或 facecolors 或 fc	颜色 或 颜色列表
figure	Figure 或 SubFigure
gid	str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	未知
in_layout	布尔值
joinstyle	JoinStyle 或 {'miter', 'round', 'bevel'}
label	object
linestyle 或 dashes 或 linestyles 或 ls	字符串或元组或其列表
linewidth 或 linewidths 或 lw	浮点数或浮点数列表
mouseover	布尔值
norm	Normalize 或 字符串 或 None
offset_transform 或 transOffset	变换
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect 列表
paths	类数组列表
picker	None 或 布尔值 或 浮点数 或 可调用对象
pickradius	浮点数
rasterized	布尔值
sizes	numpy.ndarray 或 None
sketch_params	(scale: 浮点数, length: 浮点数, randomness: 浮点数)
snap	布尔值或 None
transform	变换
url	str
字符串列表或 None	urls
verts	类数组列表
verts_and_codes	未知
visible	布尔值
zorder	浮点数

另请参阅

fill_between

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

fill_betweenx

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

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

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

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