A10 RRM Design Document

Owned by Tanya Reshel
Last updated: May 29, 2019 by Renata McCoy
3 min read

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

RRM
2.Owner
Erika Roesler
3.Created
 
4.Equ(tick)
5.Ver(tick)
6.Perf(tick)
7.Val(tick)
8.Approver
Shaocheng Xie
9.Approved Date
 
V1.0Approved
 Click here for Table of Contents ...

Table of Contents

Title: RRM

Requirements and Design

ACME Atmosphere Group

Date:  

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:  
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: 
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:  
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:   
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:  
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:  
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:  
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:  
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