Air Quality Modeling

This page is for the aqm_dev branch based on the production/AQM.v7 implementation. This is available on WCOSS2 and Hera as of 11/17/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, or hera.

3. Set up the user-specific configuration:

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

where [machine] is wcoss2, or hera.

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:

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

where [machine] is hera.

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.