matplotlib.pyplot.fill_between

matplotlib.pyplot. fill_between ( x , y1 , y2 = 0 , wobei = None , interpolate = False , step = None , * , data = None , ** kwargs )

Füllen Sie den Bereich zwischen zwei horizontalen Kurven.

Die Kurven werden durch die Punkte ( x , y1 ) und ( x , y2 ) definiert. Dadurch werden ein oder mehrere Polygone erstellt, 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 angegebenen Punkte direkt. Verwenden Sie step, wenn die Füllung eine Treppenfunktion sein soll, dh konstant zwischen x .

Parameter :

x -Array (Länge N)

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

y1 Array (Länge N) oder Skalar

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

y2 Array (Länge N) oder Skalar, Standard: 0

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

wo Array von bool (Länge N), optional

Definieren Sie , wo einige horizontale Bereiche vom Füllen ausgeschlossen werden sollen. Die gefüllten Bereiche werden durch die Koordinaten definiert x[where]. Genauer gesagt, füllen Sie zwischen x[i]und x[i+1]if aus . 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 angrenzenden False- Werte unbesetzt.where[i] and where[i+1]

interpolate bool, Standard: False

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

Semantisch wird where oft für y1 > y2 oder ähnliches verwendet. Standardmäßig werden die Knoten des Polygons, die den gefüllten Bereich definieren, nur an den Positionen im x -Array platziert. Ein solches Polygon kann die obige Semantik in der Nähe des Schnittpunkts nicht beschreiben. Die den Schnittpunkt enthaltenden X-Schnitte werden einfach abgeschnitten.

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

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

Schritt definieren , wenn die Füllung eine Sprungfunktion sein soll, dh konstant zwischen x . Der Wert bestimmt, wo der Schritt auftritt:

• 'pre': Der y-Wert wird von jeder x -Position nach links konstant fortgesetzt , dh das Intervall hat den Wert .(x[i-1], x[i]]y[i]

• 'post': Der y-Wert wird von jeder x -Position stetig nach rechts fortgesetzt , dh das Intervall hat den Wert .[x[i], x[i+1])y[i]

• 'mid': Schritte treten auf halbem Weg zwischen den x - Positionen auf.

Rückgaben :

PolyCollection

A PolyCollectionmit den gezeichneten Polygonen.

Andere Parameter :

data indexierbares Objekt, optional

Falls angegeben, akzeptieren die folgenden Parameter auch einen String s, der interpretiert wird als data[s](es sei denn, dies löst eine Ausnahme aus):

x , y1 , y2 , wobei

**Kwarg

Alle anderen Schlüsselwortargumente werden an übergeben PolyCollection. Sie steuern die PolygonEigenschaften:

Eigentum	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert akzeptiert und ein (m, n, 3)-Array und zwei Offsets von der unteren linken Ecke des Bildes zurückgibt
alpha	Array-ähnlich oder Skalar oder None
animated	bool
antialiasedoder aa oder Antialiasing	bool oder Liste von bools
array	Array-ähnlich oder None
capstyle	CapStyleoder {'hinter', 'vorstehend', 'rund'}
clim	(vmin: Float, vmax: Float)
clip_box	Bbox
clip_on	bool
clip_path	Patch oder (Pfad, Transform) oder None
cmap	Colormapoder str oder Keine
color	Farbe oder Liste von RGBA-Tupeln
edgecoloroder ec oder edgecolors	Farbe oder Liste von Farben oder 'Gesicht'
facecoloroder facecolors oder fc	Farbe oder Farbliste
figure	Figure
gid	Str
hatch	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
in_layout	bool
joinstyle	JoinStyleoder {'Gehrung', 'rund', 'Fase'}
label	Objekt
linestyleoder Bindestriche oder Linienstile oder ls	str oder Tupel oder Liste davon
linewidthoder Linienbreiten oder lw	Float oder Liste von Floats
mouseover	bool
norm	Normalizeoder str oder Keine
offset_transformoder transOffset	Unbekannt
offsets	(N, 2) oder (2,) Array-artig
path_effects	AbstractPathEffect
paths	Liste von Array-ähnlichen
picker	None oder bool oder float oder aufrufbar
pickradius	Unbekannt
rasterized	bool
sizes	ndarray oder None
sketch_params	(Maßstab: Float, Länge: Float, Zufälligkeit: Float)
snap	bool oder Keine
transform	Transform
url	Str
urls	Liste von str oder None
verts	Liste von Array-ähnlichen
verts_and_codes	Unbekannt
visible	bool
zorder	schweben

Siehe auch

fill_between

Füllen Sie zwischen zwei Sätzen von y-Werten.

fill_betweenx

Füllen Sie zwischen zwei Sätzen von x-Werten.