...
| Page Properties | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||
|
| Expand | |||
|---|---|---|---|
| |||
|
Title:
...
MOSART One-Way Coupling
Requirements and Design
ACME
...
Land Group
Date:
...
Summary
...
Requirements
...
This task includes:
1) Implementing a one-way coupling of the MOSART river routing model with ALM.
2) Evaluating the performance of the model using observations.
Requirements
Requirement: One-way coupling of MOSART with ALM
Date last modified:
// date
Contributors:
@ name (add your name to this list if it does not appear)Each requirement is to be listed under a ”section” heading, as there will be a one-to-one correspondence between requirements, design, proposed imple- mentation and testing. Requirements should not discuss technical software issues, but rather focus on model capability. To the extent possible, require- ments should be relatively independent of each other, thus allowing a clean design solution, implementation and testing plan.
Algorithmic Formulations
Design solution: short-description-of-proposed-solution-here
Date last modified:// date
Contributors: (add your name to this list if it does not appear)
For each requirement, there is a design solution that is intended to meet that requirement. Design solutions can include detailed technical discussions of PDEs, algorithms, solvers and similar, as well as technical discussion of performance issues. In general, this section should steer away from a detailed discussion of low-level software issues such as variable declarations, interfaces and sequencing.
Hongyi Li, Anthony Craig, Ruby Leung
The MOSART river routing model has been developed and documented in Li et al. (2013) and evaluated globally as an offline model in Li et al. (2015). MOSART has been coupled with ALM through the flux coupler. ALM passes the runoff fields to MOSART, and MOSART passes back the river channel storage to ALM to maintain an overall water balance.
Li, H.-Y., L.R. Leung, A. Getirana, M. Huang, H. Wu, Y. Xu, J. Guo, and N. Voisin. 2015. “Evaluating Global Streamflow Simulations by a Physically-Based Routing Model Coupled With the Community Land Model.” J. Hydrometeor., 16, 948-971, doi:10.1175/JHM-D-14-0079.1.
Li, H., M.S. Wigmosta, H. Wu, M. Huang, Y. Ke, A.M. Coleman, and L.R. Leung. 2013. “A Physically Based Runoff Routing Model for Land Surface and Earth System Models.” J. Hydrometeor., 14(3), 808 – 828, doi: http://dx.doi.org/10.1175/JHM-D-12-015.1.
Requirement: Evaluation of the one-way coupled ALM-MOSART
Date last modified:
Contributors: Hongyi Li, Anthony Craig, Ruby Leung
Perform global simulations of ALM-MOSART and repeat similar analyses discussed in Li et al. (2015) for model evaluation.
Algorithmic Formulations
Design solution: Implementation of one-way coupling
Date last modified:
Contributors: Hongyi Li, Anthony Craig, Ruby Leung
Previously, CLM passes three runoff fields (QOVER, QDRAI, and QGWL) to RTM or MOSART. The last term, QGWL is not associated with a runoff generation process but is a residual term required to maintain water balance in glaciers, wetlands and lakes, and it can assume large negative values. RTM takes the total runoff (positive or negative), and returns the total channel storage (VOLR) to CLM to conserve the overall CLM water balance. In the previous implementation of MOSART, the total runoff is forced to be non-negative, but the total channel storage was calculated in the same way as done in RTM so it has no impact on the overall CLM water balance.
With the new implementation of MOSART in ALM, the three runoff terms are passed separately to MOSART:
1) If QGWL is negative, the negative values are passed directly to the ocean through the flux coupler. Only positive QGWL values are passed to MOSART and treated as runoff that directly goes to the main river channel.
2) ALM also passes QSUR and QSUB to MOSART that are routed through hillslope and tributary.
3) MOSART calculates total channel storage (main channel storage + tributary channel storage) and passes it back to ALM through the coupler.
Design solution: Metrics to evaluate MOSART simulated streamflow
Date last modified:
Contributors: Hongyi Li, Anthony Craig, Ruby Leung
This will follow the approach of Li et al. (2015) for global evaluation of simulated streamflow using GRDC data. In a nutshell, streamflow is evaluated separately in river basins influenced by human activities at different levels.
Design and Implementation
Implementation:
shortOne-
desciption-of-implementation-hereway coupling of MOSART to ALM
Date last modified: // date
Contributors:
(add your name to this list if it does not appear)This section should detail the plan for implementing the design solution for requirement XXX. In general, this section is software-centric with a focus on software implementation. Pseudo code is appropriate in this section. Links to actual source code are appropriate. Project management items, such as svn branches, timelines and staffing are also appropriate. How do we typeset pseudo code?
Ruby Leung, Hongyi Li, Anthony Craig
In broad terms, the implementation of MOSART in ALM will follow the software engineering patterns established for previous implementation of MOSART within CLM. Significant differences include the level in the subgrid hierarchy at which ALM-to-MOSART coupling is realized, and the introduction of main channel and tributary storage terms passed back to ALM from MOSART.
Planned Verification and Unit Testing
Verification and Unit Testing:
short-desciption-of-testing-hereVerify one-way coupling of MOSART
Date last modified:
Contributors:
(add your name to this list if it does not appear)How will XXX be tested? i.e. how will be we know when we have met requirement XXX. Will these unit tests be included in the ongoing going forward?
Hongyi Li, Ruby Leung
Verification is performed by checking the fields that are passed from ALM to MOSART and vice versa through the flux coupler. MOSART has been verified previously through water balance check. The one-way coupled ALM-MOSART has been tested on Titan and passed the ACME_developer tests.
Planned Validation Testing
Validation Testing:
short-desciption-of-testing-hereValidate one-way coupling of MOSART
Date last modified:
Contributors:
(add your name to this list if it does not appear)How will XXX be tested? What observational or other dataset will be used? i.e. how will be we know when we have met requirement XXX. Will these unit tests be included in the ongoing going forward?
Hongyi Li, Ruby Leung
Validation is performed by comparing the MOSART simulated streamflow with observations.
Planned Performance Testing
Performance Testing:
short-desciption-of-testing-hereMOSART performance
Date last modified:
Contributors:
(add your name to this list if it does not appear)
How Performance will XXX be tested? i.e. how will be we know when we have met requirement XXX. Will these unit tests be included in the ongoing going forward?
...
be evaluated using different number of processors on Titan.