Installing pyrecodes

The prerequisite for installing pyrecodes is having Python version 3.9.6 installed on your machine.

pip install

The simplest way to install pyrecodes is to use pip:

pip install --pre pyrecodes

Basic version of pyrecodes does not include dependencies required to run third-party infrastructure simulators to avoid potential dependency issues in case users do not use third-party model APIs. However, to install the version of pyrecodes with third-party infrastructure simulators, run the following command:

pip install --pre "pyrecodes[third_party_models]"

Cloning the repository

pyrecodes can also be installed by cloning the source code available on Github.

It’s good practice to use a virtual environment when installing pyrecodes to keep its dependencies isolated from other Python projects on your machine. The repository includes two requirements files in the root directory, allowing you to install all dependencies at once in case you are having trouble with pip installing pyrecodes.

Baisc pyrecodes requires dependencies listed in requirements.txt file. To install all dependencies, run the following command:

pip install -r requirements.txt

Full version of pyrecodes requires dependencies listed in requirements_third_party_models.txt file.

pip install -r requirements_third_party_models.txt

Note

Please note that python version x86_64 is required to run the third-party infrastructure simulators presented in Example 5. Further instructions are available here.

Running Examples

To ensure that the installation is successful, please run Example 1 as specified in the Examples page.

All examples are written as Jupyter notebooks and can be run locally or online using Google Colab. More information on installing Jupyter notebooks can be found here.