matplotlib.axes.Axes.hist2d#
- Axes.hist2d(x, y, bins=10, *, range=None, density=False, weights=None, cmin=None, cmax=None, data=None, **kwargs)[源代码][源代码]#
制作一个二维直方图。
- 参数:
- x, y类数组,形状 (n, )
输入值
- binsNone 或 int 或 [int, int] 或 array-like 或 [array, array]
bin 规范:
如果为整数,则为两个维度的箱数(
nx = ny = bins
)。如果
[int, int]
,每个维度中的箱数(nx, ny = bins
)。如果类似数组,则为两个维度的 bin 边缘(
x_edges = y_edges = bins
)。如果
[array, array]
,则每个维度中的 bin 边缘(x_edges, y_edges = bins
)。
默认值为 10。
- 范围类数组形状 (2, 2),可选
每个维度上箱子的最左和最右边缘(如果未在bins参数中明确指定):
[[xmin, xmax], [ymin, ymax]]
。此范围之外的所有值将被视为异常值,并且不会计入直方图中。- 密度bool, 默认值: False
归一化直方图。更多详情请参阅
hist
的 density 参数文档。- 权重类数组,形状 (n, ),可选
一个权重值 w_i 的数组,用于加权每个样本 (x_i, y_i)。
- cmin, cmax浮点数, 默认值: None
所有计数小于 cmin 或大于 cmax 的箱子将不会被显示(在传递给
pcolormesh
之前设置为 NaN),并且在返回值计数直方图中,这些计数值在返回时也将被设置为 nan。
- 返回:
- 其他参数:
- cmap : str 或
Colormap
,默认值:rcParams["image.cmap"]
(default:'viridis'
)str 或 用于将标量数据映射为颜色的 Colormap 实例或已注册的 colormap 名称。
- norm : str 或
Normalize
,可选str 或 在将标量数据映射到颜色之前,用于将标量数据缩放到 [0, 1] 范围的归一化方法。默认情况下,使用线性缩放,将最低值映射到 0,最高值映射到 1。
如果提供,这可以是以下之一:
一个刻度名称,即“linear”、“log”、“symlog”、“logit”等之一。要获取可用刻度列表,请调用
matplotlib.scale.get_scale_names()
。在这种情况下,会动态生成并实例化一个合适的Normalize
子类。
- vmin, vmax浮点数, 可选
在使用标量数据且未明确指定 norm 时,vmin 和 vmax 定义了颜色映射覆盖的数据范围。默认情况下,颜色映射覆盖所提供数据的完整值范围。当给定 norm 实例时,使用 vmin/vmax 是错误的(但使用
str
norm 名称与 vmin/vmax 一起是可以接受的)。- alpha :
0 <= 标量 <= 1
或None
,可选0 <= 标量 <= 1 或 None,可选 阿尔法混合值。
- 数据可索引对象,可选
如果给出,以下参数也接受一个字符串
s
,如果s
是data
中的一个键,则解释为data[s]
:x, y, weights
- **kwargs
附加参数会传递给
pcolormesh
方法和QuadMesh
构造函数。
- cmap : str 或
注释
目前
hist2d
会计算自己的轴限制,之前设置的任何限制都会被忽略。通过将
colors.LogNorm
实例传递给 norm 关键字参数,可以实现对直方图使用对数颜色标度。同样,幂律归一化(效果类似于伽马校正)可以通过colors.PowerNorm
实现。