matplotlib.axes.Axes.hist2d#

Axes.hist2d(x, y, bins=10, *, range=None, density=False, weights=None, cmin=None, cmax=None, data=None, **kwargs)[源代码]#

绘制 2D 直方图。

参数:

x, y类数组, 形状 (n, )

输入值

binsNone 或 int 或 [int, int] 或类数组或 [array, array]

分箱规范

如果为 int，表示两个维度的分箱数量 (nx = ny = bins)。
如果为 [int, int]，表示每个维度的分箱数量 (nx, ny = bins)。
如果为类数组，表示两个维度的分箱边缘 (x_edges = y_edges = bins)。
如果为 [array, array]，表示每个维度的分箱边缘 (x_edges, y_edges = bins)。

默认值为 10。

range类数组形状(2, 2), 可选

沿每个维度的分箱最左边和最右边边缘（如果未在 bins 参数中明确指定）：[[xmin, xmax], [ymin, ymax]]。所有超出此范围的值都将被视为异常值，并且不会在直方图中进行计数。

density布尔值, 默认: False

归一化直方图。有关 hist 的 density 参数的更多详细信息，请参阅其文档。

weights类数组, 形状 (n, ), 可选

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

cmin, cmax浮点数, 默认: None

所有计数小于 cmin 或大于 cmax 的分箱将不显示（在传递给 pcolormesh 之前设置为 NaN），并且返回的计数直方图中的这些计数值也将设置为 NaN。

返回:

h二维数组: 样本 x 和 y 的二维直方图。x 中的值沿第一维进行直方图处理，y 中的值沿第二维进行直方图处理。
xedges一维数组: 沿 x 轴的分箱边缘。
yedges一维数组: 沿 y 轴的分箱边缘。
imageQuadMesh

其他参数:

cmap字符串或 Colormap, 默认: rcParams["image.cmap"] (默认: 'viridis')

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

norm字符串或 Normalize, 可选

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

如果给定，可以是以下之一

一个 Normalize 实例或其子类（参见颜色图归一化）。
一个比例名称，即“linear”、“log”、“symlog”、“logit”等之一。有关可用比例的列表，请调用 matplotlib.scale.get_scale_names()。在这种情况下，将动态生成并实例化一个合适的 Normalize 子类。

vmin, vmax浮点型，可选

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

colorizerColorizer 或 None, 默认: None