ESMValCore

Core functionalities for the ESMValTool, a community diagnostic and performance metrics tool for routine evaluation of Earth System Models in the Climate Model Intercomparison Project.
https://github.com/esmvalgroup/esmvalcore

Category: Climate Change
Sub Category: Climate Data Processing and Analysis

Keywords from Contributors

earth-science oceanography grib iris meteorology spaceweather visualisation hydrology spatial-data-analysis climate

Last synced: about 1 hour ago
JSON representation

Repository metadata

ESMValCore: A community tool for pre-processing data from Earth system models in CMIP and running analysis scripts.

Host: GitHub
URL: https://github.com/esmvalgroup/esmvalcore
Owner: ESMValGroup
License: apache-2.0
Created: 2019-06-04T11:58:08.000Z (almost 7 years ago)
Default Branch: main
Last Pushed: 2026-04-10T17:48:31.000Z (7 days ago)
Last Synced: 2026-04-10T19:28:19.011Z (7 days ago)
Language: Python
Homepage: https://www.esmvaltool.org
Size: 138 MB
Stars: 58
Watchers: 21
Forks: 45
Open Issues: 94
Releases: 62
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Citation: CITATION.cff
- Codeowners: .github/CODEOWNERS
- Zenodo: .zenodo.json
- Notice: NOTICE

README.md

ESMValCore package

ESMValCore: core functionalities for the ESMValTool, a community diagnostic
and performance metrics tool for routine evaluation of Earth System Models
in the Climate Model Intercomparison Project (CMIP).

Getting started

Please have a look at the
documentation
to get started.

Using the ESMValCore package to run recipes

The ESMValCore package provides the esmvaltool command, which can be used to run
recipes
for working with CMIP-like data.
A large collection of ready to use
recipes and diagnostics
is provided by the
ESMValTool
package.

Using ESMValCore as a Python library

The ESMValCore package provides various functions for:

Finding data in a directory structure typically used for CMIP data.
Reading CMIP/CMOR tables and using those to check model and observational data.
ESMValTool preprocessor functions based on
iris for e.g. regridding,
vertical interpolation, statistics, correcting (meta)data errors, extracting
a time range, etcetera.

read all about it in the
API documentation.

Getting help

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

Contributing

Contributions are very welcome, please read our
contribution guidelines
to get started.

Citation (CITATION.cff)

