Air Quality Modeling

This page is for the aqm_dev branch based on the production/AQM.v7 implementation. This is available on WCOSS2, Hera, Orion, and Hercules as of 12/17/2023. Note that instructions on Hera/Orion/Hercules may not work as indicated below due to platform updates that have occurred since December 2023.

Quick Start Guide

1. Clone the "aqm_dev" branch of the authoritative repository:

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

2. Build the app:

   ./app_build.sh -p=[machine] -a=ATMAQ --extrn
   

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

3. Set up the user-specific configuration:

   cd ../ush
   cp config.aqm.retro.[machine].yaml config.yaml
   

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

   Set the following parameters in config.yaml for the automatic initial-submission and re-submission by cron:

   workflow:
     USE_CRON_TO_RELAUNCH: true
     CRON_RELAUNCH_INTVL_MNTS: 3
   

   This means that cron will submit the launch script every 3 minutes. Note that you should create your crontab with "crontab -e" first if this is your first time to use cron.

4. Load the python environment for the workflow:

• On WCOSS2:

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

• On Hera/Orion/Hercules:

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

  where [machine] is hera, orion, hercules.

5. Generate the workflow:

   ./generate_FV3LAM_wflow.py
   

6. Run the workflow only if USE_CRON_TO_RELAUNCH: true was not set in config.yaml(see Step 3 for the automatic resubmission by cron):

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

   Repeat this launch command until you have SUCCESS or FAILURE on your terminal window.