matplotlib pyplot fill_between Matplotlib 3 4 1 documentation

Prévia do material em texto

indexmodules |next |previous |home | contents » API Overview » matplotlib.pyplot »
[source]
matplotlib.pyplot » matplotlib.pyplot.fill_between
Table of Contents
matplotlib.pyplot.fill_between
Examples using
matplotlib.pyplot.fill_betwe
Show Page Source
Installa�on Documenta�on Examples Tutorials Contribu�ng Search
matplotlib.pyplot.fill_between
matplotlib.pyplot.fill_between(x, y1, y2=0, where=None,
interpolate=False, step=None, *, data=None, **kwargs)
Fill the area between two horizontal curves.
The curves are defined by the points (x, y1) and (x, y2). This creates
one or multiple polygons describing the filled area.
You may exclude some horizontal sections from filling using where.
By default, the edges connect the given points directly. Use step if the
filling should be a step function, i.e. constant in between x.
Parameters: x : array (length N)
The x coordinates of the nodes defining the
curves.
y1 : array (length N) or scalar
The y coordinates of the nodes defining the
first curve.
y2 : array (length N) or scalar, default: 0
The y coordinates of the nodes defining the
second curve.
where : array of bool (length N), optional
Define where to exclude some horizontal
regions from being filled. The filled regions
are defined by the coordinates x[where].
More precisely, fill between x[i] and
x[i+1] if where[i] and where[i+1]. Note
that this definition implies that an isolated
True value between two False values in
where will not result in filling. Both sides of
Version 3.4.1Fork me on GitHub
https://matplotlib.org/stable/genindex.html
https://matplotlib.org/stable/py-modindex.html
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.fill_betweenx.html
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.fill.html
https://matplotlib.org/stable/index.html
https://matplotlib.org/stable/contents.html
https://matplotlib.org/stable/api/index.html
https://matplotlib.org/stable/api/pyplot_summary.html
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.html
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.fill_between.html
https://matplotlib.org/stable/contents.html
https://matplotlib.org/stable/_sources/api/_as_gen/matplotlib.pyplot.fill_between.rst.txt
https://matplotlib.org/stable/users/installing.html
https://matplotlib.org/stable/contents.html
https://matplotlib.org/stable/gallery/index.html
https://matplotlib.org/stable/tutorials/index.html
https://matplotlib.org/stable/devel/index.html
https://matplotlib.org/stable/_modules/matplotlib/pyplot.html#fill_between
https://matplotlib.org/stable/index.html
https://github.com/matplotlib/matplotlib
the True position remain unfilled due to the
adjacent False values.
interpolate : bool, default: False
This option is only relevant if where is used
and the two curves are crossing each other.
Semantically, where is often used for y1 >
y2 or similar. By default, the nodes of the
polygon defining the filled region will only
be placed at the positions in the x array.
Such a polygon cannot describe the above
semantics close to the intersection. The x-
sections containing the intersection are
simply clipped.
Setting interpolate to True will calculate the
actual intersection point and extend the
filled region up to this point.
step : {'pre', 'post', 'mid'}, optional
Define step if the filling should be a step
function, i.e. constant in between x. The
value determines where the step will occur:
'pre': The y value is continued
constantly to the left from every x
position, i.e. the interval (x[i-1],
x[i]] has the value y[i].
'post': The y value is continued
constantly to the right from every x
position, i.e. the interval [x[i],
x[i+1]) has the value y[i].
'mid': Steps occur half-way between
the x positions.
Returns: PolyCollection
A PolyCollection containing the plotted
polygons.
Other Parameters: **kwargs
All other keyword arguments are passed on
to PolyCollection. They control the
Polygon properties:
Property Description
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.PolyCollection
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.PolyCollection
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.PolyCollection
https://matplotlib.org/stable/api/_as_gen/matplotlib.patches.Polygon.html#matplotlib.patches.Polygon
Property Description
agg_filter a filter function, which
takes a (m, n, 3) float
array and a dpi value,
and returns a (m, n,
3) array
alpha array-like or scalar or
None
animated bool
antialiased or
aa or antialiaseds
bool or list of bools
array ndarray or None
capstyle CapStyle or {'butt',
'projecting', 'round'}
clim (vmin: float, vmax:
float)
clip_box Bbox
clip_on bool
clip_path Patch or (Path,
Transform) or None
cmap Colormap or str or
None
color color or list of rgba
tuples
contains unknown
edgecolor or ec
or edgecolors
color or list of colors
or 'face'
facecolor or
facecolors or fc
color or list of colors
figure Figure
gid str
hatch {'/', '\', '|', '-', '+', 'x', 'o',
'O', '.', '*'}
in_layout bool
joinstyle JoinStyle or {'miter',
'round', 'bevel'}
label object
linestyle or
dashes or
linestyles or ls
str or tuple or list
thereof
linewidth or
linewidths or lw
float or list of floats
norm Normalize or None
offset_position unknown
offsets (N, 2) or (2,) array-
like
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_agg_filter.html#matplotlib.artist.Artist.set_agg_filter
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_alpha
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_animated.html#matplotlib.artist.Artist.set_animated
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_antialiased
https://matplotlib.org/stable/api/cm_api.html#matplotlib.cm.ScalarMappable.set_array
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_capstyle
https://matplotlib.org/stable/api/_enums_api.html#matplotlib._enums.CapStyle
https://matplotlib.org/stable/api/cm_api.html#matplotlib.cm.ScalarMappable.set_clim
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_clip_box.html#matplotlib.artist.Artist.set_clip_box
https://matplotlib.org/stable/api/transformations.html#matplotlib.transforms.Bbox
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_clip_on.html#matplotlib.artist.Artist.set_clip_on
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_clip_path.html#matplotlib.artist.Artist.set_clip_path
https://matplotlib.org/stable/api/cm_api.html#matplotlib.cm.ScalarMappable.set_cmap
https://matplotlib.org/stable/api/_as_gen/matplotlib.colors.Colormap.html#matplotlib.colors.Colormap
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_color
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_contains.html#matplotlib.artist.Artist.set_contains
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_edgecolor
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_facecolor
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_figure.html#matplotlib.artist.Artist.set_figure
https://matplotlib.org/stable/api/figure_api.html#matplotlib.figure.Figure
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_gid.html#matplotlib.artist.Artist.set_gid
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_hatch
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_in_layout.html#matplotlib.artist.Artist.set_in_layout
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_joinstyle
https://matplotlib.org/stable/api/_enums_api.html#matplotlib._enums.JoinStyle
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_label.html#matplotlib.artist.Artist.set_labelhttps://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_linestyle
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_linewidth
https://matplotlib.org/stable/api/cm_api.html#matplotlib.cm.ScalarMappable.set_norm
https://matplotlib.org/stable/api/_as_gen/matplotlib.colors.Normalize.html#matplotlib.colors.Normalize
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_offset_position
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_offsets
Property Description
path_effects AbstractPathEffect
picker None or bool or float
or callable
pickradius float
rasterized bool
sketch_params (scale: float, length:
float, randomness:
float)
snap bool or None
transform Transform
url str
urls list of str or None
visible bool
zorder float
See also
fill_between
Fill between two sets of y-values.
fill_betweenx
Fill between two sets of x-values.
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 can also be string s, which is
interpreted as data[s] (unless this raises an exception): x, y1,
y2, where.
Objects passed as data must support item access (data[s])
and membership test (s in data).
Examples using
matplotlib.pyplot.fill_between
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_path_effects.html#matplotlib.artist.Artist.set_path_effects
https://matplotlib.org/stable/api/patheffects_api.html#matplotlib.patheffects.AbstractPathEffect
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_picker.html#matplotlib.artist.Artist.set_picker
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_pickradius
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_rasterized.html#matplotlib.artist.Artist.set_rasterized
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_sketch_params.html#matplotlib.artist.Artist.set_sketch_params
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_snap.html#matplotlib.artist.Artist.set_snap
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_transform.html#matplotlib.artist.Artist.set_transform
https://matplotlib.org/stable/api/transformations.html#matplotlib.transforms.Transform
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_url.html#matplotlib.artist.Artist.set_url
https://matplotlib.org/stable/api/collections_api.html#matplotlib.collections.Collection.set_urls
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_visible.html#matplotlib.artist.Artist.set_visible
https://matplotlib.org/stable/api/_as_gen/matplotlib.artist.Artist.set_zorder.html#matplotlib.artist.Artist.set_zorder
https://matplotlib.org/stable/api/_as_gen/matplotlib.pyplot.fill_betweenx.html#matplotlib.pyplot.fill_betweenx