matplotlib.axes.Axes.fill_between #

轴。fill_between ( x , y1 , y2 = 0 , where = None , interpolate = False , step = None , * , data = None , ** kwargs ) [source] #

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

曲线由点 ( 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 值之间填充。

使用#的示例matplotlib.axes.Axes.fill_between

填充介于和 Alpha 之间

填充介于和 Alpha 之间

填充介于和 Alpha 之间
填充线条之间的区域

填充线条之间的区域

填充线条之间的区域
填充之间(x,y1,y2)

填充之间(x,y1,y2)

填充之间(x,y1,y2)