matplotlib.pyplot.tricontour

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

Zeichnen Sie Höhenlinien auf einem unstrukturierten Dreiecksgitter.

Rufsignaturen:

tricontour(triangulation, Z, [levels], ...)
tricontour(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.tricontour(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, also der Höhenlinien.

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 tricontourEinfä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).

Linienbreiten schwebend oder Array-artig, Standard: rcParams["contour.linewidth"](Standard: None)

Die Linienbreite der Konturlinien.

Wenn es sich um eine Zahl handelt, werden alle Ebenen mit dieser Linienbreite gezeichnet.

Bei einer Sequenz werden die Ebenen in aufsteigender Reihenfolge mit den Linienbreiten in der angegebenen Reihenfolge gezeichnet.

Wenn None, fällt dies auf rcParams["lines.linewidth"](Standard: 1.5) zurück.

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

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

linestyles kann auch ein Iterable der obigen Strings sein, der eine Reihe von zu verwendenden Linienstilen angibt. Wenn dieses Iterable kürzer als die Anzahl der Konturebenen ist, wird es nach Bedarf wiederholt.