Installation

R5py is available from PyPi and conda-forge, and can be installed using pip, mamba, or conda. See below for detailed instructions for each installation method.

For Windows users, we generally recommend to use mamba or conda to create a new dedicated environment and install r5py and its dependencies into it.

On Linux and MacOS, depending on your use case, either approach might be appropriate:

• If r5py is installed via pip, system-wide resources can be re-used (and managed by the system package manager), lowering both disk and memory footprint - but you need manually ensure that a Java environment is installed.

• If installed via conda/mamba, r5py is as much a turnkey solution on Linux and MacOS as it is on Windows, at the expense of a slight performance decrease. However, as additional package managers, conda and mamba are not available from the default package sources on all distributions; Debian and Debian-based systems, such as Ubuntu or Mint, for instance, do not provide conda packages.

Python package/environment managers

If you are new to the (sometimes confusing) world of Python package managers, read more about them in chapter 1 of Python for Geographic Data Analysis.

Install using mamba/conda

Mamba

Mambaforge (available for Windows/Linux/Mac) is a drop-in replacement for the popular package manager Miniconda, sporting tremendously improved installation times.

To use Mambaforge, simply replace conda with mamba in the code examples below.

To install r5py and all its dependencies into a newly created conda environment, use conda create (or mamba create):

conda create \
    --name r5py \
    --channel conda-forge \
    r5py

This will create a new environment r5py, and install r5py and its dependencies using the conda-forge repository. To start working inside the newly created environment, run

conda activate r5py

If you want to use r5py in a notebook environment, install JupyterLab:

conda install --channel conda-forge jupyterlab

Install r5py into an existing environment

If you already have an existing conda environment, and want to install r5py in addition to the packages already installed there, activate the environment, and run:

conda install --channel conda-forge r5py

Install using pip

To install r5py from PyPi, the official Python package index, use pip:

pip install r5py

Note that this does not automatically install a Java environment. You will have to ensure that a Java Development Kit is available, see instructions below.

Dependencies

Java Development Kit

R5py relies on one notable external dependency: a Java environment. To interface with R⁵, r5py requires a Java Development Kit (jdk).

If you installed r5py using conda or mamba, an appropriate version of OpenJDK has been installed as a dependency, and you are ready to go. If you used pip, or installed r5py manually, please install a JDK, for instance OpenJDK.

Consider installing it from your system’s package manager, or the official Microsoft build in case you work on Windows.