Cookbooks
Cookbooks#
In this section, let us present a number of “cookbooks” – examples of how to use ASPECT in typical or less typical ways. As discussed in Running ASPECT, ASPECT is driven by run-time parameter files, and so setting up a particular situation primarily comes down to creating a parameter file that has the entries that correctly describe your model. Thus, the subsections below will discuss in detail what parameters to set and to what values. Note that parameter files need not specify all parameters – of which there is a bewildering number – but only those that are relevant to the particular situation we would like to model. All parameters not listed explicitly in the input file are simply left at their default value (the default values are also documented in https://aspect.geodynamics.org/doc/parameter_view/parameters.xml).
Of course, there are situations where what you want to do is not covered by the models already implemented. Specifically, you may want to try a different geometry, a different material or gravity model, or different boundary conditions. In such cases, you will need to implement these extensions in the actual source code. Extending and contributing to ASPECT provides information on how to do that.
The remainder of this section shows a number of applications of ASPECT. They are grouped into three categories: Simple setups of examples that show thermal convection (Simple setups), setups that try to model geophysical situations (Geophysical setups) and setups that are used to benchmark ASPECT to ensure correctness or to test accuracy of our solvers (Benchmarks). Before we get there, however, we will review how one usually approaches setting up computations in How to set up computations.
Note
The input files discussed in the following sections can generally be found in the cookbooks/ directory of your ASPECT installation.
- How to set up computations
- Simple setups
- Convection in a 2d box
- Convection in a 3d box
- Convection in a box with prescribed, variable velocity boundary conditions
- Using passive and active compositional fields
- Using particles
- Using a free surface
- Using a free surface in a model with a crust
- Averaging material properties
- Prescribed internal velocity constraints
- Prescribing internal velocity constraints with ASCII files
- Artificial viscosity smoothing
- Tracking finite strain
- Reading in compositional initial composition files generated with geomIO
- Using lazy expression syntax for if-else-statements in function expressions
- Convection in a 2d box with a phase transition
- Visualizing phase diagrams
- Plume in a 2D chunk
- Geophysical setups
- Simple convection in a quarter of a 2d annulus
- Simple convection in a spherical 3d shell
- Postprocessing spherical 3D convection
- 3D convection with an Earth-like initial condition
- Using reconstructed surface velocities by GPlates
- 2D compressible convection with a reference profile and material properties from BurnMan
- Convection using a pressure–temperature look-up table and the rheology of Steinberger and Calderwood (2006)
- Reproducing rheology of Morency and Doin, 2004
- Crustal deformation
- Continental extension
- Inner core convection
- Melt migration in a 2D mantle convection model
- Melt migration in a 2D mid-ocean ridge model
- Kinematically-driven 2d oceanic subduction
- Future Cookbooks
- Setups for teaching