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):具有标量数据的图像。使用规格化和颜色映射将值映射到颜色。请参见参数 norm , cmap , vmin , vmax .
- (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)数据忽略此参数。
- norm :
Normalize
可选正常化,可选 这个
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可选浮动
使用标量数据时,没有显式 norm , vmin 和 vmax 定义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
.
返回: 其他参数: 参见
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
)