allofplos 0.10.2

Why allofplos?

This is for downloading/updating/maintaining a repository of all PLOS XML article files. This can be used to have a copy of the PLOS text corpus for further analysis. Use this program to download all PLOS XML article files instead of doing web scraping.

NOTE: This software is not stable, we consider it beta state and will be in this stage until version 1.0. This means that programming interface may change and after a new version a full corpus download may be required.

Installation instructions

This program requires Python 3.4+.

Make a virtual environment:

$ virtualenv allofplos

Using pip:

(allofplos)$ pip install allofplos

This should install allofplos and requirements. At this stage you are ready to go.

If you want to manually install from source (for example for development purposes), first clone the proyect repository:

(allofplos)$ git clone git@github.com:PLOS/allofplos.git

Install Python dependencies inside the newly created virtual environment:

(allofplos)$ pip install -r requirements.txt

How to run the program

Execute the following command.

(allofplos)$ python -m allofplos.plos_corpus

The first time it runs it will download a >4.4 Gb zip file (allofplos_xml.zip) with all the XML files inside. Note: Make sure that you have enough space in your device for the zip file and for it content before running this command (at least 30Gb). After this file is downloaded, it will extract it contents into allofplos_xml directory inside your installation of allofplos.

If you want to see the directory on your file system where this is installed run

python -c "from allofplos.plos_regex import corpusdir; print(corpusdir)"

If you ever downloaded the corpus before, it will make an incremental update to the existing corpus, the script checks for and then downloads to a temporary folder:

• individual new articles that have been published

• of those new articles, checks whether they are corrections (and whether the linked corrected article has been updated)

• checks whether there are VORs (Versions of Record) for uncorrected proofs in the main articles directory & downloads those

• checks whether the newly downloaded articles are uncorrected proofs or not after all of these checks, it moves the new articles into the main articles folder.

Here’s what the print statements might look like on a typical run:

147 new articles to download.
147 new articles downloaded.
3 corrected articles found.
0 corrected articles downloaded with new xml.
Creating new text list of uncorrected proofs from scratch.
No new VOR articles indexed in Solr.
17 VOR articles directly downloaded.
17 uncorrected proofs updated to version of record. 44 uncorrected proofs remaining in uncorrected proof list.
9 uncorrected proofs found. 53 total in list.
Corpus started with 219792 articles.
Moving new and updated files...
164 files moved. Corpus now has 219939 articles.

How to run the tests

If you have pytest installed, from anywhere in the allofplos directory, run:

(allofplos)$ pytest

If you do not have pytest installed, from the top-level project directory, run:

(allofplos)$ python -m allofplos.tests.test_unittests

Should return something like this:

......
----------------------------------------------------------------------
Ran 6 tests in 3.327s

OK

Community guidelines

If you wish to contribute to this project please open a ticket in the GitHub repo at https://github.com/PLOS/allofplos/issues. For support requests write to mining@plos.org