Submitted as: methods for assessment of models
01 Apr 2022
Submitted as: methods for assessment of models | 01 Apr 2022
Status: this preprint is currently under review for the journal GMD.

The E3SM Diagnostics Package (E3SM Diags v2.6): A Python-based Diagnostics Package for Earth System Models Evaluation

Chengzhu Zhang1, Jean-Christophe Golaz1, Ryan Forsyth1, Tom Vo1, Shaocheng Xie1, Zeshawn Shaheen1,a, Gerald L. Potter1, Xylar S. Asay-Davis2, Charles S. Zender3, Wuyin Lin4, Chih-Chieh Chen5, Chris R. Terai1, Salil Mahajan6, Tian Zhou7, Karthik Balaguru7, Qi Tang1, Cheng Tao1, Yuying Zhang1, Todd Emmenegger8, and Paul Ullrich9 Chengzhu Zhang et al.
  • 1Lawrence Livermore National Laboratory, Livermore, CA, USA
  • 2Los Alamos National Laboratory, Los Alamos, NM, USA
  • 3University of California, Irvine, Irvine, CA, USA
  • 4Brookhaven National Laboratory, Upton, NY, USA
  • 5National Center for Atmospheric Research, Boulder, CO, USA
  • 6Oak Ridge National Laboratory, Oak Ridge, TN, USA
  • 7Pacific Northwest National Laboratory, Richland, WA, USA
  • 8University of California, Los Angeles, Los Angeles, CA, USA
  • 9University of California, Davis, Davis, CA, USA
  • anow at: Google LLC, Mountain View, CA, USA

Abstract. The E3SM Diagnostics Package (E3SM Diags) is a modern, Python-based Earth System Model (ESM) evaluation tool (with Python module name e3sm_diags), developed to support the Department of Energy (DOE) Energy Exascale Earth System Model (E3SM). E3SM Diags provides a wide suite of tools for evaluating native E3SM output, as well as ESM data on regular latitude longitude grids, including output from Coupled Model Intercomparison Project (CMIP) class models.

E3SM Diags is modeled after the National Center for Atmospheric Research (NCAR) atmospheric model working group (AMWG) diagnostics package. In its version 1 release, E3SM Diags included a set of core essential diagnostics to evaluate the mean physical climate from model simulations. As of version 2.6, more process-oriented and phenomenon-based evaluation diagnostics have been implemented, such as analysis of the Quasi-biennial Oscillation (QBO), El Niño – Southern Oscillation (ENSO), streamflow, diurnal cycle of precipitation, tropical cyclones and ozone. An in-situ dataset from DOE’s Atmospheric Radiation Measurement (ARM) program has been integrated into the package for evaluating the representation of simulated cloud and precipitation processes.

This tool is designed with enough flexibility to allow for the addition of new observational datasets and new diagnostic algorithms. Additional features include: customizable figures; streamlined installation, configuration and execution; and multiprocessing for fast computation. The package uses an up-to-date observational data repository maintained by its developers, where recent datasets are added to the repository as they become available. Finally, several applications for the E3SM Diags module were introduced to fit a diverse set of use cases from the scientific community.

Chengzhu Zhang et al.

Status: open (until 22 Jun 2022)

Comment types: AC – author | RC – referee | CC – community | EC – editor | CEC – chief editor | : Report abuse
  • RC1: 'RC Comment on gmd-2022-38', Valeriu Predoi, 10 May 2022 reply

Chengzhu Zhang et al.

Chengzhu Zhang et al.


Total article views: 410 (including HTML, PDF, and XML)
HTML PDF XML Total BibTeX EndNote
298 107 5 410 3 1
  • HTML: 298
  • PDF: 107
  • XML: 5
  • Total: 410
  • BibTeX: 3
  • EndNote: 1
Views and downloads (calculated since 01 Apr 2022)
Cumulative views and downloads (calculated since 01 Apr 2022)

Viewed (geographical distribution)

Total article views: 354 (including HTML, PDF, and XML) Thereof 354 with geography defined and 0 with unknown origin.
Country # Views %
  • 1
Latest update: 20 May 2022
Short summary
Earth system model (ESM) developers run automated analysis tools on data from candidate models to inform model development. This paper introduces a new Python package: E3SM Diags, that has been developed to support ESM development and used routinely in the development of DOE’s Energy Exascale Earth System Model. This tool covers a set of essential diagnostics to evaluate the mean physical climate from simulations, as well as several process-oriented and phenomenon-based evaluation diagnostics.