MESMER

Stochastically creates Earth System Model-specific spatio-temporally correlated climate variable field realizations at a negligible computational cost.
https://github.com/MESMER-group/mesmer

Category: Climate Change
Sub Category: Earth and Climate Modeling

Keywords

climate emulator

Keywords from Contributors

energy-system climate-analysis climate-models

Last synced: about 9 hours ago
JSON representation

Repository metadata

spatially-resolved ESM-specific multi-scenario initial-condition ensemble emulator

README.rst

          MESMER: spatially resolved Earth System Model emulations
--------------------------------------------------------
**MESMER** is a **M**\ odular **E**\ arth **S**\ ystem **M**\ odel **E**\ mulator with
spatially **R**\ esolved output, which stochastically creates Earth System
Model-specific spatio-temporally correlated climate variable field realizations at a
negligible computational cost.

In combination with a global mean temperature emulator, MESMER can account for all three
major sources of climate change projection uncertainty at the local scale: (i) internal
variability uncertainty, i.e., unforced natural climate variability; (ii) forced climate
response uncertainty, i.e., the Earth’s system response to forced natural changes (solar
and volcanic) and human influences (greenhouse gas and aerosol emissions, land use
changes etc.); and (iii) emission uncertainty, i.e., uncertainty in the emission pathway
humans decide to follow. An interface between MESMER and global mean temperature
emulators can be found at https://github.com/MESMER-group/mesmer-openscmrunner.

MESMER provides infrastructure to emulate annual and monthly near-surface air
temperature (MESMER and MESMER-M) as well as various climate extreme indicators (MESMER-X).

MESMER is under active development both scientifically and technically. Future work will
increase its user friendliness and extend its emulation capabilities to include
additional emulation methods and target climate variables.

Citing MESMER
-------------

Scientific publications using MESMER Software should cite the following publication:

  Bauer, V. M., Hauser, M., Quilcaille, Y., Schöngart, S., Gudmundsson, L., and Seneviratne, S. I.:
  MESMER v1.0.0: Consolidating the Modular Earth System Model Emulator into a Sustainable Research
  Software Package, Geosci. Model Dev., tba, tba, 2026.

Depending on which application of MESMER you use (MESMER, MESMER-M, MESMER-X, etc.) please
also cite the relevant publications found in our
`publication list `_.

License
-------

Copyright (c) 2021 ETH Zurich, MESMER contributors listed in AUTHORS.

MESMER is free software; you can redistribute it and/or modify it under the terms of the
GNU General Public License as published by the Free Software Foundation, version 3  or
(at your option) any later version.

MESMER is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with MESMER. If
not, see https://www.gnu.org/licenses/.

The full list of code contributors can be found in AUTHORS or on
`github.com/contributors `_

Mesmer bundles data for analysis, tutorials, and testing:

- CMIP6 data from IPSL-CM6A-LR model, available under a `CC BY 4.0 `__ license.
  Used in tutorial notebooks and tests.

- Stratospheric aerosol optical depth data sourced licensed as `Creative Commons Zero `__.
  Used to estimate the volcanic influence.

For details see `data README `_.

        

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use this software, please cite both the software itself and the accompanying paper."
title: "MESMER"
abstract: >-
  MESMER (Modular Earth System Model Emulator with spatially Resolved output) is
  a Python package for spatially resolved climate model emulation. It translates
  annual mean global climate trajectories into gridded fields of selected climate
  variables over land, accounting for both the forced local response and internal
  variability.
type: software
version: 1.0.0
doi: 10.5281/zenodo.20156753
license: GPL-3.0-or-later
repository-code: "https://github.com/MESMER-group/mesmer"
url: "https://mesmer-emulator.readthedocs.io/"
keywords:
  - climate emulator
  - Earth system model
  - CMIP6
  - climate extremes
  - Python
