matplotlib.pyplot.savefig#

matplotlib.pyplot.savefig(*args, **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。

其他参数:

transparentbool, 默认值：rcParams["savefig.transparent"]（默认值：False）

如果为True，则所有坐标轴补丁都将透明；图形补丁也将透明，除非通过 kwargs 指定了facecolor和/或edgecolor。

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

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

这很有用，例如，用于在网页上有色背景上显示图表。

dpifloat 或 'figure'，默认值：rcParams["savefig.dpi"]（默认值：'figure'）

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

formatstr

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

metadata字典，可选

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

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

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

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

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

pad_inchesfloat 或 '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'}

目前仅由 postscript 后端支持。

papertypestr

以下之一：“letter”、“legal”、“executive”、“ledger”、“a0”到“a10”、“b0”到“b10”。仅支持 postscript 输出。

bbox_extra_artistsArtist列表，可选

在计算紧密边界框时将被考虑在内的额外 Artist 列表。

pil_kwargs字典，可选

在保存图形时传递给PIL.Image.Image.save的额外关键字参数。

备注

注意

这是pyplot 包装器，用于Figure.savefig。

使用`matplotlib.pyplot.savefig`的示例#

matplotlib.pyplot.savefig#

使用matplotlib.pyplot.savefig的示例#

使用`matplotlib.pyplot.savefig`的示例#