The E3SM Diagnostics Package (E3SM Diags v2.7): a Python-based diagnostics package for Earth system model evaluation

Chengzhu Zhang; Jean Christophe Golaz; Ryan Forsyth; Tom Vo; Shaocheng Xie; Zeshawn Shaheen; Gerald L. Potter; Xylar S. Asay-Davis; Charles S. Zender; Wuyin Lin; Chih Chieh Chen; Chris R. Terai; Salil Mahajan; Tian Zhou; Karthik Balaguru; Qi Tang; Cheng Tao; Yuying Zhang; Todd Emmenegger; Susannah Burrows; Paul A. Ullrich

doi:10.5194/gmd-15-9031-2022

The E3SM Diagnostics Package (E3SM Diags v2.7): a Python-based diagnostics package for Earth system model evaluation

Chengzhu Zhang, Jean Christophe Golaz, Ryan Forsyth, Tom Vo, Shaocheng Xie, Zeshawn Shaheen, Gerald L. Potter, Xylar S. Asay-Davis, Charles S. Zender, Wuyin Lin, Chih Chieh Chen, Chris R. Terai, Salil Mahajan, Tian Zhou, Karthik Balaguru, Qi Tang, Cheng Tao, Yuying Zhang, Todd Emmenegger, Susannah BurrowsPaul A. Ullrich

Computational Earth Sciences Group

Research output: Contribution to journal › Article › peer-review

3 Scopus citations

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) Atmosphere Model Working Group 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.7, more process-oriented and phenomenon-based evaluation diagnostics have been implemented, such as analysis of the quasi-biennial oscillation (QBO), the El Niño-Southern Oscillation (ENSO), streamflow, the diurnal cycle of precipitation, tropical cyclones, ozone and aerosol properties. 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.

Original language	English
Pages (from-to)	9031-9056
Number of pages	26
Journal	Geoscientific Model Development
Volume	15
Issue number	24
DOIs	https://doi.org/10.5194/gmd-15-9031-2022
State	Published - Dec 20 2022

Funding

This work is performed under the auspices of the US DOE by the Lawrence Livermore National Laboratory under contract no. DE-AC52-07NA27344. It is supported by the Energy Exascale Earth System Model (E3SM) project and partially supported by Atmospheric Radiation Measurement (ARM) program, funded by the US Department of Energy, Office of Science, Office of Biological and Environmental Research, IM Release LLNL-JRNL-831555. Chih-Chieh Chen's contribution of the work is supported by the US Department of Energy, Office of Science, Office of Biological & Environmental Research (BER), Regional and Global Model Analysis (RGMA) component of the Earth and Environmental System Modeling program under award number DE-SC0022070 and the National Science Foundation (NSF) IA 1947282, as well as by the National Center for Atmospheric Research (NCAR), which is a major facility sponsored by the NSF under cooperative agreement no. 1852977. The authors would like to thank Peter Gleckler, Charles Doutriaux, Jadwiga (Yaga) Richter, Sasha Glanville, David Neelin and Yi-Hung Kuo for contributing their domain knowledge and expertise in climate model analysis and software development.

Funders	Funder number
National Science Foundation	IA 1947282
U.S. Department of Energy
National Center for Atmospheric Research	1852977
Office of Science
Biological and Environmental Research	LLNL-JRNL-831555, DE-SC0022070
Lawrence Livermore National Laboratory	DE-AC52-07NA27344

Access to Document

10.5194/gmd-15-9031-2022

Cite this

Zhang, C., Golaz, J. C., Forsyth, R., Vo, T., Xie, S., Shaheen, Z., Potter, G. L., Asay-Davis, X. S., Zender, C. S., Lin, W., Chen, C. C., Terai, C. R., Mahajan, S., Zhou, T., Balaguru, K., Tang, Q., Tao, C., Zhang, Y., Emmenegger, T., ... Ullrich, P. A. (2022). The E3SM Diagnostics Package (E3SM Diags v2.7): a Python-based diagnostics package for Earth system model evaluation. Geoscientific Model Development, 15(24), 9031-9056. https://doi.org/10.5194/gmd-15-9031-2022

