Skip to content

Adding New Vegetative Canopy Data for AQM Coupling#928

Merged
jkbk2004 merged 120 commits into
NOAA-EMC:developfrom
noaa-oar-arl:feature/aqm_canopy
Jul 17, 2025
Merged

Adding New Vegetative Canopy Data for AQM Coupling#928
jkbk2004 merged 120 commits into
NOAA-EMC:developfrom
noaa-oar-arl:feature/aqm_canopy

Conversation

@drnimbusrain
Copy link
Copy Markdown
Contributor

@drnimbusrain drnimbusrain commented Feb 7, 2025

Description

In this PR we 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. This also adds three additional AQM coupled photolysis diagnostics used in helping best evaluate and understand associated canopy effects in AQM.

Issue(s) addressed

#927

Testing

How were these changes tested?
What compilers / HPCs was it tested with?
RDHPCs Hera.
Are the changes covered by regression tests? (If not, why? Do new tests need to be added?)
Yes. These add new variables only used in ccpp-physics with option turned on. The do_canopy option is turned off by default. 'logical :: do_canopy = .false. !< flag for canopy option'
Have the ufs-weather-model regression test been run? On what platform?
No.

  • Will the code updates change regression test baseline? If yes, why? Please show the baseline directory below.
    No. - Please commit the regression test log files in your ufs-weather-model branch

Dependencies

If testing this branch requires non-default branches in other repositories, list them.
Those branches should have matching names (ideally)
https://github.com/noaa-oar-arl/ccpp-physics/tree/feature/aqm_canopy2

Do PRs in upstream repositories need to be merged first?

@iri01

@bbakernoaa
Copy link
Copy Markdown
Contributor

@drnimbusrain please resolve the conflicts and I'll take a look

@drnimbusrain
Copy link
Copy Markdown
Contributor Author

@bbakernoaa OK, conflicts have been resolved here. Thank you for the review.

@drnimbusrain
Copy link
Copy Markdown
Contributor Author

Thank you @bbakernoaa for approving this! Looking forward to this moving forward with the UWM canopy package.

@BrianCurtis-NOAA
Copy link
Copy Markdown
Collaborator

You have the incorrect ccpp/physics hash, it should be the one from noaa-oar-arl/feature/aqm_canopy2 noaa-oar-arl/ccpp-physics@a57f1a0

@drnimbusrain
Copy link
Copy Markdown
Contributor Author

drnimbusrain commented Jul 15, 2025

You have the incorrect ccpp/physics hash, it should be the one from noaa-oar-arl/feature/aqm_canopy2 noaa-oar-arl/ccpp-physics@a57f1a0

@BrianCurtis-NOAA Thank you for that. I have updated the ccpp/physics hash to reflect my latest sync up for my branch.

@rhaesung
Copy link
Copy Markdown
Contributor

@drnimbusrain ufs-community/ccpp-physics#253 has been merged. Please update the submodule pointer for ccpp-physics (ufs-community/ccpp-physics@5d6bacf) and revert the .gitmodules file in preparation for the merge.

@drnimbusrain
Copy link
Copy Markdown
Contributor Author

drnimbusrain commented Jul 17, 2025 via email

@BrianCurtis-NOAA
Copy link
Copy Markdown
Collaborator

Brian, could you help here with this to get it merged? Thank you!

On Thu, Jul 17, 2025, 8:32 AM Rhae Sung Kim @.> wrote: rhaesung left a comment (NOAA-EMC/fv3atm#928) <#928 (comment)> @drnimbusrain https://github.com/drnimbusrain ufs-community/ccpp-physics#253 <ufs-community/ccpp-physics#253> has been merged. Please update the submodule pointer for ccpp-physics ( @. <ufs-community/ccpp-physics@5d6bacf>) and revert the .gitmodules file in preparation for the merge. — Reply to this email directly, view it on GitHub <#928 (comment)>, or unsubscribe https://github.com/notifications/unsubscribe-auth/AGLFYNSTSXBT7CQDJA5NQMT3I6JUZAVCNFSM6AAAAABWWMO5JOVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZTAOBTHA4TEMJUHE . You are receiving this because you were mentioned.Message ID: @.***>

@drnimbusrain sure, but i'll need collaborator permissions

@drnimbusrain
Copy link
Copy Markdown
Contributor Author

BrianCurtis-NOAA

@BrianCurtis-NOAA Sure thing, just added you. Thank you!

@BrianCurtis-NOAA
Copy link
Copy Markdown
Collaborator

@rhaesung @DusanJovic-NOAA ready for merge.

@jkbk2004 jkbk2004 merged commit aa18f2c into NOAA-EMC:develop Jul 17, 2025
8 checks passed
@drnimbusrain
Copy link
Copy Markdown
Contributor Author

Thank you all so much!!

@iri01

DusanJovic-NOAA pushed a commit that referenced this pull request Feb 27, 2026
…al Tracers (#1056)

This PR facilitates updates the current integrated subcanopy effect (previously merged PR #928 ) to use a more robust, explicit, 3-layer subcanopy effect on chemical tracers (ONLY) in the ccpp-physics, PBL-SATMEDMF scheme. The vegetative canopy modulates vertical diffusion. We split the diffusion on 3 sub-canopy layers with variable height located at 1, 0.5 and 0.2 canopy height (based on Makar et al. 2017), while ensuring mass conservation before returning to the original model layers (for advection, deposition, other physical processes). This leads to a more pronounced effect on the transport of chemical tracers, particularly those as precursors to near-surface ozone formation in the UFS-AQM configuration.


---------

Co-authored-by: Irena Ivanova <Irena.Ivanova@gaea62.ncrc.gov>
Co-authored-by: iri01 <i.t.ivanova@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

9 participants