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.
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
pip install fair
Refer to the documentation
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.
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.
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.
If you use FaIR in your work, please cite the following references depending on the version:
FAQs
Finite-amplitude Impulse Response (FaIR) simple climate model
We found that fair demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.