Adding Climatological Canopy Datasets for CCPP with AQM Coupling

[drnimbusrain]

Description

Incorporation of vegetative sub-canopy parameterizations in ufs-weather-model/fv3/ccpp-physics (with AQM coupling), which requires addition of new climatological vegetative canopy datasets. This is a part of NOAA-WPO-FY22 project, "Beyond the “Big-Leaf” Model at NOAA: Use of Novel Satellite Data and In-Canopy Processes to Improve U.S. Air Quality Predictions".

Solution

Add five new vegetative canopy datasets based on satellite observations, which is currently passed from the AQM chemical component to the ufs-weather-model for incorporation in the optional sub-canopy parameterizations in ccpp-physics PBL schemes (SATMEDMF). These include the forest canopy height (FCH), forest fraction (FRT), clumping index (CLU), population density (POPU), and leaf area index from (LAI). These datasets have recently been published in a NOAA-ARL Tech Memo and at NCEI.

Alternatives

While some alternatives may exist in the future (e.g., collaboration with UFS physics and LSMs teams on usage of satellite based LAI), to accomplish our project goals for AQM within the immediate timeline, our most feasible option is to pass these canopy data from the AQM coupled component within that configuration.

Testing:

1. Have you tested the code changes? On what platforms?

Yes, on RDHPCs such as Hera.

2. Have you run regression test in ufs-weather-model or ufs-s2s-model with code changes?- Will the baseline results change?
   No. Since canopy option is turned off by default in GFS_typedefs (logical :: do_canopy = .false. !< flag for canopy option) no changes to baseline should result. New regression test may be needed.

Dependent PRs:

NOAA-EMC/AQM#19 - Needed for reading canopy datasets and for facilitating usage of data in fv3/ccpp-physics PBL schemes.

fv3 PR upcoming.
ccpp-physics PR upcoming.