matplotlib.axes.Axes.pcolorfast

Achsen. pcolorfast ( * args , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs )

Erstellen Sie ein Pseudofarbendiagramm mit einem unregelmäßigen rechteckigen Gitter.

Rufsignatur:

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

Diese Methode ähnelt pcolorund pcolormesh. Es wurde entwickelt, um mit dem Agg-Backend das schnellste Plotten vom pcolor-Typ bereitzustellen. Um dies zu erreichen, verwendet es je nach Komplexität des Eingabegitters (regelmäßiges Rechteck, nicht regelmäßiges Rechteck oder beliebiges Viereck) intern unterschiedliche Algorithmen.

Warnung

Diese Methode ist experimentell. Im Vergleich zu pcoloroder pcolormeshhat es einige Einschränkungen:

• Es unterstützt nur flache Schattierung (keine Umrisse)

• Es fehlt die Unterstützung für die Log-Skalierung der Achsen.

• Es hat keinen Pyplot-Wrapper.

Parameter :

C -Array-ähnlich

Die Bilddaten. Unterstützte Arrayformen sind:

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

• (M, N, 3): ein Bild mit RGB-Werten (0-1 float oder 0-255 int).

• (M, N, 4): ein Bild mit RGBA-Werten (0-1 Float oder 0-255 Int), dh inklusive Transparenz.

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

Dieser Parameter kann nur positionsbezogen übergeben werden.

X-, Y -Tupel oder Array-ähnlich, Standard: ,(0, N)(0, M)

X und Y werden verwendet, um die Koordinaten der Vierecke anzugeben. Dazu gibt es verschiedene Möglichkeiten:

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

  Die Tupel definieren die Außenkanten des Gitters. Alle einzelnen Vierecke haben die gleiche Größe. Dies ist die schnellste Version.

• 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 und M+1 sein , die die x- und y-Grenzen der Zellen angeben.

  Die Geschwindigkeit ist mittel. Hinweis: Das Raster wird überprüft und bei Gleichmäßigkeit wird die schnelle Version verwendet.

• Verwenden Sie 2D-Arrays X , Y , wenn Sie ein beliebiges vierseitiges Gitter benötigen (dh 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 am langsamsten zu rendernde. Es kann jedoch eine schnellere und kompaktere Ausgabe mit ps-, pdf- und svg-Backends erzeugen.

Diese Argumente können nur positionsbezogen übergeben werden.

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

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

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

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

Alphafloat , Standard: Keine

Der Alpha-Blending-Wert zwischen 0 (transparent) und 1 (deckend).

snap bool, Standard: False

Ob das Netz an Pixelgrenzen ausgerichtet werden soll.

Rückgaben :

AxesImageoder PcolorImageoderQuadMesh

Der Rückgabetyp hängt von der Art des Gitters ab:

• AxesImagefür ein regelmäßiges rechteckiges Gitter.

• PcolorImagefür ein unregelmäßiges rechteckiges Gitter.

• QuadMeshfür ein nicht rechteckiges Gitter.

Andere Parameter :

data indexierbares Objekt, optional

Wenn angegeben, akzeptieren alle Parameter auch einen String s, der als interpretiert wird data[s](es sei denn, dies löst eine Ausnahme aus).

**Kwarg

Unterstützte zusätzliche Parameter hängen von der Art des Gitters ab. Siehe Rückgabetypen von Bildern für eine weitere Beschreibung.

Beispiele mit matplotlib.axes.Axes.pcolorfast

Pcolor-Demo

Pcolor-Demo