matplotlib.image

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

class 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 的图像。

参数:

axAxes

图像将属于的坐标轴。

cmap : str 或 Colormap，默认值: rcParams["image.cmap"] (default: 'viridis')str 或

用于将标量数据映射为颜色的 Colormap 实例或已注册的 colormap 名称。

norm : str 或 Normalizestr 或

将亮度映射到0-1。

插值 : str, 默认值: rcParams["image.interpolation"] (default: 'auto')str, 默认值:

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

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

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

origin : {'upper', 'lower'}, 默认值: rcParams["image.origin"] (default: 'upper'){'upper', 'lower'}, 默认:

将数组的 [0, 0] 索引放置在 Axes 的左上角或左下角。通常，对于矩阵和图像，使用 'upper' 约定。

范围tuple, 可选

用于与数据图一起制作图像图的数据轴（左、右、底、顶）。默认情况下，使用基于零的行和列索引来标记像素中心。

filternormbool, 默认: True

用于抗锯齿图像缩放滤镜的参数（参见抗锯齿文档）。如果设置了 filternorm，滤镜会规范化整数值并修正舍入误差。它不会对源浮点值做任何处理，只会根据1.0的规则修正整数，这意味着任何像素权重的总和必须等于1.0。因此，滤镜函数必须生成适当形状的图表。

filterradfloat > 0, 默认值: 4

对于具有半径参数的滤波器，即当插值是以下之一时：'sinc'、'lanczos' 或 'blackman'，滤波器半径。

重采样bool, 默认值: False

当为 True 时，使用完整的重采样方法。当为 False 时，仅在输出图像大于输入图像时进行重采样。

**kwargs : Artist 属性艺术家属性

参数:

norm : Normalize (或其子类) 或 str 或 NoneNormalize（或其子类）或 str 或 None

用于缩放数据的规范化对象，通常将其缩放到区间 [0, 1]。如果是一个 str，则会根据相应名称动态生成一个 Normalize 子类。如果为 None，norm 默认使用一个 colors.Normalize 对象，该对象根据处理的第一批数据初始化其缩放。

cmap : str 或 Colormapstr 或

用于将归一化数据值映射到 RGBA 颜色的颜色映射。

get_cursor_data(event)

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

参见

matplotlib.artist.Artist.get_cursor_data

get_extent()

返回图像范围作为元组 (左, 右, 底, 顶)。

get_window_extent(renderer=None)

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

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

子类应重写以包含在边界框“紧密”计算中。默认是返回位于0, 0的空边界框。

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

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

使用 渲染器 对图像数据进行归一化、重缩放和颜色映射，以进行渲染，并使用给定的 放大倍数。

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

返回:

图像 : (M, N, 4) numpy.uint8 数组(M, N, 4) numpy.uint8 array

RGBA 图像，除非 unsampled 为 True，否则会进行重采样。

x, y浮动

图像应绘制的左上角位置，以像素为单位。

transAffine2D

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

set(*, 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>, interpolation_stage=<UNSET>, label=<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: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
data	类似数组或 PIL.Image.Image
extent	4个浮点数的元组
figure	Figure 或 SubFigure
filternorm	布尔
filterrad	正浮点数
gid	str
in_layout	布尔
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} 或 None
interpolation_stage	{'数据', 'rgba', '自动'} 或 None
标签	对象
鼠标悬停	布尔
norm	Normalize 或 str 或 None
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
resample	布尔值或无
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

set_extent(extent, **kwargs)

设置图像范围。

参数:

范围4个浮点数的元组

图像的位置和大小，以数据坐标中的元组 (左, 右, 底, 顶) 表示。

**kwargs

其他参数，如果存在，将从其中应用单位信息（即 xunits、yunits、zunits*（用于 3D 轴）、*runits 和 *thetaunits*（用于极坐标轴）条目）。

注释

这将更新 Axes.dataLim，并且，如果启用了自动缩放，则将 Axes.viewLim 设置为紧密适应图像，无论 dataLim 如何。自动缩放状态不会改变，因此后续调用 Axes.autoscale_view 将根据 dataLim 重新进行自动缩放。

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

基类：_ImageBase

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

cmap 是一个 colors.Colormap 实例，norm 是一个 colors.Normalize 实例，用于将亮度映射到 0-1。

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

contains(mouseevent)

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

get_window_extent(renderer=None)

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

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

子类应重写以包含在边界框“紧密”计算中。默认是返回位于0, 0的空边界框。

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

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

使用 渲染器 对图像数据进行归一化、重缩放和颜色映射，以进行渲染，并使用给定的 放大倍数。

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

返回:

图像 : (M, N, 4) numpy.uint8 数组(M, N, 4) numpy.uint8 array

