matplotlib.pyplot.tricontourf

matplotlib.pyplot. tricontourf ( * args , ** kwargs )

Zeichnen Sie Konturbereiche auf einem unstrukturierten Dreiecksgitter.

Rufsignaturen:

tricontourf(triangulation, Z, [levels], ...)
tricontourf(x, y, Z, [levels], *, [triangles=triangles], [mask=mask], ...)

Das Dreiecksgitter kann entweder durch Übergabe eines Triangulation Objekts als ersten Parameter oder durch Übergabe der Punkte x , y und optional der Dreiecke und einer Maske spezifiziert werden . Siehe Triangulationfür eine Erläuterung dieser Parameter. Wenn weder Triangulation noch Dreiecke angegeben sind, wird die Triangulation on-the-fly berechnet.

Es ist möglich, Dreiecke positionsbezogen zu übergeben, dh . Davon wird jedoch abgeraten. Für mehr Klarheit übergeben Sie Dreiecke über das Schlüsselwortargument.tricontourf(x, y, triangles, Z, ...)

Parameter :

Triangulation Triangulation, optional

Ein bereits erstelltes Dreiecksgitter.

x, y, Dreiecke, Maske

Parameter, die das Dreiecksgitter definieren. Siehe Triangulation. Dies schließt sich gegenseitig mit der Angabe von Triangulation aus .

Z -Array-ähnlich

Die Höhenwerte, über die die Kontur gezeichnet wird. Die Farbzuordnung wird durch cmap , norm , vmin und vmax gesteuert .

Ebenen int oder arrayartig, optional

Bestimmt die Anzahl und Positionen der Konturlinien / Regionen.

Wenn ein int n , verwenden MaxNLocatorSie , wodurch versucht wird, automatisch nicht mehr als n+1 "schöne" Konturebenen zwischen vmin und vmax auszuwählen .

Wenn es sich um ein Array handelt, zeichnen Sie Konturlinien auf den angegebenen Ebenen. Die Werte müssen in aufsteigender Reihenfolge sein.

Rückgaben :

TriContourSet

Andere Parameter :

Farben Farbzeichenfolge oder Farbfolge, optional

Die Farben der Ebenen, dh der Konturbereiche.

Die Sequenz wird für die Ebenen in aufsteigender Reihenfolge durchlaufen. Wenn die Sequenz kürzer als die Anzahl der Ebenen ist, wird sie wiederholt.

Als Abkürzung können anstelle von Ein-Element-Listen einfarbige Zeichenketten verwendet werden, dh 'red'anstatt ['red']alle Ebenen mit der gleichen Farbe einzufärben. Diese Abkürzung funktioniert nur für Farbstrings, nicht für andere Möglichkeiten, Farben anzugeben.

Standardmäßig (Wert None ) wird die durch cmap angegebene Farbtabelle verwendet.

Alphafloat , Standard: 1

Der Alpha-Blending-Wert zwischen 0 (transparent) und 1 (deckend).

cmap str oder Colormap, Standard: rcParams["image.cmap"](Standard: 'viridis')

Die Colormap-Instanz oder der registrierte Colormap-Name, der zum Zuordnen von Skalardaten zu Farben verwendet wird.

Dieser Parameter wird ignoriert, wenn Farben gesetzt sind.

norm str oder Normalize, optional

Die Normalisierungsmethode, die verwendet wird, um skalare Daten auf den Bereich [0, 1] zu skalieren, bevor sie mithilfe von cmap auf Farben abgebildet werden . Standardmäßig wird eine lineare Skalierung verwendet, die den niedrigsten Wert auf 0 und den höchsten auf 1 abbildet.

Falls angegeben, kann dies einer der folgenden sein:

• Eine Instanz Normalizeoder eine ihrer Unterklassen (siehe Colormap-Normalisierung ).

• Ein Skalenname, z. B. „linear“, „log“, „symlog“, „logit“ usw. Rufen Sie für eine Liste der verfügbaren Skalen auf matplotlib.scale.get_scale_names(). In diesem Fall wird eine geeignete NormalizeUnterklasse dynamisch generiert und instanziiert.

Dieser Parameter wird ignoriert, wenn Farben gesetzt sind.

vmin, vmax Float, optional

