matplotlib.pyplot.stackplot
-
matplotlib.pyplot.stackplot(x, *args, labels=(), colors=None, baseline='zero', data=None, **kwargs)
[source]
-
Draw a stacked area plot.
Parameters: |
-
x : 1d array of dimension N -
y : 2d array (dimension MxN), or sequence of 1d arrays (each dimension 1xN) -
The data is assumed to be unstacked. Each of the following calls is legal: stackplot(x, y) # where y is MxN
stackplot(x, y1, y2, y3, y4) # where y1, y2, y3, y4, are all 1xNm
-
baseline : {'zero', 'sym', 'wiggle', 'weighted_wiggle'} -
Method used to calculate the baseline: -
'zero' : Constant zero baseline, i.e. a simple stacked plot. -
'sym' : Symmetric around zero and is sometimes called 'ThemeRiver'. -
'wiggle' : Minimizes the sum of the squared slopes. -
'weighted_wiggle' : Does the same but weights to account for size of each layer. It is also called 'Streamgraph'-layout. More details can be found at http://leebyron.com/streamgraph/. -
labels : Length N sequence of strings -
Labels to assign to each data series. -
colors : Length N sequence of colors -
A list or tuple of colors. These will be cycled through and used to colour the stacked areas. - **kwargs
-
All other keyword arguments are passed to Axes.fill_between() . |
Returns: |
-
list : list of PolyCollection -
A list of PolyCollection instances, one for each element in the stacked area plot. |
Notes
Note
In addition to the above described arguments, this function can take a data keyword argument. If such a data argument is given, the following arguments are replaced by data[<arg>]:
- All positional and all keyword arguments.
Objects passed as data must support item access (data[<arg>]
) and membership test (<arg> in data
).