Installation with Spack¶

Installation with Spack is easy and preferable for users who don't want to develop in microStamp or exaNBody. Only stable versions are added when you install exaNBody with Spack, meaning that it doesn't provide you access to the development branches. In addition, the main branch of exaNBody will never be directly accessible via this installation method.

Minimal requirements¶

Spack package manager¶

Below are instructions to first retrieve spack sources and install it on your system. First, clone the corresponding git repository and source the appropriate environment.

1
2
3
4
5
6
7
8
9

# 1. Retrieve Spack and add the path to your .bashrc

mkdir ${HOME}/dev && cd ${HOME}/dev
git clone --depth=2 --branch=v1.1.0 https://github.com/spack/spack.git
export SPACK_ROOT=${HOME}/dev/spack

# 2. Activate the Spack environment

source ${SPACK_ROOT}/share/spack/setup-env.sh

YAML library¶

All three platforms extensively use the YAML Library. It can be easily installed through spack as follows:

1
2

spack install yaml-cpp@0.6.3
spack load yaml-cpp@0.6.3

At this point, you should have YAML installed on your system. Please note that the installation procedure of YAML from sources using CMake also works on HPC clusters. In the following, remember to add the `-DCMAKE_PREFIX_PATH=${YAML_CPP_INSTALL_DIR} argument to your cmake command.

exaNBody x microStamp¶

First, clone the spack-repos GitHub repository on your computer and add this repository to spack. This repository contains onika and exaNBody recipes that allow for their installation.

git clone https://github.com/Collab4exaNBody/spack-repos.git
spack repo add spack-repos

Then, simply install exaNBody. To get access to the microStamp mini application, you need to require the contribs variant as follows:

spack install exanbody+contribs

spack install exanbody+contribs+cuda

The default version will be the latest stable release.