E3SM Diagnostics Package

Contents:

• E3SM Diagnostics Package
• Input Data Requirement
• Quick Guides
  • Quick guide for running in e3sm_unified environment for Compy and Others
  • Quick guide for using Docker
  • Quick guide for NERSC Cori using Shifter
  • Quick guide for ANL ALCF Cooley using Singularity
  • Quick guide for LLNL AIMS4 or ACME1
  • Quick guide for OLCF Rhea
  • Old Quick Guides
• Examples
  • Running via the API
  • Model Time-series vs Model Time-series: Historical H1 (2011-2013) vs Historical H1 (1850-1852)
  • Model Time-series vs Model Time-series with CMIP data
  • Model Time-series vs Observation Time-series with CMIP data
  • Model Climatology vs Model Climatology
  • Model Climatology vs Observation Climatology
  • Observation Climatology vs Observation Climatology
• Installation
  • Latest stable release
  • Environment for development
• Configuration and Running
  • Configuration
  • Running
• Defining Parameters
  • Ways to define parameters
  • Selecting certain parameters
• Available Parameters
  • Parameters for diagnostics
  • Parameters for plotting
• Colormaps
  • Default
  • Precipitation
  • Wind
  • Customizing
• How to Add New Diagnostics Runs
  • Adding Derived Variables
  • Example
• Developer Guide
  • How to Add Diagnostic Sets to E3SM Diagnostics
  • How to Prepare a Release
  • Creating a New Environment from Scratch
• Contributing to E3SM Diags
  • Code
  • Documentation

Overview

This diagnostics package is constructed to support the diagnostics needs of DOE’s Energy Exascale Earth System Model (E3SM) project, formerly known as Accelerated Climate Modeling for Energy (ACME). The ultimate 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 configuration for use by other climate models.

Current State

Algorithm and visualization codes for latitude-longitude contour maps, polar contour maps, the accompanying summarizing table and Taylor diagram plots, pressure-latitude zonal mean contour plots, zonal mean line plots, and Cloud Top Height-Tau joint histograms from COSP cloud simulator output. Plots can be created for annual and seasonal climatologies.

The package also supports custom user diagnostics, by specifying plot type, desired region (global, ocean, land, etc.), pressure levels for variables with the vertical dimension.

For flexibility, the code structure cleanly separates data manipulation (reading input files, processing data, etc) from plotting functions. To satisfy specific user tastes, two graphical back-ends are available:

• matplotlib/ cartopy (mpl)
• CDAT VCS (vcs)

Additional back-ends could be implemented if the need arose.

Latitude-longitude contour map (mpl)	Polar contour map (mpl)
Pressure-latitude zonal mean contour plot (vcs)	Zonal mean line plot (vcs)
Cloud Top Height-Tau joint histograms (mpl)	Taylor Diagram (mpl)
Summary Table

Feature availability for each backend

Not all plot sets and feature are currently supported for every backend. The table below summarizes current status.

Plot set or Feature	mpl	vcs
Latitude-longitude contour maps	✔	✔
Polar contour maps	✔	✔
Pressure-latitude zonal mean contour plots	✔	✔
Zonal mean line plots	✔	✔
Cloud Top Height-Tau joint histograms	✔	✘ [1]
Multi-processing	✔	✔

^[1] Defaults to mpl instead.