matplotlib.axes.Axes.fill_between#

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

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

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

你可以使用 where 来排除一些水平部分进行填充。

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

参数:

x数组 (长度 N)

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

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

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

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

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

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

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

插值bool, 默认: False

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

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

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

步骤{'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 位置的中间。

返回:

PolyCollection: 包含绘制多边形的 PolyCollection。

其他参数:

数据可索引对象，可选

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

x, y1, y2, where

**kwargs

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

属性	描述
`agg_filter`	一个过滤函数，它接收一个 (m, n, 3) 的浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组以及图像左下角的两个偏移量
`alpha`	类似数组或标量或无
`animated`	布尔
`抗锯齿` 或 aa 或 antialiaseds	布尔值或布尔值列表
`数组`	类似数组或无
`capstyle`	`CapStyle` 或 {'butt', 'projecting', 'round'}
`clim`	(vmin: 浮点数, vmax: 浮点数)
`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'}
`标签`	对象
`线型` 或虚线或线型或 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`	浮动
`光栅化`	布尔
`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`	浮动