jax.lax.approx_max_k#

jax.lax.approx_max_k(operand, k, reduction_dimension=-1, recall_target=0.95, reduction_input_size_override=-1, aggregate_to_topk=True)[源代码]#

以近似方式返回 operand 的最大 k 值及其索引。

有关算法详细信息，请参阅 https://arxiv.org/abs/2206.14286。

参数：

  • operand (Array) – 用于搜索最大 k 值的数组。必须是浮点数类型。

  • k (int) – 指定最大 k 值数量。

  • reduction_dimension (int) – 搜索的整数维度。默认值：-1。

  • recall_target ( float) – 近似计算的目标召回率。

  • reduction_input_size_override ( int) – 当设置为正值时，它会覆盖由 operand[reduction_dim] 确定的用于评估召回率的大小。当给定的 operand 只是 SPMD 或分布式管道中整体计算的一个子集时，此选项非常有用，在这种情况下，真实的输入大小不能由 operand 的形状来推断。

  • aggregate_to_topk ( bool) – 当为 true 时，将近似结果聚合到排序后的前 k 个结果。当为 false 时，返回未排序的近似结果。在这种情况下，近似结果的数量由实现定义，并且大于或等于指定的 k。

返回:

包含两个数组的元组。数组是输入 operand 沿 reduction_dimension 的最大 k 个值和对应的索引。数组的维度与输入 operand 相同，但 reduction_dimension 除外：当 aggregate_to_topk 为 true 时，reduction dimension 为 k；否则，它大于等于 k，其中大小由实现定义。

返回类型:

tuple[Array, Array]

我们鼓励用户使用 jit 包装 approx_max_k。请参阅以下示例以了解最大内积搜索（MIPS）

>>> import functools
>>> import jax
>>> import numpy as np
>>> @functools.partial(jax.jit, static_argnames=["k", "recall_target"])
... def mips(qy, db, k=10, recall_target=0.95):
...   dists = jax.lax.dot(qy, db.transpose())
...   # returns (f32[qy_size, k], i32[qy_size, k])
...   return jax.lax.approx_max_k(dists, k=k, recall_target=recall_target)
>>>
>>> qy = jax.numpy.array(np.random.rand(50, 64))
>>> db = jax.numpy.array(np.random.rand(1024, 64))
>>> dot_products, neighbors = mips(qy, db, k=10)