PPUG_running_diagnostics

Running post processing scripts to create diagnostics plots

Note: The [comp] option corresponds to 'atm', 'ice', 'lnd' and 'ocn'.

Synopsis

$PP_CASE_PATH/[comp]diagnostics

Run the diagnostics plotting routines in parallel. Uses the env_postprocess.xml and env_diags[comp].xml to define behavior. The $PP_CASE_PATH/logs/[comp]diagnostics.log contains the stderr and stdout from the job submission. Running the [comp]diagnostics depends on the successful completion of the [comp]averages script. The yellowstone submission commands are:

bsub < atm_diagnostics
bsub < ice_diagnostics
bsub < lnd_diagnostics
bsub < ocn_diagnostics

Details

The [comp]diagnostics bash wrapper script calls the [comp]diags_generator.py python script in parallel to generate different diagnostics types and their associated plotting sets. The [comp]diags_generator.py script parses the XML options defined in env_diags[comp].xml to determine which plotting sets need to be created by calling the underlying associated NCL or plotting routines that correspond to a specific plot set.

The NCL routines are the supported CESM Working Group diagnostics packages that have been slightly modified for inclusion in the CESM_postprocessing python framework. Only paths and environment variables have been modified with the underlying algorithms and plotting calls remaining untouched.

The diagnostics types supported include:

Atmosphere - AMWG Diagnostics Package

Test vs. Observations (includes WACCM and CAM-CHEM diagnostics) Test vs. Control (includes WACCM and CAM-CHEM diagnostics)

Land - LMWG Main Page

Model vs. Observations (includes trends) Model1 vs. Model2 (includes trends) ILAMB package (coming soon)

Sea-Ice - PCWG Main Page

Control vs. Observations (includes time series, contour, and vector plot sets) Control vs. Difference (includes time series, contour, and vector plot sets)

Ocean - OMWG Main Page

Model vs. Observations Model vs. Control Model Time series Model vs. Observations for ocean ecosystem (coming soon) Model vs. Control for ocean ecosystem (coming soon) Model Time series for ocean ecosystem (coming soon)

Users unfamiliar with the various diagnostics settings as defined by the XML should reference the working group pages listed above which contain more detailed documentation about the diagnostics types and plotting routines.

Dependencies

Running the diagnostics depends on the following:

• successful completion of the corresponding [comp]_averages script.
• CESM Working Group diagnostics NCL and plotting routines which are included in this package in $POSTPROCESS_PATH in directories atm_diag, ice_diag, lnd_diag, and ocn_diag.
• observation input data files with paths and file names defined in the env_diags[comp].xml settings
• mapping input data files with paths and file names defined in the env_diags[comp].xml settings

Special Notes