cupy.histogram2d#

cupy.histogram2d(x, y, bins=10, range=None, weights=None, density=None)[源代码]#

计算两个数据样本的二维直方图。

参数：

  • x (cupy.ndarray) – 第一个用于构建直方图的样本数组。

  • y (cupy.ndarray) – 第二个用于构建直方图的样本数组。

  • bins (int 或 tuple of int 或 cupy.ndarray) –

    bin 规格

    • 一个数组序列，描述了沿每个维度单调递增的 bin 边界。

    • 每个维度的 bin 数量 (nx, ny)

    • 所有维度的 bin 数量 (nx=ny=bins)。

  • range (sequence, 可选) – 长度为二的序列，每个元素都是可选的 (lower, upper) 元组，给出如果 bins 中未明确给出边界时要使用的外部 bin 边界。序列中的 None 条目表示使用相应维度的最小值和最大值。默认值 None 等效于传递两个 None 值的元组。

  • weights (cupy.ndarray) – 一个数组，其中包含衡量每个样本 (x_i, y_i) 的值 w_i。返回的直方图值等于落入每个 bin 的样本权重的总和。

  • density (bool, 可选) – 如果为 False（默认值），则返回每个 bin 中的样本数量。如果为 True，则返回 bin 处的概率*密度*函数，即 bin_count / sample_count / bin_volume。

返回值：

H (cupy.ndarray)

样本 x 的多维直方图。有关不同的可能语义，请参见 normed 和 weights。

edges0 (tuple of cupy.ndarray)

一个由 D 个数组组成的列表，描述了第一个维度的 bin 边界。

edges1 (tuple of cupy.ndarray)

一个由 D 个数组组成的列表，描述了第二个维度的 bin 边界。

返回类型：

tuple

警告

此函数可能会同步设备。

另请参阅

numpy.histogram2d()