matplotlib.pyplot.pcolor

matplotlib.pyplot.pcolor(*args, shading=None, alpha=None, norm=None, cmap=None, vmin=None, vmax=None, data=None, **kwargs)[源代码]

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

呼叫签名:

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

XY 可用于指定四边形的角。

提示

pcolor() 对于大型阵列,速度可能非常慢。在大多数情况下,您应该使用类似的,但速度要快得多的 pcolormesh 相反。见 Differences between pcolor() and pcolormesh() 讨论不同之处。

参数:
C类数组

一个标量二维数组。这些值将被颜色映射。

X, Y类似数组,可选

多边形四边形的角点坐标:

(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。有关详细信息,请参见 Notes 下面部分。

如果 shading='flat' 尺寸 XY 应该大于 C ,并且四边形由于 C[i, j] . 如果 XYC 如果维度相等,则会引发警告,并在 C 将被忽略。

如果 shading='nearest' ,尺寸 XY 应与 C (否则,将引发ValueError)。颜色 C[i, j] 将以 (X[i, j], Y[i, j]) .

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

shading{'flat','nearest','auto'},可选

四边形的填充样式;默认为“平面”或 rcParams["pcolor.shading"] (default: 'flat') . 可能值:

  • “平面”:每个四边形都使用纯色。四元(i,j),(i+1,j),(i,j+1),(i+1,j+1)的颜色由下式给出: C[i, j] . 尺寸 XY 应该大于 C ;如果它们与 C ,则会引发一个弃用警告,并且 C 都掉下来了。
  • “最近的”:每个网格点都有一个以其为中心的颜色,在相邻网格中心之间延伸一半。尺寸 XY 必须与相同 C .
  • “自动”:如果尺寸为 XY 一个比一个大吗 C . 如果尺寸相同,请选择“最近”。

pColor网格和着色 更多描述。

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

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

normNormalize 可选正常化,可选

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

VMN,Vmax浮点,默认值:无

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

edgecolors'none',none,'face',color,color sequence,可选

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

单数形式 变色染料 用作别名。

alpha浮点,默认值:无

面颜色的alpha混合值,介于0(透明)和1(不透明)之间。注意:EdgeColor当前不受此影响。

snapbool,默认值:False

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

返回:
matplotlib.collections.Collection
其他参数:
antialiasedsbool,默认值:False

默认值 抗混叠剂 如果默认值为 绿色染料 =使用“无”。这消除了补丁边界处的人工线,并且不管alpha的值如何都可以工作。如果 绿色染料 不是“无”,则为默认值 抗混叠剂 取自 rcParams["patch.antialiased"] (default: True) . 如果 阿尔法 是1,但否则将导致工件。

**kwargs

此外,还允许使用以下参数。它们被传给 PolyCollection 构造函数:

财产 描述
agg_filter 一种过滤函数,它接受一个(m,n,3)浮点数组和一个dpi值,并返回一个(m,n,3)数组。
alpha 浮动或无
animated 布尔
antialiased 或者aa或者抗锯齿药 布尔或布尔列表
array 恩达雷
capstyle “对接”、“圆形”、“突出”
clim (V最小:浮动,V最大:浮动)
clip_box Bbox
clip_on 布尔
clip_path 面片或(路径、变换)或无
cmap Colormap 或str或None
color rgba元组的颜色或列表
contains 未知的
edgecolor 或ec或edgecolors 颜色或颜色列表或“面”
facecolor 或者facecolors或者fc 颜色或颜色列表
figure Figure
gid STR
hatch '/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*'
in_layout 布尔
joinstyle 'miter'、'round'、'bevel'
label 对象
linestyle 或虚线或线型或ls str或tuple或其列表
linewidth 或线宽或lw 浮动或浮动列表
norm Normalize 或无
offset_position 未知的
offsets 类似于(N,2)或(2,)
path_effects AbstractPathEffect
picker 无、布尔或可呼叫
pickradius 未知的
rasterized 布尔或无
sketch_params (比例:浮动,长度:浮动,随机性:浮动)
snap 布尔或无
transform Transform
url STR
urls str或None列表
visible 布尔
zorder 浮动

参见

pcolormesh
以解释pcolor和pcolormesh之间的差异。
imshow
如果 XY 都是等距的, imshow 可能是更快的选择。

笔记

屏蔽阵列

XYC 可能是屏蔽数组。如果任一 C[i, j] 或周围的一个顶点 C[i, j]XY[i, j], [i+1, j], [i, j+1], [i+1, j+1] )被蒙蔽了,什么也没有标出来。

网格方向

网格方向遵循标准矩阵约定:数组 C 使用形状(nrows,ncolumns)绘制,列号为 X 行数为 Y .

注解

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

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