matplotlib.axes.Axes.pcolor¶
-
Axes.
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
相反。见 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'
尺寸 X 和 Y 应该大于 C ,并且四边形由于C[i, j]
. 如果 X , Y 和 C 如果维度相等,则会引发警告,并在 C 将被忽略。如果
shading='nearest'
,尺寸 X 和 Y 应与 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]
. 尺寸 X 和 Y 应该大于 C ;如果它们与 C ,则会引发一个弃用警告,并且 C 都掉下来了。 - “最近的”:每个网格点都有一个以其为中心的颜色,在相邻网格中心之间延伸一半。尺寸 X 和 Y 必须与相同 C .
- “自动”:如果尺寸为 X 和 Y 一个比一个大吗 C . 如果尺寸相同,请选择“最近”。
见 pColor网格和着色 更多描述。
- “平面”:每个四边形都使用纯色。四元(i,j),(i+1,j),(i,j+1),(i+1,j+1)的颜色由下式给出:
- cmap : str or
Colormap
, default:rcParams["image.cmap"]
(default:'viridis'
)str或 颜色映射实例或注册的颜色映射名称。彩色地图显示 C 值到颜色。
- norm :
Normalize
可选正常化,可选 normalize实例将数据值缩放到标准颜色映射范围。 [0, 1] 用于映射到颜色。默认情况下,使用线性缩放将数据范围映射到颜色条范围。
- VMN,Vmax浮点,默认值:无
颜色条范围。如果 None ,自动选择合适的最小/最大值
Normalize
实例(默认为 C 在默认线性缩放的情况下)。不推荐使用 vmin / vmax 什么时候? norm 给出。- edgecolors'none',none,'face',color,color sequence,可选
边缘的颜色。默认为“无”。可能值:
- “无”或“”:没有边缘。
- None :
rcParams["patch.edgecolor"]
(default:'black'
) 将被使用。注意,目前rcParams["patch.force_edgecolor"]
(default:False
) 必须做到这一点才能奏效。 - “面”:使用相邻的面颜色。
- 颜色或颜色序列将设置边缘颜色。
单数形式 变色染料 用作别名。
- alpha浮点,默认值:无
面颜色的alpha混合值,介于0(透明)和1(不透明)之间。注意:EdgeColor当前不受此影响。
- snapbool,默认值:False
是否将网格捕捉到像素边界。
返回: 其他参数: - 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或Nonecolor
rgba元组的颜色或列表 contains
未知的 edgecolor
或ec或edgecolors颜色或颜色列表或“面” facecolor
或者facecolors或者fc颜色或颜色列表 figure
Figure
gid
STR hatch
'/'、''、''、'-'、'+'、'X'、'O'、'O'、'、'、'*' in_layout
布尔 joinstyle
'miter'、'round'、'bevel' label
对象 linestyle
或虚线或线型或lsstr或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
- 如果 X 和 Y 都是等距的,
imshow
可能是更快的选择。
笔记
屏蔽阵列
X , Y 和 C 可能是屏蔽数组。如果任一
C[i, j]
或周围的一个顶点C[i, j]
( X 或 Y 在[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
)