matplotlib.figure.Figure.savefig#

Figure.savefig(fname, *, transparent=None, **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äres datei-ähnliches Objekt

Ein Pfad, ein Python-datei-ähnliches Objekt oder möglicherweise ein Backend-abhängiges 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 keine Versuche unternommen werden, 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 wird 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 Auswirkungen 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 beim Verlassen dieser Funktion auf ihre ursprünglichen Werte zurückgesetzt.

Dies ist zum Beispiel 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 Punkten pro Zoll. Wenn 'figure', wird der dpi-Wert der Figur 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 Bildmetadaten gespeichert werden sollen. Die unterstützten Schlüssel und Standardwerte hängen vom Bildformat und Backend ab.

'png' mit Agg-Backend: Siehe den Parameter metadata von print_png.
'pdf' mit pdf-Backend: Siehe den Parameter metadata von PdfPages.
'svg' mit svg-Backend: Siehe den 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 unterstützen. Unterstützt derzeit nicht 'jpg', 'tiff' oder 'webp', kann aber in Zukunft das Einbetten von EXIF-Metadaten umfassen.

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 anstelle des Standard-"agg" zu rendern oder eine PDF-Datei mit dem "pgf"-Backend anstelle des Standard-"pdf". Beachten Sie, dass das Standard-Backend normalerweise ausreicht. 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'}