matplotlib.pyplot.figimage

matplotlib.pyplot.figimage(*args, **kwargs) [source]

Add a non-resampled image to the figure.

The image is attached to the lower or upper left corner depending on origin.

Parameters:	X The image data. This is an array of one of the following shapes: MxN: luminance (grayscale) values MxNx3: RGB values MxNx4: RGBA values xo, yo : int The x/y image offset in pixels. alpha : None or float The alpha blending value. norm : matplotlib.colors.Normalize A Normalize instance to map the luminance to the interval [0, 1]. cmap : str or matplotlib.colors.Colormap The colormap to use. Default: rcParams["image.cmap"]. vmin, vmax : scalar If norm is not given, these values set the data limits for the colormap. origin : {'upper', 'lower'} Indicates where the [0, 0] index of the array is in the upper left or lower left corner of the axes. Defaults to rcParams["image.origin"]. resize : bool If True, resize the figure to match the given image size.
Returns:	matplotlib.image.FigureImage
Other Parameters:	**kwargs Additional kwargs are Artist kwargs passed on to FigureImage.

Notes

figimage complements the axes image (imshow()) which will be resampled to fit the current axes. If you want a resampled image to fill the entire figure, you can define an Axes with extent [0,0,1,1].

Examples:

f = plt.figure()
nx = int(f.get_figwidth() * f.dpi)
ny = int(f.get_figheight() * f.dpi)
data = np.random.random((ny, nx))
f.figimage(data)
plt.show()

Examples using matplotlib.pyplot.figimage