jax.lax.cond#
- jax.lax.cond(pred, true_fun, false_fun, *operands, operand=<object object>)[source]#
有条件地应用
true_fun
或false_fun
。包装了 XLA 的 Conditional 运算符。
如果提供的参数类型正确,
cond()
具有与此 Python 实现等效的语义,其中pred
必须是标量类型def cond(pred, true_fun, false_fun, *operands): if pred: return true_fun(*operands) else: return false_fun(*operands)
与
jax.lax.select()
相比,使用cond
表明只执行两个分支中的一个(取决于编译器重写和优化)。但是,当使用vmap()
转换以对一批谓词进行操作时,cond
将转换为select()
。在所有情况下都会追踪两个分支(有关 JAX 追踪模型的讨论,请参阅 关键概念:追踪)。- 参数:
pred – 布尔标量类型,指示要应用哪个分支函数。
true_fun (Callable) – 函数 (A -> B),如果
pred
为 True,则应用此函数。false_fun (Callable) – 函数 (A -> B),如果
pred
为 False,则应用此函数。operands – 操作数 (A) 输入到任一分支,具体取决于
pred
。类型可以是标量、数组或它们的任何 pytree(嵌套的 Python 元组/列表/字典)。
- 返回:
值 (B) 为
true_fun(*operands)
或false_fun(*operands)
之一,具体取决于pred
的值。类型可以是标量、数组或它们的任何 pytree(嵌套的 Python 元组/列表/字典)。