cupy.histogram#

cupy.histogram(x, bins=10, range=None, weights=None, density=False)[source]#

计算一组数据的直方图。

参数：

  • x (cupy.ndarray) – 输入数组。

  • bins (int 或 cupy.ndarray) – 如果 bins 是整数，则表示 bin 的数量。如果 bins 是 ndarray，则表示 bin 的边缘。

  • range (float 的 2 元组, 可选) – Bin 的下限和上限范围。如果未提供，范围默认为 (x.min(), x.max())。范围外的值将被忽略。范围的第一个元素必须小于或等于第二个元素。range 也会影响自动 bin 计算。虽然 bin 宽度是根据 range 内的实际数据计算出的最优值，但 bin 计数将填充整个范围，包括不包含数据的部分。

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

  • weights (cupy.ndarray, 可选) – 一个与 x 形状相同的权重数组。x 中的每个值仅贡献其相关权重到 bin 计数（而不是 1）。

返回值：

(hist, bin_edges)，其中 hist 是一个 cupy.ndarray，存储直方图的值，bin_edges 是一个 cupy.ndarray，存储 bin 的边缘。

返回类型：

tuple

警告

此函数可能会同步设备。

另请参见

numpy.histogram()