@article{55359a7eb2394803ae788f27b72c727c,

title = "The E3SM Diagnostics Package (E3SM Diags v2.7): a Python-based diagnostics package for Earth system model evaluation",

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) Atmosphere Model Working Group 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.7, more process-oriented and phenomenon-based evaluation diagnostics have been implemented, such as analysis of the quasi-biennial oscillation (QBO), the El Ni{\~n}o-Southern Oscillation (ENSO), streamflow, the diurnal cycle of precipitation, tropical cyclones, ozone and aerosol properties. 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.",

author = "Chengzhu Zhang and Golaz, {Jean Christophe} and Ryan Forsyth and Tom Vo and Shaocheng Xie and Zeshawn Shaheen and Potter, {Gerald L.} and Asay-Davis, {Xylar S.} and Zender, {Charles S.} and Wuyin Lin and Chen, {Chih Chieh} and Terai, {Chris R.} and Salil Mahajan and Tian Zhou and Karthik Balaguru and Qi Tang and Cheng Tao and Yuying Zhang and Todd Emmenegger and Susannah Burrows and Ullrich, {Paul A.}",

note = "Publisher Copyright: {\textcopyright} 2022 Chengzhu Zhang et al.",

year = "2022",

month = dec,

day = "20",

doi = "10.5194/gmd-15-9031-2022",

language = "English",

volume = "15",

pages = "9031--9056",

journal = "Geoscientific Model Development",

issn = "1991-959X",

publisher = "European Geosciences Union",

number = "24",

}

Zhang, C, Golaz, JC, Forsyth, R, Vo, T, Xie, S, Shaheen, Z, Potter, GL, Asay-Davis, XS, Zender, CS, Lin, W, Chen, CC, Terai, CR, Mahajan, S, Zhou, T, Balaguru, K, Tang, Q, Tao, C, Zhang, Y, Emmenegger, T, Burrows, S & Ullrich, PA 2022, 'The E3SM Diagnostics Package (E3SM Diags v2.7): a Python-based diagnostics package for Earth system model evaluation', Geoscientific Model Development, vol. 15, no. 24, pp. 9031-9056. https://doi.org/10.5194/gmd-15-9031-2022

TY - JOUR

T1 - The E3SM Diagnostics Package (E3SM Diags v2.7)

T2 - a Python-based diagnostics package for Earth system model evaluation

AU - Zhang, Chengzhu

AU - Golaz, Jean Christophe

AU - Forsyth, Ryan

AU - Vo, Tom

AU - Xie, Shaocheng

AU - Shaheen, Zeshawn

AU - Potter, Gerald L.

AU - Asay-Davis, Xylar S.

AU - Zender, Charles S.

AU - Lin, Wuyin

AU - Chen, Chih Chieh

AU - Terai, Chris R.

AU - Mahajan, Salil

AU - Zhou, Tian

AU - Balaguru, Karthik

AU - Tang, Qi

AU - Tao, Cheng

AU - Zhang, Yuying

AU - Emmenegger, Todd

AU - Burrows, Susannah

AU - Ullrich, Paul A.

PY - 2022/12/20

Y1 - 2022/12/20

N2 - 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) Atmosphere Model Working Group 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.7, more process-oriented and phenomenon-based evaluation diagnostics have been implemented, such as analysis of the quasi-biennial oscillation (QBO), the El Niño-Southern Oscillation (ENSO), streamflow, the diurnal cycle of precipitation, tropical cyclones, ozone and aerosol properties. 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.

AB - 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) Atmosphere Model Working Group 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.7, more process-oriented and phenomenon-based evaluation diagnostics have been implemented, such as analysis of the quasi-biennial oscillation (QBO), the El Niño-Southern Oscillation (ENSO), streamflow, the diurnal cycle of precipitation, tropical cyclones, ozone and aerosol properties. 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.

UR - http://www.scopus.com/inward/record.url?scp=85145567184&partnerID=8YFLogxK

U2 - 10.5194/gmd-15-9031-2022

DO - 10.5194/gmd-15-9031-2022

M3 - Article

AN - SCOPUS:85145567184

SN - 1991-959X

VL - 15

SP - 9031

EP - 9056

JO - Geoscientific Model Development

JF - Geoscientific Model Development

IS - 24

ER -

The E3SM Diagnostics Package (E3SM Diags v2.7): a Python-based diagnostics package for Earth system model evaluation

Abstract

Funding

Access to Document

Other files and links

Fingerprint

Cite this