authors:
  - family-names: "Hauser"
    given-names: "Mathias"
    orcid: "https://orcid.org/0000-0002-0057-4878"
    affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
  - family-names: "Bauer"
    given-names: "Victoria M."
    orcid: "https://orcid.org/0009-0000-9675-5958"
    affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
  - family-names: "Quilcaille"
    given-names: "Yann"
    orcid: "https://orcid.org/0000-0002-1474-0144"
    affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
  - family-names: "Schöngart"
    given-names: "Sarah"
    orcid: "https://orcid.org/0009-0002-2030-9139"
    affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
  - family-names: "Beusch"
    given-names: "Lea"
  - family-names: "Nicholls"
    given-names: "Zebedee"
  - family-names: "Nath"
    given-names: "Shruti"
  - family-names: "Pierini"
    given-names: "Lorenzo"
  - family-names: "Schwaab"
    given-names: "Jonas"
  - family-names: "Gudmundsson"
    given-names: "Lukas"
    orcid: "https://orcid.org/0000-0003-3539-8621"
    affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
  - family-names: "Seneviratne"
    given-names: "Sonia I."
    orcid: "https://orcid.org/0000-0001-9528-2917"
    affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
preferred-citation:
  type: article
  title: >-
    MESMER v1.0.0: consolidating the modular Earth system model emulator into a
    sustainable research software package
  authors:
    - family-names: "Bauer"
      given-names: "Victoria M."
      orcid: "https://orcid.org/0009-0000-9675-5958"
      affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
      email: "victoria.bauer@env.ethz.ch"
    - family-names: "Hauser"
      given-names: "Mathias"
      orcid: "https://orcid.org/0000-0002-0057-4878"
      affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
    - family-names: "Quilcaille"
      given-names: "Yann"
      orcid: "https://orcid.org/0000-0002-1474-0144"
      affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
    - family-names: "Schöngart"
      given-names: "Sarah"
      orcid: "https://orcid.org/0009-0002-2030-9139"
      affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
    - family-names: "Gudmundsson"
      given-names: "Lukas"
      orcid: "https://orcid.org/0000-0003-3539-8621"
      affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
    - family-names: "Seneviratne"
      given-names: "Sonia I."
      orcid: "https://orcid.org/0000-0001-9528-2917"
      affiliation: "Institute for Atmospheric and Climate Science, ETH Zurich, Switzerland"
  journal: "Geoscientific Model Development"
  volume: 19
  issue: 12
  start: 5669
  end: 5688
  year: 2026
  month: 6
  issn: "1991-959X"
  doi: 10.5194/gmd-19-5669-2026
  url: "https://gmd.copernicus.org/articles/19/5669/2026/"
  license: CC-BY-4.0
  publisher:
    name: "Copernicus Publications"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 16 days ago

Total Commits: 653
Total Committers: 14
Avg Commits per committer: 46.643
Development Distribution Score (DDS): 0.329

Commits in past year: 107
Committers in past year: 6
Avg Commits per committer in past year: 17.833
Development Distribution Score (DDS) in past year: 0.364

Name Email Commits
Mathias Hauser m****e 438
Victoria 1****i 92
dependabot[bot] 4****] 40
Lea Beusch l****h 30
pre-commit-ci[bot] 6****] 28
Zeb Nicholls z****s@c****g 9
yquilcaille 4****e 6
snath-xoc 5****c 3
Lea Beusch b****l@s****h 2
woodhome23 4****3 1
sarasita 9****a 1
readthedocs-assistant 9****t 1
l-pierini l****i@e****h 1
Lea Beusch l****h@h****h 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 214
Total pull requests: 850
Average time to close issues: 11 months
Average time to close pull requests: 14 days
Total issue authors: 13
Total pull request authors: 12
Average comments per issue: 1.74
Average comments per pull request: 2.09
Merged pull request: 752
Bot issues: 10
Bot pull requests: 87

Past year issues: 21
Past year pull requests: 113
Past year average time to close issues: 12 days
Past year average time to close pull requests: 2 days
Past year issue authors: 4
Past year pull request authors: 6
Past year average comments per issue: 2.43
Past year average comments per pull request: 1.63
Past year merged pull request: 102
Past year bot issues: 5
Past year bot pull requests: 28

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/MESMER-group/mesmer

