E3SM Diagnostics Package

Table of Contents

1. Documentation
2. Overview
3. Current State

Documentation

• Documentation Website
• Sample Output, Historical H1 (2011-2013) vs Historical H1 (1850-1852)
• Quick Start Guides:
  • Quick Start Guide for NERSC Cori
  • Quick Start Guide for NERSC Edison
  • Quick Start Guide for AIMS4/ACME1
  • Quick Start Guide for OLCF Rhea
• Examples:
  • Model Time-series vs Model Time-series
  • Model Time-series vs Model Time-series with CMIP data
  • Model Time-series vs Observation Time-series with CMIP data
  • Model Climo vs Model Climo Comparison
  • Model Climo vs Observation Climo Comparison
  • Observation vs Observation Comparison

Overview

This diagnostics package is constructed for supporting the diagnostics task of DOE's Energy Exascale Earth System Model (E3SM) project. The goal of this work is to develop a comprehensive diagnostics package that:

• fully integrates the functionality of NCAR's AMWG diagnostics package.
• utilizes most updated observational datasets, including remote sensing, reanalysis and in-situ datasets.
• interfaces with diagnostics developed from different E3SM focus groups: atmosphere group, coupled simulation group, land group.
• interacts effectively with the PCMDI's metrics package and the ARM diagnostics package through a unifying framework: Community Diagnostics Package (CDP).
• is flexible for user specified diagnostics and being configured for use by other climate models.

Current State

Algorithm and visualization codes for the AMWG Set 5, 7, 4, 3, 13, 1, 14 diagnostics, namely lat-lon contour plots (Figure 1), polar contour plots (Figure 2), zonal mean 2d plots (Figure 3), zonal mean line plots (Figure 4), 2d joint histogram for COSP cloud simulator output (Figure 5), tables (Figure 6) and Taylor Diagrams (Figure 7) summarizing metrics, for climatology seasonal means, are implemented.

The package features built-in user diagnostics, by specifying user desired diagnostics regions and pressure levels for variables with the vertical dimension.

In addition to default model versus observation comparison, the package also provide support for model versus model and obs versus obs comparisons.

Figure 1: An example of the lat-lon contour plots for air temperature at 850 mb with tropical ocean region considered

Figure 2: An example of the polar contour plots for precipitation rate

Figure 3: An example of the pressure-lat contour plots for air temperature

Figure 4: An example of the zonal mean surface air temperature line plot

Figure 5: An example of 2d joint histogram plot using COSP simulator output

Figure 6: An example of table summarizing metrics calculated based on lat-lon contour plots diagnostics

Figure 7: An example of Taylor diagram summarizing metrics calculated based on lat-lon contour plots diagnostics of several key variables

License

Copyright (c) 2018-2021, Energy Exascale Earth System Model Project All rights reserved

SPDX-License-Identifier: (BSD-3-Clause)

See LICENSE for details

Unlimited Open Source - BSD 3-clause Distribution LLNL-CODE-819717