matplotlib.pyplot.imsave#

matplotlib.pyplot.imsave(fname, arr, **kwargs)[源码]#

对数组进行颜色映射并将其保存为图像文件。

RGB(A) 图像直接通过。单通道图像将根据 cmap 和 norm 进行颜色映射。

注意

如果您想将单通道图像保存为灰度图像，请直接使用图像 I/O 库（例如 pillow、tifffile 或 imageio）。

参数:
fname字符串或路径类或文件类

一个路径或文件类对象，用于存储图像。如果未设置 format，则输出格式将从 fname 的扩展名（如果有）推断，否则从 rcParams["savefig.format"]（默认值：'png'）推断。如果设置了 format，则它决定输出格式。

arrarray-like（类数组）

图像数据。接受 NumPy 数组或序列（例如，列表或元组）。形状可以是 MxN（亮度）、MxNx3（RGB）或 MxNx4（RGBA）。

vmin, vmax浮点型，可选

vmin 和 vmax 通过固定映射到颜色映射颜色限制的值来设置图像的颜色缩放。如果 vmin 或 vmax 为 None，则该限制将从 arr 的最小值/最大值确定。

cmapstr 或 Colormap，默认值：rcParams["image.cmap"] (默认值：'viridis')

一个 Colormap 实例或注册的颜色映射名称。颜色映射将标量数据映射到颜色。对于 RGB(A) 数据，此参数被忽略。

formatstr, 可选

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

origin{'upper', 'lower'}，默认值：rcParams["image.origin"] (默认值：'upper')

指示数组的 (0, 0) 索引是在 Axes 的左上角还是左下角。

dpifloat（浮点数）

要存储在文件元数据中的 DPI。这不影响输出图像的分辨率。根据文件格式，此值可能会四舍五入到最接近的整数。

metadata字典，可选

图像文件中的元数据。支持的键取决于输出格式，详情请参阅相应后端的文档。目前仅支持“png”、“pdf”、“ps”、“eps”和“svg”格式。

pil_kwargs字典，可选

传递给 PIL.Image.Image.save 的关键字参数。如果存在“pnginfo”键，它将完全覆盖 metadata，包括默认的“Software”键。

备注

注意

这等同于 matplotlib.image.imsave。

在此页