The ClimateMachine is a software package that models the evolution of the Earth system over weeks to centuries. The ClimateMachine solves three-dimensional partial differential equations for the distributions of water, momentum, energy, and tracers such as carbon in the atmosphere, oceans, and on land.

The ClimateMachine will harness a wide range of Earth observations and data generated computationally to predict the evolution of Earth’s climate and features such as droughts, rainfall extremes, and high-impact storms.


The ClimateMachine currently consists of three models for the subcomponents of the Earth system:

  • ClimateMachine.Atmos: A model of the fluid mechanics of the atmosphere and its interaction with solar radiation and phase changes of water that occur, for example, in clouds.

  • ClimateMachine.Ocean: A model for the fluid mechanics of the ocean and its distributions of heat, salinity, carbon, and other tracers.

  • ClimateMachine.Land: A model for the flow of energy and water in soils and on the land surface, for the biophysics of vegetation on land, and for the transfer and storage of carbon in the land biosphere.

The subcomponents will be coupled by exchanging water, momentum, energy, and tracers such as carbon dioxide across their boundaries.

Dynamical core

A dynamical core based on discontinuous Galerkin numerical methods is used to discretize the physical conservation laws that underlie each of the ClimateMachine's subcomponents.

How to use the documentation

If you want to...Look here
install ClimateMachine.jlGetting started
learn about default configurationsGetting started
look up common terminologyGetting started
run simple Atmos, Ocean, or Land modelsTutorials
run code fragments detailing numerical methodsTutorials
get more detail about a model subcomponent or a numerical methodHow-to-guides
learn how to call functions in source codeAPIs
help develop ClimateMachine.jl softwareContribution guide


The ClimateMachine is being developed by the Climate Modeling Alliance.