Installation

The respy package can be conveniently installed from the Python Package Index (PyPI) or directly from its source files. We currently support Python 2.7 and Python 3.3+. We develop the package on Linux systems, but it can also be installed on MacOS and Windows.

Python Package Index

You can install the stable version of the package the usual way.

$ pip install respy

We provide a pure Python implementation as our baseline. However, to address performance constraints, we also maintain scalar and parallel Fortran implementations. If additional requirements are met, both are installed automatically.

… adding Fortran

Please make sure that the gfortran compiler is available on your path and it knows where to find the Linear Algebra PACKage (LAPACK) library.

On Ubuntu systems, both can be achieved by the following commands:

$ sudo apt-get install gfortran
$ sudo apt-get install libblas-dev liblapack-dev

If so, just call a slightly modified version of the installation command.

$ pip install --no-binary respy respy

The –no-binary flag is required for now to avoid the use of Python Wheels and ensure a compilation of the Fortran source code during the build.

… adding Parallelism

We use the Message Passing Interface (MPI) library. This requires a recent version of its MPICH implementation available on your compiler’s search path which was build with shared/dynamic libraries.

Source Files

You can download the sources directly from our GitHub repository.

$ git clone https://github.com/restudToolbox/package.git

Once you obtained a copy of the source files, installing the package in editable model is straightforward.

$ pip install -e .

Test Suite

Please make sure that the package is working properly by running our test suite using pytest.

$ python -c "import respy; respy.test()"