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从填充中排除一些水平部分。

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

参数：

x数组（长度 N）

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

y1数组（长度 N）或标量

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

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

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

其中bool 数组（长度 N），可选

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

插值布尔值，默认值：False

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

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

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

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

定义step如果填充应该是一个阶跃函数，即x之间的常数。该值确定步骤将发生的位置：

• 'pre': y 值从每个x位置一直向左连续，即区间有 值。(x[i-1], x[i]]y[i]

• 'post': y 值从每个x位置不断向右延伸，即区间有 值。[x[i], x[i+1])y[i]

• 'mid'：台阶出现在x位置的中间。

返回：

PolyCollection

APolyCollection包含绘制的多边形。

其他参数：

数据可索引对象，可选

如果给定，以下参数也接受一个字符串s，它被解释为data[s]（除非这引发异常）：

x , y1 , y2 ,其中

**kwargs

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

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	类数组或标量或无
animated	布尔
antialiased或 aa 或抗锯齿	布尔或布尔列表
array	类数组或无
capstyle	CapStyle或 {'butt', 'projecting', 'round'}
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
color	rgba 元组的颜色或列表
edgecolor或 ec 或 edgecolors	颜色或颜色列表或“脸”
facecolor或 facecolors 或 fc	颜色或颜色列表
figure	Figure
gid	字符串
hatch	{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}
in_layout	布尔
joinstyle	JoinStyle或 {'miter', 'round', 'bevel'}
label	目的
linestyle或破折号或线条样式或 ls	str 或元组或其列表
linewidth或线宽或lw	浮动或浮动列表
mouseover	布尔
norm	Normalize或 str 或 无
offset_transform或 transOffset	未知
offsets	(N, 2) 或 (2,) 类数组
path_effects	AbstractPathEffect
paths	类似数组的列表
picker	None 或 bool 或 float 或可调用
pickradius	未知
rasterized	布尔
sizes	ndarray 或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
urls	str 或 None 的列表
verts	类似数组的列表
verts_and_codes	未知
visible	布尔
zorder	漂浮

也可以看看

fill_between

在两组 y 值之间填充。

fill_betweenx

在两组 x 值之间填充。