matplotlib.pyplot.savefig #
- matplotlib.pyplot. savefig ( * args , ** kwargs ) [Quelle] #
Speichern Sie die aktuelle Figur.
Rufsignatur:
savefig(fname, *, 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 :
- fname str oder pfadähnlich oder binärdateiähnlich
Ein Pfad oder ein dateiähnliches Python-Objekt oder möglicherweise ein Backend-abhängiges Objekt wie
matplotlib.backends.backend_pdf.PdfPages
.Wenn format festgelegt ist, bestimmt es das Ausgabeformat und die Datei wird als fname gespeichert . Beachten Sie, dass fname wörtlich verwendet wird, und es wird nicht versucht, die Erweiterung, falls vorhanden, von fname mit format abzugleichen , und es wird keine Erweiterung angehängt.
Wenn format nicht festgelegt ist, wird das Format von der Erweiterung von fname abgeleitet , sofern vorhanden. Wenn das Format nicht festgelegt 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 :
- dpi Float oder 'Zahl', Standard:
rcParams["savefig.dpi"]
(Standard:'figure'
) Die Auflösung in Punkten pro Zoll. Wenn es sich um eine Figur handelt, verwenden Sie den dpi-Wert der Figur.
- formatieren str
Das Dateiformat, zB 'png', 'pdf', 'svg', ... Das Verhalten, wenn dieses nicht gesetzt ist, ist unter fname dokumentiert .
- Metadatenverzeichnis , 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:
- bbox_inches str oder
Bbox
, Standard:rcParams["savefig.bbox"]
(Standard:None
) Begrenzungsrahmen in Zoll: Nur der angegebene Teil der Figur wird gespeichert. Wenn es „eng“ ist, versuchen Sie, die enge Box der Figur herauszufinden.
- pad_inches Float, Standard:
rcParams["savefig.pad_inches"]
(Standard:0.1
) Umfang der Polsterung um die Figur herum, wenn bbox_inches 'eng' ist.
- facecolor color oder 'auto', default:
rcParams["savefig.facecolor"]
(default:'auto'
) Die Gesichtsfarbe der Figur. Bei 'auto' wird die aktuelle Gesichtsfarbe der Figur verwendet.
- edgecolor color oder 'auto', default:
rcParams["savefig.edgecolor"]
(default:'auto'
) Die Kantenfarbe der Figur. Bei 'auto' wird die aktuelle Kantenfarbe der Figur verwendet.
- Backend -Str, optional
Verwenden Sie zum Rendern der Datei ein nicht standardmäßiges Backend, z. B. zum Rendern einer PNG-Datei mit dem „cairo“-Backend anstelle des standardmäßigen „agg“ oder einer PDF-Datei mit dem „pgf“-Backend anstelle des standardmäßigen „pdf“. Beachten Sie, dass das Standard-Backend normalerweise ausreichend ist. Eine Liste gültiger Backends für jedes Dateiformat finden Sie unter Die integrierten Backends . Auf benutzerdefinierte Backends kann als "module://..." verwiesen werden.
- Ausrichtung {'Querformat', 'Hochformat'}
Derzeit nur vom Postscript-Backend unterstützt.
- Papiertyp str
Einer von „Letter“, „Legal“, „Executive“, „Ledger“, „a0“ bis „a10“, „b0“ bis „b10“. Wird nur für die Postscript-Ausgabe unterstützt.
- transparenter boolescher Wert
Wenn True , sind alle Axes-Patches transparent; Der Figurenpatch ist ebenfalls transparent, es sei denn, facecolor und/oder edgecolor werden über kwargs angegeben.
Wenn False keine Auswirkung hat und die Farbe der Axes- und Figure-Patches unverändert bleibt (es sei denn, das 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 beispielsweise nützlich, um auf einer Webseite ein Diagramm auf einem farbigen Hintergrund anzuzeigen.
- bbox_extra_artists Liste von
Artist
, optional Eine Liste mit zusätzlichen Künstlern, die bei der Berechnung der knappen Box berücksichtigt werden.
- pil_kwargs Diktat , optional
Zusätzliche Schlüsselwortargumente, die
PIL.Image.Image.save
beim Speichern der Figur übergeben werden.
- dpi Float oder 'Zahl', Standard: