rgmining-tripadvisor-dataset 0.5.1

Trip Advisor dataset for Review Graph Mining Project

# Trip Advisor Dataset Loader
[](https://www.gnu.org/copyleft/gpl.html)
[](https://github.com/rgmining/tripadvisor/releases/tag/v0.5.0)
[](https://pypi.python.org/pypi/rgmining-tripadvisor-dataset)

For the [Review Graph Mining project](https://github.com/rgmining),
this package provides a loader of the
[Trip Advisor dataset](http://times.cs.uiuc.edu/~wang296/Data/)
provided by [Dr. Wang](http://www.cs.virginia.edu/~hw5x/).


## Installation
Use pip to install this package.

```shell
$ pip install --upgrade rgmining-tripadvisor-dataset
```

Note that this installation will download a big data file from
the [original web site](http://times.cs.uiuc.edu/~wang296/Data/).


## Usage
This package provides module `tripadvisor` and this module provides `load` function.
The `load` function takes a graph object defined in [Review Graph Mining project](https://github.com/rgmining).

For example, the following code constructs a graph object provides the
[FRAUDAR](http://www.kdd.org/kdd2016/subtopic/view/fraudar-bounding-graph-fraud-in-the-face-of-camouflage) algorithm,
loads the Trip Advisor dataset,
runs the algorithm, and then outputs names of anomalous reviewers.
Since this dataset consists of huge reviews, loading may take long time.

```py
import fraudar
import tripadvisor

# Construct a graph and load the dataset.
graph = fraudar.ReviewGraph()
tripadvisor.load(graph)

# Run the analyzing algorithm.
graph.update()

# Print names of reviewers who are judged as anomalous.
for r in graph.reviewers:
if r.anomalous_score == 1:
print r.name

# The number of reviewers the dataset has: -> 1169456.
len(graph.reviewers)

# The number of reviewers judged as anomalous: -> 147.
len([r for r in graph.reviewers if r.anomalous_score == 1])
```

Note that you may need to install the FRAUDAR algorithm for the Review Mining Project
by `pip install rgmining-fraudar`.


## License
This software is released under The GNU General Public License Version 3,
see [COPYING](COPYING) for more detail.

The authors of the Trip Advisor dataset, which this software imports, requires to
cite the following papers when you publish research papers using this package:

- [Hongning Wang](http://www.cs.virginia.edu/~hw5x/),
[Yue Lu](https://www.linkedin.com/in/yue-lu-80a6a549),
and [ChengXiang Zhai](http://czhai.cs.illinois.edu/),
"[Latent Aspect Rating Analysis without Aspect Keyword Supervision](http://times.cs.uiuc.edu/~wang296/paper/p618.pdf),"
In Proc. of the 17th ACM SIGKDD Conference on Knowledge Discovery and Data Mining (KDD'2011),
pp.618-626, 2011;
- [Hongning Wang](http://www.cs.virginia.edu/~hw5x/),
[Yue Lu](https://www.linkedin.com/in/yue-lu-80a6a549),
and [Chengxiang Zhai](http://czhai.cs.illinois.edu/),
"[Latent Aspect Rating Analysis on Review Text Data: A Rating Regression Approach](http://sifaka.cs.uiuc.edu/~wang296/paper/rp166f-wang.pdf),"
In Proc. of the 16th ACM SIGKDD Conference on Knowledge Discovery and Data Mining (KDD'2010),
pp.783-792, 2010.