matplotlib.pyplot.stackplot#

matplotlib.pyplot.stackplot(x, *args, labels=(), colors=None, baseline='zero', data=None, **kwargs)[source]#

绘制堆叠面积图或流线图。

参数:
x(N,) 类数组结构
y(M, N) 类数组结构

数据可以是堆叠的或未堆叠的。以下调用方式均合法

stackplot(x, y)  # where y has shape (M, N) e.g. y = [y1, y2, y3, y4]
stackplot(x, y1, y2, y3, y4)  # where y1, y2, y3, y4 have length N
baseline{'zero', 'sym', 'wiggle', 'weighted_wiggle'}

用于计算基准线的方法

  • 'zero':恒定的零基准线,即简单的堆叠图。

  • 'sym':关于零对称,有时被称为“主题河流图”(ThemeRiver)。

  • 'wiggle':最小化斜率平方和。

  • 'weighted_wiggle':执行相同操作,但根据各层的大小进行加权。这也称为“流图”(Streamgraph)布局。更多详细信息请参考 http://leebyron.com/streamgraph/

labels字符串列表, 可选

为每个数据序列分配的标签序列。如果未指定,则不会为绘图元素应用标签。

colors颜色列表,可选

用于循环填充堆叠区域的颜色序列。该序列的长度不需要与提供的 y 的数量完全一致,如果长度不一致,颜色将从开头循环使用。

如果未指定,将使用 Axes 属性循环中的颜色。

data可索引对象,可选

如果提供,所有参数也接受字符串 s,如果 sdata 中的键,则将其解释为 data[s]

**kwargs
所有其他关键字参数都会传递给 Axes.fill_between。以下

参数额外支持接收与 y 数据集相对应的值序列

  • hatch

  • edgecolor

  • facecolor

  • linewidth

  • linestyle

3.9 版本新增:允许为 hatch(填充图案)使用字符串序列。

3.11 版本新增:允许在上述列出的 Axes.fill_between 参数中使用值序列。

返回:
PolyCollection 列表

PolyCollection 实例列表,堆叠面积图中的每个元素对应一个实例。

备注

注意

这是 axes.Axes.stackplotpyplot 包装器