Metadata-Version: 2.4
Name: mesmer-emulator
Version: 1.0.0
Summary: Modular Earth System Model Emulator with spatially Resolved output
Author-email: mesmer developers <mesmer@env.ethz.ch>
License-Expression: GPL-3.0-or-later
Project-URL: Homepage, https://github.com/MESMER-group/mesmer
Project-URL: Documentation, https://mesmer-emulator.readthedocs.io
Project-URL: Source, https://github.com/MESMER-group/mesmer
Project-URL: BugReports, https://github.com/MESMER-group/mesmer/issues
Keywords: climate atmosphere "Earth System Model Emulator"
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
Requires-Python: >=3.12
Description-Content-Type: text/x-rst
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: dask[array,distributed]>=2025.4
Requires-Dist: deprecated
Requires-Dist: filefisher>=1.1
Requires-Dist: joblib>=1.5
Requires-Dist: netcdf4>=1.7
Requires-Dist: numpy>=2.1
Requires-Dist: packaging>=25.0
Requires-Dist: pandas>=2.2
Requires-Dist: pooch>=1.8
Requires-Dist: pyproj>=3.7
Requires-Dist: regionmask>=0.13
Requires-Dist: scikit-learn>=1.6
Requires-Dist: scipy>=1.15
Requires-Dist: statsmodels>=0.14
Requires-Dist: xarray>=2025.11
Provides-Extra: complete
Requires-Dist: mesmer-emulator[viz]; extra == "complete"
Requires-Dist: properscoring>=0.1; extra == "complete"
Provides-Extra: viz
Requires-Dist: cartopy>=0.24; extra == "viz"
Requires-Dist: matplotlib>=3.8; extra == "viz"
Requires-Dist: nc-time-axis; extra == "viz"
Dynamic: license-file

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 <https://mesmer-emulator.readthedocs.io/en/latest/publications.html>`_.

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 <https://github.com/MESMER-group/mesmer/graphs/contributors>`_

Mesmer bundles data for analysis, tutorials, and testing:

- CMIP6 data from IPSL-CM6A-LR model, available under a `CC BY 4.0 <https://creativecommons.org/licenses/by/4.0/>`__ license.
  Used in tutorial notebooks and tests.

- Stratospheric aerosol optical depth data sourced licensed as `Creative Commons Zero <https://creativecommons.org/public-domain/cc0/>`__.
  Used to estimate the volcanic influence.

For details see `data README <data/README.md>`_.
