matplotlib.figure.Figure.savefig#

Figure.savefig(fname, *, transparent=None, **kwargs)[源代码]#

将当前图形保存为图像或矢量图形文件。

调用签名

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

可用的输出格式取决于所使用的后端。

参数:

fnamestr 或类路径对象或二进制文件类对象

一个路径，或一个 Python 文件类对象，或可能是某些取决于后端的对象，例如 matplotlib.backends.backend_pdf.PdfPages。

如果设置了 *format*，它将决定输出格式，并且文件将以 *fname* 为名保存。请注意，*fname* 将按原样使用，不会尝试使 *fname*（如果存在）的扩展名与 *format* 匹配，也不会添加任何扩展名。

如果未设置 *format*，则格式将从 *fname* 的扩展名（如果存在）中推断。如果未设置 *format* 且 *fname* 没有扩展名，则文件将使用 rcParams["savefig.format"] (默认值：'png') 并向 *fname* 添加相应的扩展名。

其他参数:

transparent布尔值，默认值：rcParams["savefig.transparent"] (默认值：False)

如果为 *True*，所有 Axes 补丁都将透明；Figure 补丁也将透明，除非通过 kwargs 指定了 *facecolor* 和/或 *edgecolor*。

如果为 *False* 则无效，并且 Axes 和 Figure 补丁的颜色不变（除非通过 *facecolor* 和/或 *edgecolor* 关键字参数指定了 Figure 补丁，在这种情况下会使用这些颜色）。

这些补丁的透明度将在函数退出时恢复到其原始值。

这很有用，例如，在网页上将绘图显示在彩色背景之上时。

dpi浮点数或 'figure'，默认值：rcParams["savefig.dpi"] (默认值：'figure')

每英寸点数的分辨率。如果为 'figure'，则使用图的 dpi 值。

formatstr

文件格式，例如 'png', 'pdf', 'svg', ... 未设置此项时的行为已在 *fname* 下记录。

metadata字典，可选

用于存储在图像元数据中的键/值对。支持的键和默认值取决于图像格式和后端

'png' 使用 Agg 后端：请参阅 print_png 的 metadata 参数。
'pdf' 使用 pdf 后端：请参阅 PdfPages 的 metadata 参数。
'svg' 使用 svg 后端：请参阅 print_svg 的 metadata 参数。
'eps' 和 'ps' 使用 PS 后端：仅支持 'Creator'。

不支持 'pgf', 'raw' 和 'rgba'，因为这些格式不支持嵌入元数据。目前不支持 'jpg', 'tiff' 或 'webp'，但将来可能会支持嵌入 EXIF 元数据。

bbox_inchesstr 或 Bbox，默认值：rcParams["savefig.bbox"] (默认值：None)

以英寸为单位的边界框：只保存图的给定部分。如果为 'tight'，则尝试计算图的紧密边界框。

pad_inches浮点数或 'layout'，默认值：rcParams["savefig.pad_inches"] (默认值：0.1)

当 bbox_inches 为 'tight' 时，围绕图的英寸填充量。如果为 'layout'，则使用受约束或压缩布局引擎的填充；如果未使用其中一个引擎，则忽略此项。

facecolor颜色或 'auto'，默认值：rcParams["savefig.facecolor"] (默认值：'auto')

图的背景色。如果为 'auto'，则使用当前图的背景色。

edgecolor颜色或 'auto'，默认值：rcParams["savefig.edgecolor"] (默认值：'auto')

图的边框颜色。如果为 'auto'，则使用当前图的边框颜色。

backendstr，可选

使用非默认后端渲染文件，例如，使用 "cairo" 后端而不是默认的 "agg" 来渲染 png 文件，或者使用 "pgf" 后端而不是默认的 "pdf" 来渲染 pdf 文件。请注意，默认后端通常就足够了。请参阅内置后端以获取每种文件格式的有效后端列表。自定义后端可以引用为 "module://..."。

orientation{'landscape', 'portrait'}