matplotlib.axes.Axes.pcolorfast#

Axes.pcolorfast(*args, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, colorizer=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) 定义一个均匀矩形网格。

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

  • 使用 1D 数组 X、Y 指定一个非均匀矩形网格。

    在这种情况下，X 和 Y 必须是长度分别为 N+1 和 M+1 的单调 1D 数组，指定单元格的 x 和 y 边界。

    速度居中。注意：网格会被检查，如果发现是均匀的，则使用快速版本。

  • 如果您需要一个任意四边形网格（即如果四边形不是矩形），则使用 2D 数组 X、Y。

    在这种情况下，X 和 Y 是形状为 (M + 1, N + 1) 的 2D 数组，指定彩色四边形角点的 x 和 y 坐标。

    这是最通用但渲染最慢的版本。但是，它在使用 ps、pdf 和 svg 后端时可能会生成更快、更紧凑的输出。

这些参数只能按位置传递。

cmap字符串或 Colormap，默认值：rcParams["image.cmap"] (默认值: 'viridis')

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

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

norm字符串或 Normalize，可选

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

如果给定，可以是以下之一

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

vmin, vmax浮点型，可选

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

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

colorizerColorizer 或 None，默认值：None

用于将颜色映射到数据的 Colorizer 对象。如果为 None，则从 norm 和 cmap 创建一个 Colorizer 对象。

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

alpha浮点数，默认值: None

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

snap布尔型，默认值: False

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

返回:
AxesImage 或 PcolorImage 或 QuadMesh

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

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

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

**kwargs

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

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

pcolor 图像

pcolor 图像
在此页