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)

这种方法类似于 pcolorpcolormesh . 它的目的是提供最快的pcolor类型绘制与agg后端。为了实现这一点,它在内部根据输入网格(规则矩形、非规则矩形或任意四边形)的复杂性使用不同的算法。

警告

这种方法是实验性的。相比于 pcolorpcolormesh 它有一些局限性:

  • 它只支持平面着色(无轮廓)
  • 它不支持轴的日志缩放。
  • 它没有具有Pyplot包装器的。
参数:
C类阵列(m,n)

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

  • (m,n):具有标量数据的图像。使用颜色映射可视化数据。
  • (M,N,3):具有RGB值(0-1浮点或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 指定一个 non-uniform rectangular grid .

    In this case X and Y have to be monotonic 1D arrays of length N+1 and M+1, specifying the x and y boundaries of the cells.

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

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

    In this case X and Y are 2D arrays with shape (M + 1, N + 1), specifying the x and y coordinates of the corners of the colored quadrilaterals.

    这是最一般的,但渲染速度最慢。但是,它可以使用ps、pdf和svg后端生成更快、更紧凑的输出。

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

cmap : str or Colormap, default: rcParams["image.cmap"] (default: 'viridis')str或

颜色映射实例或注册的颜色映射名称。彩色地图显示 C 值到颜色。

normNormalize 可选正常化,可选

normalize实例将数据值缩放到标准颜色映射范围。 [0, 1] 用于映射到颜色。默认情况下,使用线性缩放将数据范围映射到颜色条范围。

VMN,Vmax浮点,默认值:无

颜色条范围。如果 None ,自动选择合适的最小/最大值 Normalize 实例(默认为 C 在默认线性缩放的情况下)。不推荐使用 vmin / vmax 什么时候? norm 给出。

alpha浮点,默认值:无

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

snapbool,默认值:False

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

返回:
AxesImage or PcolorImage or QuadMesh

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

其他参数:
**kwargs

支持的其他参数取决于网格的类型。参见返回类型 形象 进一步说明。

笔记

注解

除了上述参数外,此函数还可以 data 关键字参数。如果这样的话 data 参数,其他每个参数也可以是字符串 s ,解释为 data[s] (除非引起例外)。

作为传递的对象 data 必须支持项目访问 (data[s] )和会员资格测试 (s in data

使用实例 matplotlib.axes.Axes.pcolorfast