matplotlib.image

图像模块支持基本的图像加载、重新缩放和显示操作。

注意：Matplotlib只能本机读取PNG。通过对枕头的可选依赖性支持进一步的图像格式。注意，URL字符串与枕头不兼容。
来源：https://www.osgeo.cn/matplotlib/api/image_api.html

https://matplotlib.org/api/image_api.html

类 AxesImage

class matplotlib.image.AxesImage(ax, cmap=None, norm=None, interpolation=None, origin=None, extent=None, filternorm=1, filterrad=4.0, resample=False, **kwargs)


插值和CMAP默认为其RC设置
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
范围是数据轴（左、右、下、上），用于将图像绘图注册到数据绘图中。默认设置是使用基于零的行和列索引标记像素中心。
其他Kwarg是Matplotlib.Artist属性

。	说明
基类	matplotlib.image._ImageBase
作用
参数：
ax
cmap
norm=None
interpolation	origin
extent
filternorm
filterrad
resample

方法

方法	说明
get_cursor_data(event)	获取给定事件的光标数据
get_extent()	获取图像范围：左、右、下、上
get_window_extent(renderer=None)	获取显示空间中的轴边界框。子类应覆盖以包含在边界框“紧密”计算中。默认值是返回0、0处的空边界框。使用此函数时要小心，如果艺术家窗口的范围发生更改，结果将不会更新。范围可能因变换堆栈中的任何更改而更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做）。这可能会导致意想不到的行为，在屏幕上交互式图形看起来很好，但保存不正确。
make_image(renderer, magnification=1.0, unsampled= False)	对该图像的数据进行规范化，重新缩放和颜色映射，以使用渲染器以给定的放大倍数进行渲染。如果unsampled为True，则不会缩放图像，但是将返回适当的仿射变换。
set_extent(extent)	范围是用于绘制图像绘图的数据轴（左、右、下、上.这将更新ax.datalim，如果自动缩放，则将viewlim设置为与图像紧密匹配，而不考虑datalim。自动缩放状态未更改，因此使用ax.autoscale_视图执行此操作后，将根据datalim重新进行自动缩放。

类 BboxImage

class matplotlib.image.BboxImage(bbox, cmap=None, norm=None, interpolation=None, origin=None, filternorm=1, filterrad=4.0, resample=False, interp_at_native=True, **kwargs)
基类：matplotlib.image._ImageBase
其大小由给定bbox确定的图像类。
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
interp_at_native是一个标志，用于确定当图像以其本机分辨率显示时，是否仍应应用插值。这种方法的一个常见使用案例是，为了注释目的显示图像时；它的处理方式与Photoshop类似（仅当以非本机分辨率显示图像时才使用插值）。
Kwargs是艺术家关键字args的可选列表

方法	说明
contains(mouseevent)	测试鼠标事件是否发生在图像中。
get_transform()	返回 Transform 此艺术家使用的实例。
get_window_extent(renderer=None)	获取显示空间中的轴边界框。子类应覆盖以包含在边界框“紧密”计算中。默认值是返回0、0处的空边界框。使用此函数时要小心，如果艺术家窗口的范围发生更改，结果将不会更新。范围可能因变换堆栈中的任何更改而更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做）。这可能会导致意想不到的行为，在屏幕上交互式图形看起来很好，但保存不正确。
make_image(renderer, magnification=1.0, unsampled=False)

类 FigureImage

class matplotlib.image.FigureImage(fig, cmap=None, norm=None, offsetx=0, offsety=0, origin=None, **kwargs)[源代码]
基类：matplotlib.image._ImageBase
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
Kwargs是艺术家关键字args的可选列表

方法	说明
get_extent()	获取图像范围：左、右、下、上
make_image(renderer, magnification=1.0, unsampled=False)
set_data(A)	设置图像数组。
zorder = 0

类 NonUniformImage

class matplotlib.image.NonUniformImage(ax, *, interpolation='nearest', **kwargs)

基类：matplotlib.image.AxesImage
Kwarg与Axesimage的Kwarg相同，只是“最近”和“双线性”是唯一受支持的“插值”选项。

方法	说明
get_extent()	获取图像范围：左、右、下、上
make_image(renderer, magnification=1.0, unsampled=False)
set_array(*args)	保留为向后兼容-使用set_data代替。参数: A : 类数组
set_cmap(cmap)	为亮度数据设置颜色映射参数: cmap : 颜色映射或注册的颜色映射名称
set_data(x, y, A)	为像素中心和像素值设置网格。 x 和 y 是长度n和m的单调一维Ndarrays，分别指定像素中心. A 是（m，n）ndarray或屏蔽的值数组颜色映射，或A（m，n，3）RGB数组，或A（m，n，4）RGBA数组。
set_filternorm(s)	设置调整大小过滤器是否规范化权重。查看帮助 imshow . 参数: 滤波器范数 : 布尔
set_filterrad(s)	设置只适用于某些插值方案的调整大小过滤器半径--有关imshow，请参阅帮助参数: 菲尔特拉德 : 正浮标
set_interpolation(s)	参数: s : 没有“最近”、“双线性”或 None .
set_norm(norm)	设置规范化实例。参数: norm ： Normalize : 归一化

