embiggen/edge_prediction/edge_prediction_tensorflow/gnn.py
"""Generic GNN model for edge prediction."""
from typing import List, Union, Optional, Type, Dict, Any
from tensorflow.keras.optimizers import Optimizer
from embiggen.edge_prediction.edge_prediction_tensorflow.gcn import GCNEdgePrediction
class GNNEdgePrediction(GCNEdgePrediction):
"""Generic GNN model for edge prediction."""
def __init__(
self,
epochs: int = 1000,
batch_size: int = 1024,
number_of_batches_per_epoch: Optional[int] = None,
number_of_body_layers: int = 2,
number_of_head_layers: int = 1,
number_of_units_per_body_layer: Union[int, List[int]] = 128,
number_of_units_per_head_layer: Union[int, List[int]] = 128,
edge_embedding_methods: Union[List[str], str] = "Concatenate",
optimizer: Union[str, Type[Optimizer]] = "adam",
early_stopping_min_delta: float = 0.0001,
early_stopping_patience: int = 20,
reduce_lr_min_delta: float = 0.0001,
reduce_lr_patience: int = 5,
early_stopping_monitor: str = "loss",
early_stopping_mode: str = "min",
reduce_lr_monitor: str = "loss",
reduce_lr_mode: str = "min",
reduce_lr_factor: float = 0.9,
avoid_false_negatives: bool = True,
training_unbalance_rate: float = 1.0,
use_edge_metrics: bool = False,
random_state: int = 42,
use_node_embedding: bool = False,
node_embedding_size: int = 50,
use_node_type_embedding: bool = False,
node_type_embedding_size: int = 50,
use_edge_type_embedding: bool = False,
edge_type_embedding_size: int = 50,
siamese_node_feature_module: bool = True,
node_feature_names: Optional[Union[str, List[str]]] = None,
node_type_feature_names: Optional[Union[str, List[str]]] = None,
edge_type_feature_names: Optional[Union[str, List[str]]] = None,
verbose: bool = False
):
"""Create new GNN object.
Parameters
-------------------------------
epochs: int = 1000
Epochs to train the model for.
batch_size: int = 1024
Batch size to train the model.
number_of_batches_per_epoch: Optional[int] = None
Number of batches to use per epoch.
By default, this is None, which means that the number of batches
will be equal to the number of directed edges divided by the batch size.
number_of_body_layers: int = 2
Number of layers in the body subsection of the FFNN section of the model.
number_of_head_layers: int = 1
Number of layers in the head subsection of the FFNN section of the model.
number_of_units_per_body_layer: Union[int, List[int]] = 128
Number of units per ffnn body layer.
number_of_units_per_head_layer: Union[int, List[int]] = 128
Number of units per ffnn head layer.
edge_embedding_method: str = "Concatenate"
The edge embedding method to use to put togheter the
source and destination node features, which includes:
- Concatenate
- Average
- Hadamard
- L1
- L2
- Maximum
- Minimum
- Add
- Subtract
- Dot
optimizer: str = "adam"
The optimizer to use while training the model.
early_stopping_min_delta: float
Minimum delta of metric to stop the training.
early_stopping_patience: int
Number of epochs to wait for when the given minimum delta is not
achieved after which trigger early stopping.
reduce_lr_min_delta: float
Minimum delta of metric to reduce learning rate.
reduce_lr_patience: int
Number of epochs to wait for when the given minimum delta is not
achieved after which reducing learning rate.
early_stopping_monitor: str = "loss",
Metric to monitor for early stopping.
early_stopping_mode: str = "min",
Direction of the variation of the monitored metric for early stopping.
reduce_lr_monitor: str = "loss",
Metric to monitor for reducing learning rate.
reduce_lr_mode: str = "min",
Direction of the variation of the monitored metric for learning rate.
reduce_lr_factor: float = 0.9,
Factor for reduction of learning rate.
avoid_false_negatives: bool = True
Whether to avoid sampling false negatives.
This check makes the sampling a bit slower, and generally
the rate of collision is extremely low.
Consider disabling this when the task can account for this.
training_unbalance_rate: float = 1.0
The amount of negatives to be sampled during the training of the model.
By default this is 1.0, which means that the same number of positives and
negatives in the training are of the same cardinality.
use_node_embedding: bool = False
Whether to use a node embedding layer to let the model automatically
learn an embedding of the nodes.
node_embedding_size: int = 50
Size of the node embedding.
use_node_types: Union[bool, str] = "auto"
Whether to use the node types while training the model.
By default, automatically uses them if the graph has them.
node_type_embedding_size: int = 50
Size of the embedding for the node types.
use_edge_metrics: bool = False
Whether to use the edge metrics from traditional edge prediction.
These metrics currently include:
- Adamic Adar
- Jaccard Coefficient
- Resource allocation index
- Preferential attachment
use_node_embedding: bool = False
Whether to use a node embedding layer that is automatically learned
by the model while it trains. Please do be advised that by using
a node embedding layer you are making a closed-world assumption,
and this model will not work on graphs with a different node vocabulary.
node_embedding_size: int = 50
Dimension of the node embedding.
use_node_type_embedding: bool = False
Whether to use a node type embedding layer that is automatically learned
by the model while it trains. Please do be advised that by using
a node type embedding layer you are making a closed-world assumption,
and this model will not work on graphs with a different node vocabulary.
node_type_embedding_size: int = 50
Dimension of the node type embedding.
use_edge_type_embedding: bool = False
Whether to use a edge type embedding layer that is automatically learned
by the model while it trains. Please do be advised that by using
a edge type embedding layer you are making a closed-world assumption,
and this model will not work on graphs with a different edge vocabulary.
edge_type_embedding_size: int = 50
Dimension of the edge type embedding.
siamese_node_feature_module: bool = True
Whether to use a siamese module for the node features.
node_feature_names: Optional[Union[str, List[str]]] = None
Names of the node features.
This is used as the layer names.
node_type_feature_names: Optional[Union[str, List[str]]] = None
Names of the node type features.
This is used as the layer names.
edge_type_feature_names: Optional[Union[str, List[str]]] = None
Names of the edge type features.
This is used as the layer names.
verbose: bool = False
Whether to show loading bars.
"""
super().__init__(
kernels=None,
epochs=epochs,
batch_size=batch_size,
number_of_batches_per_epoch=number_of_batches_per_epoch,
number_of_graph_convolution_layers=0,
number_of_units_per_graph_convolution_layers=0,
number_of_ffnn_body_layers=number_of_body_layers,
number_of_ffnn_head_layers=number_of_head_layers,
number_of_units_per_ffnn_body_layer=number_of_units_per_body_layer,
number_of_units_per_ffnn_head_layer=number_of_units_per_head_layer,
edge_embedding_methods=edge_embedding_methods,
optimizer=optimizer,
early_stopping_min_delta=early_stopping_min_delta,
early_stopping_patience=early_stopping_patience,
reduce_lr_min_delta=reduce_lr_min_delta,
reduce_lr_patience=reduce_lr_patience,
early_stopping_monitor=early_stopping_monitor,
early_stopping_mode=early_stopping_mode,
reduce_lr_monitor=reduce_lr_monitor,
reduce_lr_mode=reduce_lr_mode,
reduce_lr_factor=reduce_lr_factor,
avoid_false_negatives=avoid_false_negatives,
training_unbalance_rate=training_unbalance_rate,
use_edge_metrics=use_edge_metrics,
random_state=random_state,
use_node_embedding=use_node_embedding,
node_embedding_size=node_embedding_size,
use_node_type_embedding=use_node_type_embedding,
node_type_embedding_size=node_type_embedding_size,
use_edge_type_embedding=use_edge_type_embedding,
edge_type_embedding_size=edge_type_embedding_size,
siamese_node_feature_module=siamese_node_feature_module,
node_feature_names=node_feature_names,
node_type_feature_names=node_type_feature_names,
edge_type_feature_names=edge_type_feature_names,
verbose=verbose,
)
@classmethod
def smoke_test_parameters(cls) -> Dict[str, Any]:
"""Returns parameters for smoke test."""
removed = [
"number_of_units_per_graph_convolution_layers",
"handling_multi_graph",
"number_of_units_per_ffnn_body_layer",
"number_of_units_per_ffnn_head_layer"
]
return dict(
number_of_units_per_body_layer=1,
number_of_units_per_head_layer=1,
**{
key: value
for key, value in GCNEdgePrediction.smoke_test_parameters().items()
if key not in removed
}
)
def parameters(self) -> Dict[str, Any]:
"""Returns parameters for smoke test."""
removed = [
"number_of_units_per_graph_convolution_layers",
"handling_multi_graph",
"residual_convolutional_layers",
"number_of_units_per_ffnn_body_layer",
"number_of_units_per_ffnn_head_layer",
"combiner",
"apply_norm",
"dropout_rate"
]
return dict(
number_of_units_per_body_layer=self._number_of_units_per_ffnn_body_layer,
number_of_units_per_head_layer=self._number_of_units_per_ffnn_head_layer,
**{
key: value
for key, value in super().parameters().items()
if key not in removed
}
)
@classmethod
def model_name(cls) -> str:
return "GNN"