Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Hillslope hydrology #1715

Merged
merged 189 commits into from
Feb 28, 2024
Merged

Conversation

swensosc
Copy link
Contributor

@swensosc swensosc commented Apr 18, 2022

Description of changes

Add hillslope hydrology parameterization

Specific notes

Changes include multiple soil columns per vegetated landunit, additional meteorological downscaling, new subsurface lateral flow equations, and a hillslope routing parameterization.

Described in:
Swenson, S. C., Clark, M., Fan, Y., Lawrence, D. M., & Perket, J. (2019). Representing intra-hillslope lateral subsurface flow in the community land model. Journal of Advances in Modeling Earth Systems, 11, 4044–4065. https://doi.org/10.1029/ 2019MS001833

Contributors other than yourself, if any: None

CTSM Issues Fixed (include github issue #): None

Are answers expected to change (and if so in what way)?

  • FSDS answers change due to rounding differences, since the history field now uses a column-level variable instead of a gridcell-level one. (Confirmed using this branch.)
  • The oldhyd test changes answers due to the removal of the origflag parameter, which was intended to replicate CLM4 behavior.

Any User Interface Changes (namelist or namelist defaults changes)?
Adds namelist parameters:

  • use_hillslope: Toggle to turn on the hillslope model
  • downscale_hillslope_meteorology: Toggle to turn on meteorological downscaling in hillslope model
  • use_hillslope_routing: Toggle to turn on surface water routing in the hillslope hydrology model
  • hillslope_head_gradient_method: Method for calculating hillslope saturated head gradient
  • hillslope_transmissivity_method: Method for calculating transmissivity of hillslope columns
  • hillslope_pft_distribution_method: Method for distributing PFTs across hillslope columns
  • hillslope_soil_profile_method: Method for distributing soil thickness across hillslope columns

Testing performed, if any:

  • Twenty year simulations to check for water and energy balance errors
  • aux_clm on Derecho and Izumi is bit-for-bit identical to ctsm5.1.dev169 aside from the changes mentioned above.

swensosc and others added 30 commits January 8, 2018 21:32
first set of changes for hillslope hydrology global implementation
added hillslope factory modules
fixed positive drainage in soilhydrologymod
fixed patch%column assinment in histfilemod
added getglobalindex to histfilemod
break long line, needed for nag
tag clm4_5_18_r270 from svn

No changes here, just doing the merge so history shows us being
up-to-date with r270
Will allow running from a standalone checkout
(The latter 2 have no theme; they are intended to exercise all options.)
* HillslopeFromFile
* HillslopeC
* HillslopeD
Suites aux_clm and hillslope:
* ERP_D_P64x2_Ld10.f10_f10_mg37.I2000Clm51Bgc.derecho_intel.clm-Hillslope
* SMS_D_Mmpi-serial_Ld5.5x5_amazon.I1850Clm51Bgc.derecho_gnu.clm-HillslopeC
* SMS_D_Ld3.f10_f10_mg37.I2000Clm51Bgc.izumi_nag.clm-HillslopeD

Suite hillslope:
* SMS_D_Ld3.f10_f10_mg37.I1850Clm51Bgc.derecho_intel.clm-HillslopeFromFile
@samsrabin samsrabin added priority: high High priority to fix/merge soon, e.g., because it is a problem in important configurations PR status: awaiting review Work on this PR is paused while waiting for review. and removed priority: high High priority to fix/merge soon, e.g., because it is a problem in important configurations PR status: awaiting review Work on this PR is paused while waiting for review. labels Feb 1, 2024
Hillslope hydrology pre-merge changes
@samsrabin
Copy link
Collaborator

samsrabin commented Feb 7, 2024

Per meeting today with @swensosc:

  • He will make some changes to parameter/variable/history variable names for consistency.
  • I will then redo aux_clm
  • He will share his Python scripts with me
  • I will incorporate those into the CTSM repo, including unit and system tests as appropriate

@billsacks, per our recent conversation, would you mind going ahead and approving this PR? With the recent branch protection changes, we can't merge until all approvals are given. Thanks!

@samsrabin samsrabin requested a review from billsacks February 7, 2024 20:27
Copy link
Member

@billsacks billsacks left a comment

Choose a reason for hiding this comment

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

Thank you for all of your amazing work on this @swensosc and @samsrabin !!!

@samsrabin
Copy link
Collaborator

Scripts will come in later.

@samsrabin samsrabin changed the base branch from master to hillslope-merge February 28, 2024 17:26
@samsrabin samsrabin merged commit b6280df into ESCOMP:hillslope-merge Feb 28, 2024
1 of 2 checks passed
@samsrabin samsrabin mentioned this pull request Feb 28, 2024
@samsrabin samsrabin added enhancement new capability or improved behavior of existing capability science Enhancement to or bug impacting science labels Aug 8, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
enhancement new capability or improved behavior of existing capability science Enhancement to or bug impacting science
Projects
Status: Ready to eat (Done!)
Status: Done
Status: Done (non release/external)
Development

Successfully merging this pull request may close these issues.

6 participants