dgl.DGLGraph.srcdata

property DGLGraph.srcdata

返回一个节点数据视图，用于设置/获取源节点特征。

让 g 成为一个 DGLGraph。如果 g 是单一源节点类型的图， g.srcdata[feat] 返回与名称 feat 相关联的源节点特征。 也可以通过将 g.srcdata[feat] 设置为张量来设置与名称 feat 相关联的源节点特征。

如果 g 是一个多源节点类型的图，g.srcdata[feat] 返回一个 dict[str, Tensor]，将源节点类型映射到与名称 feat 相关联的节点特征 对于相应的类型。也可以通过设置 g.srcdata[feat] 为一个字典来为某些源节点类型设置与名称 feat 相关联的节点特征。

注释

为了设置特征，特征的设备必须与图的设备相同。

示例

以下示例使用PyTorch后端。

>>> import dgl
>>> import torch

为单一源节点类型的图设置和获取特征‘h’。

>>> g = dgl.heterograph({
...     ('user', 'plays', 'game'): (torch.tensor([0, 1]), torch.tensor([1, 2]))})
>>> g.srcdata['h'] = torch.ones(2, 1)
>>> g.srcdata['h']
tensor([[1.],
        [1.]])

为多源节点类型的图设置和获取特征‘h’。

>>> g = dgl.heterograph({
...     ('user', 'plays', 'game'): (torch.tensor([1, 2]), torch.tensor([3, 4])),
...     ('player', 'plays', 'game'): (torch.tensor([2, 2]), torch.tensor([1, 1]))
... })
>>> g.srcdata['h'] = {'user': torch.zeros(3, 1), 'player': torch.ones(3, 1)}
>>> g.srcdata['h']
{'player': tensor([[1.], [1.], [1.]]),
 'user': tensor([[0.], [0.], [0.]])}
>>> g.srcdata['h'] = {'user': torch.ones(3, 1)}
>>> g.srcdata['h']
{'player': tensor([[1.], [1.], [1.]]),
 'user': tensor([[1.], [1.], [1.]])}

另请参阅

nodes, ndata, srcnodes