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 ). 这将创建一个或多个描述填充区域的多边形。

您可以使用 在哪里？ .

默认情况下，边直接连接给定的点。使用 step 如果填充应为阶跃函数，即介于 x .

参数:
x数组（长度n）

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

y1数组（长度n）或标量

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

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

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

where布尔数组（长度N），可选

定义 在哪里？ 不填充某些水平区域。填充区域由坐标定义。 x[where] . 更准确地说，在两者之间填充 x[i] 和 x[i+1] 如果 where[i] and where[i+1] . 注意，这个定义意味着 True 介于两者之间的值 假 价值观 在哪里？ 不会导致填充。两侧 True 位置因相邻而未填满 假 价值观。

interpolatebool，默认值：False

此选项仅在以下情况下适用 在哪里？ 两条曲线相互交叉。

语义上， 在哪里？ 通常用于 y1 > y2 或者类似的。默认情况下，定义填充区域的多边形节点将仅放置在 x 数组。这样的多边形不能描述上述接近交点的语义。包含交叉点的x截面将被简单地剪裁。

设置 内插 到 True 将计算实际交叉点并将填充区域扩展到此点。

step'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

A PolyCollection 包含绘制的多边形。
其他参数:
**kwargs

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

财产 描述
agg_filter 一种过滤函数，它接受一个（m，n，3）浮点数组和一个dpi值，并返回一个（m，n，3）数组。
alpha 浮动或无
animated 布尔
antialiased 或者aa或者抗锯齿药 布尔或布尔列表
array 恩达雷
capstyle “对接”、“圆形”、“突出”
clim （V最小：浮动，V最大：浮动）
clip_box Bbox
clip_on 布尔
clip_path 面片或（路径、变换）或无
cmap Colormap 或str或None
color rgba元组的颜色或列表
contains 未知的
edgecolor 或ec或edgecolors 颜色或颜色列表或“面”
facecolor 或者facecolors或者fc 颜色或颜色列表
figure Figure
gid STR
hatch '/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*'
in_layout 布尔
joinstyle 'miter'、'round'、'bevel'
label 对象
linestyle 或虚线或线型或ls str或tuple或其列表
linewidth 或线宽或lw 浮动或浮动列表
norm Normalize 或无
offset_position 未知的
offsets 类似于（N，2）或（2，）
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
pickradius 未知的
rasterized 布尔或无
sketch_params （比例：浮动，长度：浮动，随机性：浮动）
snap 布尔或无
transform Transform
url STR
urls str或None列表
visible 布尔
zorder 浮动

参见

fill_between
在两组Y值之间填充。
fill_betweenx
在两组x值之间填充。

笔记

注解

除了上述参数外，此函数还可以 data 关键字参数。如果这样的话 data 参数，下列参数也可以是字符串 s ，解释为 data[s] （除非引起例外）： x ， y1 ， y2 ， 在哪里？ .

作为传递的对象 data 必须支持项目访问 (data[s] ）和会员资格测试 (s in data ）