matplotlib.axes.Axes.pcolor #

轴。pcolor ( * args , shading = None , alpha = None , norm = None , cmap = None , vmin = None , vmax = None , data = None , ** kwargs ) [来源] #

使用非常规矩形网格创建伪彩色图。

来电签名：

pcolor([X, Y,] C, **kwargs)

X和Y可用于指定四边形的角。

暗示

pcolor()对于大型阵列可能会非常慢。在大多数情况下，您应该使用类似但更快的方法 pcolormesh。有关 差异的讨论，请参阅 pcolor() 和 pcolormesh() 之间的差异。

参数：
C 2D 类数组

颜色映射的值。颜色映射由cmap、 norm、vmin和vmax控制。

X, Y类数组，可选

pcolormesh 的四边形角的坐标：

(X[i+1, j], Y[i+1, j])       (X[i+1, j+1], Y[i+1, j+1])
                      +-----+
                      |     |
                      +-----+
    (X[i, j], Y[i, j])       (X[i, j+1], Y[i, j+1])

请注意，列索引对应于 x 坐标，行​​索引对应于 y。有关详细信息，请参阅下面的 注释部分。

如果X和Yshading='flat'的尺寸应该比C的尺寸大一，并且四边形由于 的值而被着色。如果X，Y和C具有相同的尺寸，则会发出警告，并且C的最后一行和最后一列将被忽略。C[i, j]

如果shading='nearest'，则X和Y的尺寸应该与C的尺寸相同（如果不是，则会引发 ValueError ）。颜色将以 为中心。C[i, j](X[i, j], Y[i, j])

如果X和/或Y是一维数组或列向量，它们将根据需要扩展为适当的二维数组，形成一个矩形网格。

着色{'flat', 'nearest', 'auto'}，默认值：（rcParams["pcolor.shading"]默认值'auto'：）

四边形的填充样式。可能的值：

  • 'flat'：每个四边形使用纯色。四边形 (i, j), (i+1, j), (i, j+1), (i+1, j+1) 的颜色由 给出 。X和Y的尺寸应该比C的尺寸大一；如果它们与C相同，则会引发弃用警告，并删除C的最后一行和最后一列。C[i, j]

  • 'nearest'：每个网格点都会有一个颜色以它为中心，在相邻网格中心之间延伸一半。X和Y的尺寸必须与C相同。

  • 'auto'：如果X和Y的尺寸比C大一，则选择 'flat' 。如果尺寸相同，请选择“最近”。

有关更多描述，请参阅pcolormesh 网格和阴影 。

cmap str 或Colormap，默认值：（rcParams["image.cmap"]默认值'viridis'：）

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

范数str 或Normalize, 可选

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

如果给出，这可以是以下之一：

vmin, vmax浮点数，可选

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

edgecolors {'none', None, 'face', color, color sequence}, 可选

边缘的颜色。默认为“无”。可能的值：

  • “无”或“”：没有优势。

  • 无：（rcParams["patch.edgecolor"]默认值：）'black'将被使用。请注意，当前 rcParams["patch.force_edgecolor"]（默认值False：）必须为 True 才能正常工作。

  • 'face'：使用相邻的面颜色。

  • 颜色或颜色序列将设置边缘颜色。

单数形式edgecolor用作别名。

alpha浮点数，默认值：无

面部颜色的 alpha 混合值，介于 0（透明）和 1（不透明）之间。注意：edgecolor 目前不受此影响。

snap bool，默认值：False

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

返回：
matplotlib.collections.Collection
其他参数：
antialiaseds bool，默认值：False

如果使用默认的edgecolors ="none"，则默认的antialiaseds为 False 。这消除了补丁边界处的人工线，并且无论 alpha 的值如何都可以工作。如果edgecolors不是“none”，则默认抗锯齿 取自（默认值：） 。如果alpha为 1，则可能首选抚摸边缘，否则会导致伪影。rcParams["patch.antialiased"]True

数据可索引对象，可选

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

**kwargs

此外，允许使用以下参数。它们被传递给PolyCollection构造函数：

财产

描述

agg_filter

一个过滤器函数，它接受一个 (m, n, 3) 浮点数组和一个 dpi 值，并返回一个 (m, n, 3) 数组和距图像左下角的两个偏移量

alpha

类数组或标量或无

animated

布尔

antialiased或 aa 或抗锯齿

布尔或布尔列表

array

类数组或无

capstyle

CapStyle或 {'butt', 'projecting', 'round'}

clim

（vmin：浮动，vmax：浮动）

clip_box

Bbox

clip_on

布尔

clip_path

补丁或（路径，变换）或无

cmap

Colormap或 str 或 无

color

rgba 元组的颜色或列表

edgecolor或 ec 或 edgecolors

颜色或颜色列表或“脸”

facecolor或 facecolors 或 fc

颜色或颜色列表

figure

Figure

gid

字符串

hatch

{'/'、'\'、'|'、'-'、'+'、'x'、'o'、'O'、'.'、'*'}

in_layout

布尔

joinstyle

JoinStyle或 {'miter', 'round', 'bevel'}

label

目的

linestyle或破折号或线条样式或 ls

str 或元组或其列表

linewidth或线宽或lw

浮动或浮动列表

mouseover

布尔

norm

Normalize或 str 或 无

offset_transform或 transOffset

未知

offsets

(N, 2) 或 (2,) 类数组

path_effects

AbstractPathEffect

paths

类似数组的列表

picker

None 或 bool 或 float 或可调用

pickradius

未知

rasterized

布尔

sizes

ndarray 或无

sketch_params

（比例：浮动，长度：浮动，随机性：浮动）

snap

布尔或无

transform

Transform

url

字符串

urls

str 或 None 的列表

verts

类似数组的列表

verts_and_codes

未知

visible

布尔

zorder

漂浮

也可以看看

pcolormesh

有关 pcolor 和 pcolormesh 之间差异的解释。

imshow

如果X和Y都是等距的，imshow则可以是更快的选择。

笔记

掩码数组

X、Y和C可以是掩码数组。如果任何一个 或周围（X或Y处 ）的顶点之一被遮盖，则不会绘制任何内容。C[i, j]C[i, j][i, j], [i+1, j], [i, j+1], [i+1, j+1]

网格方向

网格方向遵循标准矩阵约定： 绘制形状为 (nrows, ncolumns) 的数组C ，列号为X，行号为Y。

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

Pcolor 演示

Pcolor 演示

Pcolor 演示
使用边距和sticky_edges 控制视图限制

使用边距和sticky_edges 控制视图限制

使用边距和sticky_edges 控制视图限制