A curated list of open technology projects to sustain a stable climate, energy supply, biodiversity and natural resources.

ESMValTool

A community diagnostic and performance metrics tool for routine evaluation of Earth system models in World Climate Research Programme.
https://github.com/ESMValGroup/ESMValTool

Category: Climate Change
Sub Category: Earth and Climate Modeling

Keywords from Contributors

earth-science oceanography hydrology meteorology climate-models visualisation grib iris spaceweather climate

Last synced: about 16 hours ago
JSON representation

Repository metadata

ESMValTool: A community diagnostic and performance metrics tool for routine evaluation of Earth system models in CMIP

README.md

Maintenance
made-with-python
Documentation Status
DOI
Chat on Matrix
CircleCI
Test in Full Development Mode
Codacy Badge
Docker Build Status
Anaconda-Server Badge
stand with Ukraine

esmvaltoollogo

Introduction

ESMValTool is a community-developed climate model diagnostics and evaluation software package, driven
both by computational performance and scientific accuracy and reproducibility. ESMValTool is open to both
users and developers, encouraging open exchange of diagnostic source code and evaluation results from the
Coupled Model Intercomparison Project CMIP ensemble. For a
comprehensive introduction to ESMValTool please visit our
documentation page.

Running esmvaltool

Diagnostics from ESMValTool are run using recipe
files that contain pointers to the requested data types, directives for the preprocessing steps that data
will be subject to, and directives for the actual diagnostics that will be run with the now preprocessed data.
Data preprocessing is done via the ESMValCore package, a pure Python, highly-optimized scientific library, developed by the ESMValTool core developers,
and that performs a number of common analysis tasks
such as regridding, masking, levels extraction etc. Diagnostics are written in a variety of programming languages (Python, NCL, R, Julia) and are developed by the wider
scientific community, and included after a scientific and technical review process.

Input data

ESMValTool can run with the following types of data as input:

Getting started

Please see getting started on our instance of Read the Docs as well as ESMValTool tutorial. The tutorial is a set of lessons that together teach skills needed to work with ESMValTool in climate-related domains.

Getting help

The easiest way to get help, if you cannot find the answer in the documentation in our docs, is to open an issue on GitHub.

Contributing

If you would like to contribute a new diagnostic or feature, please have a look at our contribution guidelines.

Citation (CITATION.cff)

# YAML 1.2
---
abstract: "ESMValTool: A community diagnostic and performance metrics tool for routine evaluation of Earth system models in CMIP."

