Stable Tag of Regional Workflow for EMC

Target platforms (machines) of this wiki page: WCOSS2, Hera, and Orion

Quick Start Guide

1. Retrieve the develop branch of the UFS Short Range Weather Application (SRW App) repository:

   git clone -b develop https://github.com/ufs-community/ufs-srweather-app.git
   cd ufs-srweather-app

2. Check out the stable hash of UFS SRW App:

   git checkout ff6f103

• This hash will check out the following hashes of the external components that are specified in Externals.cfg:

  Component	Hash
  UFS_UTILS	ca9bed8
  ufs-weather-model	e051e0e
  UPP	2b2c84a

3. Check out the external components:

   ./manage_externals/checkout_externals

4. Set up the build environment and build executables:

   ./devbuild.sh --platform=[machine]

where [machine] is wcoss2, hera, or orion.

5. Set up the user-specific configuration:

   cd ush
   cp config.community.yaml config.yaml (or, cp config.nco.yaml config.yaml)

Edit config.yaml as needed.

Set the following parameters in config.yaml for the automatic initial-submission and re-submission by cron (every 3 minutes in the following example):

workflow:
  USE_CRON_TO_RELAUNCH: true
  CRON_RELAUNCH_INTVL_MNTS: 3

6. Load the python environment for the workflow:

• On WCOSS2:

   source ../versions/run.ver.wcoss2
   module use ../modulefiles
   module load wflow_wcoss2

• On Hera / Orion:

   module use ../modulefiles
   module load wflow_[machine]
   conda activate regional_workflow

7. Generate the workflow:

   python3 generate_FV3LAM_wflow.py

8. Run the workflow repeatedly only if USE_CRON_TO_RELAUNCH: true was not set in config.yaml:

   cd ../../expt_dirs/[EXPT_SUBDIR]
   ./launch_FV3LAM_wflow.sh

References

• UFS SRW App Users' Guide for the develop branch of the UFS SRW App and Regional Workflow (Chan-Hoo Jeon, NOAA/NCEP/EMC).

• Sample configuration files (config.yaml): https://github.com/chan-hoo/ufs-srw-app_sample_config