Machines

One of the major advantages of compass over Legacy COMPASS is that it attempts to be aware of the capabilities of the machine it is running on. This is a particular advantage for so-called “supported” machines with a config file defined for them in the compass package. But even for “unknown” machines, it is not difficult to set a few config options in your user config file to describe your machine. Then, compass can use this data to make sure test cases are configured in a way that is appropriate for your machine.

Supported Machines

If you follow the procedure in compass conda environment, compilers and system modules, you will have an activation script for activating the development conda environment, setting loading system modules and setting environment variables so you can build MPAS and work with compass. Just source the script that should appear in the base of your compass branch, e.g.:

source load_dev_compass_1.0.0_anvil_intel_impi.sh

After loading this environment, you can set up test cases or test suites, and a link load_compass_env.sh will be included in each suite or test case work directory. This is a link to the activation script that you sourced when you were setting things up. You can can source this file on a compute node (e.g. in a job script) to get the right compass conda environment, compilers, MPI libraries and environment variables for running compass tests and the MPAS model.

Machine	Compiler	MPI lib.	MPAS make target
anvil	intel	impi	intel-mpi
		openmpi	ifort
		mvapich	ifort
	gnu	mvapich	gfortran
		openmpi	gfortran
badger	intel	impi	intel-mpi
	gnu	mvapich	gfortran
chrysalis	intel	impi	intel-mpi
		openmpi	ifort
	gnu	openmpi	gfortran
compy	intel	impi	intel-mpi
cori-haswell	intel	mpt	intel-nersc
	gnu	mpt	gnu-nersc
cori-knl	intel	impi	intel-mpi
grizzly	intel	impi	intel-mpi
	gnu	mvapich	gfortran

Below are specifics for each supported machine

• Anvil
• Badger
• Chrysalis
• CompyMcNodeFace
• Cori
• Grizzly

Other Machines

If you are working on an “unknown” machine, the procedure is pretty similar to what was described in compass conda environment, compilers and system modules. The main difference is that we will use mpich or openmpi and the gnu compilers from conda-forge rather than system compilers. To create a development conda environment and an activation script for it, on Linux, run:

./conda/configure_compass_env.py --conda <conda_path> -c gnu -i mpich

and on OSX run:

./conda/configure_compass_env.py --conda <conda_path> -c clang -i mpich

You may use openmpi instead of mpich but we have had better experiences with the latter.

The result should be an activation script load_dev_compass_1.0.0_<mpi>.sh. Source this script to get the appropriate conda environment and environment variables.

Under Linux, you can build the MPAS model with

make gfortran

Under OSX, you can build the MPAS model with

make gfortran-clang