authors:
  -
    affiliation: "NLeSC, Netherlands"
    family-names: Andela
    given-names: Bouwe
    orcid: "https://orcid.org/0000-0001-9005-8940"
  -
    affiliation: "DLR, Germany"
    family-names: Broetz
    given-names: Bjoern
  -
    affiliation: "PML, UK"
    name-particle: de
    family-names: Mora
    given-names: Lee
    orcid: "https://orcid.org/0000-0002-5080-3149"
  -
    affiliation: "NLeSC, Netherlands"
    family-names: Drost
    given-names: Niels
    orcid: "https://orcid.org/0000-0001-9795-7981"
  -
    affiliation: "DLR, Germany"
    family-names: Eyring
    given-names: Veronika
    orcid: "https://orcid.org/0000-0002-6887-4885"
  -
    affiliation: "AWI, Germany"
    family-names: Koldunov
    given-names: Nikolay
    orcid: "https://orcid.org/0000-0002-3365-8146"
  -
    affiliation: "DLR, Germany"
    family-names: Lauer
    given-names: Axel
    orcid: "https://orcid.org/0000-0002-9270-1044"
  -
    affiliation: "LMU, Germany"
    family-names: Mueller
    given-names: Benjamin
  -
    affiliation: "URead, UK"
    family-names: Predoi
    given-names: Valeriu
    orcid: "https://orcid.org/0000-0002-9729-6578"
  -
    affiliation: "DLR, Germany"
    family-names: Righi
    given-names: Mattia
    orcid: "https://orcid.org/0000-0003-3827-5950"
  -
    affiliation: "DLR, Germany"
    family-names: Schlund
    given-names: Manuel
    orcid: "https://orcid.org/0000-0001-5251-0158"
  -
    affiliation: "BSC, Spain"
    family-names: Vegas-Regidor
    given-names: Javier
    orcid: "https://orcid.org/0000-0003-0096-4291"
  -
    affiliation: "SMHI, Sweden"
    family-names: Zimmermann
    given-names: Klaus
  -
    affiliation: "University of Bremen, Germany"
    family-names: Adeniyi
    given-names: Kemisola
  -
    affiliation: "ISAC-CNR, Italy"
    family-names: Arnone
    given-names: Enrico
    orcid: "https://orcid.org/0000-0001-6740-5051"
  -
    affiliation: "BSC, Spain"
    family-names: Bellprat
    given-names: Omar
    orcid: "https://orcid.org/0000-0001-6434-1793"
  -
    affiliation: "SMHI, Sweden"
    family-names: Berg
    given-names: Peter
    orcid: "https://orcid.org/0000-0002-1469-2568"
  -
    affiliation: "Met Office, UK"
    family-names: Billows
    given-names: Chris
  -
    affiliation: "DLR, Germany"
    family-names: Bock
    given-names: Lisa
    orcid: "https://orcid.org/0000-0001-7058-5938"
  -
    affiliation: "Met Office, UK"
    family-names: Bodas-Salcedo
    given-names: Alejandro
    orcid: "https://orcid.org/0000-0002-7890-2536"
  -
    affiliation: "BSC, Spain"
    family-names: Caron
    given-names: Louis-Philippe
    orcid: "https://orcid.org/0000-0001-5221-0147"
  -
    affiliation: "MPI for Biogeochemistry, Germany"
    family-names: Carvalhais
    given-names: Nuno
  -
    affiliation: "ENEA, Italy"
    family-names: Cionni
    given-names: Irene
    orcid: "https://orcid.org/0000-0002-0591-9193"
  -
    affiliation: "BSC, Spain"
    family-names: Cortesi
    given-names: Nicola
    orcid: "https://orcid.org/0000-0002-1442-9225"
  -
    affiliation: "ISAC-CNR, Italy"
    family-names: Corti
    given-names: Susanna
  -
    affiliation: "ETH Zurich, Switzerland"
    family-names: Crezee
    given-names: Bas
    orcid: "https://orcid.org/0000-0002-1774-1126"
  -
    affiliation: "ETH Zurich, Switzerland"
    family-names: Davin
    given-names: Edouard Leopold
    orcid: "https://orcid.org/0000-0003-3322-9330"
  -
    affiliation: "ISAC-CNR, Italy"
    family-names: Davini
    given-names: Paolo
    orcid: "https://orcid.org/0000-0003-3389-7849"
  -
    affiliation: "NCAR, USA"
    family-names: Deser
    given-names: Clara
  -
    affiliation: "NLeSC, Netherlands"
    family-names: Diblen
    given-names: Faruk
  -
    affiliation: "UCLouvain, Belgium"
    family-names: Docquier
    given-names: David
  -
    affiliation: "Met Office, UK"
    family-names: Dreyer
    given-names: Laura
  -
    affiliation: "DKRZ, Germany"
    family-names: Ehbrecht
    given-names: Carsten
  -
    affiliation: "Met Office, UK"
    family-names: Earnshaw
    given-names: Paul
  -
    affiliation: "Met Office, UK"
    family-names: Geddes
    given-names: Theo
  -
    affiliation: "University of Bremen, Germany"
    family-names: Gier
    given-names: Bettina
  -
    affiliation: "Met Office, UK"
    family-names: Gillett
    given-names: Ed
  -
    affiliation: "BSC, Spain"
    family-names: Gonzalez-Reviriego
    given-names: Nube
    orcid: "https://orcid.org/0000-0002-5919-6701"
  -
    affiliation: "University of Arizona, USA"
    family-names: Goodman
    given-names: Paul
  -
    affiliation: "HZG, Germany"
    family-names: Hagemann
    given-names: Stefan
    orcid: "https://orcid.org/0000-0001-5444-2945"
  -
    affiliation: "University of Canterbury, New Zealand"
    family-names: Hardacre
    given-names: Catherine
    orcid: "https://orcid.org/0000-0001-9093-4656"
  -
    affiliation: "ISAC-CNR, Italy"
    name-particle: von
    family-names: Hardenberg
    given-names: Jost
    orcid: "https://orcid.org/0000-0002-5312-8070"
  -
    affiliation: "DLR, Germany"
    family-names: Hassler
    given-names: Birgit
    orcid: "https://orcid.org/0000-0003-2724-709X"
  -
    affiliation: "DLR, Germany"
    family-names: Heuer
    given-names: Helge
    orcid: "https://orcid.org/0000-0003-2411-7150"
  -
    affiliation: "Met Office, UK"
    family-names: Hogan
    given-names: Emma
  -
    affiliation: "BSC, Spain"
    family-names: Hunter
    given-names: Alasdair
    orcid: "https://orcid.org/0000-0001-8365-3709"
  -
    affiliation: "FUB, Germany"
    family-names: Kadow
    given-names: Christopher
  -
    affiliation: "DKRZ, Germany"
    family-names: Kindermann
    given-names: Stephan
    orcid: "https://orcid.org/0000-0001-9335-1093"
  -
    affiliation: "MPI for Biogeochemistry, Germany"
    family-names: Koirala
    given-names: Sujan
  -
    affiliation: "DLR, Germany"
    family-names: Kuehbacher
    given-names: Birgit
  -
    affiliation: "BSC, Spain"
    family-names: Lledó
    given-names: Llorenç
  -
    affiliation: "ETH Zurich, Switzerland"
    family-names: Lejeune
    given-names: Quentin
  -
    affiliation: "University of Hamburg, German"
    family-names: Lembo
    given-names: Valerio
    orcid: "https://orcid.org/0000-0001-6085-5914"
  -
    affiliation: "Met Office, UK"
    family-names: Little
    given-names: Bill
  -
    affiliation: "BSC, Spain"
    family-names: Loosveldt-Tomas
    given-names: Saskia
  -
    affiliation: "ETH Zurich, Switzerland"
    family-names: Lorenz
    given-names: Ruth
    orcid: "https://orcid.org/0000-0002-3986-1268"
  -
    affiliation: "CMCC, Italy"
    family-names: Lovato
    given-names: Tomas
    orcid: "https://orcid.org/0000-0002-5188-6767"
  -
    affiliation: "University of Hamburg, German"
    family-names: Lucarini
    given-names: Valerio
  -
    affiliation: "UCLouvain, Belgium"
    family-names: Massonnet
    given-names: François
  -
    affiliation: "NIBIO, Norway"
    family-names: Mohr
    given-names: Christian Wilhelm
    orcid: "https://orcid.org/0000-0003-2656-1802"
  -
    affiliation: "University of Arizona, USA"
    family-names: Amarjiit
    given-names: Pandde
  -
    affiliation: "BSC, Spain"
    family-names: Pérez-Zanón
    given-names: Núria
  -
    affiliation: "NCAR, USA"
    family-names: Phillips
    given-names: Adam
    orcid: "https://orcid.org/0000-0003-4859-8585"
  -
    affiliation: "ACCESS-NRI, Australia"
    family-names: Proft
    given-names: Max
    orcid: "https://orcid.org/0009-0003-1611-9516"
  -
    affiliation: "University of Arizona, USA"
    family-names: Russell
    given-names: Joellen
  -
    affiliation: "CICERO, Norway"
    family-names: Sandstad
    given-names: Marit
  -
    affiliation: "Met Office, UK"
    family-names: Sellar
    given-names: Alistair
  -
    affiliation: "DLR, Germany"
    family-names: Senftleben
    given-names: Daniel
  -
    affiliation: "ISMAR-CNR, Italy"
    family-names: Serva
    given-names: Federico
    orcid: "https://orcid.org/0000-0002-7118-0817"
  -
    affiliation: "CICERO, Norway"
    family-names: Sillmann
    given-names: Jana
  -
    affiliation: "MPI-M, Germany"
    family-names: Stacke
    given-names: Tobias
    orcid: "https://orcid.org/0000-0003-4637-5337"
  -
    affiliation: "URead, UK"
    family-names: Swaminathan
    given-names: Ranjini
    orcid: "https://orcid.org/0000-0001-5853-2673"
  -
    affiliation: "Met Office, UK"
    family-names: Tomkins
    given-names: Katherine
  -
    affiliation: "BSC, Spain"
    family-names: Torralba
    given-names: Verónica
  -
    affiliation: "University of Bremen, Germany"
    family-names: Weigel
    given-names: Katja
    orcid: "https://orcid.org/0000-0001-6133-7801"
  -
    affiliation: "DLR, Germany"
    family-names: Sarauer
    given-names: Ellen
  -
    affiliation: "University of Reading, UK"
    family-names: Roberts
    given-names: Charles
    orcid: "https://orcid.org/0000-0002-1147-8961"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Kalverla
    given-names: Peter
    orcid: "https://orcid.org/0000-0002-5025-7862"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Alidoost
    given-names: Sarah
    orcid: "https://orcid.org/0000-0001-8407-6472"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Verhoeven
    given-names: Stefan
    orcid: "https://orcid.org/0000-0002-5821-2060"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Vreede
    given-names: Barbara
    orcid: "https://orcid.org/0000-0002-5023-4601"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Smeets
    given-names: Stef
    orcid: "https://orcid.org/0000-0002-5413-9038"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Soares Siqueira
    given-names: Abel
    orcid: "https://orcid.org/0000-0003-4451-281X"
  -
    affiliation: "DLR, Germany"
    family-names: Kazeroni
    given-names: Rémi
    orcid: "https://orcid.org/0000-0001-7205-9528"
  -
    affiliation: "NASA, USA"
    family-names: Potter
    given-names: Jerry
  -
    affiliation: "DLR, Germany"
    family-names: Winterstein
    given-names: Franziska
    orcid: "https://orcid.org/0000-0002-2406-4936"
  -
    affiliation: "ACCESS-NRI, Australia"
    family-names: Beucher
    given-names: Romain
    orcid: "https://orcid.org/0000-0003-3891-5444"
  -
    affiliation: "DLR, Germany"
    family-names: Kraft
    given-names: Jeremy
  -
    affiliation: "University of Bremen, Germany"
    family-names: Ruhe
    given-names: Lukas
    orcid: "https://orcid.org/0000-0001-6349-9118"
  -
    affiliation: "DLR, Germany"
    family-names: Bonnet
    given-names: Pauline
    orcid: "https://orcid.org/0000-0003-3780-0784"
  -
    affiliation: "Met Office, UK"
    family-names: Munday
    given-names: Gregory
    orcid: "https://orcid.org/0000-0003-4750-9923"

