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 18 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 added to ACME. The model solves equations for the conservation of momentum, energy, and mass. The momentum balance solver - Felix-Albany, developed as part of the PISCEES project - is based on the first-order accurate approximation to the Stokes equations for ice flow and uses finite element methods discretized on variable resolution, Delaunay triangulation meshes (the dual mesh to the SCVT-meshes used by other MPAS components). Because the momentum balance solver has undergone extensive verification and performance testing elsewhere, many of the sections below will simply contain links to already published work. Similarly, where appropriate, links to existing documentation of the MPAS-Land Ice modeling framework will be provided in lieu of detailed descriptions.

Requirements


Requirement: conservation of momentum, energy, and mass

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

The model will conserve momentum, energy, and mass.


Requirement: simulation of grounded, transitional, and floating ice-flow regimes

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

The model will simulate the flow of both grounded and floating ice (ice shelves), as well as transitional flow regimes (e.g. ice streams) in between

Requirement: grounding line dynamics

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

The model will accurately simulate ice sheet dynamics at the grounding line (specifically, grounding line advance and retreat).


Requirement: iceberg calving

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

The model will simulate calving of icebergs to allow for advance and retreat of floating ice shelves

 

Requirement: other

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





  • No labels