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 , ** kwargs )

Fügen Sie der Abbildung ein nicht neu berechnetes Bild hinzu.

Das Bild wird je nach Herkunft an der unteren oder oberen linken Ecke angehängt .

Parameter :

X

Die Bilddaten. Dies ist ein Array aus einer der folgenden Formen:

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

xo, yo int

Der x / y -Bildversatz in Pixel.

alpha Keine oder Float

Der Alpha-Blending-Wert.

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

Herkunft {'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.

Größe ändern bool

Wenn True , wird die Größe der Figur an die angegebene Bildgröße angepasst.

Rückgaben :

matplotlib.image.FigureImage

Andere Parameter :

**Kwarg

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

Anmerkungen

figimage ergänzt das Axes-Bild ( imshow), das neu gesampelt wird, um zu den aktuellen Axes zu passen. Wenn Sie möchten, dass ein neu berechnetes Bild die gesamte Figur ausfüllt, können Sie ein Axesmit Ausdehnung [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()