Hypergraphs with Attention on Reviews for Explainable Recommendation (#…

…600)

* Init method

* Example file

* Added HypAR

Added hyper and its functions.

* Added dataset standard files and virtual env names to ignore

* Create graph comments

* Flock comments

* Graph wrapper comments

* ao embedding comments

* Remove learned ui embeddings

* Learned embedding and norm comments

* fit comments

* Removed unused code

* Comments on main file

* Removed more and comments

* More comments

* More comments

* Updated readmes

* Fix dataset name

* Reference fix

* Path fix

* Removed example

* Removed HypAR from examples readme

* Styling

* Added hypar doc string

* Removed spacing

* Added paper link

* Moved docstrings to earlier

* Simplified model type

* Added paper reference

* Added lightgcn as part of HypAR

* Updated url

* Fix double normalize of first layer

.gitignore

@@ -56,6 +56,11 @@ coverage.xml
 # Sphinx documentation
 docs/_build/
 
+# Dataset stuff
+**.pickle
+**.csv
+**.lock
+**.zip
 
 # Environment
 env

README.md

@@ -147,6 +147,7 @@ The recommender models supported by Cornac are listed below. Why don't you join
 
 | Year | Model and paper | Model type | Require-ments | Examples |
 | :---: | --- | :---: | :---: | :---: |
+| 2024 | [Hypergraphs with Attention on Reviews (HypAR)](cornac/models/hypar), [paper](https://doi.org/10.1007/978-3-031-56027-9_14)| Hybrid / Sentiment / Explainable | [reqs](cornac/models/hypar/requirements_cu116.txt) | [exp](https://github.com/PreferredAI/HypAR)
 | 2021 | [Bilateral Variational Autoencoder for Collaborative Filtering (BiVAECF)](cornac/models/bivaecf), [paper](https://dl.acm.org/doi/pdf/10.1145/3437963.3441759) | Collaborative Filtering / Content-Based | [reqs](cornac/models/bivaecf/requirements.txt) | [exp](https://github.com/PreferredAI/bi-vae)
 |      | [Causal Inference for Visual Debiasing in Visually-Aware Recommendation (CausalRec)](cornac/models/causalrec), [paper](https://arxiv.org/abs/2107.02390) | Content-Based / Image | [reqs](cornac/models/causalrec/requirements.txt) | [exp](examples/causalrec_clothing.py)
 |      | [Explainable Recommendation with Comparative Constraints on Product Aspects (ComparER)](cornac/models/comparer), [paper](https://dl.acm.org/doi/pdf/10.1145/3437963.3441754) | Explainable | N/A | [exp](https://github.com/PreferredAI/ComparER)

cornac/models/__init__.py

@@ -49,6 +49,7 @@
 from .hft import HFT
 from .hpf import HPF
 from .hrdr import HRDR
+from .hypar import HypAR
 from .ibpr import IBPR
 from .knn import ItemKNN
 from .knn import UserKNN

cornac/models/hypar/__init__.py

@@ -0,0 +1,16 @@
+# Copyright 2018 The Cornac Authors. All Rights Reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ============================================================================
+
+from .recom_hypar import HypAR