jax.tree.map_with_path#

jax.tree.map_with_path(f, tree, *rest, is_leaf=None)[源代码]#

将一个多输入函数映射到 pytree 键路径和参数上，以生成一个新的 pytree。

这是 tree_map 的更强大的替代方案，它可以将每个叶子的键路径作为输入参数。

参数：

  • f (Callable[..., Any]) – 接受 2 + len(rest) 个参数的函数，即键路径和 pytree 的每个对应叶子。

  • tree (Any) – 要映射的 pytree，每个叶子的键路径作为第一个位置参数，叶子本身作为 f 的第二个参数。

  • *rest (Any) – 一个 pytree 元组，每个 pytree 的结构都与 tree 相同，或以 tree 作为前缀。

  • is_leaf (Callable[[Any], bool] | None | None)

返回：

一个新的 pytree，其结构与 tree 相同，但每个叶子的值由 f(kp, x, *xs) 给出，其中 kp 是 tree 中相应叶子的叶子键路径，x 是叶子值，xs 是 rest 中相应节点的值的元组。

返回类型:

任意

示例

>>> import jax
>>> jax.tree.map_with_path(lambda path, x: x + path[0].idx, [1, 2, 3])
[1, 3, 5]

另请参阅