matplotlib.image

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

类 matplotlib.image。AxesImage ( ax , * , cmap = None , norm = None , interpolation = None , origin = None , extent = None , filternorm = True , filterrad = 4.0 , resample = False , interpolation_stage = None , ** kwargs )

基地：_ImageBase

附加到轴的图像。

参数：

斧头Axes

图像所属的轴。

cmap str 或Colormap，默认值：（rcParams["image.cmap"]默认值'viridis'：）

用于将标量数据映射到颜色的颜色图实例或注册的颜色图名称。

规范str 或Normalize

将亮度映射到 0-1。

插值str，默认值：（rcParams["image.interpolation"]默认值'antialiased'：）

支持的值为 'none'、'antialiased'、'nearest'、'bilinear'、'bicubic'、'spline16'、'spline36'、'hanning'、'hamming'、'hermite'、'kaiser'、'quadric' , 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'blackman'。

插值阶段 {'data', 'rgba'}，默认值：'data'

如果是“数据”，则对用户提供的数据进行插值。如果为 'rgba'，则在应用颜色映射后执行插值（视觉插值）。

原点{'upper', 'lower'}，默认值：（rcParams["image.origin"]默认值'upper'：）

将数组的 [0, 0] 索引放置在坐标区的左上角或左下角。约定“上”通常用于矩阵和图像。

范围元组，可选

用于制作与数据图对齐的图像图的数据轴（左、右、下、上）。默认是使用从零开始的行和列索引来标记像素中心。

filternorm布尔值，默认值：True

antigrain 图像调整大小过滤器的参数（请参阅 antigrain 文档）。如果设置了 filternorm，则过滤器对整数值进行归一化并纠正舍入错误。它不对源浮点值做任何事情，它只根据 1.0 的规则纠正整数，这意味着像素权重的任何总和必须等于 1.0。因此，过滤器函数必须生成正确形状的图形。

filterrad浮点数 > 0，默认值：4

具有半径参数的过滤器的过滤器半径，即当插值是以下之一时：“sinc”、“lanczos”或“blackman”。

重采样布尔值，默认值：False

如果为 True，则使用完全重采样方法。为 False 时，仅在输出图像大于输入图像时重新采样。

**kwargsArtist属性

参数：

norm Normalize（或其子类）或 str 或 None

将数据缩放到区间的标准化对象。如果 a ，则根据具有相应名称的比例动态生成子类。如果None，norm默认为colors.Normalize对象，该对象根据处理的第一个数据初始化其缩放。[0, 1]strNormalize

cmap str 或Colormap

用于将标准化数据值映射到 RGBA 颜色的颜色图。

get_cursor_data (事件)

返回事件位置的图像值，如果事件在图像之外，则返回None。

也可以看看

matplotlib.artist.Artist.get_cursor_data

get_extent ( )

将图像范围返回为元组（左、右、下、上）。

get_window_extent ( renderer = None )

在显示空间中获取艺术家的边界框。

边界框的宽度和高度是非负的。

子类应覆盖以包含在边界框“紧密”计算中。默认是在 0, 0 处返回一个空的边界框。

使用此功能时要小心，如果艺术家的艺术家窗口范围发生变化，结果将不会更新。由于变换堆栈中的任何更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做的那样），范围可能会发生变化。这可能会导致意外行为，其中交互式图形在屏幕上看起来很好，但会错误地保存。

make_image ( renderer , magnification = 1.0 , unsampled = False )

使用给定的magnification对这个图像的数据进行归一化、重新缩放和颜色映射，以便使用 renderer进行渲染。

如果unsampled为 True，则图像不会被缩放，而是会返回适当的仿射变换。

返回：

图像(M, N, 4) uint8 数组

RGBA 图像，重新采样，除非未采样为 True。

x, y浮动

应该在像素空间中绘制图像的左上角。

反仿射二维

