Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 19 Next »

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. 

Design Document

 

 Click here for instructions to fill up the table below ......

The first table in Design Document gives overview of this document, from this info the Design Documents Overview page is automatically created.

In the table below, 4.Equ means Equations and Algorithms, 5.Ver means Verification, 6.Perf - Performance, 7. Val - Validation

  • Equations: Document the equations that are being solved and describe algorithms
  • Verification Plans: Define tests that will be run to show that implementation is correct and robust. Involve unit tests to cover range of inputs as well as benchmarks.
  • Performance expectations: Explain the expected performance impact from this development
  • Validation Plans: Document what process-based, stand-alone component, and coupled model runs will be performed, and with what metrics will be used to assess validity

Use the symbols below (copy and paste) to indicate if the section is in progress or done or not started.

In the table below, 4.Equ means Equations and Algorithms, 5.Ver means Verification, 6.Perf - Performance, 7. Val - Validation,   (tick) - completed, (warning) - in progress, (error) - not done

 

Overview table for the owner and an approver of this feature

1.Description

 
2.OwnerStephen Price
3.Created 
4.Equ(tick)
5.Ver(tick)
6.Perf(warning)
7.Val(error)
8.Approver 
9.Approved Date 

 

 Click here for Table of Contents ...

Table of Contents

 

 


 


Title: O_24_LI MPAS Land Ice in ACME Design Doc

Requirements and Design

ACME Ocean and Ice Group

Date: 2015-9-23

Summary

A three dimensional, thermo-mechanical ice sheet model, implemented in the MPAS-Land Ice modeling framework, will be coupled to ACME. The model itself is more fully described elsewhere, including extensive verification and performance testing (see the references at the bottom of this document). This document describes the high-level requirements and design for the process of integrating that model into ACME.


Requirements


Requirement: blah

Date last modified:  2015-9-23
Contributors: Stephen Price


Requirement: blah

Date last modified:  2015-9-23
Contributors: Stephen Price


Requirement: blah

Date last modified:  2015-9-23
Contributors: Stephen Price



Algorithmic Formulations

Design solution: short-description-of-proposed-solution-here

Date last modified:  
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.


Design and Implementation

Implementation: conservation of energy

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

The model will solve the standard advective-diffusive equations for temperature evolution in an ice sheet.


 

 

 

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)

 


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?

 


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)

 

 

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?

 

 

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)

 

 

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?

 



References

  • Tezaur, I., M. Perego, A. Salinger, R. Tuminaro, and S. Price. 2015. Albany/FELIX: a parallel, scalable and robust, finite element, first-order Stokes approximation ice sheet solver built for advanced analysis, Geophys. Model Devel., 8, doi:10.5194/gmd-8-1197-2015. link
  • Tezaur, I., R. Tuminaro, M. Perego, A. Salinger, S. Price, 2015: On the scalability of the Albany/FELIX first-order Stokes approximation ice sheet solver for large-scale simulations of the Greenland and Antarctic ice sheets", Numerical and Computational Developments to Advance Multiscale Earth System Models (MSESM)/International Conference on Computational Science (ICCS15), Reykjavik, Iceland  link
  • MPAS Land Ice Model User's Guide Version 3.0. link





  • No labels