W3cubDocs

matplotlib.pyplot.imsave

matplotlib.pyplot.imsave(fname, arr, **kwargs) [source]

Save an array as an image file.

Parameters:

Parameters:	`fname : str or PathLike file-like` A path or a Python file-like object to store the image in. If format is not set, then the output format is inferred from the extension of fname, if any, and from `rcParams["savefig.format"]` otherwise. If format is set, it determines the output format. `arr : array-like` The image data. The shape can be one of MxN (luminance), MxNx3 (RGB) or MxNx4 (RGBA). `vmin, vmax : scalar, optional` vmin and vmax set the color scaling for the image by fixing the values that map to the colormap color limits. If either vmin or vmax is None, that limit is determined from the arr min/max value. `cmap : str or Colormap, optional` A Colormap instance or registered colormap name. The colormap maps scalar data to colors. It is ignored for RGB(A) data. Defaults to `rcParams["image.cmap"]` ('viridis'). `format : str, optional` The file format, e.g. 'png', 'pdf', 'svg', ... The behavior when this is unset is documented under fname. `origin : {'upper', 'lower'}, optional` Indicates whether the `(0, 0)` index of the array is in the upper left or lower left corner of the axes. Defaults to `rcParams["image.origin"]` ('upper'). `dpi : int` The DPI to store in the metadata of the file. This does not affect the resolution of the output image.

fname : str or PathLike file-like: A path or a Python file-like object to store the image in. If format is not set, then the output format is inferred from the extension of fname, if any, and from rcParams["savefig.format"] otherwise. If format is set, it determines the output format.
arr : array-like: The image data. The shape can be one of MxN (luminance), MxNx3 (RGB) or MxNx4 (RGBA).
vmin, vmax : scalar, optional: vmin and vmax set the color scaling for the image by fixing the values that map to the colormap color limits. If either vmin or vmax is None, that limit is determined from the arr min/max value.
cmap : str or Colormap, optional: A Colormap instance or registered colormap name. The colormap maps scalar data to colors. It is ignored for RGB(A) data. Defaults to rcParams["image.cmap"] ('viridis').
format : str, optional: The file format, e.g. 'png', 'pdf', 'svg', ... The behavior when this is unset is documented under fname.
origin : {'upper', 'lower'}, optional: Indicates whether the (0, 0) index of the array is in the upper left or lower left corner of the axes. Defaults to rcParams["image.origin"] ('upper').
dpi : int: The DPI to store in the metadata of the file. This does not affect the resolution of the output image.