cupy.histogram2d#

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

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

参数:

  • x (cupy.ndarray) – 第一个要进行直方图统计的样本数组。

  • y (cupy.ndarray) – 第二个要进行直方图统计的样本数组。

  • bins (int or tuple of int or cupy.ndarray) – bin 规范：* 描述沿每个维度单调递增的 bin 边缘的数组序列。* 每个维度的 bin 数量 (nx, ny) * 所有维度的 bin 数量 (nx=ny=bins)。

  • range (sequence, optional) – 一个长度为二的序列，每个序列是一个可选的（下限，上限）元组，用于指定如果 bins 中未明确给出边缘时的外部箱边缘。序列中的 None 条目将导致使用相应维度的最小值和最大值。默认值 None 等同于传递一个包含两个 None 值的元组。

  • weights (cupy.ndarray) – 一个值数组 w_i ，用于衡量每个样本 (x_i, y_i) 的权重。返回的直方图的值等于落入每个箱子的样本的权重之和。

  • density (bool, optional) – 如果为 False ，默认情况下，返回每个箱子中的样本数量。如果为 True ，则返回箱子处的概率 密度 函数，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()