Skip to main content

Finite-amplitude Impulse Response (FaIR) simple climate model

Project description

image image Documentation Status image image image Anaconda-Server Badge

FaIR

FaIR (the Finite-amplitude Impulse-Response) climate model is a simple climate model, or emulator, useful for producing global mean temperature projections from a wide range of emissions or prescribed forcing scenarios.

Requirements

  • python 3.8, 3.9, 3.10, 3.11 or 3.12

Installation

From anaconda (recommended)

NEW! from v2.1.4, fair is available on conda-forge:

conda install -c conda-forge fair

Older versions of fair (1.6.2+, 2.1.0-4) can be installed from the chrisroadmap channel:

conda install -c chrisroadmap fair==X.Y.Z

From the Python Package Index

pip install fair

From source

Refer to the documentation

Usage

FaIR can be driven by emissions of greenhouse gases (GHGs) and short-lived forcers (SLCFs), concentrations of GHGs, or effective radiative forcing (ERF), with different input methods for different species possible in the same run. If run concentration-driven, emissions are back-calculated. Custom GHGs and SLCFs can be defined, and all components are optional allowing experiments such as pulse-response analyses to single forcers or gathering up non-CO2 species as an aggregate forcing.

Examples

The examples directory contains Jupyter notebooks with some simple examples showing how to run FaIR and the standalone energy balance model.

If you want to try this out online, go here.

Important: A note about calibrating and constraining

FaIR is naive. It will run whatever climate scenario and climate configuration you give it. If you violate the laws of physics, FaIR won't stop you. For simple climate models as for complex, garbage in leads to garbage out. More subtle to spot are those analyses with simple climate models where the present day warming (or historical) is wrong or the climate is warming too slowly or too quickly. At least, plot a historical temperature reconstruction over your results and see if it looks right.

We have produced IPCC AR6 Working Group 1 consistent probabilistic ensembles to run with. The calibration data can be obtained here. These parameter sets are calibrated to CMIP6 models, run in a large Monte Carlo ensemble, and constrained based on observed and assessed climate metrics. For an example of how to use this calibration data set with SSP emissions, see this example. If you're writing a paper using FaIR, you should use these. A paper describing this method has been submitted, but for now please cite the Zenodo DOI.

Citation

If you use FaIR in your work, please cite the following references depending on the version:

  • v2.0+: Leach, N. J., Jenkins, S., Nicholls, Z., Smith, C. J., Lynch, J., Cain, M., Walsh, T., Wu, B., Tsutsui, J., and Allen, M. R.: FaIRv2.0.0: a generalized impulse response model for climate uncertainty and future scenario exploration, Geosci. Model Dev., 14, 3007--3036, https://doi.org/10.5194/gmd-14-3007-2021, 2021
  • v1.1-v1.6: Smith, C. J., Forster, P. M., Allen, M., Leach, N., Millar, R. J., Passerello, G. A., and Regayre, L. A.: FAIR v1.3: A simple emissions-based impulse response and carbon cycle model, Geosci. Model Dev., https://doi.org/10.5194/gmd-11-2273-2018, 2018.
  • v1.0 (or the concept of the state-dependent impulse-response function for CO2): Millar, R. J., Nicholls, Z. R., Friedlingstein, P., and Allen, M. R.: A modified impulse-response representation of the global near-surface air temperature and atmospheric concentration response to carbon dioxide emissions, Atmos. Chem. Phys., 17, 7213-7228, https://doi.org/10.5194/acp-17-7213-2017, 2017.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fair-2.2.0.tar.gz (66.0 kB view details)

Uploaded Source

Built Distribution

fair-2.2.0-py3-none-any.whl (53.8 kB view details)

Uploaded Python 3

File details

Details for the file fair-2.2.0.tar.gz.

File metadata

  • Download URL: fair-2.2.0.tar.gz
  • Upload date:
  • Size: 66.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.7

File hashes

Hashes for fair-2.2.0.tar.gz
Algorithm Hash digest
SHA256 11ba886a43a5ada408b5cdd364b0cc91e8dfc0ef499ac07e96c3b665080376dc
MD5 4e43a5ec8c04885de1649e9be1d1a73c
BLAKE2b-256 c6b5d3701da50778154da63449f2dd1b49cf62f96e67009bb2ead9acdf7ea0b9

See more details on using hashes here.

Provenance

File details

Details for the file fair-2.2.0-py3-none-any.whl.

File metadata

  • Download URL: fair-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 53.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.11.7

File hashes

Hashes for fair-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a4944bf5efe516bfca5ce4b17d144c1e35666e35755a4f86fad565ef7176b1a5
MD5 1795027ca9f4a499b4eb617d260624e0
BLAKE2b-256 4ae082a214c01428667894c9a9e6b010ad27bca09560c7fe77c1ff864a0d44b6

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page