从图像到像素空间的仿射变换。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , extent=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> ,插值阶段=<UNSET> ,标签=<UNSET> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=< UNSET> , picker=<UNSET > , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	浮点数或二维数组或无
animated	布尔
array	类数组
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
data	类数组或PIL.Image.Image
extent	浮点数的 4 元组
figure	Figure
filternorm	布尔
filterrad	正浮动
gid	字符串
in_layout	布尔
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} 或无
interpolation_stage	{'data', 'rgba'} 或无
label	目的
mouseover	布尔
norm	Normalize或 str 或 无
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
resample	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮

set_extent (范围)

设置图像范围。

参数：

浮点数的范围4 元组

图像的位置和大小作为 数据坐标中的元组。(left, right, bottom, top)

笔记

这会更新ax.dataLim，并且如果自动缩放，则设置ax.viewLim 为紧密适合图像，而不管dataLim. 自动缩放状态没有改变，所以跟随这个ax.autoscale_view() 将按照 重做自动缩放dataLim。

类 matplotlib.image。BboxImage ( bbox , * , cmap = None , norm = None , interpolation = None , origin = None , filternorm = True , filterrad = 4.0 , resample = False , ** kwargs )

基地：_ImageBase

Image 类，其大小由给定的 bbox 确定。

cmap 是颜色。Colormap 实例 norm 是颜色。标准化实例以将亮度映射到 0-1

kwargs 是 Artist 关键字参数的可选列表

包含( mouseevent )

测试鼠标事件是否发生在图像内。

get_window_extent ( renderer = None )

在显示空间中获取艺术家的边界框。

边界框的宽度和高度是非负的。

子类应覆盖以包含在边界框“紧密”计算中。默认是在 0, 0 处返回一个空的边界框。

使用此功能时要小心，如果艺术家的艺术家窗口范围发生变化，结果将不会更新。由于变换堆栈中的任何更改，例如更改轴限制、图形大小或使用的画布（如保存图形时所做的那样），范围可能会发生变化。这可能会导致意外行为，其中交互式图形在屏幕上看起来很好，但会错误地保存。

make_image ( renderer , magnification = 1.0 , unsampled = False )

使用给定的magnification对这个图像的数据进行归一化、重新缩放和颜色映射，以便使用 renderer进行渲染。

如果unsampled为 True，则图像不会被缩放，而是会返回适当的仿射变换。

返回：

图像(M, N, 4) uint8 数组

RGBA 图像，重新采样，除非未采样为 True。

x, y浮动

应该在像素空间中绘制图像的左上角。

反仿射二维

从图像到像素空间的仿射变换。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> ,标签=<UNSET> ,mouseover=<UNSET> ,norm=<UNSET> , path_effects=< UNSET> , picker=<UNSET > , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	浮点数或二维数组或无
animated	布尔
array	类数组
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
data	类数组或PIL.Image.Image
figure	Figure
filternorm	布尔
filterrad	正浮动
gid	字符串
in_layout	布尔
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} 或无
interpolation_stage	{'data', 'rgba'} 或无
label	目的
mouseover	布尔
norm	Normalize或 str 或 无
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
resample	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮

类 matplotlib.image。FigureImage ( fig , * , cmap = None , norm = None , offsetx = 0 , offsety = 0 , origin = None , ** kwargs )

基地：_ImageBase

附在图形上的图像。

cmap 是颜色。Colormap 实例 norm 是颜色。标准化实例以将亮度映射到 0-1

kwargs 是 Artist 关键字参数的可选列表

get_extent ( )

将图像范围返回为元组（左、右、下、上）。

make_image ( renderer , magnification = 1.0 , unsampled = False )

使用给定的magnification对这个图像的数据进行归一化、重新缩放和颜色映射，以便使用 renderer进行渲染。

如果unsampled为 True，则图像不会被缩放，而是会返回适当的仿射变换。

返回：

图像(M, N, 4) uint8 数组