# YAML 1.2
---
abstract: "ESMValCore: A community tool for pre-processing data from Earth system models in CMIP and running analysis scripts."
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: "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
    orcid: "https://orcid.org/0000-0003-3994-2057"
  -
    affiliation: "DLR, Germany"
    family-names: Bock
    given-names: Lisa
    orcid: "https://orcid.org/0000-0001-7058-5938"
  -
    affiliation: "NLeSC, Netherlands"
    family-names: Diblen
    given-names: Faruk
  -
    affiliation: "MetOffice, UK"
    family-names: Dreyer
    given-names: Laura
  -
    affiliation: "MetOffice, UK"
    family-names: Earnshaw
    given-names: Paul
  -
    affiliation: "DLR, Germany"
    family-names: Hassler
    given-names: Birgit
    orcid: "https://orcid.org/0000-0003-2724-709X"
  -
    affiliation: "MetOffice, UK"
    family-names: Little
    given-names: Bill
  -
    affiliation: "BSC, Spain"
    family-names: Loosveldt-Tomas
    given-names: Saskia
  -
    "affiliation": "NLeSC, Netherlands"
    "family-names": "Smeets"
    "given-names": "Stef"
    "orcid": "https://orcid.org/0000-0002-5413-9038"
  -
    "affiliation": "NLeSC, Netherlands"
    "family-names": "Camphuijsen"
    "given-names": "Jaro"
    "orcid": "https://orcid.org/0000-0002-8928-7831"
  -
    "affiliation": "University of Bremen, Germany"
    "family-names": "Gier"
    "given-names": "Bettina K."
    "orcid": "https://orcid.org/0000-0002-2928-8664"
  -
    "affiliation": "University of Bremen, Germany"
    "family-names": "Weigel"
    "given-names": "Katja"
    "orcid": "https://orcid.org/0000-0001-6133-7801"
  -
    "affiliation": "Institute for Atmospheric and Climate Science, ETH Zurich, Zurich, Switzerland"
    "family-names": "Hauser"
    "given-names": "Mathias"
    "orcid": "https://orcid.org/0000-0002-0057-4878"
  -
    "affiliation": "Netherlands eScience Center"
    "family-names": "Kalverla"
    "given-names": "Peter"
    "orcid": "https://orcid.org/0000-0002-5025-7862"
  -
    "affiliation": "University of Bremen, Germany"
    "family-names": "Galytska"
    "given-names": "Evgenia"
    "orcid": "https://orcid.org/0000-0001-6575-1559"
  -
    "affiliation": "BSC, Spain"
    "family-names": "Cos-Espuña"
    "given-names": "Pep"
  -
    "affiliation": "Netherlands eScience Center"
    "family-names": "Pelupessy"
    "given-names": "Inti"
    "orcid": "https://orcid.org/0000-0002-8024-0412"
  -
    "affiliation": "Max Planck Institute for Biogeochemistry, Germany"
    "family-names": "Koirala"
    "given-names": "Sujan"
    "orcid": "https://orcid.org/0000-0001-5681-1986"
  -
    "affiliation": "Helmholtz-Zentrum Geesthacht, Germany "
    "family-names": "Stacke"
    "given-names": "Tobias"
    "orcid": "https://orcid.org/0000-0003-4637-5337"
  -
    "affiliation": "Netherlands eScience Center"
    "family-names": "Alidoost"
    "given-names": "Sarah"
    "orcid": "https://orcid.org/0000-0001-8407-6472"
  -
    "affiliation": "Barcelona Supercomputing Center"
    "family-names": "Jury"
    "given-names": "Martin"
    "orcid": "https://orcid.org/0000-0003-0590-7843"
  -
    "affiliation": "Stéphane Sénési EIRL, Colomiers, France"
    "family-names": "Sénési"
    "given-names": "Stéphane"
    "orcid": "https://orcid.org/0000-0003-0892-5967"
  -
    affiliation: "MetOffice, UK"
    family-names: Crocker
    given-names: Thomas
    orcid: "https://orcid.org/0000-0001-7761-5546"
  -
    affiliation: "Netherlands eScience Center"
    family-names: Vreede
    given-names: Barbara
    orcid: "https://orcid.org/0000-0002-5023-4601"
  -
    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: "GEOMAR, Germany"
    family-names: Hohn
    given-names: David
    orcid: "https://orcid.org/0000-0002-5317-1247"
  -
    affiliation: "DLR, Germany"
    family-names: Bauer
    given-names: Julian
  -
    affiliation: "ACCESS-NRI, Australia"
    family-names: Beucher
    given-names: Romain
    orcid: "https://orcid.org/0000-0003-3891-5444"
  -
    affiliation: "Forschungszentrum Juelich (FZJ), Germany"
    family-names: Benke
    given-names: Joerg
  -
    affiliation: "BSC, Spain"
    family-names: Martin-Martinez
    given-names: Eneko
    orcid: "https://orcid.org/0000-0002-9213-7818"
  -
    affiliation: "DLR, Germany"
    family-names: Cammarano
    given-names: Diego
  -
    affiliation: "ACCESS-NRI, Australia"
    family-names: Yousong
    given-names: Zeng
    orcid: "https://orcid.org/0000-0002-8385-5367"
  -
    affiliation: "ECCC, Canada"
    family-names: Malinina
    given-names: Elizaveta
    orcid: "https://orcid.org/0000-0002-4102-2877"
  -
    affiliation: "ECCC, Canada"
    family-names: Garcia Perdomo
    given-names: Karen
    orcid: "https://orcid.org/0009-0004-2333-3358"
  -
    affiliation: "SMHI, Sweden"
    family-names: Lenhardt
    given-names: Julien
    orcid: "https://orcid.org/0000-0002-9949-3989"

cff-version: 1.2.0
date-released: 2026-03-10
doi: "10.5281/zenodo.3387139"
license: "Apache-2.0"
message: "If you use this software, please cite it using these metadata."
repository-code: "https://github.com/ESMValGroup/ESMValCore/"
title: ESMValCore
version: "v2.14.0"
...

Owner metadata

