matplotlib.pyplot.figimage

matplotlib.pyplot.figimage(X, xo=0, yo=0, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, origin=None, resize=False, *, colorizer=None, **kwargs)

Fügt ein nicht-resampeltes Bild zur Abbildung hinzu.

Das Bild wird je nach origin an der unteren oder oberen linken Ecke angebracht.

Parameter:

X

Die Bilddaten. Dies ist ein Array mit einer der folgenden Formen

• (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.

xo, yoint

Der x/y Bild-Offset in Pixel.

alphaNone oder float

Der Alpha-Mischwert.

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 X 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

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

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

origin{'upper', 'lower'}, Standard: rcParams["image.origin"] (Standard: 'upper')

Gibt an, wo sich der Index [0, 0] des Arrays in der oberen linken oder unteren linken Ecke der Achsen befindet.

resizebool

Wenn True, wird die Figur so angepasst, dass sie die angegebene Bildgröße hat.

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

Gibt zurück:

matplotlib.image.FigureImage

Andere Parameter:

**kwargs

Zusätzliche kwargs sind Artist kwargs, die an FigureImage weitergegeben werden.

Anmerkungen

Hinweis

Dies ist der pyplot-Wrapper für Figure.figimage.

figimage ergänzt das Achsenbild (imshow), das auf die aktuelle Achse skaliert wird. Wenn Sie ein skaliertes Bild wünschen, das die gesamte Figur ausfüllt, können Sie eine Achse mit dem Ausschnitt [0, 0, 1, 1] definieren.

Beispiele

f = plt.figure()
nx = int(f.get_figwidth() * f.dpi)
ny = int(f.get_figheight() * f.dpi)
data = np.random.random((ny, nx))
f.figimage(data)
plt.show()

Beispiele mit matplotlib.pyplot.figimage

Figimage Demo

Figimage Demo