matplotlib.axes.Axes.pcolorfast #
- 轴。pcolorfast ( * args , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs ) [来源] #
使用非常规矩形网格创建伪彩色图。
来电签名:
ax.pcolorfast([X, Y], C, /, **kwargs)
此方法类似于
pcolor
和pcolormesh
。它旨在通过 Agg 后端提供最快的 pcolor 类型绘图。为了实现这一点,它在内部使用不同的算法,具体取决于输入网格的复杂性(规则矩形、非常规矩形或任意四边形)。- 参数:
- 类C数组
图像数据。支持的数组形状是:
(M, N):具有标量数据的图像。颜色映射由cmap、norm、vmin和vmax控制。
(M, N, 3):具有 RGB 值(0-1 float 或 0-255 int)的图像。
(M, N, 4):具有 RGBA 值(0-1 float 或 0-255 int)的图像,即包括透明度。
前两个维度 (M, N) 定义图像的行和列。
此参数只能按位置传递。
- X, Y元组或类似数组,默认值:,
(0, N)
(0, M)
X和Y用于指定四边形的坐标。有不同的方法可以做到这一点:
使用元组和定义一个统一的矩形网格。
X=(xmin, xmax)
Y=(ymin, ymax)
元组定义了网格的外边缘。所有单独的四边形将具有相同的大小。这是最快的版本。
使用一维数组X,Y指定非均匀矩形网格。
在这种情况下, X和Y必须是长度为 N+1和M+1的单调一维数组,指定单元的 x 和 y 边界。
速度中等。注意:检查网格,如果发现是统一的,则使用快速版本。
如果您需要任意四边形网格(即,如果四边形不是矩形) ,请使用二维数组X、Y 。
在这种情况下, X和Y是形状为 (M + 1, N + 1) 的二维数组,指定彩色四边形角的 x 和 y 坐标。
这是最通用的,但渲染速度最慢。但是,它可以使用 ps、pdf 和 svg 后端生成更快、更紧凑的输出。
这些参数只能按位置传递。
- cmap str 或
Colormap
,默认值:(rcParams["image.cmap"]
默认值'viridis'
:) 用于将标量数据映射到颜色的颜色图实例或注册的颜色图名称。
如果C为 RGB(A),则忽略此参数。
- 范数str 或
Normalize
, 可选 在使用cmap映射到颜色之前,用于将标量数据缩放到 [0, 1] 范围的标准化方法。默认情况下,使用线性缩放,将最小值映射到 0,将最大值映射到 1。
如果给出,这可以是以下之一:
一个实例
Normalize
或其子类之一(请参阅Colormap Normalization)。刻度名称,即“linear”、“log”、“symlog”、“logit”等之一。有关可用刻度的列表,请调用
matplotlib.scale.get_scale_names()
。Normalize
在这种情况下,会动态生成并实例化一个合适的子类。
如果C为 RGB(A),则忽略此参数。
- vmin, vmax浮点数,可选
当使用标量数据且没有明确的norm时,vmin和vmax定义颜色图覆盖的数据范围。默认情况下,颜色图覆盖所提供数据的完整值范围。给定范数实例时使用vmin / vmax是错误的 (但可以接受将范数 名称与vmin / vmax一起使用)。
str
如果C为 RGB(A),则忽略此参数。
- alpha浮点数,默认值:无
Alpha 混合值,介于 0(透明)和 1(不透明)之间。
- snap bool,默认值:False
是否将网格捕捉到像素边界。
- 返回:
AxesImage
或PcolorImage
或QuadMesh
返回类型取决于网格的类型:
AxesImage
对于一个规则的矩形网格。PcolorImage
对于不规则的矩形网格。QuadMesh
对于非矩形网格。
- 其他参数:
- 数据可索引对象,可选
如果给定,所有参数也接受一个字符串
s
,它被解释为data[s]
(除非这引发异常)。- **kwargs
支持的附加参数取决于网格的类型。有关进一步说明,请参阅图像的返回类型。