mesmer-emulator 1.0.0rc1
Modular Earth System Model Emulator with spatially Resolved output
Requires Python: >=3.11
Keywords: climate atmosphere "Earth System Model Emulator"

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 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 should cite the following publication:

  Beusch, L., Gudmundsson, L., and Seneviratne, S. I.: Emulating Earth system model
  temperatures with MESMER: from global mean temperature trajectories to grid-point-level
  realizations on land, Earth Syst. Dynam., 11, 139–159,
  https://doi.org/10.5194/esd-11-139-2020, 2020.

If MESMER is used to emulate multiple emission pathways and/or in combination with a
global mean emulator, the following publication should additionally be cited:

  Beusch, L., Nicholls, Z., Gudmundsson, L., Hauser, M., Meinshausen, M., and Seneviratne,
  S. I.: From emission scenarios to spatially resolved projections with a chain of
  computationally efficient emulators: coupling of MAGICC (v7.5.1) and MESMER (v0.8.3),
  Geosci. Model Dev., 15, 2085–2103, https://doi.org/10.5194/gmd-15-2085-2022, 2022.

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>`_.