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

归一化直方图。更多详情请参阅 histdensity 参数文档。

权重类数组,形状 (n, ),可选

一个权重值 w_i 的数组,用于加权每个样本 (x_i, y_i)。

cmin, cmax浮点数, 默认值: None

所有计数小于 cmin 或大于 cmax 的箱子将不会被显示(在传递给 pcolormesh 之前设置为 NaN),并且在返回值计数直方图中,这些计数值在返回时也将被设置为 nan。

返回:
h二维数组

样本 x 和 y 的二维直方图。x 中的值沿第一个维度进行直方图统计,y 中的值沿第二个维度进行直方图统计。

xedges一维数组

沿 x 轴的 bin 边缘。

yedges一维数组

沿 y 轴的 bin 边缘。

图像 : QuadMeshQuadMesh
其他参数:
cmap : str 或 Colormap,默认值: rcParams["image.cmap"] (default: 'viridis')str 或

用于将标量数据映射为颜色的 Colormap 实例或已注册的 colormap 名称。

norm : str 或 Normalize,可选str 或

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

如果提供,这可以是以下之一:

vmin, vmax浮点数, 可选

在使用标量数据且未明确指定 norm 时,vminvmax 定义了颜色映射覆盖的数据范围。默认情况下,颜色映射覆盖所提供数据的完整值范围。当给定 norm 实例时,使用 vmin/vmax 是错误的(但使用 str norm 名称与 vmin/vmax 一起是可以接受的)。

alpha : 0 <= 标量 <= 1None,可选0 <= 标量 <= 1 或 None,可选

阿尔法混合值。

数据可索引对象,可选

如果给出,以下参数也接受一个字符串 s,如果 sdata 中的一个键,则解释为 data[s]

x, y, weights

**kwargs

附加参数会传递给 pcolormesh 方法和 QuadMesh 构造函数。

参见

hist

一维直方图绘制

hexbin

带有六边形分箱的二维直方图

注释

  • 目前 hist2d 会计算自己的轴限制,之前设置的任何限制都会被忽略。

  • 通过将 colors.LogNorm 实例传递给 norm 关键字参数,可以实现对直方图使用对数颜色标度。同样,幂律归一化(效果类似于伽马校正)可以通过 colors.PowerNorm 实现。

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

直方图

Histograms

探索归一化

Exploring normalizations

hist2d(x, y)

hist2d(x, y)