Wenn skalare Daten und keine explizite Norm verwendet werden, definieren vmin und vmax den Datenbereich, den die Farbtabelle abdeckt. Standardmäßig deckt die Colormap den kompletten Wertebereich der gelieferten Daten ab. Es ist ein Fehler, vmin / vmax zu verwenden, wenn eine Norminstanz angegeben ist (aber die Verwendung eines Normnamens zusammen mit vmin / vmax ist akzeptabel).str

Wenn vmin oder vmax nicht angegeben sind, basiert die Standardfarbskalierung auf Ebenen .

Dieser Parameter wird ignoriert, wenn Farben gesetzt sind.

Herkunft { Keine , 'upper', 'lower', 'image'}, Standard: Keine

Bestimmt die Ausrichtung und genaue Position von Z durch Angabe der Position von . Dies ist nur relevant, wenn X , Y nicht angegeben sind.Z[0, 0]

• None : befindet sich bei X=0, Y=0 in der unteren linken Ecke.Z[0, 0]

• 'lower': ist bei X=0.5, Y=0.5 in der unteren linken Ecke.Z[0, 0]

• 'upper': ist bei X=N+0.5, Y=0.5 in der oberen linken Ecke.Z[0, 0]

• 'image': Verwenden Sie den Wert von rcParams["image.origin"](Standard: 'upper').

Ausdehnung (x0, x1, y0, y1), optional

Wenn Ursprung nicht None ist, wird Ausdehnung wie in interpretiert imshow: Es gibt die äußeren Pixelgrenzen an. In diesem Fall ist die Position von Z[0, 0] die Mitte des Pixels, keine Ecke. Wenn der Ursprung None ist , dann ist ( x0 , y0 ) die Position von Z[0, 0] und ( x1 , y1 ) die Position von Z[-1, -1].

Dieses Argument wird ignoriert, wenn X und Y im Aufruf von Contour angegeben werden.

Locator -Ticker.Locator-Unterklasse, optional

Der Locator dient zur Ermittlung der Höhenlinien, sofern diese nicht explizit über Ebenen vorgegeben sind . Standardmäßig auf MaxNLocator.

Erweitern {'weder', 'beide', 'min', 'max'}, Standard: 'weder'

Bestimmt die tricontourfEinfärbung von Werten, die außerhalb des Pegelbereichs liegen .

Bei „weder noch“ werden Werte außerhalb des Ebenenbereichs nicht eingefärbt. Wenn „min“, „max“ oder „beide“, färben Sie die Werte unter, über oder unter und über dem Pegelbereich ein.

Werte darunter min(levels)und darüber max(levels)werden den Unter-/Über-Werten von zugeordnet Colormap. Beachten Sie, dass die meisten Colormaps standardmäßig keine dedizierten Farben dafür haben, sodass die Über- und Unterwerte die Randwerte der Colormap sind. Möglicherweise möchten Sie diese Werte explizit mit Colormap.set_underund festlegen Colormap.set_over.

Notiz

Eine vorhandene TriContourSetwird nicht benachrichtigt, wenn Eigenschaften ihrer Farbtabelle geändert werden. Daher ist nach dem Ändern der Colormap ein expliziter Aufruf ContourSet.changed()erforderlich. Der explizite Aufruf kann weggelassen werden, wenn dem ein Farbbalken zugeordnet ist, TriContourSetda dieser intern aufruft ContourSet.changed().

xunits, yunits registrierte Einheiten, optional

Überschreiben Sie Achseneinheiten, indem Sie eine Instanz von a angeben matplotlib.units.ConversionInterface.

Antialiased bool, optional

Aktivieren Sie Antialiasing und überschreiben Sie die Standardeinstellungen. Für gefüllte Konturen ist der Standardwert True . Für Linienkonturen wird es übernommen rcParams["lines.antialiased"](Standard: True).

Schraffurliste [str], optional

Eine Liste von Kreuzschraffurmustern, die auf den gefüllten Bereichen verwendet werden sollen. Bei None wird der Kontur keine Schraffur hinzugefügt. Schraffur wird nur in den Backends PostScript, PDF, SVG und Agg unterstützt.

Anmerkungen

tricontourffüllt oben geschlossene Intervalle; Das heißt, für die Grenzen z1 und z2 ist die gefüllte Region:

z1 < Z <= z2

mit Ausnahme des niedrigsten Intervalls, das auf beiden Seiten geschlossen ist (dh es enthält den niedrigsten Wert).