Top Issue Authors

  • mathause (149)
  • veni-vidi-vici-dormivi (27)
  • znicholls (10)
  • github-actions[bot] (9)
  • leabeusch (9)
  • yquilcaille (2)
  • sarasita (2)
  • 251925209391 (1)
  • jschwaab (1)
  • l-pierini (1)
  • dongjinchi (1)
  • snath-xoc (1)
  • pre-commit-ci[bot] (1)

Top Pull Request Authors

  • mathause (564)
  • veni-vidi-vici-dormivi (174)
  • dependabot[bot] (47)
  • pre-commit-ci[bot] (40)
  • yquilcaille (10)
  • sarasita (5)
  • snath-xoc (3)
  • 925209391 (2)
  • l-pierini (2)
  • znicholls (1)
  • jfecher (1)
  • nikhilnarla (1)

Top Issue Labels

  • enhancement (21)
  • good first issue (13)
  • topic-MESMER_M (13)
  • topic-stats (11)
  • topic-MESMER_X (11)
  • CI (9)
  • topic-maintenance (7)
  • topic-documentation (5)
  • topic-performance (5)
  • breaking-change (4)
  • question (4)
  • tests (3)
  • bug (3)
  • wontfix (2)
  • topic-io (2)
  • topic-tests (1)
  • run-upstream (1)
  • documentation (1)
  • topic-dependencies (1)
  • priority:high (1)

Top Pull Request Labels

  • topic-dependencies (25)
  • dependencies (22)
  • run-upstream (19)
  • github_actions (18)
  • topic-MESMER_X (9)
  • topic-tests (2)
  • bug (2)
  • topic-MESMER_M (1)

Package metadata

proxy.golang.org: github.com/MESMER-group/mesmer

proxy.golang.org: github.com/mesmer-group/mesmer

pypi.org: mesmer-emulator

Modular Earth System Model Emulator with spatially Resolved output

  • Homepage: https://github.com/MESMER-group/mesmer
  • Documentation: https://mesmer-emulator.readthedocs.io
  • Licenses: GPL-3.0-or-later
  • Latest release: 1.0.0 (published 4 months ago)
  • Last Synced: 2026-09-04T04:01:40.222Z (1 day ago)
  • Versions: 10
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 83 Last month
  • Rankings:
    • Dependent packages count: 10.141%
    • Forks count: 10.507%
    • Stargazers count: 13.662%
    • Average: 17.716%
    • Dependent repos count: 21.526%
    • Downloads: 32.742%
  • Maintainers (3)
conda-forge.org: mesmer

  • Homepage: https://github.com/MESMER-group/mesmer
  • Licenses: GPL-3.0-or-later
  • Latest release: 0.8.3 (published over 4 years ago)
  • Last Synced: 2026-03-20T01:06:42.536Z (6 months ago)
  • Versions: 4
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 14,728 Total
  • Rankings:
    • Dependent repos count: 24.412%
    • Average: 43.684%
    • Forks count: 45.007%
    • Dependent packages count: 51.614%
    • Stargazers count: 53.7%

Dependencies

pyproject.toml pypi
.github/workflows/ci-workflow.yml actions
  • actions/checkout v7 composite
  • actions/setup-python v7 composite
  • codecov/codecov-action v7 composite
  • mamba-org/setup-micromamba v3 composite
environment.yml conda
  • black !=23
  • cartopy
  • dask
  • filefisher
  • joblib
  • matplotlib-base
  • nc-time-axis
  • netcdf4
  • numpy
  • packaging
  • pandas >=2.2
  • pooch
  • properscoring
  • pyproj
  • pytest
  • pytest-cov
  • pytest-xdist
  • regionmask >=0.12
  • ruff
  • scikit-learn
  • scipy
  • statsmodels >=0.14
  • xarray >=2025.03
.github/workflows/pypi-release.yaml actions
  • actions/checkout v7 composite
  • actions/download-artifact v8 composite
  • actions/setup-python v7 composite
  • actions/upload-artifact v7 composite
  • pypa/gh-action-pypi-publish v1.14.2 composite
.github/workflows/upstream-dev-ci.yaml actions
  • actions/checkout v7 composite
  • mamba-org/setup-micromamba v3 composite
  • xarray-contrib/issue-from-pytest-log v1 composite

Score: 16.696867582754727