Name: ESMValGroup
Login: ESMValGroup
Email:
Kind: organization
Description: Earth System Model eValuation Tool
Website: https://www.esmvaltool.org
Location:
Twitter: ESMValTool
Company:
Icon url: https://avatars.githubusercontent.com/u/24584460?v=4
Repositories: 8
Last ynced at: 2023-03-04T22:27:36.878Z
Profile URL: https://github.com/ESMValGroup

Committers metadata

Last synced: 1 day ago

Total Commits: 8,169
Total Committers: 91
Avg Commits per committer: 89.769
Development Distribution Score (DDS): 0.836

Commits in past year: 247
Committers in past year: 16
Avg Commits per committer in past year: 15.438
Development Distribution Score (DDS) in past year: 0.741

Name	Email	Commits
Bouwe Andela	b**a@e**l	1342
Valeriu Predoi	v**i@g**m	1267
Mattia Righi	m**i@d**e	805
Javier Vegas	j**s@b**s	641
Manuel Schlund	m**d@d**e	604
Lee de Mora	l**m@p**k	322
Jost von Hardenberg	h**g@g**m	277
Axel Lauer	a**r@d**e	189
Nuria Pérez-Zanón	n**z@b**s	160
Alexander Loew	a**w@l**e	157
github-actions[bot]	4****]	142
Benjamin Müller	b**r@i**e	137
Valerio Lembo	v**o@u**e	137
Björn Brötz	b**z@d**e	126
Lisa Bock	l**k@d**e	116
Saskia Loosveldt Tomas	s**t@b**s	113
Enrico Arnone	e**e@i**t	107
Sarah Alidoost	f**t@e**l	107
Tomas Lovato	t**o@c**t	99
Klaus Zimmermann	k**n@s**e	97
Veronika Eyring	v**g@d**e	86
Bas Crezee	b**e@g**m	81
Tobias Stacke	t**e@m**e	80
Bettina Gier	B**r@d**e	80
pre-commit-ci[bot]	6****]	70
Ricarda Rettinger	r**r@d**e	60
Peter Berg	p**g@s**e	58
Daniel Senftleben	d**n@d**e	56
Peter Kalverla	p**a@g**m	49
Jaro Camphuijsen	j**n@g**m	41
and 61 more...

Committer domains:

Issue and Pull Request metadata

Last synced: about 15 hours ago

Total issues: 451
Total pull requests: 917
Average time to close issues: over 1 year
Average time to close pull requests: 2 months
Total issue authors: 66
Total pull request authors: 52
Average comments per issue: 4.06
Average comments per pull request: 3.53
Merged pull request: 710
Bot issues: 1
Bot pull requests: 194

Past year issues: 19
Past year pull requests: 148
Past year average time to close issues: 13 days
Past year average time to close pull requests: 4 days
Past year issue authors: 11
Past year pull request authors: 11
Past year average comments per issue: 1.42
Past year average comments per pull request: 1.68
Past year merged pull request: 99
Past year bot issues: 1
Past year bot pull requests: 54

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

Top Issue Authors

bouweandela (81)
schlunma (73)
valeriupredoi (68)
ledm (25)
sloosvel (16)
malininae (14)
ehogan (11)
rebeccaherman1 (10)
remi-kazeroni (10)
zklaus (10)
chrisbillowsMO (9)
Karen-A-Garcia (9)
rbeucher (6)
thomascrocker (6)
k-a-webb (5)

Top Pull Request Authors

schlunma (195)
bouweandela (179)
valeriupredoi (133)
github-actions[bot] (116)
pre-commit-ci[bot] (72)
sloosvel (15)
rbeucher (13)
jlenh (12)
malininae (11)
ehogan (11)
remi-kazeroni (11)
axel-lauer (10)
rhaegar325 (10)
Karen-A-Garcia (9)
LisaBock (8)

Top Issue Labels

enhancement (133)
bug (67)
Stale (60)
preprocessor (50)
data issue (38)
testing (31)
documentation (22)
cmor (19)
fix for dataset (19)
installation (14)
dask (14)
bear at a dinner party (13)
question (9)
release (8)
iris (6)
api (5)
observations (4)
deployment (3)
UX (3)
backwards incompatible change (2)
Numpy2 (2)
variable derivation (2)
config (1)
help wanted (1)
EUCP (1)
AR6 (1)
containerization (1)
deprecated feature (1)
EMAC (1)
automated-testing-workshop (1)

