jax.numpy.digitize

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

将数组转换为 bin 索引。

JAX 对 numpy.digitize() 的实现。

参数:

• x (ArrayLike) – 要进行离散化的值数组。

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

• right (bool) – 如果为 true，则区间包含右侧 bin 边界。如果为 false（默认），则区间包含左侧 bin 边界。

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

返回:

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

返回类型:

数组

另请参阅

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

• jax.numpy.histogram(): 计算指定 bin 中数组值的频率。

示例

>>> 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 也支持反向排序的 bin。

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