index_add

paddle. index_add ( x, index, axis, value, name=None ) [源代码]

沿着指定轴 axisindex 中指定位置的 xvalue 相加,并写入到结果 Tensor 中的对应位置。这里 index 是一个 1-D Tensor。除 axis 轴外,返回的 Tensor 其余维度大小和输入 x 相等, axis 维度的大小等于 index 的大小。

参数

  • x (Tensor)– 输入 Tensor。 x 的数据类型可以是 float16, float32,float64,int32,int64。

  • index (Tensor)– 包含索引下标的 1-D Tensor。数据类型为 int32 或者 int64。

  • axis (int) – 索引轴。数据类型为 int。

  • value (Tensor)– 与 x 相加的 Tensor。 value 的数据类型同 x

  • name (str,可选) - 具体用法请参见 Name,一般无需设置,默认值为 None。

返回

Tensor,返回一个数据类型同输入的 Tensor。

代码示例

>>> import paddle
>>> paddle.device.set_device('gpu')

>>> input_tensor = paddle.to_tensor(paddle.ones((3, 3)), dtype="float32")
>>> index = paddle.to_tensor([0, 2], dtype="int32")
>>> value = paddle.to_tensor([[1, 1, 1], [1, 1, 1]], dtype="float32")
>>> outplace_res = paddle.index_add(input_tensor, index, 0, value)
>>> print(outplace_res)
Tensor(shape=[3, 3], dtype=float32, place=Place(gpu:0), stop_gradient=True,
[[2., 2., 2.],
 [1., 1., 1.],
 [2., 2., 2.]])

使用本API的教程文档