RGBA 图像，重新采样，除非未采样为 True。

x, y浮动

应该在像素空间中绘制图像的左上角。

反仿射二维

从图像到像素空间的仿射变换。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> , interpolation_stage=<UNSET> ,标签=<UNSET> ,mouseover=<UNSET> ,norm=<UNSET> , path_effects=< UNSET> , picker=<UNSET > , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform=<UNSET> , url= <UNSET> , visible=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	浮点数或二维数组或无
animated	布尔
array	类数组
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
data	未知
figure	Figure
filternorm	布尔
filterrad	正浮动
gid	字符串
in_layout	布尔
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} 或无
interpolation_stage	{'data', 'rgba'} 或无
label	目的
mouseover	布尔
norm	Normalize或 str 或 无
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
resample	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮

set_data ( A )

设置图像数组。

zorder = 0

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

基地：AxesImage

参数：

插值{'nearest', 'bilinear'}，默认值：'nearest'

**kwargs

所有其他关键字参数与AxesImage.

get_extent ( )

将图像范围返回为元组（左、右、下、上）。

make_image ( renderer , magnification = 1.0 , unsampled = False )

使用给定的magnification对这个图像的数据进行归一化、重新缩放和颜色映射，以便使用 renderer进行渲染。

如果unsampled为 True，则图像不会被缩放，而是会返回适当的仿射变换。

返回：

图像(M, N, 4) uint8 数组

RGBA 图像，重新采样，除非未采样为 True。

x, y浮动

应该在像素空间中绘制图像的左上角。

反仿射二维

从图像到像素空间的仿射变换。

鼠标悬停=假

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , extent=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> ,插值阶段=<UNSET> ,标签=<UNSET> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=< UNSET> , picker=<UNSET > , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	浮点数或二维数组或无
animated	布尔
array	未知
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	未知
data	未知
extent	浮点数的 4 元组
figure	Figure
filternorm	未知
filterrad	未知
gid	字符串
in_layout	布尔
interpolation	{'最近的'，'双线性'} 或无
interpolation_stage	{'data', 'rgba'} 或无
label	目的
mouseover	布尔
norm	未知
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
resample	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮

set_array ( * args )

为向后兼容而保留 - 请改用 set_data。

参数：

类似数组

set_cmap ( cmap )

设置亮度数据的颜色图。

参数：

cmapColormap或 str 或 None

set_data ( x , y , A )

设置像素中心的网格和像素值。

参数：

x, y一维数组

形状 (N,) 和 (M,) 的单调数组，分别指定像素中心。

类似数组

(M, N) ndarray 或要进行颜色映射的值的掩码数组，或 (M, N, 3) RGB 数组或 (M, N, 4) RGBA 数组。

set_filternorm ( s )

设置调整大小过滤器是否对权重进行归一化。

请参阅帮助imshow。

参数：

过滤器标准布尔

set_filterrad ( s )

设置仅适用于某些插值方案的调整大小过滤器半径 - 请参阅 imshow 的帮助

参数：

filterrad正浮点数

set_interpolation ( s )

参数：

s {'nearest', 'bilinear'} 或无

如果没有，使用rcParams["image.interpolation"]（默认值：）'antialiased'。

set_norm ( norm )

设置规范化实例。

参数：

normNormalize或 str 或 None

笔记

如果有任何颜色条使用该规范的可映射，设置可映射的规范会将颜色条上的规范、定位器和格式化程序重置为默认值。

类 matplotlib.image。PcolorImage ( ax , x = None , y = None , A = None , * , cmap = None , norm = None , ** kwargs )

基地：AxesImage

使用不规则的矩形网格制作 pcolor 样式的绘图。

这使用了原始不规则图像代码的变体，pcolorfast 将其用于相应的网格类型。

参数：

斧头Axes

图像所属的轴。

x, y一维数组，可选

