.idea (0, 2022-03-25)
LICENSE (11357, 2022-03-25)
data (0, 2022-03-25)
data\gos_id_time_mapping.pkl (2995950, 2022-03-25)
data\gos_id_twitter_mapping.pkl (6197860, 2022-03-25)
data\gos_news_list.txt (103523, 2022-03-25)
data\pol_id_time_mapping.pkl (327369, 2022-03-25)
data\pol_id_twitter_mapping.pkl (676036, 2022-03-25)
data\pol_news_list.txt (4868, 2022-03-25)
gnn_model (0, 2022-03-25)
gnn_model\bigcn.py (8178, 2022-03-25)
gnn_model\gcnfn.py (5968, 2022-03-25)
gnn_model\gnn.py (5821, 2022-03-25)
gnn_model\gnncl.py (6101, 2022-03-25)
hyper_parameters.md (1420, 2022-03-25)
overview.png (303129, 2022-03-25)
requirements.txt (73, 2022-03-25)
utils (0, 2022-03-25)
utils\data_loader.py (7447, 2022-03-25)
utils\eval_helper.py (1450, 2022-03-25)
utils\profile_feature.py (1267, 2022-03-25)
utils\twitter_crawler.py (942, 2022-03-25)
# GNN-based Fake News Detection
[](https://codeocean.com/capsule/7305473/tree)
[](https://paperswithcode.com/sota/graph-classification-on-upfd-gos?p=user-preference-aware-fake-news-detection)
[](https://paperswithcode.com/sota/graph-classification-on-upfd-pol?p=user-preference-aware-fake-news-detection)
[Installation](#installation) | [Datasets](#datasets) | [Models](#models) | [PyG Example](https://github.com/rusty1s/pytorch_geometric/blob/master/examples/upfd.py) | [DGL Example](https://github.com/dmlc/dgl/blob/master/python/dgl/data/fakenews.py) | [Benchmark](https://paperswithcode.com/dataset/upfd) | [Intro Video](https://youtu.be/QAIVFr24FrA) | [How to Contribute](#how-to-contribute)
This repo includes the Pytorch-Geometric implementation of a series of Graph Neural Network (GNN) based fake news detection models.
All [GNN models](#user-guide) are implemented and evaluated under the User Preference-aware Fake News Detection ([UPFD](https://arxiv.org/pdf/2104.12259.pdf)) framework.
The fake news detection problem is instantiated as a graph classification task under the UPFD framework.
You can make reproducible run on [CodeOcean](https://codeocean.com/capsule/7305473/tree) without manual configuration.
The UPFD dataset and its example usage is also available at the PyTorch-Geometric official repo
We welcome contributions of results of existing models and the SOTA results of new models based on our dataset.
You can check the [benchmark](https://paperswithcode.com/dataset/upfd) hosted by PaperWithCode for SOTA models and their performances.
If you use the code in your project, please cite the following paper:
SIGIR'21 ([PDF](https://arxiv.org/pdf/2104.12259.pdf))
```bibtex
@inproceedings{dou2021user,
title={User Preference-aware Fake News Detection},
author={Dou, Yingtong and Shu, Kai and Xia, Congying and Yu, Philip S. and Sun, Lichao},
booktitle={Proceedings of the 44th International ACM SIGIR Conference on Research and Development in Information Retrieval},
year={2021}
}
```
## Installation
### Install via PyG
Our [dataset](https://github.com/rusty1s/pytorch_geometric/blob/master/torch_geometric/datasets/upfd.py) has been integrated with the official PyTorch-Geometric library. Please follow the installation instructions of [PyTorch-Geometric](https://github.com/rusty1s/pytorch_geometric) to install the latest version of PyG and check the [code example](https://github.com/rusty1s/pytorch_geometric/blob/master/examples/upfd.py) for dataset usage.
### Install via DGL
Our [dataset](https://github.com/dmlc/dgl/blob/master/python/dgl/data/fakenews.py) has been integrated with the official [Deep Graph library](https://github.com/dmlc/dgl)(DGL). Please follow the installation instructions of [DGL](https://github.com/dmlc/dgl) to install the latest version of DGL and check the [docstring](https://github.com/dmlc/dgl/blob/master/python/dgl/data/fakenews.py) of the dataset class for dataset usage.
### Manually Install
To run the code in this repo, you need to have `Python>=3.6`, `PyTorch>=1.6`, and `PyTorch-Geometric>=1.6.1`.
Please follow the installation instructions of [PyTorch-Geometric](https://github.com/rusty1s/pytorch_geometric) to install PyG.
Other dependencies can be installed using the following commands:
```bash
git clone https://github.com/safe-graph/GNN-FakeNews.git
cd GNN-FakeNews
pip install -r requirements.txt
```
## Datasets
If you have installed the latest version of PyG or DGL, you can use their built-in dataloaders to download and load the UPFD dataset.
If you install the project manually, you need to download the dataset (1.2GB)
via the links below and
unzip the corresponding data under the `\data\{dataset_name}\raw\` directory,
the `dataset_name` is `politifact` or `gossipcop`.
Google Drive: https://drive.google.com/drive/folders/1OslTX91kLEYIi2WBnwuFtXsVz5SS_XeR?usp=sharing
Baidu Disk: https://pan.baidu.com/s/1NFtuwzmpAezNcJzlSlduSw Password: fj43
The dataset includes fake&real news propagation networks on Twitter built according to fact-check information from
[Politifact](https://www.politifact.com/) and [Gossipcop](https://www.gossipcop.com/).
The news retweet graphs were originally extracted by [FakeNewsNet](https://github.com/KaiDMML/FakeNewsNet).
We crawled near 20 million historical tweets from users who participated in fake news propagation in FakeNewsNet to
generate node features in the dataset.
The statistics of the dataset is shown below:
| Data | #Graphs | #Fake News| #Total Nodes | #Total Edges | #Avg. Nodes per Graph |
|-------|--------|--------|--------|--------|--------|
| Politifact | 314 | 157 | 41,054 | 40,740 | 131 |
| Gossipcop | 54*** | 2732 | 314,262 | 308,7*** | 58 |
Due to the Twitter policy, we could not release the crawled user historical tweets publicly.
To get the corresponding Twitter user information, you can refer to news lists and the node_id-twitter_id mappings under `\data`.
Two `xxx_id_twitter_mapping.pkl` files include the dictionaries with the keys as the node_ids in the datasets and the values represent corresponding Twitter user_ids.
For the news node, its value represents news id in the [FakeNewsNet](https://github.com/KaiDMML/FakeNewsNet) datasets.
Similarly, two `xxx_id_time_mapping.pkl` files include the node_id to its corresponding Tweet timestamp mappings.
Note that the timestamp is in UNIX timestamp format. The news node doesn’t contain timestamp even in the original FakeNewsNet dataset, you can either retrieve it on Twitter or use its most recent retweet time as an approximation.
In the UPFD project, we use [Tweepy](https://www.tweepy.org/) and [Twitter Developer API](https://developer.twitter.com/en) to get the user information, the crawler code can be found at [\utils\twitter_crawler.py](https://github.com/safe-graph/GNN-FakeNews/blob/main/utils/twitter_crawler.py).
We incorporate four node feature types in the dataset, the 768-dimensional `bert` and 300-dimensional `spacy` features
are encoded using pretrained [BERT](https://github.com/hanxiao/bert-as-service) and [spaCy](https://spacy.io/models/en#en_core_web_lg) word2vec, respectively.
The 10-dimensional `profile` feature is obtained from a Twitter account's profile.
You can refer to [profile_feature.py](https://github.com/safe-graph/GNN-FakeNews/blob/master/utils/profile_feature.py) for profile feature extraction.
The 310-dimensional `content` feature is composed of a 300-dimensional user comment word2vec (spaCy) embedding
plus a 10-dimensional profile feature.
Each graph is a hierarchical tree-structured graph where the root node represents the news, the leaf nodes are Twitter users who retweeted the root news.
A user node has an edge to the news node if he/she retweeted the news tweet. Two user nodes have an edge if one user retweeted the news tweet from the other user.
The following figure shows the UPFD framework including the dataset construction details
You can refer to the [paper](https://arxiv.org/pdf/2005.00625.pdf) for more details about the dataset.
## Models
All GNN-based fake news detection models are under the `\gnn_model` directory.
You can fine-tune each model according to arguments specified in the argparser of each model.
The implemented models are as follows:
* **[GNN-CL](https://arxiv.org/pdf/2007.03316.pdf)**: Han, Yi, Shanika Karunasekera, and Christopher Leckie. "Graph neural networks with continual learning for fake news detection from social media." arXiv preprint arXiv:2007.03316 (2020).
* **[GCNFN](https://arxiv.org/pdf/1902.06673.pdf)**: Monti, Federico, Fabrizio Frasca, Davide Eynard, Damon Mannion, and Michael M. Bronstein. "Fake news detection on social media using geometric deep learning." arXiv preprint arXiv:1902.06673 (2019).
* **[BiGCN](https://arxiv.org/pdf/2001.06362.pdf)**: Bian, Tian, Xi Xiao, Tingyang Xu, Peilin Zhao, Wenbing Huang, Yu Rong, and Junzhou Huang. "Rumor detection on social media with bi-directional graph convolutional networks." In Proceedings of the AAAI Conference on Artificial Intelligence, vol. 34, no. 01, pp. 549-556. 2020.
* **[UPFD-GCN](https://arxiv.org/pdf/1609.02907.pdf)**: Kipf, Thomas N., and Max Welling. "Semi-supervised classification with graph convolutional networks." arXiv preprint arXiv:1609.02907 (2016).
* **[UPFD-GAT](https://arxiv.org/pdf/1710.10903.pdf)**: Velickovic, Petar, Guillem Cucurull, Arantxa Casanova, Adriana Romero, Pietro Lio, and Yoshua Bengio. "Graph attention networks." arXiv preprint arXiv:1710.10903 (2017).
* **[UPFD-SAGE](https://cs.stanford.edu/people/jure/pubs/graphsage-nips17.pdf)**: Hamilton, William L., Rex Ying, and Jure Leskovec. "Inductive representation learning on large graphs." arXiv preprint arXiv:1706.02216 (2017).
Since the UPFD framework is built upon the [PyG](https://github.com/rusty1s/pytorch_geometric), you can easily try other graph classification models
like [GIN](https://github.com/rusty1s/pytorch_geometric/blob/master/examples/mutag_gin.py) and [HGP-SL](https://github.com/cszhangzhen/HGP-SL)
under our dataset.
## How to Contribute
You are welcomed to submit your model code, hyper-parameters, and results to this repo via create a pull request.
After verifying the results, your model will be added to the repo and the result will be updated to the [benchmark](https://paperswithcode.com/dataset/upfd).
Please email to [ytongdou@gmail.com](mailto:ytongdou@gmail.com) for other inquiries.