Getting Started

Dependencies

You should first ensure that all the core dependencies listed in the README.md file are satisfied. Many of these packages can be installed either via a package manager such as apt, or via the Python package manager (pip) using

sudo pip install -r requirements.txt

from the OpenSBLI base/root directory.

Obtaining OPS

In order to target and compile the generated OPSC code, you will need to have OPS available. First, clone the OPS GitHub repository using

git clone https://github.com/gihanmudalige/OPS.git

and install it by running sudo python setup.py install from within the OPS directory that is created by the git clone process.

You will then need to set up your OPS-related environment variables, listed below. Note that the values given here are system-dependent and may need to be adapted depending on where the MPI or HDF5 libraries are installed. Furthermore, it is assumed that the OPS GitHub repository has been cloned in your home (~) directory.

export OPS_INSTALL_PATH=~/OPS/ops
export OPS_COMPILER=gnu
export MPI_INSTALL_PATH=/usr/
export HDF5_INSTALL_PATH=/usr/

You can include these export commands in your ~/.bashrc file to save typing them out each time you open up a new terminal.

Installing OpenSBLI

First, clone the OpenSBLI GitHub repository using

git clone https://github.com/opensbli/opensbli.git

You can install OpenSBLI using

sudo make install

from within the base directory of OpenSBLI. Alternatively, particularly for developers of OpenSBLI, you can simply point your PYTHONPATH environment variable to the OpenSBLI base directory using, for example,

export PYTHONPATH=$PYTHONPATH:~/opensbli

After installation, it is recommended that you run the test suite to check that OpenSBLI is performing as it should by using

make test