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