Before running any of the Bibliotools Python scripts, it is essential to ensure that you've locally installed all of the required dependencies the tool uses for data visualisation and argument processing.

Using Pipenv

Managing dependencies is easy using pipenv. The concrete requirements for a Python Application is set up as Pipfile, including where the packages should be fetched from and their loose version constraints.

The details of the environment (all installed packages with pinned versions and other details) is stored in Pipfile.lock, for reproducibility. This file will be automatically generated and should not be modified by the user.

If you're on MacOS, use can install Pipenv easily with Homebrew:

$ brew install pipenv

Or, if you're using Ubuntu 17.10:

$ sudo apt install software-properties-common python-software-properties
$ sudo add-apt-repository ppa:pypa/ppa
$ sudo apt update
$ sudo apt install pipenv

Otherwise, just use pip:

$ pip install pipenv

Install dependencies

$ pipenv install

And invoke shell

$ pipenv shell

Now you have all the dependencies ready to run on your local machine!

Using Pip

Installing ArgParse

You can easily install argparse with the following command:

$ pip install argparse

It is recommended to set up a python virtual environment with the virtualenv tool if you intend on using these scripts long-term. A virtualenv will keep all your dependencies for a particular project stored in the same place, rather than installing them systemwide.

Installing NumPy

You can easily install numpy with the following command:

$ pip install numpy

Installing MatPlotLib / Networkx

You may install the remaining dependencies with the following:

$ pip install matplotlib
$ pip install networkx

These tools are both used for generating graphs that will then be visualised using Gephi, or within our online visualisation environment.

Congratulations! You are now ready to start scientometric analysis with ScienceScapeS! Go Back

---

Something wrong with this set of instructions? Log an issue to help us fix it.