matplotlib.pyplot.tricontourf

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

Zeichnet Konturbereiche auf einem unstrukturierten Dreiecksgitter.

Aufrufsignaturen

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

Das Dreiecksnetz kann entweder durch Übergabe eines Triangulation-Objekts als erster Parameter oder durch Übergabe der Punkte x, y und optional der Dreiecke und einer Maske angegeben werden. Siehe Triangulation für eine Erklärung dieser Parameter. Wenn weder triangulation noch triangles angegeben sind, wird die Dreieckszerlegung "on the fly" berechnet.

Es ist möglich, *triangles* positional zu übergeben, d. h. tricontourf(x, y, triangles, z, ...). Dies wird jedoch nicht empfohlen. Zur besseren Übersichtlichkeit übergeben Sie *triangles* über das Schlüsselwortargument.

Parameter:

triangulationTriangulation, optional

Ein bereits erstelltes dreieckiges Gitter.

x, y, triangles, mask

Parameter, die das dreieckige Gitter definieren. Siehe Triangulation. Dies ist gegenseitig ausschließend mit der Angabe von triangulation.

zarray-ähnlich

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

Hinweis

Alle Werte in z müssen endlich sein. Daher müssen nan- und inf-Werte entweder entfernt oder mit set_mask gesetzt werden.

levelsint oder array-ähnlich, optional

Bestimmt die Anzahl und Positionen der Konturlinien / Regionen.

Wenn n eine Ganzzahl ist, wird MaxNLocator verwendet, der versucht, automatisch nicht mehr als n+1 "schöne" Konturebenen zwischen dem minimalen und maximalen numerischen Wert von Z auszuwählen.

Wenn array-ähnlich, werden Konturlinien auf den angegebenen Ebenen gezeichnet. Die Werte müssen aufsteigend geordnet sein.

Gibt zurück:

TriContourSet

Andere Parameter:

colorsFarbe oder Liste von Farben, optional

Die Farben der Niveaus, d. h. 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 einzelne Farb-Strings anstelle von ein-elementigen Listen verwendet werden, d.h. 'red' anstelle von ['red'], um alle Ebenen mit der gleichen Farbe zu versehen. Diese Abkürzung funktioniert nur für Farb-Strings, nicht für andere Arten der Farbangabe.

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

alphafloat, Standard: 1

Der Alpha-Mischwert, zwischen 0 (transparent) und 1 (opak).

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

Die Colormap-Instanz oder der registrierte Colormap-Name, der verwendet wird, um Skalardaten in Farben abzubilden.

Dieser Parameter wird ignoriert, wenn colors gesetzt ist.

normstr oder Normalize, optional

Die Normalisierungsmethode, die verwendet wird, um Skalardaten vor der Abbildung auf Farben mithilfe von cmap in den Bereich [0, 1] zu skalieren. Standardmäßig wird eine lineare Skalierung verwendet, die den niedrigsten Wert auf 0 und den höchsten auf 1 abbildet.

Wenn angegeben, kann dies eine der folgenden Optionen sein

• Eine Instanz von Normalize oder eine ihrer Unterklassen (siehe Farbkartennormalisierung).

• Ein Skalennamen, d. h. einer von "linear", "log", "symlog", "logit" usw. Für eine Liste der verfügbaren Skalen rufen Sie matplotlib.scale.get_scale_names() auf. In diesem Fall wird eine geeignete Normalize-Unterklasse dynamisch generiert und instanziiert.

Dieser Parameter wird ignoriert, wenn colors gesetzt ist.

vmin, vmaxfloat, optional

Wenn Skalardaten und keine explizite norm verwendet werden, definieren vmin und vmax den Datenbereich, den die Farbkarte abdeckt. Standardmäßig deckt die Farbkarte den gesamten Wertebereich der bereitgestellten Daten ab. Es ist ein Fehler, vmin/vmax zu verwenden, wenn eine norm-Instanz angegeben ist (aber die Verwendung eines str-norm-Namens zusammen mit vmin/vmax ist akzeptabel).

