matplotlib.pyplot.tripcolor

matplotlib.pyplot.tripcolor(*args, alpha=1.0, norm=None, cmap=None, vmin=None, vmax=None, shading='flat', facecolors=None, **kwargs)

Erstellt einen Pseudofarben-Plot eines unstrukturierten Dreiecksgitters.

Aufrufsignaturen

tripcolor(triangulation, c, *, ...)
tripcolor(x, y, c, *, [triangles=triangles], [mask=mask], ...)

Das Dreiecksgitter kann entweder durch Übergabe eines Triangulation-Objekts als erstem Parameter oder durch Übergabe der Punkte x, y und optional der triangles und einer mask spezifiziert werden. Siehe Triangulation für eine Erklärung dieser Parameter.

Es ist möglich, die Dreiecke positionsweise zu übergeben, d.h. tripcolor(x, y, triangles, c, ...). Dies wird jedoch nicht empfohlen. Für mehr Klarheit übergeben Sie triangles über das Schlüsselwortargument.

Wenn weder triangulation noch triangles angegeben sind, wird die Triangulation dynamisch berechnet. In diesem Fall macht es keinen Sinn, Farben an den Dreiecksflächen über c oder facecolors anzugeben, da es mehrere mögliche Triangulationen für eine Gruppe von Punkten gibt und Sie nicht wissen, welche Dreiecke konstruiert werden.

Parameter:

triangulationTriangulation

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.

carray-like

Die Farbwerte, entweder für die Punkte oder für die Dreiecke. Welches davon automatisch aus der Länge von c abgeleitet wird, d.h. ob es der Anzahl der Punkte oder der Anzahl der Dreiecke entspricht. Wenn die Anzahl der Punkte und Dreiecke in der Triangulation gleich ist, wird angenommen, dass die Farbwerte an den Punkten definiert sind; um die Verwendung von Farbwerte an den Dreiecken zu erzwingen, verwenden Sie stattdessen das Schlüsselwortargument facecolors=c anstelle von nur c. Dieser Parameter ist positionsgebunden.

facecolorsarray-like, optional

Kann alternativ zu c verwendet werden, um Farben an den Dreiecksflächen anzugeben. Dieser Parameter hat Vorrang vor c.

shading{'flat', 'gouraud'}, default: 'flat'

Wenn 'flat' und die Farbwerte c an den Punkten definiert sind, sind die für jedes Dreieck verwendeten Farbwerte der Mittelwert von c der drei Punkte des Dreiecks. Wenn shading 'gouraud' ist, müssen die Farbwerte an den Punkten definiert sein.

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.

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.

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

colorizerColorizer oder None, Standard: None

Das Colorizer-Objekt, das verwendet wird, um Farbe auf Daten abzubilden. Wenn None, wird ein Colorizer-Objekt aus norm und cmap erstellt.

Gibt zurück:

PolyCollection oder TriMesh

Das Ergebnis hängt von shading ab: Für shading='flat' ist das Ergebnis eine PolyCollection, für shading='gouraud' ist das Ergebnis ein TriMesh.

Andere Parameter:

**kwargsCollection-Eigenschaften

Eigenschaft	Beschreibung
agg_filter	eine Filterfunktion, die ein (m, n, 3) Float-Array und einen dpi-Wert entgegennimmt und ein (m, n, 3) Array und zwei Offsets von der linken unteren Ecke des Bildes zurückgibt
alpha	Array-ähnlich oder float oder None
animated	bool
antialiased oder aa oder antialiaseds	bool oder Liste von bools
Array	Array-ähnlich oder None
capstyle	CapStyle oder {'butt', 'projecting', 'round'}
clim	(vmin: float, vmax: float)
clip_box	BboxBase oder None
clip_on	bool
clip_path	Patch oder (Path, Transform) oder None
cmap	Colormap oder str oder None
color	Farbe oder Liste von RGBA-Tupeln
edgecolor oder ec oder edgecolors	Farbe oder Liste von Farben oder 'face'
facecolor oder facecolors oder fc	Farbe oder Liste von Farben
figure	Figure oder SubFigure
gid	str
Muster (hatch)	{'/', '\', '|', '-', '+', 'x', 'o', 'O', '.', '*'}
hatch_linewidth	unknown
in_layout	bool
joinstyle	JoinStyle oder {'miter', 'round', 'bevel'}
label	object
linestyle oder dashes oder linestyles oder ls	str oder Tupel oder Liste davon
linewidth oder linewidths oder lw	float oder Liste von floats
mouseover	bool
norm	Normalize oder str oder None
offset_transform oder transOffset	Transform
offsets	(N, 2) oder (2,) Array-ähnlich
path_effects	Liste von AbstractPathEffect
paths	unknown
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
visible	bool
zorder	float

Anmerkungen

Hinweis

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

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

Tripcolor Demo

Tripcolor Demo