matplotlib.pyplot.fill_betweenx#

matplotlib.pyplot.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值之间的区域。

备注

注意

这是 pyplot 封装，用于 axes.Axes.fill_betweenx。