matplotlib.axes.Axes.imshow

Axes.imshow(X, cmap=None, norm=None, aspect=None, interpolation=None, alpha=None, vmin=None, vmax=None, origin=None, extent=None, *, filternorm=True, filterrad=4.0, resample=None, url=None, data=None, **kwargs)[源代码]

将数据显示为图像,即在二维常规栅格上。

输入可以是实际RGB(A)数据,也可以是2D标量数据,其将被渲染为伪彩色图像。对于显示灰度图像,请使用参数设置颜色映射 cmap='gray', vmin=0, vmax=255 .

用于渲染图像的像素数由轴大小和 dpi 数字的一部分。这可能会导致图像重采样时出现锯齿伪影,因为显示的图像大小通常与图像大小不匹配 X (见 图像抗锯齿 ). 重采样可以通过 插值 参数和/或 rcParams["image.interpolation"] (default: 'antialiased') .

参数:
X数组或pil图像

图像数据。支持的数组形状为:

  • (M,N):具有标量数据的图像。使用规格化和颜色映射将值映射到颜色。请参见参数 normcmapvminvmax .
  • (M,N,3):具有RGB值(0-1浮点或0-255 int)的图像。
  • (M,N,4):具有RGBA值(0-1 float或0-255 int)的图像,即包括透明度。

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

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

cmap : str or Colormap, default: rcParams["image.cmap"] (default: 'viridis')str或

用于映射ColorName或ColorScalar实例的已注册颜色。RGB(A)数据忽略此参数。

normNormalize 可选正常化,可选

这个 Normalize 用于将标量数据缩放到 [0, 1] 在映射到颜色之前使用 cmap . 默认情况下,使用线性缩放将最小值映射为0,将最大值映射为1。对于RGB(A)数据,忽略此参数。

方面 : {{'equal', 'auto'}} or float, default: rcParams["image.aspect"] (default: 'equal'){equal'、'auto'}或float,默认值:

轴的纵横比。此参数与图像特别相关,因为它确定数据像素是否为正方形。

此参数是显式调用的快捷方式 Axes.set_aspect . 详情请参阅。

  • “相等”:确保纵横比为1。像素将是方形的(除非在数据坐标中使用 程度
  • “自动”:轴保持固定,并且调整方面,以便数据适合轴。通常,这将导致非方形像素。
插值 : str, default: rcParams["image.interpolation"] (default: 'antialiased')str,默认值:

使用的插值方法。

支持的值为“none”、“antialiased”、“nearest”、“双线性”、“bicubic”、“spline16”、“spline36”、“hanning”、“hamming”、“hermite”、“kaiser”、“quadric”、“catrom”、“gaussian”、“bessel”、“mitchell”、“sinc”、“lanczos”。

如果 插值 为“none”,则不对Agg、ps、pdf和svg后端执行插值。其他后端将回落到“最近”。请注意,大多数SVG渲染器在渲染时执行插值,并且它们实现的默认插值方法可能不同。

如果 插值 是默认的“抗锯齿”,则如果图像上采样超过三倍(即显示像素的数量至少是数据数组大小的三倍),则使用“最近”插值。如果上采样率小于3,或者图像被下采样,则“hanning”插值被用作抗混叠滤波器,除非图像恰好被上采样了2倍或1倍。

imshow插值 有关支持的插值方法的概述,以及 图像抗锯齿 关于图像抗锯齿的讨论。

某些插值方法需要一个额外的半径参数,可通过 菲尔特拉德 . 此外,反颗粒图像调整过滤器由参数控制 滤波器范数 .

alpha浮点型或数组型,可选

alpha混合值,介于0(透明)和1(不透明)之间。如果 阿尔法 是一个数组,alpha混合值逐像素应用,并且 阿尔法 形状必须与 X .

VMN,Vmax可选浮动

使用标量数据时,没有显式 normvminvmax 定义colormap覆盖的数据范围。默认情况下,colormap覆盖所提供数据的完整值范围。不推荐使用 vmin / vmax 什么时候? norm 给出。

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

放置 [0, 0] 位于轴左上角或左下角的数组索引。约定(默认值)“upper”通常用于矩阵和图像。

请注意,垂直轴向上指向“下部”,向下指向“上部”。

起源 和 程度 在里面 imshow 教程的例子和更详细的描述。

extent浮动(左、右、下、上),可选

图像将填充的数据坐标中的边界框。图像分别沿X和Y拉伸以填充方框。

默认范围由以下条件确定。像素在数据坐标中具有单位大小。它们的中心位于整数坐标上,中心坐标水平从0到列1,垂直从0到行1。

请注意,垂直轴的方向以及顶部和底部的默认值取决于 起源

  • 为了 origin == 'upper' 默认值为 (-0.5, numcols-0.5, numrows-0.5, -0.5) .
  • 为了 origin == 'lower' 默认值为 (-0.5, numcols-0.5, -0.5, numrows-0.5) .

起源 和 程度 在里面 imshow 教程的例子和更详细的描述。

filternormbool,默认值:True

反颗粒图像调整过滤器的参数(请参阅反颗粒文档)。如果 滤波器范数 设置后,过滤器将整数值规范化并更正舍入错误。它与源浮点值无关,它只根据1.0规则更正整数,这意味着任何像素权重之和必须等于1.0。因此,过滤函数必须生成一个适当形状的图。

filterrad浮点>0,默认值:4.0

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

重采样 : bool, default: rcParams["image.resample"] (default: True)布尔,默认值:

什么时候? True ,请使用完全重新采样方法。什么时候? ,仅当输出图像大于输入图像时重新采样。

url可选的STR

设置创建的 AxesImage . 见 Artist.set_url .

返回:
AxesImage
其他参数:
**kwargsArtist 性质艺术家属性

这些参数将传递给 AxesImage 艺术家。

参见

matshow
将矩阵或数组绘制为图像。

笔记

除非 程度 如果使用,像素中心将位于整数坐标处。换句话说:原点将与像素的中心(0,0)重合。

对于阿尔法通道的RGB图像,有两种常见的表示形式:

  • 直(非关联)alpha:r、g和b通道表示像素的颜色,忽略其不透明度。
  • 预乘(相关)alpha:r、g和b通道表示像素的颜色,通过乘法调整其不透明度。

imshow 期望RGB图像采用直(非关联)阿尔法表示。

注解

除了上述参数外,此函数还可以 data 关键字参数。如果这样的话 data 参数,其他每个参数也可以是字符串 s ,解释为 data[s] (除非引起例外)。

作为传递的对象 data 必须支持项目访问 (data[s] )和会员资格测试 (s in data