jax.lax.dynamic_update_index_in_dim

jax.lax.dynamic_update_index_in_dim#

jax.lax.dynamic_update_index_in_dim(operand, update, index, axis)[源代码][源代码]#

围绕 dynamic_update_slice() 的便捷包装器，用于在单个 axis 中更新大小为 1 的切片。

参数:

  • operand (Array | np.ndarray) – 一个要切片的数组。

  • update (ArrayLike) – 包含要写入 operand 的新值的数组。

  • index (ArrayLike) – 一个单一的标量索引

  • axis (int) – 更新轴。

返回:

更新后的数组

返回类型:

Array

示例

>>> x = jnp.zeros(6)
>>> y = 1.0
>>> dynamic_update_index_in_dim(x, y, 2, axis=0)
Array([0., 0., 1., 0., 0., 0.], dtype=float32)

>>> y = jnp.array([1.0])
>>> dynamic_update_index_in_dim(x, y, 2, axis=0)
Array([0., 0., 1., 0., 0., 0.], dtype=float32)

如果指定的索引超出范围，索引将被裁剪到有效范围内：

>>> dynamic_update_index_in_dim(x, y, 10, axis=0)
Array([0., 0., 0., 0., 0., 1.], dtype=float32)

以下是一个二维动态索引更新的示例：

>>> x = jnp.zeros((4, 4))
>>> y = jnp.ones(4)
>>> dynamic_update_index_in_dim(x, y, 1, axis=0)
Array([[0., 0., 0., 0.],
      [1., 1., 1., 1.],
      [0., 0., 0., 0.],
      [0., 0., 0., 0.]], dtype=float32)

请注意，update 中额外轴的形状不需要与 operand 的相关维度匹配：

>>> y = jnp.ones((1, 3))
>>> dynamic_update_index_in_dim(x, y, 1, 0)
Array([[0., 0., 0., 0.],
       [1., 1., 1., 0.],
       [0., 0., 0., 0.],
       [0., 0., 0., 0.]], dtype=float32)

参见

目录