matplotlib.pyplot.imsave

matplotlib.pyplot.imsave(fname, arr, **kwargs)

Färbt eine Colormap und speichert ein Array als Bilddatei.

RGB(A)-Bilder werden weitergegeben. Einzelkanalbilder werden entsprechend cmap und norm farbgetreuer abgebildet.

Hinweis

Wenn Sie ein Einzelkanalbild als Graustufenbild speichern möchten, verwenden Sie bitte direkt eine Bild-I/O-Bibliothek (wie z. B. Pillow, tifffile oder imageio).

Parameter:

fnamestr oder pfadähnlich oder dateiähnlich

Ein Pfad oder ein dateiähnliches Objekt zum Speichern des Bildes. Wenn format nicht gesetzt ist, wird das Ausgabeformat aus der Erweiterung von fname abgeleitet, falls vorhanden, und ansonsten aus rcParams["savefig.format"] (Standard: 'png'). Wenn format gesetzt ist, bestimmt es das Ausgabeformat.

arrarray-ähnlich

Die Bilddaten. Akzeptiert NumPy-Arrays oder Sequenzen (z. B. Listen oder Tupel). Die Form kann eine der folgenden sein: MxN (Luminanz), MxNx3 (RGB) oder MxNx4 (RGBA).

vmin, vmaxfloat, optional

vmin und vmax legen die Farbskalierung für das Bild fest, indem sie die Werte fixieren, die den Farbgrenzwerten der Colormap zugeordnet werden. Wenn entweder vmin oder vmax None ist, wird dieser Grenzwert aus dem Min/Max-Wert von arr bestimmt.

cmapstr oder Colormap, Standard: rcParams["image.cmap"] (Standard: 'viridis')

Eine Colormap-Instanz oder ein registrierter Colormap-Name. Die Colormap ordnet Skalardaten Farben zu. Sie wird für RGB(A)-Daten ignoriert.

formatstr, optional

Das Dateiformat, z. B. 'png', 'pdf', 'svg', ... Das Verhalten, wenn dies nicht gesetzt ist, ist unter fname dokumentiert.

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

Gibt an, ob der Index (0, 0) des Arrays in der oberen linken oder unteren linken Ecke der Achsen liegt.

dpifloat

Die DPI, die in den Metadaten der Datei gespeichert werden. Dies hat keinen Einfluss auf die Auflösung des Ausgabebildes. Abhängig vom Dateiformat kann dies auf die nächste ganze Zahl gerundet werden.

metadatadict, optional

Metadaten in der Bilddatei. Die unterstützten Schlüssel hängen vom Ausgabeformat ab. Weitere Informationen finden Sie in der Dokumentation der jeweiligen Backends. Derzeit nur unterstützt für "png", "pdf", "ps", "eps" und "svg".

pil_kwargsdict, optional

Schlüsselwortargumente, die an PIL.Image.Image.save übergeben werden. Wenn der Schlüssel 'pnginfo' vorhanden ist, überschreibt er metadata vollständig, einschließlich des Standardschlüssels 'Software'.

Anmerkungen

Hinweis

Dies ist äquivalent zu matplotlib.image.imsave.