E3SM Diagnostics Package v2

This documentation reflects the master branch of E3SM Diags. For documentation on specific releases, see:

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:

  • integrates the basic 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 (v2 release)

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, pressure-longitude meridional mean contour plots, area mean time series plots, and Cloud Top Height-Tau joint histograms from COSP cloud simulator output. Plots can be created for annual and seasonal climatologies, and monthly mean time series.

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. One back-end is available:

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

_images/fig01.png

Latitude-longitude contour map

_images/fig02.png

Summary table

_images/fig03.png

Taylor Diagram

_images/fig04.png

Zonal mean line plot

_images/fig05.png

Pressure-latitude zonal mean contour

_images/fig06.png

Polar contour map

_images/fig07.png

Cloud Top Height-Tau joint histograms

_images/fig08.png

Pressure-longitude meridional mean contour

_images/fig09.png

ENSO diagnostics map

_images/fig10.png

ENSO diagnostics scatter plot

_images/fig11.png

QBO

_images/fig12.png

Area Mean time series

_images/fig13.png

Diurnal cycle phase maps

_images/fig14.png

Streamflow seasonality map

_images/fig15.png

Mean annual streamflow map

_images/fig16.png

Mean annual streamflow scatter plot

The above plots and more can be found here.

Feature availability for each backend

The table below summarizes current status of features supported by the backend.

Plot set or Feature

mpl

Latitude-longitude contour maps

Polar contour maps

Pressure-latitude zonal mean contour plots

Pressure-longitude meridional mean contour

Zonal mean line plots

Cloud Top Height-Tau joint histograms

Area Mean time series plots

Multi-processing