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, - completed, - in progress, - not done

Overview table for the owner and an approver of this feature

1.Description	RRM
2.Owner	Erika Roesler
3.Created	21 Sep 2015
4.Equ
5.Ver
6.Perf
7.Val
8.Approver	Shaocheng Xie
9.Approved Date	02 Oct 2015
V1.0	Approved

Click here for Table of Contents ...

Table of Contents

Title: RRM

Requirements and Design

ACME Atmosphere Group

Date: 21 Sep 2015

Summary

The purpose of this task is to create a regionally-refined test case for the ACME model. The refined area covers the continental United States (CONUS) and has the same resolution as the target resolution of the ACME model, 1/4-degree or ne120. The low resolution area covers the remainder of the globe and is 1-degree, or ne30. This configuration will enable developers wishing to see how their parameterization performs in high-resolution without having to run at global high-resolution. This configuration can be used when set-up as a new case by the user. See How to run the regionally refined model (RRM) for information on how to run with this configuration. Verification, performance testing, and validation are in progress.

Requirements

Requirement: RRM CONUS case configuration

Date last modified: 30 Jun 2015
Contributors: Erika Roesler , Mark Taylor Qi Tang , Wuyin Lin, Steve Klein

Grid, initial condition, and boundary condition files were uploaded to ACME data repository. A new case was developed on a feature branch and merged to master.

Algorithmic Formulations

Design solution: Case generation

Date last modified:21 Sep 2015
Contributors: Erika Roesler , Mark Taylor, Steve Klein

Grid file was generated and approved by ACME Atmos group. From this grid file the initial and boundary condition files were generated. The new case was then configured.

Design and Implementation

Implementation: CONUS implementation

Date last modified: 21 Sep 2015
Contributors: Erika Roesler , Wuyin Lin, Qi Tang, Mark Taylor

After the case and necessary files are generated, the case was implemented on a local cluster. Time steps were investigated as needed to achieve model stability.

Planned Verification and Unit Testing

Verification and Unit Testing: Test CONUS case on other ACME-supported machines

Date last modified: 21 Sep 2015
Contributors: Erika Roesler , Qi Tang, Wuyin Lin

Members of this group downloaded the feature branch and tested the case on their institutional clusters. If the case ran for the specified time, then this test and requirement was considered successful. A unit test for the RRM CONUS case in under consideration.

Planned Validation Testing

Validation Testing: Climatology analysis

Date last modified: 21 Sep 2015
Contributors: Erika Roesler , Mark Taylor , Qi Tang , Wuyin Lin , Steve Klein

Analysis of the climatology of the CONUS grid is underway. Comparisons will be made with the global uniform resolutions of the ne30 and ne120 (AMIP, v.03) simulations.

Validation Testing: CAPT testing

Date last modified: 21 Sep 2015
Contributors: Wuyin Lin, Qi Tang

CAPT tests will be performed as an application of this tool to understand model behavior at high resolution.

Validation Testing: Nudging

Date last modified: 21 Sep 2015
Contributors: Wuyin Lin, Qi Tang

Nudging tests will be performed as an application of this tool to understand model behavior at high resolution. See this page for more info on nudging:

How to perform nudging simulations with the regional refined model (RRM)

Planned Performance Testing

Performance Testing: RRM-CONUS performance testing

Date last modified: 21 Sep 2015
Contributors: Erika Roesler , Qi Tang, Wuyin Lin, Mark Taylor

Initial performance tests were performed on institutional clusters to compare the RRM case with global low or global high resolution cases. The performance of implementing nudging was also investigated here: /wiki/spaces/ATM/pages/24478405

Browser not supported