Skip to content

Implement SNICAR v3 snow albedo model into Noah-MP#187

Merged
cenlinhe merged 37 commits intoNCAR:developfrom
cenlinhe:snicar_impl
May 7, 2025
Merged

Implement SNICAR v3 snow albedo model into Noah-MP#187
cenlinhe merged 37 commits intoNCAR:developfrom
cenlinhe:snicar_impl

Conversation

@cenlinhe
Copy link
Collaborator

@cenlinhe cenlinhe commented Apr 22, 2025 •
edited
Loading

This PR is to implement SNICAR v3 snow albedo model into Noah-MP. The SNICAR model follows the code that is implemented in the Community Land Model (CLM) done by this study (He et al. 2024 JAMES, https://doi.org/10.1029/2023MS003861) and in this CLM PR : ESCOMP/CTSM#1861

The reference of this SNICAR coupling with Noah-MP v5 is here (Lin et al., 2025 JHM): https://doi.org/10.1175/JHM-D-24-0082.1

The original code implementation in Noah-MP is done by Tzu-Shun Lin (NCAR) with updates from Cenlin He (NCAR).

Both 2-D CONUS and 1-D Irwin site tests are successful for HRLDAS/NoahMP-SNICAR.

Specifically, this PR includes the SNICAR module for the following snow albedo calculation features:

  • Basic SNICAR model using two-stream snowpack radiative transfer and multi-layer snowpack (Flanner et al. 2007)
  • Updated ice optical properties from Flanner et al. (2021), with multiple types for ice refractive indices
  • Updated aerosol optical properties from Flanner et al. (2021) with multiple dust types & new BC and OC optics
  • Updated downward solar spectra from Flanner et al. (2021) for multiple condition types.
  • More accurate radiative transfer solver (adding-doubling) from Dang et al. (2019).
  • Nonspherical snow grain scheme from He et al. (2017).
  • BC-snow internal mixing scheme from He et al. (2017).
  • Dust-snow internal mixing scheme from He et al. (2019).
  • Hyperspectral (480-band, 10-nm spectral res) capability with all the above features
  • Add new SNICAR namelist controls

tslin2 and others added 28 commits June 22, 2023 15:38
@tslin2
1st version of SNICR snow albedo scheme
58ff458
@tslin2
update snicar for glacier temperature
6690216
@tslin2
revise SNICAR and add aerosol compoments
a806140
@tslin2
snicar updated for revision
d714d77
@tslin2
updating snow aerosol processes
28ee3cd
@tslin2
add surface albedo as output and add energy check for snicar
9d6ced1
@tslin2
use fresh snow age for zero snow layer
7a49de1
@tslin2
move snicar aging to surface albedo
3997e4c
@tslin2
fix issues for snicar
f7ed60d
@tslin2
bug fix for snowlayer, fveg and update vis/nir and direct/diffuse fra…
04fdcc8 
…ction
@tslin2
change default shape to hexagonal
1d094aa
@tslin2
update dust and parameters
6a586a0
@tslin2
updated parameters
7a6dcd5
@tslin2
remove path and add data for SNICAR
126f8c0
@cenlinhe
Merge pull request NCAR#116 from NCAR/develop
44bef28 
Sync with develop branch
@cenlinhe
Merge branch 'snicar_lin' into develop
929fd87
@cenlinhe
Merge pull request #13 from cenlinhe/develop
c3a92ae 
Develop
@cenlinhe
Merge pull request #12 from cenlinhe/snicar_lin
626363b 
Snicar lin
@cenlinhe
bug fix for doubled vegfrac
4399294
@cenlinhe
bug fix
611e19d
@cenlinhe
bug fix for aerosol mass initialization
d118daf
@cenlinhe
bug fix for dust5 optics initialization
8e0ba67
@cenlinhe
bug fix for glacier snow water for aerosol
8cba61a
@cenlinhe
Merge pull request NCAR#124 from NCAR/develop
fa2d209 
Sync with Develop branch for bug fix
@cenlinhe
Merge pull request NCAR#171 from NCAR/develop
cfb0ee4 
Sync with Develop branch for adding LIS driver folder
@cenlinhe
Merge pull request #14 from cenlinhe/master
5c1c0a3 
sync master branch (Dec2024) to snicar branch
@cenlinhe
Merge branch 'snicar_impl' into develop
7fcd0c6
@cenlinhe
Merge pull request #17 from cenlinhe/develop
277f9f5 
sync with Develop
@cenlinhe cenlinhe added enhancement New feature or request development labels Apr 22, 2025
cenlinhe
cenlinhe commented Apr 26, 2025
View reviewed changes
cenlinhe
cenlinhe commented Apr 26, 2025
View reviewed changes
@cenlinhe
Copy link
Collaborator Author

cenlinhe commented Apr 28, 2025

@tslin2 @RAbolafiaRosenzweig I finished updating this PR, so you can review this one. If we could get this PR done in the next few days, that would be great. Thanks!

@cenlinhe cenlinhe mentioned this pull request Apr 28, 2025
Merged
@cenlinhe
Copy link
Collaborator Author

cenlinhe commented Apr 29, 2025

Both 2-D CONUS and 1-D Irwin site tests are successful for HRLDAS/NoahMP-SNICAR.

tslin2
tslin2 reviewed May 1, 2025
View reviewed changes
tslin2
tslin2 reviewed May 1, 2025
View reviewed changes
tslin2
tslin2 reviewed May 2, 2025
View reviewed changes
tslin2
tslin2 reviewed May 2, 2025
View reviewed changes
tslin2
tslin2 reviewed May 2, 2025
View reviewed changes
tslin2
tslin2 reviewed May 2, 2025
View reviewed changes
tslin2
tslin2 reviewed May 2, 2025
View reviewed changes
tslin2
tslin2 requested changes May 2, 2025
View reviewed changes
Copy link
Collaborator

@tslin2 tslin2 left a comment •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have reviewed all codes, look good to me. I only have minor suggestions above .
Thanks

@cenlinhe
Copy link
Collaborator Author

cenlinhe commented May 3, 2025

Thanks @tslin2 . I will include your suggested changes.

@cenlinhe
Copy link
Collaborator Author

cenlinhe commented May 3, 2025

@tslin2 @RAbolafiaRosenzweig I have included all Tzu-Shun's suggested changes. Please review and approve it at your earliest convenience. Thanks! I will need to wait this NoahMP update to update HRLDAS PR.

RAbolafiaRosenzweig
RAbolafiaRosenzweig approved these changes May 6, 2025
View reviewed changes
Copy link
Collaborator

@RAbolafiaRosenzweig RAbolafiaRosenzweig left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changes are applied appropriately for SNICAR v3 snow albedo model.

@cenlinhe cenlinhe merged commit ae53dd8 into NCAR:develop May 7, 2025
@cenlinhe cenlinhe mentioned this pull request May 7, 2025
Merged
@cenlinhe cenlinhe mentioned this pull request Jan 29, 2026
Merged
weiwangncar pushed a commit to wrf-model/WRF that referenced this pull request Feb 15, 2026
@cenlinhe @massimodisidoro
@dudhia @cug-xyx
Coupling with refactored Noah-MP v5.1.2 (#2268)
49e5342 
TYPE: enhancement

KEYWORDS: Noah-MP, refactored code

SOURCE: Cenlin He (NCAR), Tzu-Shun Lin (NCAR)

DESCRIPTION OF CHANGES:
This PR includes necessary code changes to couple WRF with the latest refactored Noah-MP v5.1.2 via git submodule mechanisms. Compared to Noah-MP v4.7 in WRF v4.7.1, the Noah-MP v5.1.2 has several added new model physics:
1. add new snow compaction scheme (with namelist option control) developed by Abolafia-Rosenzweig et al 2024 (JAMES; https://doi.org/10.1029/2023MS003869) (NCAR/noahmp#174)
2. improved spring wheat parameters developed by Zhang et al 2023 (GMD; https://doi.org/10.5194/gmd-16-3809-2023) (NCAR/noahmp#175)
3. add new wetland scheme (with namelist option control) developed by Zhang et al 2022 (WRR; https://doi.org/10.1029/2021WR030573) (NCAR/noahmp#186)
4. couple SNICAR v3 snow albedo scheme into Noah-MP (with namelist option control) developed by Lin et al 2024 (JHM; https://doi.org/10.1175/JHM-D-24-0082.1) (NCAR/noahmp#187)
5. add new snow cover scheme (with namelist option control) developed by Abolafia-Rosenzweig et al 2025 (JAMES; doi:10.1029/2024MS004704) (NCAR/noahmp#191)

LIST OF MODIFIED FILES: 
M       CMakeLists.txt
M       Makefile
M       Registry/Registry.EM_COMMON
M       Registry/registry.dimspec
M       Registry/registry.noahmp
M       arch/Config.pl
M       chem/depend.chem
M       chem/module_uoc_dust.F
M       clean
M       dyn_em/module_first_rk_step_part1.F
M       dyn_em/start_em.F
M       main/CMakeLists.txt
M       main/depend.common
M       phys/CMakeLists.txt
M       phys/Makefile
M       phys/module_diag_misc.F
M       phys/module_diagnostics_driver.F
M       phys/module_physics_init.F
M       phys/module_sf_clm.F
M       phys/module_surface_driver.F
M       phys/noahmp
M       run/README.namelist
M       run/README.physics_files
M       share/mediation_wrfmain.F
M       share/output_wrf.F
M       test/em_real/CMakeLists.txt
M       test/em_real/examples.namelist

TESTS CONDUCTED: 
- The code compiles successfully on NCAR's HPC (Derecho) using both intel and gfortran/gcc compilers. The test runs are also successful including that with activated MMF groundwater scheme, urban scheme, and different combinations of PBL, microphysics, and surface layer schemes. (tested by Cenlin He and Tzu-Shun Lin from NCAR), and has passed the regression tests.
- Regression tests have passed.

RELEASE NOTE: Coupling with refactored Noah-MP v5.1.2. This new version of NoahMP has a few new options and improvements compared to the previous Noah-MP v4.7 in WRF v4.7.1. See PR for details.

---------

Co-authored-by: Massimo D'isidoro <49653612+massimodisidoro@users.noreply.github.com>
Co-authored-by: dudhia <dudhia@ucar.edu>
Co-authored-by: Yuxuan Xie <77427610+cug-xyx@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@RAbolafiaRosenzweig RAbolafiaRosenzweig RAbolafiaRosenzweig approved these changes

@tslin2 tslin2 tslin2 approved these changes

Assignees

No one assigned

Labels

development enhancement New feature or request

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@cenlinhe @RAbolafiaRosenzweig @tslin2