About Gusto

Gusto is a library of finite element methods for geophysical fluid dynamics. In particular, Gusto focuses on using compatible finite element discretisations, in which variables lie in function spaces that preserve the underlying geometric structure of the equations. These compatible finite element methods underpin the Met Office’s next-generation model, LFRic.


The best way to install Gusto is as an additional package when installing Firedrake. Usually, for a Mac with Homebrew or an Ubuntu installation this is done by downloading the Firedrake install script and executing it:

curl -0 https://raw.githubusercontent/com/firedrakeproject/firedrake/master/scripts/firedrake-install
python3 firedrake-install --install gusto

For an up-to-date installation guide, see the firedrake installation instructions. Once installed, Gusto must be run from within the Firedrake virtual environment, which is activated via

source firedrake/bin/activate

To test your Gusto installation, run the test-suites:

cd firedrake/src/gusto
make test

Getting Started

Once you have a working installation, the best way to get started with Gusto is to play with some of the examples in the gusto/examples directory. Our documentation can be found here.

Getting in touch

If you’re interested in using Gusto we’d love to hear from you! The best way to get in touch with the Gusto developers is through our Github page or the Gusto channel on the Firedrake project slack channel. Alternatively you can email Jemma Shipton or Tom Bendall