ngmo-environments

Next Generation Environments for Momentum

Using NGMO Environments

Using the Conda and Spack package managers equivalent environments can be created across multiple sites. For sites that can use containers containerised versions of the environments can also be built.

To simplify usage across sites, a wrapper command envrun is used that will load the environment and run a command inside it. This wrapper command can abstract container arguments, environment modules and other local features.

E.g. for building and running LFRic in the NGMO LFRic environment:

export PATH=$NGMOENVS_BASEDIR/envs/lfric/bin:$PATH

# App to build from lfric_apps/applications
APP=gravity_wave

# Build the app using `envrun`
envrun lfric_apps/build/local_build.py --application $APP

# Run the app example using `envrun`
cd lfric_apps/applications/$APP/example
envrun mpirun -n  1 ../bin/$APP configuration.nml

Contents

• sites/: Site specific build scripts
• environments/: Environment definitions
• spack/: Spack package definitions
• conda/: Conda package definitions
• utils/: Shared scripts

Sites

Apptainer

Build an Apptainer/Singularity container

See site/apptainer/README.md

AWS

Build the environment on Amazon Linux

See site/aws/README.md

NCI

Build the environment on NCI Gadi - an example of building the container on a HPC using the system MPI, and of building in two stages - a download stage with network access and a build stage without network access

See site/nci/README.md

Environments

LFRic

Environment for running the Momentum LFRic model

See environments/lfric/README.md

Testing

Once an enviornment has been built it can be tested by building and running a demonstration case.

Run a test case with

./tests/run.sh <ENVIRONMENT> <SITE>