Versions Compared

Key

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

The Design Document page provides a description of the algorithms, implementation and planned testing including unit, verification, validation and performance testing. Please read  Step 1.3 Performance Expectations that explains feature documentation requirements from the performance group point of view. 

...

Algorithmic Formulations

Design solution: Riverine heat processes

Date last modified: 30 Jun 2019


Contributors: Hongyi LiRuby Leung

This is a completely new capacity added into E3SM/MOSART. All the heat processes are described in a physically-based way. The advective heat fluxes are estimated based on the advective water fluxes including the surface and subsurface runoff from hillslopes into the sub-network channel, from sub-network channel to main channel, and between upstrean/downstream main channels. The temperature of surface runoff is assumed to be equal to the average soil temperature (simulated by ELM) over the top 10cm soil layers. The temperature of subsurface runoff is assumed to be equal to the average soil temperature of those soil layers below the ground water table (simulated by ELM). The temperature of sub-network and main channel water is estimated based on the heat balance, including long-wave and short-wave solar radiation, sensible heat, latent heat and advective heat fluxes etc.


Design and Implementation

Implementation:

Implement

Implementing riverine heat processes

Date last modified: 30 Jun 2019

 
Contributors: Ruby LeungHongyi LiAnthony Craig


The implementation of MOSART-heat within E3SM largely follows the software engineering protocols used in E3SMv1 E3SMv2 of MOSART, One major difference comparing to the version in Li et al. (2015) is that now MOSART is established NOT as part of ELM or CLM anymore, but a E3SM component parallel to ELM. As such,  the coupling between MOSART-heat and ELM and EAM is achieved through the flux coupler directly.   


Planned Verification and Unit Testing 

Verification and Unit Testing:

verify

Verifying MOSART-heat

Date last modified:  30 Jun 2019


Contributors: Hongyi LiTian Zhou


Verification is performed by checking the fields that are passed from ELM and EAM to MOSART-heat through the flux coupler. MOSART-heat has been tested on Constance and Compy and passed the E3SM_developer tests on Compy.

Planned Validation Testing 

Validation Testing:

validating

Validating MOSART-heat

Date last modified: 30 Jun 2019


Contributors: Hongyi LiRuby Leung


Validation is performed by comparing the MOSART-heat simulated stream temperature with observations from multiple river gauges.

Planned Performance Testing 

Performance Testing: MOSART-heat performance

Date last modified: 30 Jun 2019
Contributors: Hongyi LiTian Zhou


Performance will be evaluated using different number of processors on Compy.