Add idealized, regional tropical cyclone test to tests-dev + Documentation for running Idealized TC case and tutorial for adding cases to the HSD framework #2746

[ulmononian]

Commit Queue Requirements:

• Fill out all sections of this template.
• All sub component pull requests have been reviewed by their code managers.
• Run the full Intel+GNU RT suite (compared to current baselines) on either Hera/Derecho/Hercules
• Commit 'test_changes.list' from previous step

---

Description:

Add the capability to run an idealized, regional tropical cyclone case through tests-dev as part of UFS HSD development. Utilize an ATM-only configuration with no vortex initialization or DA for now. 4km atm resolution.

Initial and lateral conditions in idealized HAFS (Wang et al. 2024) are obtained from an idealized FV3-based global atmospheric forecast. The initial vortex formulation is based on the work of Reed and Jablonowski (2011), where a weak balanced vortex is initialized in an environment favorable to rapid intensification.

More details to come.

Model capability developed by @ weiguo wang (@BinLiu-NOAA @ZhanZhang-NOAA). These developers also provided the input data and configuration files used for this case.

Commit Message:

• UFS-WM - add an idealized, regional tropical cyclone case through tests-dev

Priority:

• High: time-sensitive development

Git Tracking

UFSWM:

• Closes Add idealized, regional tropical cyclone case to tests-dev #2692

Sub component Pull Requests:

*None

UFSWM Blocking Dependencies:

• None

Changes

• No Baseline Changes.

Input data Changes:

• New input data.

Library Changes/Upgrades:

• No Updates

---

Testing Log:

• RDHPCS
  • Hera
  • Orion
  • Hercules
  • GaeaC6
  • Derecho
• WCOSS2
  • Dogwood/Cactus
  • Acorn
• CI
• opnReqTest (complete task if unnecessary)

[ulmononian]

testing the TC case on orion with fv3atm as it is in ufs-wm develop. i am hitting

  0:  npes =          265 , grid_pes =           40
  0:
  0: FATAL from PE     0: grid_pes in fv_nest_Nml does not assign all of the available PEs

input.nml, fd_ufs.yaml, model_configure, ufs.configure, field_table, & diag_table are all the same as in weiguo's run. however, i am running with HAFSW...not sure if this is correct? @BinLiu-NOAA any idea here?

i tried copying in the hafs_forecast.x from weiguo's run into my ufs wm rundir (re-named to fv3.exe), but still got the same error.

the test file is here https://github.com/ulmononian/ufs-weather-model/blob/feature/add_tc/tests-dev/test_cases/tests/tropical_cyclone. in the input_nml, we set grid_pes to 225, so i changed the export GRID_PES in the tests file to 225. am i setting something incorrectly somewhere? i based the tests file off of https://github.com/ufs-community/ufs-weather-model/blob/develop/tests/tests/hafs_regional_atm, but modified several things to fit this case.

the run dir on orion is here: /work/noaa/stmp/cbook/stmp/cbook/FV3_RT/rt_2396305/tropical_cyclone_intel.

[ulmononian]

i changed the input.nml to dynamically assign grid_pes as grid_pes = @[GRID_PES], so it takes the value assigned in the tests file. this allowed me to bypass the initial error reported above (grid_pes set to 265 now), but now i am getting:

: FATAL from PE 	0: check_nml_error in fms_mod:  Unknown namelist, or mistyped namelist variable in namelist fv_core_nml,   (IOSTAT =       	19 )

i tried again with weiguo's hafs exe, but got:

+ srun --label -n 280 ./fv3.exe
 30:
 30: FATAL from PE    30: mpp_domains_define.inc: At least one pe in pelist is not used by any tile in the mosaic
 30:
  6:
  6: FATAL from PE     6: mpp_domains_define.inc: At least one pe in pelist is not used by any tile in the mosaic
  6:
263:
263: FATAL from PE   263: mpp_domains_define.inc: At least one pe in pelist is not used by any tile in the mosaic