Quickstart

This quickstart demonstrates how to run the diagnostics toolkit using the provided CLI tools and YAML configuration files.

Spectra Diagnostics

Compute spectra comparing analysis increments between CTRL and EXP:

ufsda-spectra-ana-inc --yaml path/to/spectra_ana_inc.yaml

Compute spectra comparing background vs increment:

ufsda-spectra-bkg-inc --yaml path/to/spectra_bkg_inc.yaml

Increment Maps

Generate tile maps, global maps, and zonal means:

ufsda-inc-maps --yaml path/to/increment_maps.yaml

Observation Diagnostics

Run observation diagnostics on an IODA file:

ufsda-obs-diag --yaml path/to/obs_diag.yaml

Log Diagnostics

Parse a JEDI variational DA log:

ufsda-jedi-log path/to/OUTPUT.fv3jedi --output report.txt

Running on Hercules

The diagnostics toolkit is installed on the Hercules system at:

/work/noaa/epic/jongkim/ufs_da_diagnostics

To use the preconfigured environment, source the Hercules Anaconda setup:

source /work/noaa/epic/jongkim/hercules.anaconda

For headless plotting on Hercules (no X11 display), set the Matplotlib backend:

export MPLBACKEND=Agg

After sourcing the environment, all CLI tools (ufsda-spectra-ana-inc, ufsda-spectra-bkg-inc, ufsda-inc-maps, ufsda-obs-diag, ufsda-jedi-log) are available in the PATH and can be run directly from any directory.