RGBA 图像，除非 unsampled 为 True，否则会进行重采样。

x, y浮动

图像应绘制的左上角位置，以像素为单位。

transAffine2D

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

set(*, 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>, label=<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: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
data	类似数组或 PIL.Image.Image
figure	Figure 或 SubFigure
filternorm	布尔
filterrad	正浮点数
gid	str
in_layout	布尔
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} 或 None
interpolation_stage	{'数据', 'rgba', '自动'} 或 None
标签	对象
鼠标悬停	布尔
norm	Normalize 或 str 或 None
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
resample	布尔值或无
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

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

基类：_ImageBase

附在图中的图像。

cmap 是一个 colors.Colormap 实例，norm 是一个 colors.Normalize 实例，用于将亮度映射到 0-1。

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

get_extent()

返回图像范围作为元组 (左, 右, 底, 顶)。

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

使用 渲染器 对图像数据进行归一化、重缩放和颜色映射，以进行渲染，并使用给定的 放大倍数。

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

返回:

图像 : (M, N, 4) numpy.uint8 数组(M, N, 4) numpy.uint8 array

RGBA 图像，除非 unsampled 为 True，否则会进行重采样。

x, y浮动

图像应绘制的左上角位置，以像素为单位。

transAffine2D

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

set(*, 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>, label=<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: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
数据	未知
figure	Figure 或 SubFigure
filternorm	布尔
filterrad	正浮点数
gid	str
in_layout	布尔
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} 或 None
interpolation_stage	{'数据', 'rgba', '自动'} 或 None
标签	对象
鼠标悬停	布尔
norm	Normalize 或 str 或 None
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
resample	布尔值或无
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

set_data(A)

设置图像数组。

zorder = 0

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

基类：AxesImage

参数:

axAxes

图像将属于的坐标轴。

插值{'nearest', 'bilinear'}, 默认: 'nearest'

重采样中使用的插值方案。

**kwargs

所有其他关键字参数与 AxesImage 的参数相同。

get_cursor_data(event)

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

参见

matplotlib.artist.Artist.get_cursor_data

get_extent()

返回图像范围作为元组 (左, 右, 底, 顶)。

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

使用 渲染器 对图像数据进行归一化、重缩放和颜色映射，以进行渲染，并使用给定的 放大倍数。

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

返回:

图像 : (M, N, 4) numpy.uint8 数组(M, N, 4) numpy.uint8 array

RGBA 图像，除非 unsampled 为 True，否则会进行重采样。

x, y浮动

图像应绘制的左上角位置，以像素为单位。

transAffine2D

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