Wenn vmin oder vmax nicht angegeben werden, basiert die Standard-Farbskalierung auf levels.

Dieser Parameter wird ignoriert, wenn colors gesetzt ist.

origin{None, 'upper', 'lower', 'image'}, Standard: None

Bestimmt die Ausrichtung und genaue Position von z, indem die Position von z[0, 0] angegeben wird. Dies ist nur relevant, wenn X, Y nicht gegeben sind.

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

• 'lower': z[0, 0] befindet sich bei X=0.5, Y=0.5 in der unteren linken Ecke.

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

• 'image': Verwendet den Wert aus rcParams["image.origin"] (Standard: 'upper').

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

Wenn *origin* nicht *None* ist, dann wird *extent* wie in imshow interpretiert: es gibt die äußeren Pixelgrenzen an. In diesem Fall ist die Position von z[0, 0] die Mitte des Pixels, nicht eine Ecke. Wenn *origin* *None* ist, dann ist (x0, y0) die Position von z[0, 0] und (x1, y1) ist die Position von z[-1, -1].

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

locatorticker.Locator subclass, optional

Der Locator wird verwendet, um die Konturebenen zu bestimmen, wenn sie nicht explizit über levels angegeben werden. Standardmäßig wird MaxNLocator verwendet.

extend{'neither', 'both', 'min', 'max'}, Standard: 'neither'

Bestimmt die tricontourf-Färbung von Werten, die außerhalb des *levels*-Bereichs liegen.

Wenn 'neither', werden Werte außerhalb des levels-Bereichs nicht gefärbt. Wenn 'min', 'max' oder 'both', werden Werte unter, über bzw. unter und über dem levels-Bereich gefärbt.

Werte unterhalb von min(levels) und oberhalb von max(levels) werden auf die Unter-/Oberwerte der Colormap abgebildet. Beachten Sie, dass die meisten Colormaps standardmäßig keine dedizierten Farben für diese haben, so dass die Ober- und Unterwerte die Randwerte der Colormap sind. Möglicherweise möchten Sie diese Werte explizit mit Colormap.set_under und Colormap.set_over festlegen.

Hinweis

Ein bestehendes TriContourSet wird nicht benachrichtigt, wenn sich die Eigenschaften seiner Colormap ändern. Daher ist ein expliziter Aufruf von ContourSet.changed() erforderlich, nachdem die Colormap geändert wurde. Der explizite Aufruf kann weggelassen werden, wenn der TriContourSet ein Colorbar zugewiesen ist, da dieser intern ContourSet.changed() aufruft.

xunits, yunitsregistrierte Einheiten, optional

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

antialiasedbool, optional

Aktiviert Antialiasing und überschreibt die Standardwerte. Für gefüllte Konturen ist der Standardwert True. Für Linienkonturen wird er von rcParams["lines.antialiased"] (Standard: True) übernommen.

hatcheslist[str], optional

Eine Liste von Schraffierungsmustern, die auf den gefüllten Flächen verwendet werden sollen. Wenn None, wird keine Schraffierung zu den Konturen hinzugefügt.

Anmerkungen

Hinweis

Dies ist der pyplot-Wrapper für axes.Axes.tricontourf.

tricontourf füllt Intervalle, die oben geschlossen sind; das heißt, für Grenzen z1 und z2 ist der gefüllte Bereich

z1 < Z <= z2

mit Ausnahme des untersten Intervalls, das beidseitig geschlossen ist (d. h. es enthält den niedrigsten Wert).

Beispiele für die Verwendung von matplotlib.pyplot.tricontourf

Konturplot von unregelmäßig verteilten Daten

Konturplot von unregelmäßig verteilten Daten

Tricontour Demo

Tricontour Demo

Tricontour Smooth Delaunay

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

Triinterp Demo

Triinterp Demo