cff-version: 1.2.0
date-released: 2025-03-05
doi: "10.5281/zenodo.3401363"
license: "Apache-2.0"
message: "If you use this software, please cite it using these metadata."
repository-code: "https://github.com/ESMValGroup/ESMValTool/"
title: ESMValTool
version: "v2.12.0"
...

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 9,207
Total Committers: 139
Avg Commits per committer: 66.237
Development Distribution Score (DDS): 0.859

Commits in past year: 163
Committers in past year: 24
Avg Commits per committer in past year: 6.792
Development Distribution Score (DDS) in past year: 0.791

Name Email Commits
Bouwe Andela b****a@e****l 1294
Valeriu Predoi v****i@g****m 1088
Mattia Righi m****i@d****e 1026
Manuel Schlund m****d@d****e 654
Javier Vegas-Regidor j****s@b****s 611
Lee de Mora l****m@p****k 356
jhardenberg h****g@g****m 326
Axel Lauer a****r@d****e 290
Bas Crezee b****e@g****m 209
nperezzanon n****z@b****s 173
Björn Brötz b****z@d****e 170
SarahAlidoost f****t@e****l 168
loewalex b****2 157
Lisa Bock l****k@d****e 148
Tomas Lovato t****o@c****t 140
Nikolay Koldunov k****n@g****m 138
Ben b****r@i****e 134
Peter Kalverla p****a@g****m 132
Birgit Hassler 3****6 131
Enrico Arnone e****e@i****t 126
github-actions[bot] 4****] 107
Klaus Zimmermann k****n@s****e 102
bettina-gier B****r@d****e 93
“katjaweigel” “****l@i****” 88
Veronika Eyring v****g@d****e 86
Tobias Stacke t****e@m****e 80
mwjury m****y@g****m 64
RicardaRe r****r@d****e 60
zechlau 3****u 59
peter.berg a****0@c****e 57
and 109 more...

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 1,587
Total pull requests: 2,197
Average time to close issues: 4 months
Average time to close pull requests: about 1 month
Total issue authors: 162
Total pull request authors: 109
Average comments per issue: 5.0
Average comments per pull request: 5.19
Merged pull request: 1,815
Bot issues: 0
Bot pull requests: 146

