W1 - Gustiness Design Document

Owned by Bryce Harrop
Last updated: Jul 16, 2019 by Robert Jacob
2 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

Gustiness (representation of subgrid winds)
2.Owner
Bryce Harrop
3.Created
4.Equ(tick)
5.Ver(tick)
6.Perf(tick)
7.Val(tick)
8.Approver
9.Approved Date
V2.0
 Click here for Table of Contents ...

Table of Contents

Title: Gustiness (representation of subgrid surface winds)

Requirements and Design

E3SM Atmosphere Group

Date: 

Summary

The gustiness formulation from v1 has been modified to allow to be applied globally (over land and ocean instead of restricted to ocean only) and also to include the the effect of large eddies from CLUBB.  These winds are added to the resolved-scale winds in the calculation of surface exchange of heat, moisture, and momentum.

Requirements

Requirement 1: Calculation of marine organic emissions from offline fields produced from marine biogeochemistry models

Date last modified:

Contributors: Po-Lun Ma, Balwinder Singh, Bryce Harrop


Algorithmic Formulations

Convective gustiness formulation taken from Redelsperger et al. (2000)



Design and Implementation

Three pull requests incorporate the gustiness: 2679 adds the main functionality; 2720 removes the previous implementation; 2789 adds namelist changes for EAMv2.


PR locations

https://github.com/E3SM-Project/E3SM/pull/2679 Merged to master on  

https://github.com/E3SM-Project/E3SM/pull/2720 Merged to master on  

https://github.com/E3SM-Project/E3SM/pull/2789 Merged to master on  

Verification and Unit Testing 

A test mod directory was added as part of PR 2789

Validation

Comparison of experiments with gustiness against EAMv1 control here

The previous implementation of convective gustiness (only over the ocean) was analyzed in a paper by Harrop et al. (2018) (highlight)

Performance Testing