Exporting Canopy Variables from AQM to Facilitate Sub-Canopy Effects in FV3 and CCPP

[drnimbusrain]

Draft PR Task List

• 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:

This PR allows for the "export" of new vegetative canopy fields from the AQM component submodule to FV3 submodule, and subsequently into the CCPP submodule to facilitate new sub-canopy effect parameterizations in respective dependent codes/repositories.

Commit Message:

* UFSWM - Exporting new vegetative canopy variables from AQM component submodule for usage in FV3 component submodule and CCPP  physics submodule
  * AQM - Reads new canopy data files, and exports necessary variables to FV3
    * FV3 - Reads canopy variables exported from AQM for usage in CCPP physics submodule
    * ccpp-physics - Uses canopy variables from FV3 in PBL physics scheme for sub-canopy effects on diffusivity

Priority:

• Normal.

Git Tracking

UFSWM:

• Closes #
• None

Sub component Pull Requests:

• AQM: Adding Integrated Canopy Effects to AQM NOAA-EMC/AQM#19
• FV3: Adding New Vegetative Canopy Data for AQM Coupling NOAA-EMC/fv3atm#928
  • ccpp-physics: Adding Integrated Canopy Effects to CCPP/PBL Scheme ccpp-physics#253

UFSWM Blocking Dependencies:

• None

---

Changes

Regression Test Changes (Please commit test_changes.list):

We have not run an FV3/AQM RT yet for the new sub-canopy effect option, or a full RT suite with all necessary canopy data needed (at required) staged on Hera yet. We request support/assistance with setting this up @BrianCurtis-NOAA. With option = false by default, we anticipate no baseline changes to results, but when set to true, the sub-canopy effects will change baselines.

Input data Changes:

Yes, new canopy data input files are needed and are read through AQM component into FV3/CCPP. The files for the UFS-AQM regional NA domain at 13 km are found on Hera locally at: /scratch2/NAGAPE/arl/Patrick.C.Campbell/RRFS_CMAQ/fix/canopy/AQM_NA_13km/gfs.t12z.geo.*

Library Changes/Upgrades:

** SPECIAL INSTRUCTIONS **

• No Updates

@iri

---

Testing Log:

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