Skip to content


The diagram below shows several G-ADOPT example codes and how they relate to each other. These notebooks demonstrate how to use G-ADOPT to set up (forward and inverse) geodynamical simulations.

graph TD

  subgraph physical[Physical]
  ala[ALA] --> tala[TALA]

  subgraph dimension[Dimension]
  cartesian_3d[3D Cartesian]

  subgraph geometry[Geometry]
  cylindrical_2d[2D Cylindrical] --> spherical_3d[3D Spherical]

  subgraph multimaterial[Multi-material]
  isothermal["2-Material (isothermal)"] --> thermochemical["2-Material (thermochemical)"]

  subgraph adjoint[Adjoint]

  base --> physical
  base --> dimension
  base --> geometry
  base --> multimaterial
  base ~~~ adjoint

  click base "base_case"
  click ala "2d_compressible_ALA"
  click tala "2d_compressible_TALA"
  click viscoplastic "viscoplastic_case"
  click cartesian_3d "3d_cartesian"
  click cylindrical_2d "2d_cylindrical"
  click isothermal "compositional_buoyancy"
  click thermochemical "thermochemical_buoyancy"

We start with the most basic problem - isoviscous, incompressible convection, in an enclosed 2-D Cartesian box (base) - and systematically build complexity, initially moving into more realistic physical approximations (compressibility - ALA, TALA; visco-plastic rheology), subsequently to multi-material simulations, and finally to different dimensions and to spherical shell geometries that are more representative of Earth's mantle.

These pages are all rendered from Jupyter notebooks that come with the G-ADOPT source code. You can find them under the directory demos/.

To run these notebooks, you'll need a working installation of Firedrake and G-ADOPT, and a Jupyter kernel for Firedrake. See the install page for instructions.

Note that Firedrake includes its own tutorials, to get you started. If you are not familiar with Firedrake, we strongly recommend that you start with their introductory tutorials, here.