类 PcolorImage

class matplotlib.image.PcolorImage(ax, x=None, y=None, A=None, cmap=None, norm=None, **kwargs)
基类：matplotlib.image.AxesImage
使用不规则的矩形网格绘制PColor样式的绘图。
它使用原始不规则图像代码的变体，并由pcolorfast用于对应的网格类型。
CMAP默认为其RC设置
CMAP是一种颜色。颜色映射实例norm是一种颜色。规范化实例以将亮度映射到0-1
其他Kwarg是Matplotlib.Artist属性

方法	说明
get_cursor_data(event)	获取给定事件的光标数据
make_image(renderer, magnification=1.0, unsampled=False)
set_array(*args)	保留为向后兼容-使用set_data代替。参数: A : 类数组
set_data(x, y, A)	设置矩形边界的网格和数据值。	x 和 y 是长度n+1和m+1的单调一维Ndarrays，分别指定矩形边界。如果没有，它们将分别创建为从0到n和0到m的均匀数组。 A 是（m，n）ndarray或屏蔽的值数组颜色映射，或A（m，n，3）RGB数组，或A（m，n，4）RGBA数组。
matplotlib.image.composite_images(images, renderer, magnification=1.0)	将多个rgba图像合成一个。	这些图像按它们在 images 名单。参数: images : 图像列表。每个都必须有一个 make_image 方法。对于每个图像， can_composite 应该返回 True 尽管此函数不强制执行。每个图像必须有一个纯仿射变换，没有剪切。 renderer：渲染器。 renderBase实例 magnification：放大倍率 :，浮点数。要应用于正在使用的渲染器的附加放大倍数。返回: 元组 tuple : （image, offset_x, offset_y） image：与输入图像类型相同的numpy数组。 offset_x，offset_y：输出图形中图像（左，下）的偏移量。

模块方法 imread

matplotlib.image.imread(fname, format=None)
#将文件中的图像读取到数组中。

参数:

参数名	数据类型	说明
fname	str	文件名	要读取的图像文件。这可以是文件名、URL或类似于python file-like的对象。
format	str	可选参数。	读取图像文件数据的格式。如果没有给出，则从文件名中推断格式。如果无法推导出任何结果，则尝试使用png。
返回值	numpy.array	图像数据。	返回的数组具有形状。（m，n）用于灰度图像。（m，n，3）对于RGB图像。（m，n，4）对于rgba图像。

模块方法 imsave

 matplotlib.image.imsave(fname, arr, vmin=None, vmax=None, cmap=None, format=None, origin=None, dpi=100)
#将数组另存为图像文件。可用的输出格式取决于所使用的后端。

参数	数据类型	说明
fname	str	文件名或路径	要存储图像的文件名或类似于python文件的对象。从文件扩展名推断出必要的输出格式，但可以使用格式 .
arr	array-like	图像数据。	形状可以是MXN（亮度）、MXNX3（RGB）或MXNX4（RGBA）之一。
vmin，vmax	可能是int或float	数量，可选	通过设置映射到颜色限制的值来设置图像的颜色缩放比例。如果任一 vmin 或 vmax为“无”，该限制由数组最小/最大值确定。
cmap	str或 Colormap	可选参数。颜色映射实例或注册的颜色映射名称。	颜色映射将标量数据映射到颜色。对于RGB（A）数据，它被忽略。默认为 rcParams["image.cmap"] ='viridis' ('viridis').
format	str	可选参数。文件格式，例如“png”、“pdf”、“svg”等。	如果未给出，则从文件扩展名中推断格式。
origin	元组{ 'upper'、'lower'}	可选参数.	指示是否 (0, 0) 数组的索引位于轴的左上角或左下角。默认为 rcParams["image.origin"] ='upper'。
dpi	str	可选参数	DPI存储在文件元数据中。不会影响输出图像的分辨率。

模块方法 pil_to_array

matplotlib.image.pil_to_array(pilImage)
#Load a PIL image and return it as a numpy array.
#返回:    numpy.array

数组形状取决于图像类型：

array	image type
（m，n）	灰度图像(grayscale images)
（m，n，3）	RGB图像。
（m，n，4）	rgba图像。

模块方法 thumbnail

 matplotlib.image.thumbnail(infile, thumbfile, scale=0.1, interpolation='bilinear', preview=False)
#在中制作图像的缩略图。

参数

参数名称	数据类型	po	说明
infile	str	图形文件	must be PNG or Pillow-readable if you have Pillow installed
thumbfile	str	缩略图	缩略图的文件名
scale	float	比例因子	缩略图的比例因子。浮点数，
interpolation	str	插值	重采样中使用的插值方案。可选参数，默认为 'bilinear'
preview	boolean	预览	可选参数，默认为False

matplotlib模块学习笔记--matplotlib.image