matplotlib.axes.Axes.tricontourf

Axes.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. Für mehr Klarheit übergeben Sie triangles über ein 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) 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-Einfä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-/Überwerte der Colormap abgebildet. 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_under und Colormap.set_over festlegen.

Hinweis

Eine vorhandene TriContourSet wird nicht benachrichtigt, wenn sich Eigenschaften ihrer 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 eine Colorbar zugewiesen ist, da diese 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 Bereichen verwendet werden sollen. Wenn None, wird keine Schraffierung zum Kontur hinzugefügt.

Anmerkungen

tricontourf füllt Intervalle, die an der Oberseite geschlossen sind; das heißt, für die 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.axes.Axes.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

Dreieckiges 3D-Konturdiagramm mit Füllung

Dreieckiges 3D-Konturdiagramm mit Füllung

tricontourf(x, y, z)

tricontourf(x, y, z)