set(*, 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>, interpolation_stage=<UNSET>, label=<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: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	未知
数据	未知
extent	4个浮点数的元组
figure	Figure 或 SubFigure
filternorm	未知
filterrad	未知
gid	str
in_layout	布尔
插值	{'nearest', 'bilinear'} 或 None
interpolation_stage	{'数据', 'rgba', '自动'} 或 None
标签	对象
鼠标悬停	布尔
norm	未知
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
resample	布尔值或无
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

set_array(*args)

保留以实现向后兼容性 - 请改用 set_data。

参数:

A类数组

set_cmap(cmap)

设置亮度数据的色图。

参数:

cmap : Colormap 或 str 或 NoneColormap 或 str 或 None

set_data(x, y, A)

设置像素中心的网格，以及像素值。

参数:

x, y1D 数组类

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

A类数组

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

set_filternorm(filternorm)

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

查看 imshow 的帮助。

参数:

filternorm布尔

set_filterrad(filterrad)

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

参数:

filterrad正浮点数

set_interpolation(s)

参数:

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

如果为 None，则使用 rcParams["image.interpolation"] (default: 'auto')。

set_norm(norm)

设置归一化实例。

参数:

norm : Normalize 或 str 或 None标准化或字符串或无

注释

如果存在使用此规范的 mappable 的颜色条，设置 mappable 的规范将重置颜色条的规范、定位器和格式化器为默认值。

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

基类：AxesImage

使用不规则矩形网格制作pcolor风格的图。

这使用了原始不规则图像代码的一个变体，并且它被 pcolorfast 用于相应的网格类型。

参数:

axAxes

图像将属于的坐标轴。

x, y一维数组类，可选

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

A类数组

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

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

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

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

cmap : str 或 Colormap，默认值: rcParams["image.cmap"] (default: 'viridis')str 或

用于将标量数据映射为颜色的 Colormap 实例或已注册的 colormap 名称。

norm : str 或 Normalizestr 或

将亮度映射到0-1。

**kwargs : Artist 属性艺术家属性

get_cursor_data(event)

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

参见

matplotlib.artist.Artist.get_cursor_data

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

使用 渲染器 对图像数据进行归一化、重缩放和颜色映射，以进行渲染，并使用给定的 放大倍数。

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

返回:

图像 : (M, N, 4) numpy.uint8 数组(M, N, 4) numpy.uint8 array

RGBA 图像，除非 unsampled 为 True，否则会进行重采样。

x, y浮动

图像应绘制的左上角位置，以像素为单位。

transAffine2D

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

set(*, 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>, interpolation_stage=<UNSET>, label=<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: float, vmax: float)
clip_box	BboxBase 或 None
clip_on	布尔
clip_path	补丁或（路径，变换）或无
cmap	Colormap 或 str 或 None
数据	未知
extent	4个浮点数的元组
figure	Figure 或 SubFigure
filternorm	布尔
filterrad	正浮点数
gid	str
in_layout	布尔
interpolation	{'auto', 'nearest', 'bilinear', 'bicubic', 'spline16', 'spline36', 'hanning', 'hamming', 'hermite', 'kaiser', 'quadric', 'catrom', 'gaussian', 'bessel', 'mitchell', 'sinc', 'lanczos', 'none'} 或 None
interpolation_stage	{'数据', 'rgba', '自动'} 或 None
标签	对象
鼠标悬停	布尔
norm	Normalize 或 str 或 None
path_effects	AbstractPathEffect 列表
picker	None 或 bool 或 float 或 callable
光栅化	布尔
resample	布尔值或无
sketch_params	(scale: float, length: float, randomness: float)
snap	布尔值或无
transform	Transform
url	str
可见	布尔
zorder	浮动

set_array(*args)

保留以实现向后兼容性 - 请改用 set_data。

参数:

A类数组

set_data(x, y, A)

设置矩形边界的网格，以及数据值。

参数:

x, y一维数组类，可选

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

A类数组

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

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

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

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

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

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

参数:

图片图片列表

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

渲染器 : RendererBaseRendererBase

放大float, 默认值: 1

应用于当前渲染器的额外放大倍数。

返回:

图像 : (M, N, 4) numpy.uint8 数组(M, N, 4) numpy.uint8 array

合成后的 RGBA 图像。

offset_x, offset_y浮动

合成图像应放置在输出图形中的 (左, 底) 偏移位置。

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

从文件中读取图像到数组中。

备注

出于历史原因存在此功能。建议使用 PIL.Image.open 来加载图像。

参数:

fnamestr 或 file-like

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

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

格式str, 可选

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

返回:

numpy.array

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

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

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

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

PNG 图像以浮点数数组（0-1）的形式返回。所有其他格式以整数数组的形式返回，其位深由文件内容决定。

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

颜色映射并将数组保存为图像文件。

RGB(A) 图像会被传递。单通道图像将根据 cmap 和 norm 进行颜色映射。

备注

如果你想将单通道图像保存为灰度图像，请直接使用图像I/O库（如pillow、tifffile或imageio）。

参数:

fnamestr 或 path-like 或 file-like

一个路径或类似文件的对象来存储图像。如果未设置 format，则输出格式由 fname 的扩展名（如果有）推断，否则由 rcParams["savefig.format"] (default: 'png') 决定。如果设置了 format，它将决定输出格式。

arr类数组

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

vmin, vmax浮点数，可选

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

cmap : str 或 Colormap，默认值: rcParams["image.cmap"] (default: 'viridis')str 或

一个 Colormap 实例或已注册的 colormap 名称。colormap 将标量数据映射为颜色。对于 RGB(A) 数据，它将被忽略。

格式str, 可选

文件格式，例如 'png', 'pdf', 'svg', ... 当未设置此项时的行为在 fname 下有文档说明。

origin : {'upper', 'lower'}, 默认值: rcParams["image.origin"] (default: 'upper'){'upper', 'lower'}, 默认:

指示数组的 (0, 0) 索引是否位于 Axes 的左上角或左下角。

dpi浮动

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

元数据字典，可选

图像文件中的元数据。支持的键取决于输出格式，更多信息请参阅相应后端的文档。目前仅支持“png”、“pdf”、“ps”、“eps”和“svg”。

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)

将 infile 中的图像制作成缩略图，并输出为 thumbfile 文件名。

参见 图像缩略图。

参数:

infilestr 或 file-like

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

thumbfilestr 或 file-like

缩略图文件名。

比例浮点数，默认值：0.1

缩略图的比例因子。

插值str, 默认值: 'bilinear'

重采样中使用的插值方案。参见 imshow 的 interpolation 参数以获取可能的值。

预览bool, 默认值: False

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

返回:

Figure

包含缩略图的图形实例。