当前位置: 首页>>代码示例 >>用法及示例精选 >>正文


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

相关用法


注:本文由纯净天空筛选整理自skytowner.com大神的英文原创作品 matplotlib.figure.Figure.savefig。非经特殊声明,原始代码版权归原作者所有,本译文未经允许或授权,请勿转载或复制。