PPUG_create_postprocess

Setting up the CESM post processing case root using create_postprocess

The second setup step in running the CESM post processing tools is to create a post processing case root either as a stand-alone case or as part of an existing CESM experiment caseroot.

This step needs to be run for each unique CESM caseroot or CESM case DOUT_S_ROOT data archive.

cd [POSTPROCESS_PATH]

./create_postprocess --help

usage: create_postprocess [-h] [-backtrace] [-debug DEBUG] -caseroot CASEROOT [-cesmtag CESMTAG]

Read the necessary XML files from the postprocessing configuration system and
translate them into bash scripts for batch submission of postprocessing tasks.
Runtime options can be set in the XML files in the caseroot.

optional arguments:
  -h, --help                                show this help message and exit
  -backtrace, --backtrace                   show exception backtraces as extra debugging output
  -debug DEBUG, --debug DEBUG               debugging verbosity level output: 0 = none, 1 = minimum,
                                            2 = maximum. 0 is default
  -caseroot CASEROOT, --caseroot CASEROOT   fully quailfied path to case root directory
  -cesmtag CESMTAG, --cesmtag CESMTAG       CESM repository tag

The --caseroot option is mandatory and must contain a fully qualified path location to an existing CESM caseroot or a new postprocessing caseroot which will be created.

If an existing CESM caseroot exists, then all the postprocessing files are placed in a subdirectory called:

$CASEROOT/postprocess

If this is a stand-alone postprocessing caseroot, then all the postprocessing files are placed at the top of the specified CASEROOT option path. The postprocessing caseroot environment variable is called PP_CASE_PATH.

create_postprocess reads and parses all the XML definition files in the POSTPROCESS_PATH and creates and copies all the case specific env_*.xml and batch submission script wrappers in the PP_CASE_PATH.

All the env_*.xml files in the PP_CASE_PATH adhere to the following schema:

<entry id="ID" value="VALUE">

The env_*.xml files include:

• env_postprocess.xml
• env_timeseries.xml
• env_diags_atm.xml
• env_diags_ice.xml
• env_diags_lnd.xml
• env_diags_ocn.xml

The submission script wrappers contain batch submission stanza settings for the specific machine