matplotlib.axes.Axes.tricontour #
- Achsen. tricontour ( * args , ** kwargs ) [Quelle] #
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
TriangulationObjekts als ersten Parameter oder durch Übergabe der Punkte x , y und optional der Dreiecke und einer Maske spezifiziert werden . SieheTriangulationfü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.
- Triangulation
- Rückgaben :
- 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 geeigneteNormalizeUnterklasse 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).
strWenn 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übermax(levels)werden den Unter-/Über-Werten von zugeordnetColormap. 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 mitColormap.set_underund festlegenColormap.set_over.Notiz
Eine vorhandene
TriContourSetwird nicht benachrichtigt, wenn Eigenschaften ihrer Farbtabelle geändert werden. Daher ist nach dem Ändern der Colormap ein expliziter AufrufContourSet.changed()erforderlich. Der explizite Aufruf kann weggelassen werden, wenn dem ein Farbbalken zugeordnet ist,TriContourSetda dieser intern aufruftContourSet.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.
