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)

此方法类似于pcolorpcolormesh。它旨在通过 Agg 后端提供最快的 pcolor 类型绘图。为了实现这一点,它在内部使用不同的算法,具体取决于输入网格的复杂性(规则矩形、非常规矩形或任意四边形)。

警告

这种方法是实验性的。相比pcoloror pcolormesh它有一些限制:

  • 它仅支持平面阴影(无轮廓)

  • 它不支持轴的对数缩放。

  • 它没有 pyplot 包装器。

参数
类C数组

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

  • (M, N):具有标量数据的图像。颜色映射由cmapnormvminvmax控制。

  • (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)

XY用于指定四边形的坐标。有不同的方法可以做到这一点:

  • 使用元组和定义一个统一的矩形网格X=(xmin, xmax)Y=(ymin, ymax)

    元组定义了网格的外边缘。所有单独的四边形将具有相同的大小。这是最快的版本。

  • 使用一维数组XY指定非均匀矩形网格

    在这种情况下, XY必须是长度为 N+1M+1的单调一维数组,指定单元的 x 和 y 边界。

    速度中等。注意:检查网格,如果发现是统一的,则使用快速版本。

  • 如果您需要任意四边形网格(即,如果四边形不是矩形) ,请使用二维数组XY 。

    在这种情况下, XY是形状为 (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。

如果给出,这可以是以下之一:

如果C为 RGB(A),则忽略此参数。

vmin, vmax浮点数,可选

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

如果C为 RGB(A),则忽略此参数。

alpha浮点数,默认值:无

Alpha 混合值,介于 0(透明)和 1(不透明)之间。

snap bool,默认值:False

是否将网格捕捉到像素边界。

返回
AxesImagePcolorImageQuadMesh

返回类型取决于网格的类型:

其他参数
数据可索引对象,可选

如果给定,所有参数也接受一个字符串s,它被解释为data[s](除非这引发异常)。

**kwargs

支持的附加参数取决于网格的类型。有关进一步说明,请参阅图像的返回类型。

使用#的示例matplotlib.axes.Axes.pcolorfast

Pcolor 演示

Pcolor 演示

Pcolor 演示