NCL

Reference:

Zihan Lin*, Changxin Tian*, Yupeng Hou*, Wayne Xin Zhao. “Improving Graph Collaborative Filtering with Neighborhood-enriched Contrastive Learning.” in WWW 2022.

class recbole.model.general_recommender.ncl.NCL(config, dataset)

Bases: recbole.model.abstract_recommender.GeneralRecommender

NCL is a neighborhood-enriched contrastive learning paradigm for graph collaborative filtering. Both structural and semantic neighbors are explicitly captured as contrastive learning objects.

ProtoNCE_loss(node_embedding, user, item)

calculate_loss(interaction)

Calculate the training loss for a batch data.

Parameters

interaction (Interaction) – Interaction class of the batch.

Returns

Training loss, shape: []

Return type

torch.Tensor

e_step()

forward()

Defines the computation performed at every call.

Should be overridden by all subclasses.

Note

Although the recipe for forward pass needs to be defined within this function, one should call the Module instance afterwards instead of this since the former takes care of running the registered hooks while the latter silently ignores them.

full_sort_predict(interaction)

full sort prediction function. Given users, calculate the scores between users and all candidate items.

Parameters

interaction (Interaction) – Interaction class of the batch.

Returns

Predicted scores for given users and all candidate items, shape: [n_batch_users * n_candidate_items]

Return type

torch.Tensor

get_ego_embeddings()

Get the embedding of users and items and combine to an embedding matrix.

Returns

Tensor of the embedding matrix. Shape of [n_items+n_users, embedding_dim]

get_norm_adj_mat()

Get the normalized interaction matrix of users and items.

Construct the square matrix from the training data and normalize it using the laplace matrix.

\[A_{hat} = D^{-0.5} \times A \times D^{-0.5}\]

Returns

Sparse tensor of the normalized interaction matrix.

input_type = 2

predict(interaction)

Predict the scores between users and items.

Parameters

interaction (Interaction) – Interaction class of the batch.

Returns

Predicted scores for given users and items, shape: [batch_size]

Return type

torch.Tensor

run_kmeans(x)

Run K-means algorithm to get k clusters of the input tensor x

ssl_layer_loss(current_embedding, previous_embedding, user, item)

training: bool