Past year issues: 202
Past year pull requests: 277
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 11 days
Past year issue authors: 36
Past year pull request authors: 31
Past year average comments per issue: 2.84
Past year average comments per pull request: 2.81
Past year merged pull request: 178
Past year bot issues: 0
Past year bot pull requests: 56

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/ESMValGroup/ESMValTool

Top Issue Authors

  • valeriupredoi (211)
  • bouweandela (192)
  • schlunma (95)
  • mattiarighi (94)
  • ehogan (65)
  • ledm (61)
  • remi-kazeroni (55)
  • jvegreg (41)
  • rswamina (40)
  • zklaus (32)
  • sloosvel (31)
  • nielsdrost (30)
  • alistairsellar (29)
  • axel-lauer (25)
  • bascrezee (23)

Top Pull Request Authors

  • bouweandela (350)
  • valeriupredoi (328)
  • schlunma (185)
  • github-actions[bot] (146)
  • mattiarighi (119)
  • jvegreg (98)
  • axel-lauer (82)
  • zklaus (59)
  • remi-kazeroni (56)
  • bjoernbroetz (45)
  • LisaBock (39)
  • ehogan (38)
  • sloosvel (34)
  • rbeucher (32)
  • yifatdzigan (30)

Top Issue Labels

  • enhancement (308)
  • bug (234)
  • diagnostic (226)
  • documentation (147)
  • installation (130)
  • observations (103)
  • Recipe Test Workflow (RTW) (78)
  • testing (63)
  • standards (59)
  • community (56)
  • question (56)
  • release (46)
  • help wanted (46)
  • metric (41)
  • Data (26)
  • REF (24)
  • iris (21)
  • PRIMAVERA (15)
  • deployment (14)
  • EUCP (12)
  • ESMValBot (11)
  • AutoAssess (11)
  • eWaterCycle (10)
  • IPCC (9)
  • era5 (9)
  • is-enes (8)
  • deprecated feature (6)
  • backwards incompatible change (6)
  • requires new ESMValCore release (5)
  • EMAC (3)

