graph_send_recv

paddle.incubate. graph_send_recv ( x, src_index, dst_index, pool_type='sum', out_size=None, name=None ) [源代码]

主要应用于图学习领域,目的是为了减少在消息传递过程中带来的中间变量显存或内存的损耗。其中,x 作为输入 Tensor,首先利用 src_index 作为索引来 gather 出在 x 中相应位置的数据,随后再将 gather 出的结果利用 dst_index 来更新到对应的输出结果中,其中 pool_type 表示不同的更新方式,包括 sum、mean、max、min 共计 4 种处理模式。另外,提供了 out_size 参数,用于设置实际输出的形状,有利于减少实际显存占用。

X = [[0, 2, 3],
     [1, 4, 5],
     [2, 6, 7]]

src_index = [0, 1, 2, 0]

dst_index = [1, 2, 1, 0]

pool_type = "sum"

out_size = None

Then:

Out = [[0, 2, 3],
       [2, 8, 10],
       [1, 4, 5]]

参数

  • x (Tensor) - 输入的 Tensor,数据类型为:float32、float64、int32、int64。

  • src_index (Tensor) - 1-D Tensor,数据类型为:int32、int64。

  • dst_index (Tensor) - 1-D Tensor,数据类型为:int32、int64。注意:dst_index 的形状应当与 src_index 一致。

  • pool_type (str) - scatter 结果的不同处理方式,包括 sum、mean、max、min。默认值为 sum。

  • out_size (int64,可选) - 可以通过根据实际需求设置 out_size 来改变实际输出形状。默认值为 None,表示这个参数将不会被使用。注意,out_size 的值必须等于或大于 max(dst_index) + 1

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

返回

Tensor,维度和数据类型都与 x 相同,存储运算后的结果。

代码示例

>>> import paddle

>>> x = paddle.to_tensor([[0, 2, 3], [1, 4, 5], [2, 6, 7]], dtype="float32")
>>> indexes = paddle.to_tensor([[0, 1], [1, 2], [2, 1], [0, 0]], dtype="int32")
>>> src_index = indexes[:, 0]
>>> dst_index = indexes[:, 1]
>>> out = paddle.incubate.graph_send_recv(x, src_index, dst_index, pool_type="sum")
>>> print(out)
Tensor(shape=[3, 3], dtype=float32, place=Place(cpu), stop_gradient=True,
[[0. , 2. , 3. ],
 [2. , 8. , 10.],
 [1. , 4. , 5. ]])

>>> x = paddle.to_tensor([[0, 2, 3], [1, 4, 5], [2, 6, 7]], dtype="float32")
>>> indexes = paddle.to_tensor([[0, 1], [2, 1], [0, 0]], dtype="int32")
>>> src_index = indexes[:, 0]
>>> dst_index = indexes[:, 1]
>>> out_size = paddle.max(dst_index) + 1
>>> out = paddle.incubate.graph_send_recv(x, src_index, dst_index, pool_type="sum", out_size=out_size)
>>> print(out)
Tensor(shape=[2, 3], dtype=float32, place=Place(cpu), stop_gradient=True,
[[0. , 2. , 3. ],
 [2. , 8. , 10.]])

>>> x = paddle.to_tensor([[0, 2, 3], [1, 4, 5], [2, 6, 7]], dtype="float32")
>>> indexes = paddle.to_tensor([[0, 1], [2, 1], [0, 0]], dtype="int32")
>>> src_index = indexes[:, 0]
>>> dst_index = indexes[:, 1]
>>> out = paddle.incubate.graph_send_recv(x, src_index, dst_index, pool_type="sum")
>>> print(out)
Tensor(shape=[3, 3], dtype=float32, place=Place(cpu), stop_gradient=True,
[[0. , 2. , 3. ],
 [2. , 8. , 10.],
 [0. , 0. , 0. ]])