matplotlib.axes.Axes.pcolorfast#

Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, data=None, **kwargs)[源代码][源代码]#

创建一个带有非规则矩形网格的伪彩色图。

调用签名:

ax.pcolorfast([X, Y], C, /, **kwargs)

参数 X, Y, C 是仅位置参数。

此方法类似于 pcolor 和 pcolormesh。它旨在使用 Agg 后端提供最快的 pcolor 类型绘图。为此，它根据输入网格的复杂性（规则矩形、非规则矩形或任意四边形）在内部使用不同的算法。

警告

此方法是实验性的。与 pcolor 或 pcolormesh 相比，它有一些限制：

  • 它仅支持平面着色（无轮廓）

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

  • 它没有 pyplot 包装器。

参数:
C类似数组

图像数据。支持的数组形状包括：

  • (M, N): 一个包含标量数据的图像。颜色映射由 cmap、norm、vmin 和 vmax 控制。

  • (M, N, 3): 一张带有RGB值（0-1浮点数或0-255整数）的图像。

  • (M, N, 4): 一张包含RGBA值（0-1浮点数或0-255整数）的图像，即包括透明度。

前两个维度 (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"] (default: 'viridis')str 或

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

如果 C 是 RGB(A)，则忽略此参数。

norm : str 或 Normalize，可选str 或

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

如果提供，这可以是以下之一：

如果 C 是 RGB(A)，则忽略此参数。

vmin, vmax浮点数, 可选

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

如果 C 是 RGB(A)，则忽略此参数。

alphafloat, 默认: None

阿尔法混合值，介于 0（透明）和 1（不透明）之间。

快照bool, 默认值: False

是否将网格对齐到像素边界。

返回:
AxesImage 或 PcolorImage 或 QuadMesh

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

其他参数:
数据可索引对象，可选

如果给出，所有参数也接受一个字符串 s，如果 s 是 data 中的一个键，则它被解释为 data[s]。

**kwargs

支持的额外参数取决于网格的类型。有关进一步描述，请参阅 image 的返回类型。

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

pcolor 图像

pcolor images
On this page