Air Quality Modeling - ufs-community/ufs-srweather-app GitHub Wiki
This page is for the main_aqm
branch to support Air Quality Modeling. This is available on Hera
as of 10/01/2024.
Quick Start Guide
-
Clone the "main_aqm" branch of the authoritative repository:
git clone -b main_aqm https://github.com/ufs-community/ufs-srweather-app.git cd ufs-srweather-app/sorc
-
Build the app:
- Air Quality Modeling (coupled):
./manage_externals/checkout_externals -e Externals_aqm.cfg ./app_build.sh -a=ATMAQ
- Smoke and Dust (uncoupled):
./manage_externals/checkout_externals -e Externals_smoke_dust.cfg ./app_build.sh
-
Set up the user-specific configuration:
cd ../parm cp config.[application].yaml config.yaml
where
[application]
isaqm
for air quality modeling, orsmoke_dust
for smoke/dust modeling.Set the following parameters in
config.yaml
for the automatic initial-submission and re-submission bycron
: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 usecron
. -
Load the python environment for the workflow:
- On Hera:
wheremodule purge module use ../modulefiles module load wflow_[machine] conda activate regional_workflow
[machine]
ishera
.
-
Generate the workflow:
./generate_FV3LAM_wflow.py
-
Run the workflow only if
USE_CRON_TO_RELAUNCH: true
was not set inconfig.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
orFAILURE
on your terminal window.