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 的其他关键字参数。