Installation

There are two supported ways to install HermesPy on your system. Users may either pull pre-built wheels from the official python package index PyPi or or clone the source code from the GitHub and build the package from scratch.

Both methods will be described in the following sections.

Install from PyPi

Pulling HermesPy from PyPi is the recommended installation method for end-users who do not intend to extend the HermesPy source code.

HermesPy is registered as an official package within the python package index. Binaries for Windows, most Linux distributions and MacOS, built from the newest release version of HermesPy, are distributed via the index, enabling easy installations for most operating systems.

Install the package by executing the following commands within a terminal:

conda create -n <envname> python=3.9
conda activate <envname>
conda install pip
pip install hermespy

Executing these statements sequentially results in the following actions:

  1. Creation of a new virtual environment titled <envname>

  2. Activate the newly created environment

  3. Install the HermesPy wheel from PyPi within the environment

Note that if you plan on utilizing HermesPy within an already existing Python environment, you may omit step one and replace <envname> by the title of the existing environment.

Install from Source

Cloning the HermesPy source code and manually building / installing its package is the recommended way for developers who plan on extending the HermesPy source code. Additionally, it can also be applied by users who, for any reason, are unable to install HermesPy from the index.

Using the Git command line interface, the HermesPy source code can be copied to any system by executing

git clone <this-repo>
cd hermespy/

within a terminal. Make sure to have the LFS extension to Git installed.

Install the package by executing the following commands within a terminal:

conda create -n <envname> python=3.9
conda activate <envname>
conda install pip
pip install .

Executing these statements sequentially results in the following actions:

  1. Creation of a new virtual environment titled <envname>

  2. Activate the newly created environment

  3. Install the HermesPy wheel from source within the environment

Note that if you plan on utilizing HermesPy within an already existing Python environment, you may omit step one and replace <envname> by the title of the existing environment.

If you plan to alter the source code in any way, we recommend appending the editable flag

pip install -e .

during installation.

Install Quadriga

In addition to its native channel models, HermesPy supports the Quadriga channel model as an external dependency. For it to be used, some preliminary steps need to be taken. Quadriga is based on Matlab and can be executed by either the Matlab interpreter or its open-source equivalent Octave.

In order to execute the Matlab interpreter the matlab.engine package provided by Matlab needs to be installed manually.

In order to execute the Octave interpreter the additional oct2py package needs to be installed (pip install oct2py). Under Windows, an extension of the PATH variable may be required for oct2py to be able to locate the octave command line interface:

setx PATH "%PATH%;<path-to-octave-cli>"