E3SM Parameterizations of fine-scale topographic effects on surface radiation balance in ELM

Add physically-based and computationally-efficient parameterizations (fineTOP; Hao et al., 2025) in ELM to explicitly resolve fine-scale (e.g., 1 km) topographic effects on downward shortwave and longwave radiation as well as land surface radiative properties.

The new parameterization can be turned on by use_finetop_rad = .true..

A test for the new parameterization is added.

[BFB]

Hao, D., Bisht, G., Li, L., & Leung, L. R. (2025). Representing fine-scale topographic effects on surface radiation balance in hyper-resolution land surface models. Journal of Advances in Modeling Earth Systems, 17, e2025MS004987. https://doi.org/10.1029/2025MS004987

See an example movie below

Oct 21 '25 02:10 daleihao

@daleihao do not merge master in to your feature branch. Undo that commit.

Oct 21 '25 03:10 rljacob

@daleihao do not merge master in to your feature branch. Undo that commit.

Done.

Oct 21 '25 13:10 daleihao

@daleihao, could you please try to rebase this PR off the latest master as there are few conflicts? thanks.

Oct 31 '25 03:10 bishtgautam

https://github.com/user-attachments/assets/039f75ea-7ede-4f2c-9293-c5ad101e1076

This movie shows the diurnal variation of solar radiation with/without fineTOP over the Sierra Nevada.

Oct 31 '25 11:10 daleihao

@bishtgautam please re-review.

Nov 20 '25 18:11 rljacob

@bishtgautam please re-review.

Dec 11 '25 18:12 rljacob