matplotlib.pyplot.fill_between#

matplotlib.pyplot.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs)[源]#

填充两条水平曲线之间的区域。

曲线由点 (x, y1) 和 (x, y2) 定义。这会创建描述填充区域的一个或多个多边形。

您可以使用 where 排除某些水平区域的填充。

默认情况下，边缘直接连接给定的点。如果填充应为阶梯函数（即在 x 之间保持恒定），请使用 step。

参数:

x类数组

定义曲线节点的 x 坐标。

y1类数组或浮点数

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

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

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

where布尔值类数组, 可选

定义 where 以排除某些水平区域的填充。填充区域由坐标 x[where] 定义。更准确地说，如果 where[i] and where[i+1] 为真，则在 x[i] 和 x[i+1] 之间填充。请注意，此定义意味着在 where 中，两个 False 值之间的孤立 True 值不会导致填充。由于相邻的 False 值，True 位置的两侧都将保持未填充。

interpolate布尔值, 默认值: False

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

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

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

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

如果填充应为阶梯函数（即在 x 之间保持恒定），请定义 step。该值决定阶梯发生的位置

'pre'：y 值从每个 x 位置向左持续保持恒定，即区间 (x[i-1], x[i]] 具有值 y[i]。
'post'：y 值从每个 x 位置向右持续保持恒定，即区间 [x[i], x[i+1]) 具有值 y[i]。
'mid': 阶梯发生在 x 位置的中间。

返回:

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

其他参数:

data可索引对象，可选

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

x, y1, y2, 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`	字符串
`hatch`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	未知
`in_layout`	布尔值
`joinstyle`	`JoinStyle` 或 {'miter', 'round', 'bevel'}
`label`	对象
`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`	字符串
`字符串列表或 None`	urls
`verts`	类数组列表
`verts_and_codes`	未知
`visible`	布尔值
`zorder`	浮点数