matplotlib.axes.Axes.pcolorfast#

Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, colorizer=None, data=None, **kwargs)[Quelle]#

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

Aufruf-Signatur

ax.pcolorfast([X, Y], C, /, **kwargs)

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

Diese Methode ist ähnlich zu pcolor und pcolormesh. Sie ist darauf ausgelegt, die schnellste Pcolor-artige Darstellung mit dem Agg-Backend bereitzustellen. Um dies zu erreichen, verwendet sie je nach Komplexität des Eingabegitters (regelmäßig rechteckig, nicht-regelmäßig rechteckig oder beliebig viereckig) unterschiedliche interne Algorithmen.

Warnung

Diese Methode ist experimentell. Im Vergleich zu pcolor oder pcolormesh hat sie einige Einschränkungen

  • Sie unterstützt nur flache Schattierung (keine Umrandungen)

  • Ihr fehlt die Unterstützung für logarithmische Skalierung der Achsen.

  • Sie hat keinen Pyplot-Wrapper.

Parameter:
Carray-artig

Die Bilddaten. Unterstützte Array-Formen sind

  • (M, N): ein Bild mit Skalardaten. Die Farbdarstellung wird durch cmap, norm, vmin und vmax gesteuert.

  • (M, N, 3): Ein Bild mit RGB-Werten (0-1 Float oder 0-255 Integer).

  • (M, N, 4): Ein Bild mit RGBA-Werten (0-1 Float oder 0-255 Integer), d.h. einschließlich Transparenz.

Die ersten beiden Dimensionen (M, N) definieren die Zeilen und Spalten des Bildes.

Dieser Parameter kann nur positionsweise übergeben werden.

X, YTupel oder array-artig, Standard: (0, N), (0, M)

X und Y werden verwendet, um die Koordinaten der Vierecke anzugeben. Es gibt verschiedene Möglichkeiten, dies zu tun

  • Verwenden Sie Tupel X=(xmin, xmax) und Y=(ymin, ymax), um ein gleichmäßiges rechteckiges Gitter zu definieren.

    Die Tupel definieren die äußeren Ränder des Gitters. Alle einzelnen Vierecke haben die gleiche Größe. Dies ist die schnellste Variante.

  • Verwenden Sie 1D-Arrays X, Y, um ein ungleichmäßiges rechteckiges Gitter anzugeben.

    In diesem Fall müssen X und Y monotone 1D-Arrays der Länge N+1 bzw. M+1 sein, die die x- und y-Grenzen der Zellen angeben.

    Die Geschwindigkeit ist intermediär. Hinweis: Das Gitter wird geprüft, und wenn es als gleichmäßig befunden wird, wird die schnelle Variante verwendet.

  • Verwenden Sie 2D-Arrays X, Y, wenn Sie ein beliebiges viereckiges Gitter benötigen (d.h. wenn die Vierecke nicht rechteckig sind).

    In diesem Fall sind X und Y 2D-Arrays mit der Form (M + 1, N + 1), die die x- und y-Koordinaten der Ecken der farbigen Vierecke angeben.

    Dies ist die allgemeinste, aber langsamste Darstellung. Sie kann jedoch mit den ps-, pdf- und svg-Backends schnellere und kompaktere Ausgaben erzeugen.

Diese Argumente können nur positionsweise übergeben werden.

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 C RGB(A) 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

Dieser Parameter wird ignoriert, wenn C RGB(A) 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).

Dieser Parameter wird ignoriert, wenn C RGB(A) ist.

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.

Dieser Parameter wird ignoriert, wenn C RGB(A) ist.

alphafloat, Standard: None

Der Alpha-Mischwert, zwischen 0 (transparent) und 1 (opak).

snapbool, Standard: False

Ob das Mesh auf Pixelgrenzen ausgerichtet werden soll.

Gibt zurück:
AxesImage oder PcolorImage oder QuadMesh

Der Rückgabetyp hängt vom Gittertyp ab

  • AxesImage für ein gleichmäßiges rechteckiges Gitter.

  • PcolorImage für ein ungleichmäßiges rechteckiges Gitter.

  • QuadMesh für ein nicht-rechteckiges Gitter.

Andere Parameter:
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

Unterstützte zusätzliche Parameter hängen vom Gittertyp ab. Weitere Beschreibungen finden Sie unter den Rückgabetypen von image.

Beispiele für die Verwendung von matplotlib.axes.Axes.pcolorfast#

pcolor-Bilder

pcolor-Bilder
Auf dieser Seite