Skip to main content

Statistical tools for the ASReview project

Project description


Deploy and releaseBuild status

ASReview extension for generating statistics on state files and datasets.


Install the package with:

pip install asreview-statistics

The general usage of the package is to inspect files related to the systematic review done with ASReview. It can be used to inspect your dataset that you would like to review (or have reviewed).

General usage:

asreview stat path_to_file


Use the following command on your command line:

asreview stat path_to_your_dataset

It should give some general properties of the dataset, e.g.:

************  PTSD_VandeSchoot_18.csv  ************

Number of papers:            5782
Number of inclusions:        38 (0.66%)
Number of exclusions:        5744 (99.34%)
Number of unlabeled:         0 (0.00%)
Average title length:        101
Average abstract length:     1339
Average number of keywords:  8.8
Number of missing titles:    64 (of which 0 included)
Number of missing abstracts: 747 (of which 0 included)

Your dataset should be in a format that is readable by the ASReview software. Documentation on how to create such a dataset is in the main project.

State files

Another use is the quick analysis of either one state file, or multiple state files in the same directory:

asreview stat path_to_your_state_files

This will give output similar to:

************  ptsd_nb  *******************

-----------  general  -----------
Number of runs            : 16
Number of papers          : 5782
Number of included papers : 38
Number of excluded papers : 5744
Number of unlabeled papers: 0
Number of queries         : 233

-----------  settings  -----------
model             : nb
query_strategy    : max_random
balance_strategy  : double
feature_extraction: tfidf
n_instances       : 25
n_prior_included  : 1
n_prior_excluded  : 1
mode              : simulate
model_param       : {'alpha': 3.822}
query_param       : {'strategy_1': 'max', 'strategy_2': 'random', 'mix_ratio': 0.95}
feature_param     : {}
balance_param     : {'a': 2.155, 'alpha': 0.94, 'b': 0.789, 'beta': 1.0}
abstract_only     : False

-----------    ATD    -----------

-----------  WSS/RRF  -----------
WSS@95 : 91.49 %
WSS@100: 87.54 %
RRF@5  : 97.30 %
RRF@10 : 97.64 %

Currently, the amount of information displayed is growing; help and suggestions are welcome!

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asreview-statistics-0.4.tar.gz (27.7 kB view hashes)

Uploaded source

Built Distribution

asreview_statistics-0.4-py3-none-any.whl (17.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page