jax.numpy.digitize

jax.numpy.digitize(x, bins, right=False, *, method=None)

将数组转换为分箱索引。

JAX 实现 numpy.digitize()。

参数:

• x (ArrayLike) – 需要分箱的值数组。

• bins (ArrayLike) – 分箱边缘的一维数组。必须单调递增或递减。

• right (bool) – 如果为 True，则区间包含右分箱边缘。如果为 False（默认），则区间包含左分箱边缘。

• method (str | None) – 可选参数 method，将传递给 searchsorted()。有关可用选项，请参阅该函数。

返回:

一个与 x 形状相同的整数数组，指示值所属的分箱编号。

返回类型:

Array

另请参阅

• jax.numpy.searchsorted(): 在排序数组中查找值的插入索引。

• jax.numpy.histogram(): 计算指定分箱内数组值的频率。

示例

>>> x = jnp.array([1.0, 2.0, 2.5, 1.5, 3.0, 3.5])
>>> bins = jnp.array([1, 2, 3])
>>> jnp.digitize(x, bins)
Array([1, 2, 2, 1, 3, 3], dtype=int32)
>>> jnp.digitize(x, bins, right=True)
Array([0, 1, 2, 1, 2, 3], dtype=int32)

digitize 也支持反向排序的分箱

>>> bins = jnp.array([3, 2, 1])
>>> jnp.digitize(x, bins)
Array([2, 1, 1, 2, 0, 0], dtype=int32)