matplotlib.pyplot.imsave#
- matplotlib.pyplot.imsave(fname, arr, **kwargs)[源代码][源代码]#
颜色映射并将数组保存为图像文件。
RGB(A) 图像会被传递。单通道图像将根据 cmap 和 norm 进行颜色映射。
备注
如果你想将单通道图像保存为灰度图像,请直接使用图像I/O库(如pillow、tifffile或imageio)。
- 参数:
- fnamestr 或 path-like 或 file-like
一个路径或类似文件的对象来存储图像。如果未设置 format,则输出格式由 fname 的扩展名(如果有)推断,否则由
rcParams["savefig.format"](default:'png') 决定。如果设置了 format,它将决定输出格式。- arr类数组
图像数据。形状可以是 MxN(亮度)、MxNx3(RGB)或 MxNx4(RGBA)。
- vmin, vmaxfloat, 可选
vmin 和 vmax 通过固定映射到色标颜色限制的值来设置图像的颜色缩放。如果 vmin 或 vmax 为 None,则该限制由 arr 的最小/最大值决定。
- cmap : str 或
Colormap,默认值:rcParams["image.cmap"](default:'viridis')str 或 一个 Colormap 实例或已注册的 colormap 名称。colormap 将标量数据映射为颜色。对于 RGB(A) 数据,它将被忽略。
- 格式str, 可选
文件格式,例如 'png', 'pdf', 'svg', ... 当未设置此项时的行为在 fname 下有文档说明。
- origin : {'upper', 'lower'}, 默认值:
rcParams["image.origin"](default:'upper'){'upper', 'lower'}, 默认: 指示数组的
(0, 0)索引是否位于 Axes 的左上角或左下角。- dpi浮动
存储在文件元数据中的DPI。这不会影响输出图像的分辨率。根据文件格式,这可能会被四舍五入到最接近的整数。
- 元数据dict, 可选
图像文件中的元数据。支持的键取决于输出格式,更多信息请参阅各自后端的文档。目前仅支持“png”、“pdf”、“ps”、“eps”和“svg”。
- pil_kwargsdict, 可选
传递给
PIL.Image.Image.save的关键字参数。如果存在 'pnginfo' 键,它将完全覆盖 metadata,包括默认的 'Software' 键。
注释
备注
这等同于
matplotlib.image.imsave。