Top Pull Request Labels

testing (217)
condalock (122)
automatedPR (117)
preprocessor (99)
enhancement (89)
documentation (81)
fix for dataset (75)
bug (65)
installation (58)
dask (47)
cmor (43)
backwards incompatible change (29)
release (29)
iris (18)
deprecated feature (18)
config (13)
observations (12)
variable derivation (11)
Stale (11)
data issue (8)
dependencies (7)
github_actions (6)
iris311 (4)
EMAC (4)
Numpy2 (2)
api (2)
bear at a dinner party (2)
community (2)
UX (2)
help wanted (2)

Package metadata

Total packages: 2
Total downloads:
- pypi: 2,642 last-month
Total dependent packages: 2 (may contain duplicates)
Total dependent repositories: 2 (may contain duplicates)
Total versions: 56
Total maintainers: 3

pypi.org: esmvalcore

A community tool for pre-processing data from Earth system models in CMIP and running analysis scripts

Homepage: https://esmvaltool.org
Documentation: https://docs.esmvaltool.org
Licenses: Apache-2.0
Latest release: 2.14.0 (published about 1 month ago)
Last Synced: 2026-04-16T03:01:36.397Z (2 days ago)
Versions: 49
Dependent Packages: 1
Dependent Repositories: 1
Downloads: 2,642 Last month
Rankings:
- Dependent packages count: 4.759%
- Downloads: 8.582%
- Average: 11.654%
- Dependent repos count: 21.62%
Maintainers (3)

conda-forge.org: esmvalcore

ESMValCore: A community tool for pre-processing data from Earth system models in CMIP and running analysis scripts.

Homepage: https://www.esmvaltool.org/
Licenses: Apache-2.0
Latest release: 2.7.0 (published over 3 years ago)
Last Synced: 2026-04-01T02:00:12.053Z (17 days ago)
Versions: 7
Dependent Packages: 1
Dependent Repositories: 1
Rankings:
- Dependent repos count: 24.103%
- Dependent packages count: 28.954%
- Forks count: 31.415%
- Average: 32.181%
- Stargazers count: 44.253%

Dependencies

.github/workflows/build-and-deploy-on-pypi.yml actions

actions/checkout v3 composite
actions/setup-python v1 composite
pypa/gh-action-pypi-publish release/v1 composite

.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-pypi.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/run-tests-monitor.yml actions

actions/checkout v3 composite
actions/upload-artifact v2 composite
conda-incubator/setup-miniconda v2 composite

.github/workflows/run-tests.yml actions

actions/checkout v3 composite
actions/upload-artifact v2 composite
conda-incubator/setup-miniconda v2 composite

docker/Dockerfile docker

condaforge/mambaforge latest build

pyproject.toml pypi

environment.yml conda

autodocsumm >=0.2.2
cartopy
cf-units
cftime
codespell
compilers
dask
dask-jobqueue
distributed
docformatter
esgf-pyclient >=0.3.1
esmpy !=8.1.0
filelock
fiona
fire
flake8
geopy
humanfriendly
importlib_metadata
ipython
iris >=3.6.1
iris-esmf-regrid >=0.7.0
isodate
isort
jinja2
libnetcdf !=4.9.1
mypy >=0.990
nbsphinx
nc-time-axis
nested-lookup
netcdf4
numpy !=1.24.3
packaging
pandas
pillow
pip !=21.3
pre-commit
prospector >=1.9.0
prov
psutil
py-cordex
pybtex
pydata-sphinx-theme
pytest >=3.9,!=6.0.0rc1,!=6.0.0
pytest-cov >=2.10.1
pytest-env
pytest-html !=2.1.0
pytest-metadata >=1.5.1
pytest-mock
pytest-mypy
pytest-xdist
python >=3.9,<3.12
python-stratify >=0.3
pyyaml
requests
scipy >=1.6
shapely >=2.0.0
sphinx >=6.1.3
types-pyyaml
types-requests
yamale
yamllint
yapf

.github/workflows/stale.yml actions

actions/stale v10 composite

Score: 17.416677516635197

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Open Sustainable Technology