matplotlib.pyplot.imread#
- matplotlib.pyplot.imread(fname,format=None)[source]#
Read an image from a file into an array.
Note
This function exists for historical reasons. It is recommended touse
PIL.Image.openinstead for loading images.- Parameters:
- fnamestr or file-like
The image file to read: a filename, a URL or a file-like object openedin read-binary mode.
Passing a URL is deprecated. Please open the URLfor reading and pass the result to Pillow, e.g. with
np.array(PIL.Image.open(urllib.request.urlopen(url))).- formatstr, optional
The image file format assumed for reading the data. The image isloaded as a PNG file ifformat is set to "png", iffname is a pathor opened file with a ".png" extension, or if it is a URL. In allother cases,format is ignored and the format is auto-detected by
PIL.Image.open.
- Returns:
numpy.arrayThe image data. The returned array has shape
(M, N) for grayscale images.
(M, N, 3) for RGB images.
(M, N, 4) for RGBA images.
PNG images are returned as float arrays (0-1). All other formats arereturned as int arrays, with a bit depth determined by the file'scontents.
Notes
Note
This is equivalent to
matplotlib.image.imread.
