matplotlib.axes.Axes.fill_between#

Axes.fill_between(x, y1, y2=0, where=None, interpolate=False, step=None, *, data=None, **kwargs)[Quelle]#

Füllt den Bereich zwischen zwei horizontalen Kurven.

Die Kurven werden durch die Punkte (x, y1) und (x, y2) definiert. Dies erzeugt ein oder mehrere Polygone, die den gefüllten Bereich beschreiben.

Sie können einige horizontale Abschnitte vom Füllen ausschließen, indem Sie where verwenden.

Standardmäßig verbinden die Kanten die gegebenen Punkte direkt. Verwenden Sie step, wenn die Füllung eine Stufenfunktion sein soll, d. h. konstant zwischen x.

Parameter:

xarray-like

Die x-Koordinaten der Knoten, die die Kurven definieren.

y1array-like oder float

Die y-Koordinaten der Knoten, die die erste Kurve definieren.

y2array-like oder float, standard: 0

Die y-Koordinaten der Knoten, die die zweite Kurve definieren.

wherearray-like von bool, optional

Definiert where, um einige horizontale Bereiche vom Füllen auszuschließen. Die gefüllten Bereiche werden durch die Koordinaten x[where] definiert. Genauer gesagt, füllen Sie zwischen x[i] und x[i+1], wenn where[i] and where[i+1]. Beachten Sie, dass diese Definition impliziert, dass ein isolierter True-Wert zwischen zwei False-Werten in where nicht zum Füllen führt. Beide Seiten der True-Position bleiben aufgrund der benachbarten False-Werte ungefüllt.

interpolatebool, standard: False

Diese Option ist nur relevant, wenn where verwendet wird und sich die beiden Kurven schneiden.

Semantisch wird where oft für y1 > y2 oder ähnliches verwendet. Standardmäßig werden die Knoten des Polygons, das den gefüllten Bereich definiert, nur an den Positionen im x-Array platziert. Ein solches Polygon kann die obige Semantik nahe am Schnittpunkt nicht beschreiben. Die x-Abschnitte, die den Schnittpunkt enthalten, werden einfach abgeschnitten.

Wenn interpolate auf True gesetzt wird, wird der tatsächliche Schnittpunkt berechnet und der gefüllte Bereich bis zu diesem Punkt erweitert.

step{'pre', 'post', 'mid'}, optional

Definieren Sie step, wenn die Füllung eine Stufenfunktion sein soll, d. h. konstant zwischen x. Der Wert bestimmt, wo der Schritt auftritt.

'pre': Der y-Wert wird von jeder x-Position aus konstant nach links fortgesetzt, d. h. das Intervall (x[i-1], x[i]] hat den Wert y[i].
'post': Der y-Wert wird von jeder x-Position aus konstant nach rechts fortgesetzt, d. h. das Intervall [x[i], x[i+1]) hat den Wert y[i].
'mid': Schritte treten auf halbem Weg zwischen den x-Positionen auf.

Gibt zurück:

FillBetweenPolyCollection: Eine FillBetweenPolyCollection, die die gezeichneten Polygone enthält.

Andere Parameter:

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren die folgenden Parameter auch einen String s, der als data[s] interpretiert wird, wenn s ein Schlüssel in data ist

x, y1, y2, where

**kwargs

Alle anderen Schlüsselwortargumente werden an FillBetweenPolyCollection weitergegeben. Sie steuern die Polygon-Eigenschaften.

Eigenschaft	Beschreibung
`agg_filter`	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
`alpha`	Array-ähnlich oder float oder None
`animated`	bool
`antialiased` oder `aa` oder `antialiaseds`	bool oder Liste von bools
`Array`	Array-ähnlich oder None
`capstyle`	`CapStyle` oder {'butt', 'projecting', 'round'}
`clim`	(vmin: float, vmax: float)
`clip_box`	`BboxBase` oder None
`clip_on`	bool
`clip_path`	Patch oder (Path, Transform) oder None
`cmap`	`Colormap` oder str oder None
`color`	Farbe oder Liste von RGBA-Tupeln
`Daten`	array-like
`edgecolor` oder `ec` oder `edgecolors`	Farbe oder Liste von Farben oder 'face'
`facecolor` oder `facecolors` oder `fc`	Farbe oder Liste von Farben
`figure`	`Figure` oder `SubFigure`
`gid`	str
`Muster (hatch)`	{'/', '\', '\|', '-', '+', 'x', 'o', 'O', '.', '*'}
`hatch_linewidth`	unknown
`in_layout`	bool
`joinstyle`	`JoinStyle` oder {'miter', 'round', 'bevel'}
`label`	object
`linestyle` oder `dashes` oder `linestyles` oder `ls`	str oder Tupel oder Liste davon
`linewidth` oder `linewidths` oder `lw`	float oder Liste von floats
`mouseover`	bool
`norm`	`Normalize` oder str oder None
`offset_transform` oder `transOffset`	`Transform`
`offsets`	(N, 2) oder (2,) Array-ähnlich
`path_effects`	Liste von `AbstractPathEffect`
`paths`	liste von array-like
`picker`	None oder bool oder float oder callable
`pickradius`	float
`rasterized`	bool
`sizes`	`numpy.ndarray` oder None
`sketch_params`	(scale: float, length: float, randomness: float)
`snap`	bool oder None
`transform`	`Transform`
`url`	str
`urls`	Liste von str oder None
`verts`	liste von array-like
`verts_and_codes`	unknown
`visible`	bool
`zorder`	float