ACCESS ESM Build Environment for GADI

Prerequisites

• Need passwordless login on accessdev from gadi

Usage

git clone 
make

Make targets:

• oasis: Compiles the OASIS-MCT library in lib/oasis, and enables that version for future compiles
• gcom: Compiles the GCOM library in lib/gcom, and enables that version for future compiles
• um: Build the UM to bin/um_hg3.exe
• mom: Build MOM5 to bin/mom5xx
• cice: Build CICE4.1 to bin/cice
• all: same as um mom cice

Build environment:

A file environment.sh is created automatically by the makefile, it can be edited if required. This file sets up the build environment for all submodules.

Building src/cice4.1

The source code is the ESM_1.5 branch of https://github.com/ACCESS-NRI/cice4, altered as follows

	sed -i 's/\([[:space:]]*setenv CPLLIBDIR\).*$$/\1 $$OASIS_LIB_DIR/' $@/compile/comp_access-cm_cice.RJ.nP-mct
	sed -i 's/\([[:space:]]*setenv CPLINCDIR\).*$$/\1 $$OASIS_INCLUDE_DIR/' $@/compile/comp_access-cm_cice.RJ.nP-mct
	rm -f $@/compile/environs.raijin.nci.org.au ; touch $@/compile/environs.raijin.nci.org.au
	cp patch/Macros.Linux.raijin.nci.org.au-mct $@/bld

The first two lines change the following two lines of https://github.com/ACCESS-NRI/cice4/blob/ESM_1.5/compile/comp_access-cm_cice.RJ.nP-mct

  setenv CPLLIBDIR /projects/access/apps/oasis3-mct/ompi.1.10.2/lib
  setenv CPLINCDIR /projects/access/apps/oasis3-mct/ompi.1.10.2/include

to use $OASIS_LIB_DIR and $OASIS_INCLUDE_DIR instead. These resolve to

export OASIS_INCLUDE_DIR=$${PWD}/lib/oasis/include
export OASIS_LIB_DIR=$${PWD}/lib/oasis/lib

respectively, with lib/oasis obtained and built from the access-esm1.5 branch of https://github.com/ACCESS-NRI/oasis3-mct

The third line removes the environment setup script https://github.com/ACCESS-NRI/cice4/blob/ESM_1.5/compile/environs.raijin.nci.org.au so that the access-esm-build-gadi ENVFILE script ./environment.sh is used instead.

The fourth line copies the Makefile macro file patch/Macros.Linux.raijin.nci.org.au-mct into the bld directory so that the following lines in https://github.com/ACCESS-NRI/cice4/blob/ESM_1.5/compile/comp_access-cm_cice.RJ.nP-mct can work with ARCH set to raijin.nci.org.au:

gmake VPFILE=Filepath EXEC=$BINDIR/$EXE \
           NXGLOB=$NXGLOB NYGLOB=$NYGLOB \
           N_ILYR=$N_ILYR \
           BLCKX=$BLCKX BLCKY=$BLCKY MXBLCKS=$MXBLCKS \
      -f  $CBLD/Makefile MACFILE=$CBLD/Macros.Linux.${ARCH}-mct || exit 2

Building bin/cice-12p

The access-esm-build-gadi Makefile builds bin/cice-12p using the single line

source $(ENVFILE) ; cd $</compile ; csh ./comp_access-cm_cice.RJ.nP-mct 12

so that the script file https://github.com/ACCESS-NRI/cice4/blob/ESM_1.5/compile/comp_access-cm_cice.RJ.nP-mct is called with $1 == 12, which sets nproc = 12.

The script file compile/comp_access-cm_cice.RJ.nP-mct

This script file sets the values of variables and then calls gmake as above.

Notably:

• The variables GRID and RES are set with opposite semantics to their use in the solo_ice_comp script and the comp_ice script in the main branch. Here:

#setenv GRID gx3 ; setenv RES 100x116
#setenv GRID gx1 ; setenv RES 320x384
#setenv GRID tx1 ; setenv RES 360x240
setenv GRID tp1 ; setenv RES 360x300

In solo_ice_comp and in comp_ice in the main branch:

setenv RES gx3 ; setenv GRID 100x116
#setenv RES gx1 ; setenv GRID 320x384
#setenv RES tx1 ; setenv GRID 360x240
#setenv RES col ; setenv GRID 5x5

• The variable GRID is set to tp1 but never used. In the solo_ice_comp script, the variable RES is used to select a subdirectory of input_templates in order to obtain the files grid, kmt, ice_in, iced_$RES* and ice.restart_file. In contrast, here the input_templates directory is never referenced. Instead, the equivalents of these files are defined via the Payu config.yaml file. In particular, the file used to define namelists is called cice_in.nml, not ice_in.