matplotlib.pyplot.savefig#

matplotlib.pyplot.savefig(*args, **kwargs)[Quelle]#

Speichert die aktuelle Abbildung als Bild oder Vektorgrafik in einer Datei.

Aufruf-Signatur

savefig(fname, *, transparent=None, dpi='figure', format=None,
        metadata=None, bbox_inches=None, pad_inches=0.1,
        facecolor='auto', edgecolor='auto', backend=None,
        **kwargs
       )

Die verfügbaren Ausgabeformate hängen vom verwendeten Backend ab.

Parameter:

fnamestr oder pfadähnlich oder binäre dateiähnliche

Ein Pfad, ein Python-dateiähnliches Objekt oder ein Backend-spezifisches Objekt wie matplotlib.backends.backend_pdf.PdfPages.

Wenn format gesetzt ist, bestimmt es das Ausgabeformat und die Datei wird als fname gespeichert. Beachten Sie, dass fname unverändert verwendet wird und es kein Versuch unternommen wird, die Erweiterung von fname (falls vorhanden) an format anzupassen, und keine Erweiterung angehängt wird.

Wenn format nicht gesetzt ist, wird das Format aus der Erweiterung von fname abgeleitet, falls vorhanden. Wenn format nicht gesetzt ist und fname keine Erweiterung hat, wird die Datei mit rcParams["savefig.format"] (Standard: 'png') gespeichert und die entsprechende Erweiterung an fname angehängt.

Andere Parameter:

transparentbool, Standard: rcParams["savefig.transparent"] (Standard: False)

Wenn True, sind alle Achsen-Patches transparent; der Figure-Patch ist ebenfalls transparent, es sei denn, facecolor und/oder edgecolor werden über kwargs angegeben.

Wenn False hat dies keine Auswirkung und die Farbe der Achsen- und Figure-Patches bleibt unverändert (es sei denn, der Figure-Patch wird über die Schlüsselwortargumente facecolor und/oder edgecolor angegeben, in welchem Fall diese Farben verwendet werden).

Die Transparenz dieser Patches wird nach Beendigung dieser Funktion auf ihre ursprünglichen Werte zurückgesetzt.

Dies ist beispielsweise nützlich, um ein Diagramm auf einem farbigen Hintergrund auf einer Webseite anzuzeigen.

dpifloat oder 'figure', Standard: rcParams["savefig.dpi"] (Standard: 'figure')

Die Auflösung in Dots per Inch. Wenn 'figure', wird der dpi-Wert der Abbildung verwendet.

formatstr

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

metadatadict, optional

Schlüssel/Wert-Paare, die in den Metadaten des Bildes gespeichert werden. Die unterstützten Schlüssel und Standardwerte hängen vom Bildformat und Backend ab

'png' mit Agg-Backend: siehe Parameter metadata von print_png.
'pdf' mit pdf-Backend: siehe Parameter metadata von PdfPages.
'svg' mit svg-Backend: siehe Parameter metadata von print_svg.
'eps' und 'ps' mit PS-Backend: Nur 'Creator' wird unterstützt.

Nicht unterstützt für 'pgf', 'raw' und 'rgba', da diese Formate keine Metadaten einbetten. Unterstützt derzeit nicht 'jpg', 'tiff' oder 'webp', könnte aber in Zukunft das Einbetten von EXIF-Metadaten beinhalten.

bbox_inchesstr oder Bbox, Standard: rcParams["savefig.bbox"] (Standard: None)

Bounding Box in Zoll: nur der angegebene Teil der Abbildung wird gespeichert. Wenn 'tight', versuchen Sie, die enge Bounding Box der Abbildung zu ermitteln.

pad_inchesfloat oder 'layout', Standard: rcParams["savefig.pad_inches"] (Standard: 0.1)

Menge des Abstands in Zoll um die Abbildung herum, wenn bbox_inches 'tight' ist. Wenn 'layout', verwenden Sie den Abstand aus der constrained- oder compressed-Layout-Engine; ignoriert, wenn eine dieser Engines nicht verwendet wird.

facecolorFarbe oder 'auto', Standard: rcParams["savefig.facecolor"] (Standard: 'auto')

Die Vordergrundfarbe der Abbildung. Wenn 'auto', wird die aktuelle Vordergrundfarbe der Abbildung verwendet.

edgecolorFarbe oder 'auto', Standard: rcParams["savefig.edgecolor"] (Standard: 'auto')

Die Randfarbe der Abbildung. Wenn 'auto', wird die aktuelle Randfarbe der Abbildung verwendet.

backendstr, optional

Verwenden Sie ein nicht standardmäßiges Backend, um die Datei zu rendern, z. B. um eine PNG-Datei mit dem "cairo"-Backend statt dem Standard-"agg" zu rendern oder eine PDF-Datei mit dem "pgf"-Backend statt dem Standard-"pdf". Beachten Sie, dass das Standard-Backend normalerweise ausreichend ist. Siehe Die integrierten Backends für eine Liste gültiger Backends für jedes Dateiformat. Benutzerdefinierte Backends können als "module://..." referenziert werden.

orientation{'landscape', 'portrait'}