Python matplotlib Figure.savefig用法及代碼示例

本文簡要介紹 python 語言中 matplotlib.figure.Figure.savefig 的用法。

用法

savefig(fname, *, transparent=None, **kwargs)

保存當前圖形。

調用簽名：

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

可用的輸出格式取決於所使用的後端。

參數：

fname str 或 path-like 或二進製 file-like

路徑，或 Python file-like 對象，或者可能是一些 backend-dependent 對象，例如 matplotlib.backends.backend_pdf.PdfPages 。

如果設置了format，則確定輸出格式，文件保存為fname。請注意，fname 是逐字使用的，並且不會嘗試使 fname 的擴展名(如果有)與 format 匹配，並且不會附加任何擴展名。

如果 format 未設置，則從 fname 的擴展名推斷格式(如果有)。如果未設置 format 並且 fname 沒有擴展名，則使用 rcParams["savefig.format"] (默認值： 'png' )保存文件，並將適當的擴展名附加到 fname 。

其他參數：

dpi 浮點數或'figure'，默認值：rcParams["savefig.dpi"](默認值：'figure')

每英寸點數的分辨率。如果'figure'，使用圖形的dpi值。

format str

文件格式，例如'png', 'pdf', 'svg', ... 未設置時的行為記錄在 fname 下。

metadata 字典，可選

要存儲在圖像元數據中的鍵/值對。支持的鍵和默認值取決於圖像格式和後端：

• 'png' 帶 Agg 後端：請參閱 print_png 的參數 metadata 。

• 'pdf' 帶有 pdf 後端：請參閱 PdfPages 的參數 metadata 。

• 'svg' 帶有 svg 後端：請參閱 print_svg 的參數 metadata 。

• 帶有 PS 後端的 'eps' 和 'ps'：僅支持 'Creator'。

不支持 'pgf', 'raw' 和 'rgba'，因為這些格式不支持嵌入元數據。目前不支持'jpg', 'tiff'或'webp'，但將來可能包括嵌入EXIF元數據。

bbox_inches str 或 Bbox ，默認值：rcParams["savefig.bbox"](默認值：None)

以英寸為單位的邊界框：僅保存圖形的給定部分。如果'tight'，試著算出圖的緊bbox。

pad_inches 浮點數或'layout'，默認值：rcParams["savefig.pad_inches"](默認值：0.1)

當 bbox_inches 為 'tight' 時圖形周圍的填充量(以英寸為單位)。如果'layout'使用來自約束或壓縮布局引擎的填充；如果這些引擎之一未使用，則忽略。

facecolor 顏色或'auto'，默認：rcParams["savefig.facecolor"](默認：'auto')

人物的麵色。如果是'auto'，則使用當前圖形的facecolor。

edgecolor 顏色或'auto'，默認：rcParams["savefig.edgecolor"](默認：'auto')

圖的邊顏色。如果'auto'，使用當前圖形邊顏色。

backend str，可選

使用非默認後端來呈現文件，例如使用 "cairo" 後端而不是默認 "agg" 渲染 png 文件，或使用 "pgf" 後端而不是默認 "pdf" 渲染 pdf 文件。請注意，默認後端通常就足夠了。有關每種文件格式的有效後端列表，請參閱內置後端。自定義後端可以引用為"module://..."。

orientation {'landscape', 'portrait'}

目前僅由 postscript 後端支持。

papertype str

'letter', 'legal', 'executive', 'ledger'、'a0' 到 'a10'、'b0' 到 'b10' 之一。僅支持 postscript 輸出。

transparent bool

如果 True ，則 Axes 補丁都是透明的；除非通過 kwargs 指定 facecolor 和/或 edgecolor，否則圖形補丁也將是透明的。

如果 False 沒有效果並且軸和圖形補丁的顏色不變(除非圖形補丁是通過 facecolor 和/或 edgecolor 關鍵字參數指定的，在這種情況下使用這些顏色)。

退出此函數後，這些補丁的透明度將恢複為原始值。

例如，這對於在網頁的彩色背景上顯示繪圖很有用。

bbox_extra_artists Artist 列表，可選

計算緊湊 bbox 時將考慮的額外藝術家列表。

pil_kwargs 字典，可選

保存圖窗時傳遞給 PIL.Image.Image.save 的其他關鍵字參數。