matplotlib.pyplot.savefig

matplotlib.pyplot.savefig(*args, **kwargs)[源代码]

保存当前图形。

呼叫签名：

savefig(fname, dpi=None, facecolor='w', edgecolor='w',
        orientation='portrait', papertype=None, format=None,
        transparent=False, bbox_inches=None, pad_inches=0.1,
        frameon=None, metadata=None)

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

参数:
fnamestr或path like或file like

路径，或者类似Python文件的对象，或者可能是一些后端相关的对象，例如 matplotlib.backends.backend_pdf.PdfPages .

如果 格式 设置时，它确定输出格式，并将文件另存为 文件名 .注意 文件名 是逐字使用的，并且没有试图对 文件名 比赛 格式 ，不追加扩展名。

如果 格式 则从 文件名 ，如果有的话。如果 格式 未设置和 文件名 没有扩展名，则文件将与一起保存 rcParams["savefig.format"] (default: 'png') 并将适当的扩展附加到 文件名 .
其他参数:
dpi : float or 'figure', default: rcParams["savefig.dpi"] (default: 'figure')float或'figure'，默认值：

以每英寸点数为单位的分辨率。如果是“figure”，则使用数字的dpi值。

**** : int, default: rcParams["savefig.jpeg_quality"] (default: 95)int，默认值：

仅适用于 格式 是“jpg”或“jpeg”，否则忽略。

图像质量，从1（最差）到95（最佳）。应该避免95以上的值；100会禁用JPEG压缩算法的某些部分，并导致大文件的图像质量几乎没有任何提高。

此参数已弃用。

optimizebool，默认值：False

仅适用于 格式 是“jpg”或“jpeg”，否则忽略。

编码器是否应该对图像进行额外的传递，以便选择最佳编码器设置。

此参数已弃用。

progressivebool，默认值：False

仅适用于 格式 是“jpg”或“jpeg”，否则忽略。

是否应将图像存储为渐进式JPEG文件。

此参数已弃用。

脸色 : color or 'auto', default: rcParams["savefig.facecolor"] (default: 'auto')颜色或“自动”，默认值：

人物的脸色。如果为“自动”，则使用当前地物颜色。

变色染料 : color or 'auto', default: rcParams["savefig.edgecolor"] (default: 'auto')颜色或“自动”，默认值：

人物的边缘颜色。如果为“自动”，则使用当前地物边颜色。

orientation‘横向’，‘纵向’

目前只有PostScript后端支持。

papertypeSTR

“Letter”、“Legal”、“Executive”、“Ledger”、“A0”到“A10”、“B0”到“B10”之一。仅支持PostScript输出。

formatSTR

文件格式，例如“png”、“pdf”、“svg”。。。未设置此选项时的行为记录在下 文件名 .

transparent布尔

如果 True ，轴补丁都将是透明的；图形补丁也将是透明的，除非通过Kwargs指定了面颜色和/或边缘颜色。例如，这对于在网页的彩色背景顶部显示绘图很有用。退出此功能后，这些补丁的透明度将恢复为其原始值。

bbox_inches : str or Bbox, default: rcParams["savefig.bbox"] (default: None)str或

以英寸为单位的边界框：仅保存图形的给定部分。如果“紧”，试着找出这个数字的紧框。

pad_inches : float, default: rcParams["savefig.pad_inches"] (default: 0.1)浮动，默认值：

当bboxu英寸“紧”时，图形周围的填充量。

bbox_extra_artists 名单 Artist 可选名单

当计算Tight BBox时将考虑的额外艺术家列表。

backend可选的STR

使用非默认后端渲染文件，例如，使用“cairo”后端而不是默认的“agg”渲染png文件，或使用“pgf”后端而不是默认的“pdf”渲染pdf文件。请注意，默认后端通常是足够的。看到了吗 内置后端 获取每个文件格式的有效后端列表。自定义后端可以引用为“模块：//。。。".

metadata可选的

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

  • 带agg后端的“png”：参见参数 metadata 属于 print_png .
  • 带PDF后端的“pdf”：请参见参数 metadata 属于 PdfPages .
  • 带有svg后端的“svg”：请参见参数 metadata 属于 print_svg .
  • “eps”和“ps”与ps后端：仅支持“creator”。
pil_kwargs可选的

传递给的其他关键字参数 PIL.Image.Image.save 保存图形时。