# Tutorials

The diagram below illustrates the set of notebook tutorials available in G-ADOPT 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
base[Base]
subgraph physical[Physical]
tala[TALA] --> ala[ALA] --> visualise_ala[ALA Nullspace]
viscoplastic[Viscoplastic]
end
subgraph dimension[Dimension]
cartesian_3d[3D Cartesian]
end
subgraph geometry["Geometry & Boundary Condition"]
cylindrical_2d[2D Cylindrical] --> spherical_3d[3D Spherical] --> gplates_global["Global GPlates"]
free_surface[Free Surface]
end
subgraph multimaterial[Multi-material]
isothermal["2-Material (isothermal)"] --> thermochemical["2-Material (thermochemical)"]
end
subgraph adjoint[Adjoint]
adjoint_forward[Forward] --> inverse[Inverse]
end
base --> physical
base --> dimension
base --> geometry
base --> multimaterial
base --> adjoint
click base "base_case"
click tala "2d_compressible_TALA"
click ala "2d_compressible_ALA"
click visualise_ala "visualise_ALA_p_nullspace"
click viscoplastic "viscoplastic_case"
click cartesian_3d "3d_cartesian"
click cylindrical_2d "2d_cylindrical"
click spherical_3d "3d_spherical"
click isothermal "compositional_buoyancy"
click thermochemical "thermochemical_buoyancy"
click gplates_global "gplates_global"
click adjoint_forward "adjoint_forward"
click inverse "adjoint"
click free_surface "free_surface"
```

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 included in the
G-ADOPT source code. You can find them under the directory `demos/`

.

To run these notebooks, you will 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.