Top Pull Request Labels

  • documentation (334)
  • diagnostic (326)
  • testing (290)
  • enhancement (198)
  • observations (195)
  • bug (173)
  • installation (148)
  • automatedPR (147)
  • condalock (129)
  • release (102)
  • approved by technical reviewer (100)
  • approved by scientific reviewer (83)
  • Recipe Test Workflow (RTW) (60)
  • standards (34)
  • ESMValBot (26)
  • deployment (26)
  • deprecated feature (24)
  • requires new ESMValCore release (24)
  • Data (23)
  • looking for technical reviewer (21)
  • eWaterCycle (18)
  • REF (17)
  • in technical review (17)
  • EUCP (16)
  • IPCC (14)
  • looking for scientific reviewer (14)
  • new recipe (13)
  • community (12)
  • iris (12)
  • in scientific review (12)

Package metadata

pypi.org: esmvaltool

ESMValTool: A community diagnostic and performance metrics tool for routine evaluation of Earth system models in CMIP.

  • Homepage: https://www.esmvaltool.org
  • Documentation: https://esmvaltool.readthedocs.io/
  • Licenses: Apache License, Version 2.0
  • Latest release: 2.12.0 (published about 2 months ago)
  • Last Synced: 2025-04-25T14:37:10.966Z (1 day ago)
  • Versions: 14
  • Dependent Packages: 1
  • Dependent Repositories: 1
  • Downloads: 672 Last month
  • Rankings:
    • Dependent packages count: 4.781%
    • Average: 14.214%
    • Downloads: 16.303%
    • Dependent repos count: 21.559%
  • Maintainers (5)

Dependencies

.github/workflows/citation_file_validator.yml actions
  • actions/checkout v3 composite
  • citation-file-format/cffconvert-github-action 2.0.0 composite
.github/workflows/create-condalock-file.yml actions
  • actions/checkout v3 composite
  • conda-incubator/setup-miniconda v2 composite
  • peter-evans/create-pull-request v3 composite
.github/workflows/install-from-conda.yml actions
  • actions/upload-artifact v2 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/install-from-condalock-file.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v2 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/install-from-source.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v2 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/pypi-build-and-deploy.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v1 composite
  • pypa/gh-action-pypi-publish v1.5.0 composite
.github/workflows/run-tests-monitor.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v2 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/test-development.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v2 composite
  • conda-incubator/setup-miniconda v2 composite
.github/workflows/test.yml actions
  • actions/checkout v3 composite
  • actions/upload-artifact v2 composite
  • conda-incubator/setup-miniconda v2 composite
esmvaltool/diag_scripts/extreme_events/climdex.pcic.ncdf/DESCRIPTION cran
  • PCICt >= 0.5 depends
  • R >= 3.0 depends
  • climdex.pcic >= 1.1 imports
  • functional >= 0.4 imports
  • ncdf4 >= 1.10 imports
  • ncdf4.helpers >= 0.3 imports
  • proj4 >= 1.0 imports
  • snow >= 0.3 imports
  • udunits2 >= 0.6 imports
  • RUnit * suggests
docker/Dockerfile docker
  • condaforge/mambaforge latest build
environment.yml pypi
pyproject.toml pypi
setup.py pypi

Score: 17.903984454836245