TSMP-PDAF Build Examples

A collection of build examples for TSMP-PDAF.

All builds involving more than one coupled component model use the coupling software Oasis3-MCT.

Compile fully coupled TSMP-PDAF (on JURECA)

The first example runs the build script of TSMP-PDAF, specifies the machine JURECA, specifies the component models CLM, COSMO and ParFlow and specifies version 1.1.0MCTPDAF.

  ./build_tsmp.ksh -m JURECA -c clm-cos-pfl -v 1.1.0MCTPDAF

The -c and -v flag are optional in this case because the inputs for these flags on -m JURECA are equivalent to the corresponding default inputs.

The -v flag is optional in this case because -c clm-cos-pfl is the default input for this flag on -m JURECA and for version -v 1.1.0MCTPDAF.

By default the build_tsmp.ksh script will make a copy of the original model source folder (named as in the catalog, f.e. clm3_5, cosmo4_21, and parflow) and back it up to MODEL_ARCH_VERSION_COMBINATION.

With the flags -wxyz (see man-page) you can specify your own directory where it is backed up to. If you like to use your own folder structure for the models you can again select your own model-path with -wxyz and avoid making a backup with -WXYZ option set to “build”.

Compile Parflow and CLM with PDAF

Build commands

Build commands for different machines.

Remarks:

  • For building TSMP-PDAF with DA, use branch TSMP_pdaf

  • Parflow-3.9 is supported using version tag 3.1.0MCTPDAF. For older versions, use 3.0.0MCTPDAF (>=3.2, <3.7), 1.1.0MCTPDAF (<3.2).

JURECA

  ./build_tsmp.ksh -m JURECA -c clm-pfl -v 3.1.0MCTPDAF -O Intel

JUWELS

  ./build_tsmp.ksh -m JUWELS -c clm-pfl -v 3.1.0MCTPDAF -O Intel

Remote build

	./build_tsmp_remote -m JUWELS -v 3.1.0MCTPDAF -O Intel -c clm-pfl -branch TSMP_pdaf -host juwels &
	./build_tsmp_remote -m JURECA -v 3.1.0MCTPDAF -O Intel -c clm-pfl -branch TSMP_pdaf -host jureca &

Component Models

The build commands were last tested for these component models

Not used:

Compile ParFlow standalone with PDAF (on JUWELS without compiler optimization)

  ./build_tsmp.ksh -m JUWELS -c pfl -v 1.1.0MCTPDAF -o -O0

The -c and -v flag are optional in this case because the inputs for these flags on -m JUWELS are equivalent to the corresponding default inputs.

  ./build_tsmp.ksh -m JUWELS -c pfl -v 1.1.0MCTPDAF -o -g

The -g flag, is build to produce debugging information.

Compile CLM5 with PDAF

CLM5-PDAF compilation, currently available only on branch TSMP_pdaf-clm5 (January 2023).

	./build_tsmp.ksh -v 4.4.0MCTPDAF -c clm -m JURECA -O Intel

Prerequisite1: CLM5 preparation

For obtaining and preparing the component model clm5_0, you have to run the following commands

	git clone git@github.com:ESCOMP/CTSM.git clm5_0
	cd clm5_0
	git checkout release-clm5.0
	./manage_externals/checkout_externals

Prerequisite2: Path to cesm

The path CESMDATAROOT needs to be changed in TSMP/bldsva/intf_oas3/clm5_0/arch/JURECA/config/softwarepaths.ksh. (analogous for JUWELS).

Currently you need to have access to compute project cjicg41 and use the line:

	export CESMDATAROOT=/p/scratch/cjicg41/<user>/cesm

For <user>, please contact someone on the inside.

Debug tips

Debug Tip 1: Skip component models in TSMP-PDAF build

./build_tsmp.ksh -m JURECA -c clm-cos-pfl -v 1.1.0MCTPDAF -W skip -X skip

Oasis and CLM compilation are skipped with the option skip for flags -W and -X. Parflow and pdaf are compiled after Cosmo.

All flags can be found using ./build_tsmp.ksh --help. Here, the output for flag of componeent model build options:

	-W, --optoas=optoas
                  Build option for Oasis.
                    fresh        #build from scratch in a new folder
                    build        #build clean
                    make         #only (resume) make and make install - no make clean and configure
                    configure    #only make clean and configure - no make
                    skip         #no build
                  The default value is 'fresh'.
  -E, --opticon=opticon
                  Build option for ICON. The default value is 'fresh'.
  -Y, --optcos=optcos
                  Build option for Cosmo. The default value is 'fresh'.
  -X, --optclm=optclm
                  Build option for CLM. The default value is 'fresh'.
  -Z, --optpfl=optpfl
                  Build option for Parflow. The default value is 'fresh'.
  -U, --optda=optda
                  Build option for Data Assimilation. The default value is 'fresh'.

Debug Tip 2: Building TSMP-PDAF after source code changes in component models

./build_tsmp.ksh -m JURECA -c clm-cos-pfl -v 1.1.0MCTPDAF -W skip -X skip -Y make

Oasis and CLM compilation are skipped with the option skip for flags -W and -X.

Cosmo compilation is resumed without making clean with option make for flag -Y. The source code change needs to be made in cosmo4_21_JURECA_1.1.0MCTPDAF_clm-cos-pfl. But note: The source code change will be lost after the next clean build of cosmo. Thus, make sure to incorporate the source code changes in the designated replace structures.