matplotlib.pyplot.pcolor

matplotlib.pyplot.pcolor(*args, shading=None, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, colorizer=None, data=None, **kwargs)

Erstellt einen Pseudofarben-Plot mit einem nicht-regulären rechteckigen Gitter.

Aufruf-Signatur

pcolor([X, Y,] C, /, **kwargs)

X und Y können verwendet werden, um die Ecken der Vierecke festzulegen.

Die Argumente X, Y, C sind nur positionsabhängig.

Hinweis

pcolor() kann bei großen Arrays sehr langsam sein. In den meisten Fällen sollten Sie stattdessen das ähnliche, aber viel schnellere pcolormesh verwenden. Siehe Unterschiede zwischen pcolor() und pcolormesh() für eine Diskussion der Unterschiede.

Parameter:

C2D-Array-ähnlich

Die farbcodierten Werte. Die Farbcodierung wird durch cmap, norm, vmin und vmax gesteuert.

X, Yarray-ähnlich, optional

Die Koordinaten der Ecken von Vierecken eines pcolormesh

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      ●╶───╴●
                      │     │
                      ●╶───╴●
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

Beachten Sie, dass der Spaltenindex der x-Koordinate und der Zeilenindex der y-Koordinate entspricht. Details finden Sie im Abschnitt Hinweise unten.

Wenn shading='flat', sollten die Dimensionen von X und Y um eins größer sein als die von C, und das Viereck wird aufgrund des Werts bei C[i, j] gefärbt. Wenn X, Y und C gleiche Dimensionen haben, wird eine Warnung ausgegeben und die letzte Zeile und Spalte von C werden ignoriert.

Wenn shading='nearest' ist, sollten die Dimensionen von X und Y die gleichen sein wie die von C (andernfalls wird ein ValueError ausgelöst). Die Farbe C[i, j] wird auf (X[i, j], Y[i, j]) zentriert.

Wenn X und/oder Y 1D-Arrays oder Spaltenvektoren sind, werden sie nach Bedarf zu den entsprechenden 2D-Arrays erweitert und bilden ein rechteckiges Gitter.

shading{'flat', 'nearest', 'auto'}, Standard: rcParams["pcolor.shading"] (Standard: 'auto')

Der Füllstil für das Viereck. Mögliche Werte

• 'flat': Für jedes Viereck wird eine einheitliche Farbe verwendet. Die Farbe des Vierecks (i, j), (i+1, j), (i, j+1), (i+1, j+1) wird durch C[i, j] bestimmt. Die Dimensionen von X und Y sollten um eins größer sein als die von C; wenn sie die gleichen wie C sind, wird eine Deprecation-Warnung ausgegeben und die letzte Zeile und Spalte von C werden verworfen.

• 'nearest': Jeder Gitterpunkt erhält eine Farbe, die auf ihn zentriert ist und sich bis zur Hälfte zwischen den angrenzenden Gittermittelpunkten erstreckt. Die Dimensionen von X und Y müssen mit denen von C übereinstimmen.

• 'auto': Wählt 'flat', wenn die Dimensionen von X und Y um eins größer sind als die von C. Wählt 'nearest', wenn die Dimensionen gleich sind.

Siehe pcolormesh-Gitter und Schattierung für weitere Beschreibungen.

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.

edgecolors{'none', None, 'face', Farbe, Farbsequenz}, optional

Die Farbe der Kanten. Standard ist 'none'. Mögliche Werte

• 'none' oder '': Keine Kante.

• None: Es wird rcParams["patch.edgecolor"] (Standard: 'black') verwendet. Beachten Sie, dass rcParams["patch.force_edgecolor"] (Standard: False) derzeit auf True gesetzt sein muss, damit dies funktioniert.

• 'face': Verwendet die Farbe der benachbarten Fläche.

• Eine einzelne Farbe oder eine Sequenz von Farben setzt die Kantenfarbe.

Die Singularform edgecolor funktioniert als Alias.

alphafloat, Standard: None

Der Alpha-Blending-Wert der Flächenfarbe, zwischen 0 (transparent) und 1 (opak). Hinweis: Die Kantenfarbe wird davon derzeit nicht beeinflusst.

snapbool, Standard: False

Ob das Mesh auf Pixelgrenzen ausgerichtet werden soll.

Gibt zurück:

matplotlib.collections.PolyQuadMesh

Andere Parameter:

antialiasedsbool, Standard: False

Der Standardwert für antialiaseds ist False, wenn der Standardwert für edgecolors="none" verwendet wird. Dies eliminiert künstliche Linien an Patch-Grenzen und funktioniert unabhängig vom Wert von alpha. Wenn edgecolors nicht "none" ist, wird der Standardwert für antialiaseds von rcParams["patch.antialiased"] (Standard: True) übernommen. Das Strichzeichnen der Kanten kann bevorzugt werden, wenn alpha 1 ist, verursacht aber sonst Artefakte.

dataindizierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch eine Zeichenkette s, die als data[s] interpretiert wird, wenn s ein Schlüssel in data ist.

**kwargs

Zusätzlich sind folgende Argumente zulässig. Sie werden an den Konstruktor von PolyQuadMesh übergeben.

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	liste von array-like
picker	None oder bool oder float oder callable
pickradius	float
rasterized	bool
sizes	numpy.ndarray oder None
sketch_params	(scale: float, length: float, randomness: float)
snap	bool oder None
transform	Transform
url	str
urls	Liste von str oder None
verts	liste von array-like
verts_and_codes	unknown
visible	bool
zorder	float

Siehe auch

pcolormesh

für eine Erklärung der Unterschiede zwischen pcolor und pcolormesh.

imshow

Wenn X und Y jeweils äquidistant sind, kann imshow eine schnellere Alternative sein.

Anmerkungen

Hinweis

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

Maskierte Arrays

X, Y und C können Masked Arrays sein. Wenn entweder C[i, j] oder eine der Vertices, die C[i, j] umgeben (X oder Y an [i, j], [i+1, j], [i, j+1], [i+1, j+1]) maskiert ist, wird nichts gezeichnet.

Gitterorientierung

Die Gitterorientierung folgt der Standard-Matrixkonvention: Ein Array C mit der Form (Anzahl Zeilen, Anzahl Spalten) wird mit der Spaltennummer als X und der Zeilennummer als Y geplottet.

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

pcolor-Bilder

pcolor-Bilder

Ansichtsgrenzen mit Rändern und sticky_edges steuern

Ansichtsgrenzen mit Rändern und sticky_edges steuern