长度分别为 N+1 和 M+1 的单调数组，指定矩形边界。如果没有给出，将分别默认为 和。range(N + 1)range(M + 1)

类似数组

要进行颜色编码的数据。解释取决于形状：

• (M, N) ndarray 或掩码数组：要进行颜色映射的值

• (M, N, 3)：RGB 数组

• (M, N, 4)：RGBA 数组

cmap str 或Colormap，默认值：（rcParams["image.cmap"]默认值'viridis'：）

用于将标量数据映射到颜色的颜色图实例或注册的颜色图名称。

规范str 或Normalize

将亮度映射到 0-1。

**kwargsArtist属性

get_cursor_data (事件)

返回事件位置的图像值，如果事件在图像之外，则返回None。

也可以看看

matplotlib.artist.Artist.get_cursor_data

make_image ( renderer , magnification = 1.0 , unsampled = False )

使用给定的magnification对这个图像的数据进行归一化、重新缩放和颜色映射，以便使用 renderer进行渲染。

如果unsampled为 True，则图像不会被缩放，而是会返回适当的仿射变换。

返回：

图像(M, N, 4) uint8 数组

RGBA 图像，重新采样，除非未采样为 True。

x, y浮动

应该在像素空间中绘制图像的左上角。

反仿射二维

从图像到像素空间的仿射变换。

设置( * , agg_filter=<UNSET> , alpha=<UNSET> , animated=<UNSET> , array=<UNSET> , clim=<UNSET> , clip_box=<UNSET> , clip_on=<UNSET> , clip_path=<UNSET > , cmap=<UNSET> , data=<UNSET> , extent=<UNSET> , filternorm=<UNSET> , filterrad=<UNSET> , gid=<UNSET> , in_layout=<UNSET> , interpolation=<UNSET> ,插值阶段=<UNSET> ,标签=<UNSET> ,mouseover=<UNSET> , norm=<UNSET> , path_effects=< UNSET> , picker=<UNSET > , rasterized=<UNSET> , resample=<UNSET> , sketch_params=<UNSET> , snap=<UNSET> , transform= <UNSET> , url=<UNSET> , visible=<UNSET> , zorder=<UNSET> )

一次设置多个属性。

支持的属性是

