matplotlib.pyplot.savefig #
- matplotlib.pyplot。savefig ( * args , ** 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 或 binary file-like
路径,或 Python 文件类对象,或者可能是一些后端相关的对象,例如
matplotlib.backends.backend_pdf.PdfPages
.如果设置了格式,它将确定输出格式,并将文件保存为fname。请注意,fname是逐字使用的,并且没有尝试使fname的扩展名(如果有)匹配 format,并且没有附加扩展名。
如果未设置格式,则从fname的扩展名中推断出格式(如果有的话)。如果未设置格式且fname没有扩展名,则使用
rcParams["savefig.format"]
(default:'png'
) 保存文件,并将适当的扩展名附加到 fname。
- 其他参数:
- dpi float 或 'figure',默认值:(
rcParams["savefig.dpi"]
默认值'figure'
:) 每英寸点数的分辨率。如果是“图”,则使用图的 dpi 值。
- 格式字符串
文件格式,例如 'png', 'pdf', 'svg', ... 未设置时的行为记录在fname下。
- 元数据字典,可选
要存储在图像元数据中的键/值对。支持的键和默认值取决于图像格式和后端:
- bbox_inches str 或
Bbox
,默认值:(rcParams["savefig.bbox"]
默认值None
:) 以英寸为单位的边界框:仅保存图形的给定部分。如果'tight',试着找出图的tight bbox。
- pad_inches浮动,默认值:(
rcParams["savefig.pad_inches"]
默认值0.1
:) 当 bbox_inches 为“紧”时,图形周围的填充量。
- facecolor颜色或“自动”,默认值:(
rcParams["savefig.facecolor"]
默认值'auto'
:) 人物的面色。如果是“自动”,则使用当前图形的面色。
- edgecolor颜色或“自动”,默认值:(
rcParams["savefig.edgecolor"]
默认值'auto'
:) 图的边缘颜色。如果为“自动”,则使用当前图形边缘颜色。
- 后端str,可选
使用非默认后端来渲染文件,例如使用“cairo”后端而不是默认“agg”来渲染 png 文件,或者使用“pgf”后端而不是默认“pdf”来渲染 pdf 文件。请注意,默认后端通常就足够了。有关每种文件格式的有效后端列表,请参阅 内置后端。自定义后端可以引用为“module://...”。
- 方向{'风景','肖像'}
目前仅由 postscript 后端支持。
- papertype str
'letter'、'legal'、'executive'、'ledger'、'a0' 到 'a10'、'b0' 到 'b10' 之一。仅支持 postscript 输出。
- 透明布尔
如果为True,则 Axes 补丁都是透明的;除非通过 kwargs 指定facecolor 和/或edgecolor ,否则 Figure 补丁也将是透明的。
如果False没有效果并且 Axes 和 Figure 补丁的颜色不变(除非 Figure 补丁是通过facecolor和/或edgecolor关键字参数指定的,在这种情况下使用这些颜色)。
退出此功能后,这些补丁的透明度将恢复为原始值。
例如,这对于在网页的彩色背景上显示绘图很有用。
- bbox_extra_artists列表
Artist
,可选 计算紧凑 bbox 时将考虑的额外艺术家列表。
- pil_kwargs字典,可选
PIL.Image.Image.save
保存图窗时传递给的其他关键字参数 。
- dpi float 或 'figure',默认值:(