Building the kaiju software on aitken for MAGE - Without TIEGCM (GR)

Introduction

This page provides instructions for building the kaiju software on the aitken supercomputer. These instructions assume that you have cloned the kaiju repository.

Prepare your software environment

Like most HPC systems, aitken uses the module system to manage the versions of software packages available to the user. When you log in to aitken, no modules are loaded by default:

module list
No Modulefiles Currently Loaded.

Start by purging any currently-loaded modules, then loading the following module set:

module --force purge

module use -a /swbuild/analytix/tools/modulefiles
module load nas
module load pkgsrc/2022Q1-rome
module load comp-intel/2020.4.304
module load mpi-hpe/mpt.2.23
module load hdf5/1.8.18_mpt
module load miniconda3/v4

Important

You must use these exact versions of the modules to ensure the software compiles properly. If you use different versions of any of these modules, a successful build cannot be guaranteed. This module list is current as of 11 April 2025, and is subject to change as the compute environment changes.

Build the kaiju software

These instructions show how to build the MPI version of the kaiju software. The MPI version is built in the subdirectory build_mpi under the kaiju source code directory. In practice, you can place the build directory in any convenient location.

# Move to your kaiju clone.
cd /path/to/kaiju

# Create the build directory and enter it.
mkdir build_mpi
cd build_mpi

# Run cmake to create the Makefile, saving output.
# NOTE: The FC definition is *required* for proper cmake operation.
FC=`which ifort` cmake -DENABLE_MPI=ON .. >& cmake.out

# You can pick one compile target below or compile all of them, if you'd like

# Compile the MAGE model for geospace simulations
make -j4 voltron_mpi.x >& make-voltron.out

# Compile the GAMERA-helio model for inner heliosphere simulations
make -j4 gamhelio_mpi.x >& make-gamhelio.out

# Compile analysis tools
make -j4 calcdb.x chop.x sctrack.x slice.x >& make-analysis.out

When finished, your build directory will contain a bin subdirectory which will contain the compiled kaiju executables.

Note

Documentation on the analysis tools is found here.