Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The purpose of this section is to summarize what capability is to be added to the ACME Ocean and Ice system through E3SM land through this design process. It should be clear what new code will do that the current code does not. Summarizing the primary challenges with respect to software design and implementation is also appropriate for this section. Finally, this statement should contain general statement with regard to what is “success.”


Requirements

Requirement: name-of-requirement-here

The PHS model needs to conform to the big leaf model.

Date last modified:   
Contributors: Yilin Fang Ruby Leung

Algorithmic Formulations

The algorithm follows the approach in Kennedy et al. (2019), which solves vegetation water potential in the root, stem, and sunlit leaf and shaded leaf. Water stress factor BTRAN is a function of leaf water potential instead of the soil matric potential. Four steady state equations (continuity of fluxes) are solved given transpiration and soil matric potentials in each soil layer as boundary conditions. Equations can be found in Kennedy et al. (2019).

Figure 1. Plant hydraulic circuit analog schematic (Kennedy et al., 2019)

Reference:

Kennedy, D., S. Swenson, K. W. Oleson, D. M. Lawrence, R. Fisher, A. C. L. da Costa, and P. Gentine (2019), Implementing Plant Hydraulics in the Community Land Model, Version 5, J Adv Model Earth Sy, 11(2), 485-513, doi:10.1029/2018MS001500.

Design solution:

Date last modified:// date
Contributors: (add your name to this list if it does not appear)

Solution follows Kennedy et al.


Design and Implementation

Implementation:

Date last modified: // date
Contributors: (add your name to this list if it does not appear)


The implementation follows the PHS implemented by Kennedy et al. (2019) in CLM5.


Planned Verification and Unit Testing 

Verification and Unit Testing: short-desciption-of-testing-here

Date last modified:  
Contributors: (add your name to this list if it does not appear)

The E3SM Developers test suite was used to make unit testing with PHS model turned off. In addition, the code will be submitted for expert review on the process of PR.

The PHS will be tested against the point simulation published in Kennedy et al. (2019).

Planned Validation Testing 

Validation Testing: short-desciption-of-testing-here

Date last modified:
Contributors: (add your name to this list if it does not appear)


The PHS will be validated using point and global simulation.

Planned Performance Testing 

Performance Testing: short-desciption-of-testing-here

Date last modified:
Contributors: (add your name to this list if it does not appear)

Global simulation will be tested for performance.



...