财产	描述
agg_filter	一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量
alpha	浮点数或二维数组或无
animated	布尔
array	未知
clim	（vmin：浮动，vmax：浮动）
clip_box	Bbox
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap或 str 或 无
data	未知
extent	浮点数的 4 元组
figure	Figure
filternorm	布尔
filterrad	正浮动
gid	字符串
in_layout	布尔
interpolation	{'antialiased', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', ' gaussian'、'bessel'、'mitchell'、'sinc'、'lanczos'、'none'} 或无
interpolation_stage	{'data', 'rgba'} 或无
label	目的
mouseover	布尔
norm	Normalize或 str 或 无
path_effects	AbstractPathEffect
picker	None 或 bool 或 float 或可调用
rasterized	布尔
resample	布尔或无
sketch_params	（比例：浮动，长度：浮动，随机性：浮动）
snap	布尔或无
transform	Transform
url	字符串
visible	布尔
zorder	漂浮

set_array ( * args )

为向后兼容而保留 - 请改用 set_data。

参数：

类似数组

set_data ( x , y , A )

设置矩形边界的网格和数据值。

参数：

x, y一维数组，可选

长度分别为 N+1 和 M+1 的单调数组，指定矩形边界。如果没有给出，将分别默认为 和。range(N + 1)range(M + 1)

类似数组

要进行颜色编码的数据。解释取决于形状：

• (M, N) ndarray 或掩码数组：要进行颜色映射的值

• (M, N, 3)：RGB 数组

• (M, N, 4)：RGBA 数组

matplotlib.image。composite_images ( images , renderer , magnification = 1.0 )

将多个 RGBA 图像合成为一个。图像按照它们在图像列表中出现的顺序进行合成。

参数：

图片 图片列表

每个人都必须有一个make_image方法。对于每个图像， can_composite应该返回True，尽管此函数不强制执行此操作。每个图像都必须有一个没有剪切的纯仿射变换。

渲染器RendererBase

放大倍数浮动，默认：1

为正在使用的渲染器应用的附加放大倍率。

返回：

图像uint8 数组 (M, N, 4)

合成的 RGBA 图像。

offset_x, offset_y浮点数

合成图像应放置在输出图中的（左，下）偏移量。

matplotlib.image。imread ( fname , format = None )

将文件中的图像读入数组。

笔记

由于历史原因而存在此功能。建议使用PIL.Image.open而不是加载图像。

参数：

fname str 或类似文件

要读取的图像文件：以读取二进制模式打开的文件名、URL 或类似文件的对象。

不推荐使用传递 URL。请打开 URL 进行阅读并将结果传递给 Pillow，例如使用 np.array(PIL.Image.open(urllib.request.urlopen(url))).

格式str，可选

假定用于读取数据的图像文件格式。如果格式设置为“png”，如果fname是路径或带有“.png”扩展名的打开文件，或者它是 URL，则图像将作为 PNG 文件加载。在所有其他情况下，格式将被忽略，格式由 自动检测 PIL.Image.open。

返回：

numpy.array

图像数据。返回的数组具有形状

• (M, N) 用于灰度图像。

• (M, N, 3) 用于 RGB 图像。

• (M, N, 4) 用于 RGBA 图像。

PNG 图像以浮点数组 (0-1) 的形式返回。所有其他格式都作为 int 数组返回，位深由文件的内容决定。

matplotlib.image。imsave ( fname , arr , vmin = None , vmax = None , cmap = None , format = None , origin = None , dpi = 100 , * , metadata = None , pil_kwargs = None )

将数组保存为图像文件。

参数：

fname str 或 path-like 或 file-like

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

arr类数组

图像数据。形状可以是 MxN（亮度）、MxNx3（RGB）或 MxNx4（RGBA）之一。

vmin, vmax浮点数，可选

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

cmap str 或Colormap，默认值：（rcParams["image.cmap"]默认值'viridis'：）

颜色图实例或注册的颜色图名称。颜色图将标量数据映射到颜色。对于 RGB(A) 数据，它会被忽略。

格式str，可选

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

原点{'upper', 'lower'}，默认值：（rcParams["image.origin"]默认值'upper'：）

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

dpi浮点数

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

元数据字典，可选

图像文件中的元数据。支持的键取决于输出格式，有关更多信息，请参阅相应后端的文档。

pil_kwargs字典，可选

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

matplotlib.image。pil_to_array ( pilImage )

加载PIL 图像并将其作为 numpy int 数组返回。

返回：

numpy.array

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

• (M, N) 用于灰度图像。

• (M, N, 3) 用于 RGB 图像。

• (M, N, 4) 用于 RGBA 图像。

matplotlib.image。thumbnail ( infile , thumbfile , scale = 0.1 , interpolation = 'bilinear' , preview = False )

使用输出文件名thumbfile在infile中制作图像的缩略图。

请参阅图像缩略图。

参数：

infile str 或类似文件

图像文件。Matplotlib 依赖Pillow进行图像读取，因此支持多种文件格式，包括 PNG、JPG、TIFF 等。

thumbfile str 或类似文件

缩略图文件名。

缩放浮动，默认：0.1

缩略图的比例因子。

插值str，默认值：'双线性'

重采样中使用的插值方案。有关可能的值，请参见 的 插值参数imshow。

预览布尔值，默认值：False

show如果为 True，则将使用默认后端（可能是用户界面后端），如果被调用，将导致一个数字被提升 。如果为 False，则使用创建图形并像通常那样FigureCanvasBase选择绘图后端。Figure.savefig

返回：

Figure

包含缩略图的图窗实例。