matplotlib.pyplot.tricontour

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

Zeichnet Konturlinien auf einem unstrukturierten Dreiecksgitter.

Aufrufsignaturen

tricontour(triangulation, z, [levels], ...)
tricontour(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. tricontour(x, y, triangles, z, ...). Dies wird jedoch nicht empfohlen. Zur besseren Lesbarkeit ü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 Konturlinien.

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 tricontour-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-/Über-Werte der Colormap abgebildet. Beachten Sie, dass die meisten Colormaps standardmäßig keine dedizierten Farben für diese haben, sodass die Unter- und Über-Werte die Randwerte der Colormap sind. Möglicherweise möchten Sie diese Werte explizit mit Colormap.set_under und Colormap.set_over festlegen.

Hinweis

Ein bestehender TriContourSet wird nicht benachrichtigt, wenn sich 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 dem TriContourSet eine Farbleiste zugewiesen wird, 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.

linewidthsfloat oder array-ähnlich, Standard: rcParams["contour.linewidth"] (Standard: None)

Die Linienbreite der Konturlinien.

Wenn es eine Zahl ist, werden alle Ebenen mit dieser Linienbreite gezeichnet.

Wenn es eine Sequenz ist, werden die Ebenen in aufsteigender Reihenfolge mit den Linienbreiten in der angegebenen Reihenfolge gezeichnet.

Wenn None, wird auf rcParams["lines.linewidth"] (Standard: 1.5) zurückgegriffen.

linestyles{None, 'solid', 'dashed', 'dashdot', 'dotted'}, optional

Wenn linestyles None ist, ist der Standardwert 'solid', es sei denn, die Linien sind monochrom. In diesem Fall erhalten negative Konturen ihren Linienstil aus der Einstellung rcParams["contour.negative_linestyle"] (Standard: 'dashed').

linestyles kann auch ein iterierbares Objekt der obigen Zeichenketten sein, das eine Reihe von Linienstilen angibt, die verwendet werden sollen. Wenn dieses iterierbare Objekt kürzer ist als die Anzahl der Konturebenen, wird es nach Bedarf wiederholt.

Anmerkungen

Hinweis

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

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

Konturplot von unregelmäßig verteilten Daten

Konturplot von unregelmäßig verteilten Daten

Tricontour Smooth Delaunay

Tricontour Smooth Delaunay

Tricontour Smooth User

Tricontour Smooth User

Trigradient Demo

Trigradient Demo