Source code for dgl.data.adapter

"""Dataset adapters for re-purposing a dataset for a different kind of training task."""

import json
import os

import numpy as np

from .. import backend as F
from ..base import DGLError
from ..convert import graph as create_dgl_graph
from ..sampling.negative import _calc_redundancy
from . import utils
from .dgl_dataset import DGLDataset

__all__ = ["AsNodePredDataset", "AsLinkPredDataset", "AsGraphPredDataset"]


[docs]class AsNodePredDataset(DGLDataset): """Repurpose a dataset for a standard semi-supervised transductive node prediction task. The class converts a given dataset into a new dataset object such that: - Contains only one graph, accessible from ``dataset[0]``. - The graph stores: - Node labels in ``g.ndata['label']``. - Train/val/test masks in ``g.ndata['train_mask']``, ``g.ndata['val_mask']``, and ``g.ndata['test_mask']`` respectively. - In addition, the dataset contains the following attributes: - ``num_classes``, the number of classes to predict. - ``train_idx``, ``val_idx``, ``test_idx``, train/val/test indexes. If the input dataset contains heterogeneous graphs, users need to specify the ``target_ntype`` argument to indicate which node type to make predictions for. In this case: - Node labels are stored in ``g.nodes[target_ntype].data['label']``. - Training masks are stored in ``g.nodes[target_ntype].data['train_mask']``. So do validation and test masks. The class will keep only the first graph in the provided dataset and generate train/val/test masks according to the given split ratio. The generated masks will be cached to disk for fast re-loading. If the provided split ratio differs from the cached one, it will re-process the dataset properly. Parameters ---------- dataset : DGLDataset The dataset to be converted. split_ratio : (float, float, float), optional Split ratios for training, validation and test sets. They must sum to one. target_ntype : str, optional The node type to add split mask for. Attributes ---------- num_classes : int Number of classes to predict. train_idx : Tensor An 1-D integer tensor of training node IDs. val_idx : Tensor An 1-D integer tensor of validation node IDs. test_idx : Tensor An 1-D integer tensor of test node IDs. Examples -------- >>> ds = dgl.data.AmazonCoBuyComputerDataset() >>> print(ds) Dataset("amazon_co_buy_computer", num_graphs=1, save_path=...) >>> new_ds = dgl.data.AsNodePredDataset(ds, [0.8, 0.1, 0.1]) >>> print(new_ds) Dataset("amazon_co_buy_computer-as-nodepred", num_graphs=1, save_path=...) >>> print('train_mask' in new_ds[0].ndata) True """ def __init__(self, dataset, split_ratio=None, target_ntype=None, **kwargs): self.dataset = dataset self.split_ratio = split_ratio self.target_ntype = target_ntype super().__init__( self.dataset.name + "-as-nodepred", hash_key=(split_ratio, target_ntype, dataset.name, "nodepred"), **kwargs ) def process(self): is_ogb = hasattr(self.dataset, "get_idx_split") if is_ogb: g, label = self.dataset[0] self.g = g.clone() self.g.ndata["label"] = F.reshape(label, (g.num_nodes(),)) else: self.g = self.dataset[0].clone() if "label" not in self.g.nodes[self.target_ntype].data: raise ValueError( "Missing node labels. Make sure labels are stored " "under name 'label'." ) if self.split_ratio is None: if is_ogb: split = self.dataset.get_idx_split() train_idx, val_idx, test_idx = ( split["train"], split["valid"], split["test"], ) n = self.g.num_nodes() train_mask = utils.generate_mask_tensor( utils.idx2mask(train_idx, n) ) val_mask = utils.generate_mask_tensor( utils.idx2mask(val_idx, n) ) test_mask = utils.generate_mask_tensor( utils.idx2mask(test_idx, n) ) self.g.ndata["train_mask"] = train_mask self.g.ndata["val_mask"] = val_mask self.g.ndata["test_mask"] = test_mask else: assert ( "train_mask" in self.g.nodes[self.target_ntype].data ), "train_mask is not provided, please specify split_ratio to generate the masks" assert ( "val_mask" in self.g.nodes[self.target_ntype].data ), "val_mask is not provided, please specify split_ratio to generate the masks" assert ( "test_mask" in self.g.nodes[self.target_ntype].data ), "test_mask is not provided, please specify split_ratio to generate the masks" else: if self.verbose: print("Generating train/val/test masks...") utils.add_nodepred_split(self, self.split_ratio, self.target_ntype) self._set_split_index() self.num_classes = getattr(self.dataset, "num_classes", None) if self.num_classes is None: self.num_classes = len( F.unique(self.g.nodes[self.target_ntype].data["label"]) ) def has_cache(self): return os.path.isfile( os.path.join(self.save_path, "graph_{}.bin".format(self.hash)) ) def load(self): with open( os.path.join(self.save_path, "info_{}.json".format(self.hash)), "r" ) as f: info = json.load(f) if ( info["split_ratio"] != self.split_ratio or info["target_ntype"] != self.target_ntype ): raise ValueError( "Provided split ratio is different from the cached file. " "Re-process the dataset." ) self.split_ratio = info["split_ratio"] self.target_ntype = info["target_ntype"] self.num_classes = info["num_classes"] gs, _ = utils.load_graphs( os.path.join(self.save_path, "graph_{}.bin".format(self.hash)) ) self.g = gs[0] self._set_split_index() def save(self): utils.save_graphs( os.path.join(self.save_path, "graph_{}.bin".format(self.hash)), [self.g], ) with open( os.path.join(self.save_path, "info_{}.json".format(self.hash)), "w" ) as f: json.dump( { "split_ratio": self.split_ratio, "target_ntype": self.target_ntype, "num_classes": self.num_classes, }, f, )
[docs] def __getitem__(self, idx): return self.g
[docs] def __len__(self): return 1
def _set_split_index(self): """Add train_idx/val_idx/test_idx as dataset attributes according to corresponding mask.""" ndata = self.g.nodes[self.target_ntype].data self.train_idx = F.nonzero_1d(ndata["train_mask"]) self.val_idx = F.nonzero_1d(ndata["val_mask"]) self.test_idx = F.nonzero_1d(ndata["test_mask"])
def negative_sample(g, num_samples): """Random sample negative edges from graph, excluding self-loops, the result samples might be less than num_samples """ num_nodes = g.num_nodes() redundancy = _calc_redundancy(num_samples, g.num_edges(), num_nodes**2) sample_size = int(num_samples * (1 + redundancy)) edges = np.random.randint(0, num_nodes, size=(2, sample_size)) edges = np.unique(edges, axis=1) # remove self loop mask_self_loop = edges[0] == edges[1] # remove existing edges has_edges = F.asnumpy(g.has_edges_between(edges[0], edges[1])) mask = ~(np.logical_or(mask_self_loop, has_edges)) edges = edges[:, mask] if edges.shape[1] >= num_samples: edges = edges[:, :num_samples] return edges
[docs]class AsLinkPredDataset(DGLDataset): """Repurpose a dataset for link prediction task. The created dataset will include data needed for link prediction. Currently it only supports homogeneous graphs. It will keep only the first graph in the provided dataset and generate train/val/test edges according to the given split ratio, and the correspondent negative edges based on the neg_ratio. The generated edges will be cached to disk for fast re-loading. If the provided split ratio differs from the cached one, it will re-process the dataset properly. Parameters ---------- dataset : DGLDataset The dataset to be converted. split_ratio : (float, float, float), optional Split ratios for training, validation and test sets. Must sum to one. neg_ratio : int, optional Indicate how much negative samples to be sampled The number of the negative samples will be equal or less than neg_ratio * num_positive_edges. Attributes ------- feat_size: int The size of the feature dimension in the graph train_graph: DGLGraph The DGLGraph for training val_edges: Tuple[Tuple[Tensor, Tensor], Tuple[Tensor, Tensor]] The validation set edges, encoded as ((positive_edge_src, positive_edge_dst), (negative_edge_src, negative_edge_dst)) test_edges: Tuple[Tuple[Tensor, Tensor], Tuple[Tensor, Tensor]] The test set edges, encoded as ((positive_edge_src, positive_edge_dst), (negative_edge_src, negative_edge_dst)) Examples -------- >>> ds = dgl.data.CoraGraphDataset() >>> print(ds) Dataset("cora_v2", num_graphs=1, save_path=...) >>> new_ds = dgl.data.AsLinkPredDataset(ds, [0.8, 0.1, 0.1]) >>> print(new_ds) Dataset("cora_v2-as-linkpred", num_graphs=1, save_path=/home/ubuntu/.dgl/cora_v2-as-linkpred) >>> print(hasattr(new_ds, "test_edges")) True """ def __init__(self, dataset, split_ratio=None, neg_ratio=3, **kwargs): self.g = dataset[0] self.num_nodes = self.g.num_nodes() self.dataset = dataset self.split_ratio = split_ratio self.neg_ratio = neg_ratio super().__init__( dataset.name + "-as-linkpred", hash_key=(neg_ratio, split_ratio, dataset.name, "linkpred"), **kwargs ) def process(self): if self.split_ratio is None: # Handle logics for OGB link prediction dataset assert hasattr( self.dataset, "get_edge_split" ), "dataset doesn't have get_edge_split method, please specify split_ratio and neg_ratio to generate the split" # This is likely to be an ogb dataset self.edge_split = self.dataset.get_edge_split() self._train_graph = self.g if "source_node" in self.edge_split["test"]: # Probably ogbl-citation2 pos_e = ( self.edge_split["valid"]["source_node"], self.edge_split["valid"]["target_node"], ) neg_e_size = self.edge_split["valid"]["target_node_neg"].shape[ -1 ] neg_e_src = np.repeat( self.edge_split["valid"]["source_node"], neg_e_size ) neg_e_dst = np.reshape( self.edge_split["valid"]["target_node_neg"], -1 ) self._val_edges = pos_e, (neg_e_src, neg_e_dst) pos_e = ( self.edge_split["test"]["source_node"], self.edge_split["test"]["target_node"], ) neg_e_size = self.edge_split["test"]["target_node_neg"].shape[ -1 ] neg_e_src = np.repeat( self.edge_split["test"]["source_node"], neg_e_size ) neg_e_dst = np.reshape( self.edge_split["test"]["target_node_neg"], -1 ) self._test_edges = pos_e, (neg_e_src, neg_e_dst) elif "edge" in self.edge_split["test"]: # Probably ogbl-collab pos_e_tensor, neg_e_tensor = ( self.edge_split["valid"]["edge"], self.edge_split["valid"]["edge_neg"], ) pos_e = (pos_e_tensor[:, 0], pos_e_tensor[:, 1]) neg_e = (neg_e_tensor[:, 0], neg_e_tensor[:, 1]) self._val_edges = pos_e, neg_e pos_e_tensor, neg_e_tensor = ( self.edge_split["test"]["edge"], self.edge_split["test"]["edge_neg"], ) pos_e = (pos_e_tensor[:, 0], pos_e_tensor[:, 1]) neg_e = (neg_e_tensor[:, 0], neg_e_tensor[:, 1]) self._test_edges = pos_e, neg_e # delete edge split to save memory self.edge_split = None else: assert self.split_ratio is not None, "Need to specify split_ratio" assert self.neg_ratio is not None, "Need to specify neg_ratio" ratio = self.split_ratio graph = self.dataset[0] n = graph.num_edges() src, dst = graph.edges() src, dst = F.asnumpy(src), F.asnumpy(dst) n_train, n_val, n_test = ( int(n * ratio[0]), int(n * ratio[1]), int(n * ratio[2]), ) idx = np.random.permutation(n) train_pos_idx = idx[:n_train] val_pos_idx = idx[n_train : n_train + n_val] test_pos_idx = idx[n_train + n_val :] neg_src, neg_dst = negative_sample( graph, self.neg_ratio * (n_val + n_test) ) neg_n_val, neg_n_test = ( self.neg_ratio * n_val, self.neg_ratio * n_test, ) neg_val_src, neg_val_dst = neg_src[:neg_n_val], neg_dst[:neg_n_val] neg_test_src, neg_test_dst = ( neg_src[neg_n_val:], neg_dst[neg_n_val:], ) self._val_edges = ( F.tensor(src[val_pos_idx]), F.tensor(dst[val_pos_idx]), ), (F.tensor(neg_val_src), F.tensor(neg_val_dst)) self._test_edges = ( F.tensor(src[test_pos_idx]), F.tensor(dst[test_pos_idx]), ), (F.tensor(neg_test_src), F.tensor(neg_test_dst)) self._train_graph = create_dgl_graph( (src[train_pos_idx], dst[train_pos_idx]), num_nodes=self.num_nodes, ) self._train_graph.ndata["feat"] = graph.ndata["feat"] def has_cache(self): return os.path.isfile( os.path.join(self.save_path, "graph_{}.bin".format(self.hash)) ) def load(self): gs, tensor_dict = utils.load_graphs( os.path.join(self.save_path, "graph_{}.bin".format(self.hash)) ) self.g = gs[0] self._train_graph = self.g self._val_edges = ( tensor_dict["val_pos_src"], tensor_dict["val_pos_dst"], ), (tensor_dict["val_neg_src"], tensor_dict["val_neg_dst"]) self._test_edges = ( tensor_dict["test_pos_src"], tensor_dict["test_pos_dst"], ), (tensor_dict["test_neg_src"], tensor_dict["test_neg_dst"]) with open( os.path.join(self.save_path, "info_{}.json".format(self.hash)), "r" ) as f: info = json.load(f) self.split_ratio = info["split_ratio"] self.neg_ratio = info["neg_ratio"] def save(self): tensor_dict = { "val_pos_src": self._val_edges[0][0], "val_pos_dst": self._val_edges[0][1], "val_neg_src": self._val_edges[1][0], "val_neg_dst": self._val_edges[1][1], "test_pos_src": self._test_edges[0][0], "test_pos_dst": self._test_edges[0][1], "test_neg_src": self._test_edges[1][0], "test_neg_dst": self._test_edges[1][1], } utils.save_graphs( os.path.join(self.save_path, "graph_{}.bin".format(self.hash)), [self._train_graph], tensor_dict, ) with open( os.path.join(self.save_path, "info_{}.json".format(self.hash)), "w" ) as f: json.dump( {"split_ratio": self.split_ratio, "neg_ratio": self.neg_ratio}, f, ) @property def feat_size(self): return self._train_graph.ndata["feat"].shape[-1] @property def train_graph(self): return self._train_graph @property def val_edges(self): return self._val_edges @property def test_edges(self): return self._test_edges
[docs] def __getitem__(self, idx): return self.g
[docs] def __len__(self): return 1
[docs]class AsGraphPredDataset(DGLDataset): """Repurpose a dataset for standard graph property prediction task. The created dataset will include data needed for graph property prediction. Currently it only supports homogeneous graphs. The class converts a given dataset into a new dataset object such that: - It stores ``len(dataset)`` graphs. - The i-th graph and its label is accessible from ``dataset[i]``. The class will generate a train/val/test split if :attr:`split_ratio` is provided. The generated split will be cached to disk for fast re-loading. If the provided split ratio differs from the cached one, it will re-process the dataset properly. Parameters ---------- dataset : DGLDataset The dataset to be converted. split_ratio : (float, float, float), optional Split ratios for training, validation and test sets. They must sum to one. Attributes ---------- num_tasks : int Number of tasks to predict. num_classes : int Number of classes to predict per task, None for regression datasets. train_idx : Tensor An 1-D integer tensor of training node IDs. val_idx : Tensor An 1-D integer tensor of validation node IDs. test_idx : Tensor An 1-D integer tensor of test node IDs. node_feat_size : int Input node feature size, None if not applicable. edge_feat_size : int Input edge feature size, None if not applicable. Examples -------- >>> from dgl.data import AsGraphPredDataset >>> from ogb.graphproppred import DglGraphPropPredDataset >>> dataset = DglGraphPropPredDataset(name='ogbg-molhiv') >>> new_dataset = AsGraphPredDataset(dataset) >>> print(new_dataset) Dataset("ogbg-molhiv-as-graphpred", num_graphs=41127, save_path=...) >>> print(len(new_dataset)) 41127 >>> print(new_dataset[0]) (Graph(num_nodes=19, num_edges=40, ndata_schemes={'feat': Scheme(shape=(9,), dtype=torch.int64)} edata_schemes={'feat': Scheme(shape=(3,), dtype=torch.int64)}), tensor([0])) """ def __init__(self, dataset, split_ratio=None, **kwargs): self.dataset = dataset self.split_ratio = split_ratio super().__init__( dataset.name + "-as-graphpred", hash_key=(split_ratio, dataset.name, "graphpred"), **kwargs ) def process(self): is_ogb = hasattr(self.dataset, "get_idx_split") if self.split_ratio is None: if is_ogb: split = self.dataset.get_idx_split() self.train_idx = split["train"] self.val_idx = split["valid"] self.test_idx = split["test"] else: # Handle FakeNewsDataset try: self.train_idx = F.nonzero_1d(self.dataset.train_mask) self.val_idx = F.nonzero_1d(self.dataset.val_mask) self.test_idx = F.nonzero_1d(self.dataset.test_mask) except: raise DGLError( "The input dataset does not have default train/val/test\ split. Please specify split_ratio to generate the split." ) else: if self.verbose: print("Generating train/val/test split...") train_ratio, val_ratio, _ = self.split_ratio num_graphs = len(self.dataset) num_train = int(num_graphs * train_ratio) num_val = int(num_graphs * val_ratio) idx = np.random.permutation(num_graphs) self.train_idx = F.tensor(idx[:num_train]) self.val_idx = F.tensor(idx[num_train : num_train + num_val]) self.test_idx = F.tensor(idx[num_train + num_val :]) if hasattr(self.dataset, "num_classes"): # GINDataset, MiniGCDataset, FakeNewsDataset, TUDataset, # LegacyTUDataset, BA2MotifDataset self.num_classes = self.dataset.num_classes else: # None for multi-label classification and regression self.num_classes = None if hasattr(self.dataset, "num_tasks"): # OGB datasets self.num_tasks = self.dataset.num_tasks else: self.num_tasks = 1 def has_cache(self): return os.path.isfile( os.path.join(self.save_path, "info_{}.json".format(self.hash)) ) def load(self): with open( os.path.join(self.save_path, "info_{}.json".format(self.hash)), "r" ) as f: info = json.load(f) if info["split_ratio"] != self.split_ratio: raise ValueError( "Provided split ratio is different from the cached file. " "Re-process the dataset." ) self.split_ratio = info["split_ratio"] self.num_tasks = info["num_tasks"] self.num_classes = info["num_classes"] split = np.load( os.path.join(self.save_path, "split_{}.npz".format(self.hash)) ) self.train_idx = F.zerocopy_from_numpy(split["train_idx"]) self.val_idx = F.zerocopy_from_numpy(split["val_idx"]) self.test_idx = F.zerocopy_from_numpy(split["test_idx"]) def save(self): if not os.path.exists(self.save_path): os.makedirs(self.save_path) with open( os.path.join(self.save_path, "info_{}.json".format(self.hash)), "w" ) as f: json.dump( { "split_ratio": self.split_ratio, "num_tasks": self.num_tasks, "num_classes": self.num_classes, }, f, ) np.savez( os.path.join(self.save_path, "split_{}.npz".format(self.hash)), train_idx=F.zerocopy_to_numpy(self.train_idx), val_idx=F.zerocopy_to_numpy(self.val_idx), test_idx=F.zerocopy_to_numpy(self.test_idx), )
[docs] def __getitem__(self, idx): return self.dataset[idx]
[docs] def __len__(self): return len(self.dataset)
@property def node_feat_size(self): g = self[0][0] return g.ndata["feat"].shape[-1] if "feat" in g.ndata else None @property def edge_feat_size(self): g = self[0][0] return g.edata["feat"].shape[-1] if "feat" in g.edata else None