matplotlib.pyplot.imshow#

matplotlib.pyplot.imshow(X, cmap=None, norm=None, *, aspect=None, interpolation=None, alpha=None, vmin=None, vmax=None, colorizer=None, origin=None, extent=None, interpolation_stage=None, filternorm=True, filterrad=4.0, resample=None, url=None, data=None, **kwargs)[源]#

将数据显示为图像，即在 2D 规则栅格上。

输入可以是实际的 RGB(A) 数据，也可以是二维标量数据，后者将作为伪彩色图像渲染。要显示灰度图像，请使用参数 cmap='gray', vmin=0, vmax=255 设置颜色映射。

用于渲染图像的像素数量由轴（Axes）大小和图形的 dpi（每英寸点数）设置。当图像被重新采样时，这可能导致锯齿伪影，因为显示的图像大小通常与 X 的大小不匹配（参见图像重采样）。重采样可以通过 interpolation 参数和/或 rcParams["image.interpolation"] (默认值：'auto') 来控制。

参数:

X类数组或 PIL 图像

图像数据。支持的数组形状有

(M, N)：包含标量数据的图像。这些值使用归一化和颜色映射映射到颜色。请参阅参数 norm、cmap、vmin、vmax。
(M, N, 3)：带有 RGB 值（0-1 浮点或 0-255 整数）的图像。
(M, N, 4)：带有 RGBA 值（0-1 浮点或 0-255 整数）的图像，即包含透明度。

前两个维度 (M, N) 定义图像的行和列。

超出范围的 RGB(A) 值将被裁剪。

cmap字符串或 Colormap，默认值：rcParams["image.cmap"] (默认值：'viridis')

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

如果 X 是 RGB(A)，则此参数将被忽略。

norm字符串或 Normalize，可选

在采用 cmap 映射颜色之前，用于将标量数据缩放到 [0, 1] 范围的归一化方法。默认情况下，使用线性缩放，将最低值映射到 0，最高值映射到 1。

如果给定，可以是以下之一

一个 Normalize 实例或其子类之一（参见颜色映射归一化）。
比例名称，例如“linear”、“log”、“symlog”、“logit”等。有关可用比例的列表，请调用 matplotlib.scale.get_scale_names()。在这种情况下，将动态生成并实例化一个合适的 Normalize 子类。

如果 X 是 RGB(A)，则此参数将被忽略。

vmin, vmax浮点型，可选

当使用标量数据且没有明确的 norm 时，vmin 和 vmax 定义了颜色映射覆盖的数据范围。默认情况下，颜色映射覆盖所提供数据的完整值范围。在给定 norm 实例时使用 vmin/vmax 是错误的（但将 str norm 名称与 vmin/vmax 一起使用是可以接受的）。

如果 X 是 RGB(A)，则此参数将被忽略。

colorizerColorizer 或 None，默认值：None

用于将颜色映射到数据的 Colorizer 对象。如果为 None，则从 norm 和 cmap 创建一个 Colorizer 对象。

如果 X 是 RGB(A)，则此参数将被忽略。

aspect{'equal', 'auto'} 或 float 或 None，默认值：None

Axes 的纵横比。此参数对于图像尤为重要，因为它决定了数据像素是否为正方形。

此参数是明确调用 Axes.set_aspect 的快捷方式。更多详细信息请参阅该处。

‘equal’：确保宽高比为 1。像素将是正方形的（除非使用 extent 在数据坐标中明确将像素大小设置为非正方形）。
'auto'：Axes 保持固定，纵横比会调整，以便数据适合 Axes。通常，这将导致非正方形像素。

通常，None（默认值）意味着使用 rcParams["image.aspect"] (默认值：'equal')。然而，如果图像使用的变换不包含轴数据变换，则 None 意味着完全不修改轴的宽高比（在这种情况下，如果需要，直接调用 Axes.set_aspect）。

interpolation字符串，默认值：rcParams["image.interpolation"] (默认值：'auto')

使用的插值方法。

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

数据 X 使用插值方法被重采样到图形画布上图像的像素大小，以对数据进行放大或缩小采样。

如果 interpolation 为 'none'，则对于 ps、pdf 和 svg 后端，不会发生降采样或升采样，并且图像数据作为原生图像传递给后端。请注意，不同的 ps、pdf 和 svg 查看器可能会以不同的方式显示这些原始像素。在其他后端上，'none' 与 'nearest' 相同。

如果 interpolation 是默认的 'auto'，那么当图像放大采样超过三倍时（即显示像素的数量至少是数据数组大小的三倍），将使用 'nearest' 插值。如果放大采样率小于 3，或者图像被降采样，则使用 'hanning' 插值作为抗锯齿滤波器，除非图像恰好被放大采样两倍或一倍。

有关支持的插值方法的概述，请参见 imshow 的插值方法，有关图像抗锯齿的讨论，请参见图像重采样。

一些插值方法需要一个额外的半径参数，可以通过 filterrad 设置。此外，抗锯齿图像大小调整滤镜由参数 filternorm 控制。

interpolation_stage{'auto', 'data', 'rgba'}，默认值：'auto'