dmlc--dgl
74 行
2.3 KiB
Python
74 行
2.3 KiB
Python
"""Torch Module for APPNPConv"""
|
|
# pylint: disable= no-member, arguments-differ, invalid-name
|
|
import torch as th
|
|
from torch import nn
|
|
|
|
from .... import function as fn
|
|
|
|
|
|
class APPNPConv(nn.Module):
|
|
r"""Approximate Personalized Propagation of Neural Predictions
|
|
layer from paper `Predict then Propagate: Graph Neural Networks
|
|
meet Personalized PageRank <https://arxiv.org/pdf/1810.05997.pdf>`__.
|
|
|
|
.. math::
|
|
H^{0} & = X
|
|
|
|
H^{t+1} & = (1-\alpha)\left(\hat{D}^{-1/2}
|
|
\hat{A} \hat{D}^{-1/2} H^{t}\right) + \alpha H^{0}
|
|
|
|
Parameters
|
|
----------
|
|
k : int
|
|
Number of iterations :math:`K`.
|
|
alpha : float
|
|
The teleport probability :math:`\alpha`.
|
|
edge_drop : float, optional
|
|
Dropout rate on edges that controls the
|
|
messages received by each node. Default: ``0``.
|
|
"""
|
|
def __init__(self,
|
|
k,
|
|
alpha,
|
|
edge_drop=0.):
|
|
super(APPNPConv, self).__init__()
|
|
self._k = k
|
|
self._alpha = alpha
|
|
self.edge_drop = nn.Dropout(edge_drop)
|
|
|
|
def forward(self, graph, feat):
|
|
r"""Compute APPNP layer.
|
|
|
|
Parameters
|
|
----------
|
|
graph : DGLGraph
|
|
The graph.
|
|
feat : torch.Tensor
|
|
The input feature of shape :math:`(N, *)` :math:`N` is the
|
|
number of nodes, and :math:`*` could be of any shape.
|
|
|
|
Returns
|
|
-------
|
|
torch.Tensor
|
|
The output feature of shape :math:`(N, *)` where :math:`*`
|
|
should be the same as input shape.
|
|
"""
|
|
graph = graph.local_var()
|
|
norm = th.pow(graph.in_degrees().float().clamp(min=1), -0.5)
|
|
shp = norm.shape + (1,) * (feat.dim() - 1)
|
|
norm = th.reshape(norm, shp).to(feat.device)
|
|
feat_0 = feat
|
|
for _ in range(self._k):
|
|
# normalization by src node
|
|
feat = feat * norm
|
|
graph.ndata['h'] = feat
|
|
graph.edata['w'] = self.edge_drop(
|
|
th.ones(graph.number_of_edges(), 1).to(feat.device))
|
|
graph.update_all(fn.u_mul_e('h', 'w', 'm'),
|
|
fn.sum('m', 'h'))
|
|
feat = graph.ndata.pop('h')
|
|
# normalization by dst node
|
|
feat = feat * norm
|
|
feat = (1 - self._alpha) * feat + self._alpha * feat_0
|
|
return feat
|