dgl.ops.gspmm

dgl.ops.gspmm(g, op, reduce_op, lhs_data, rhs_data)[source]

广义稀疏矩阵乘法接口。 它将两个步骤融合到一个内核中。

  1. 通过op源节点和边特征计算消息。

  2. 通过reduce_op聚合消息作为目标节点的特征。

\[x_v = \psi_{(u, v, e)\in \mathcal{G}}(\rho(x_u, x_e))\]

其中 \(x_v\) 是目标节点上返回的特征,而 \(x_u\), \(x_e\) 分别指代 u, e\(\rho\) 表示二元运算符 op,而 \(\psi\) 表示归约运算符 reduce_op, \(\mathcal{G}\) 是我们应用 gspmm 的图: g

请注意,此函数不处理梯度。

Parameters:
  • g (DGLGraph) – The input graph.

  • op (str) – 二进制操作的名称,可能是 add, sub, mul, div, copy_lhs, copy_rhs.

  • reduce_op (str) – 归约操作符,可以是 sum, max, min, mean

  • lhs_data (tensorNone) – 左操作数,如果操作不需要,则可能为 None。

  • rhs_data (tensorNone) – 右操作数,如果操作不需要,则可以为 None。

Returns:

结果张量。

Return type:

张量