Skip to main content
Back to top
Ctrl
+
K
ASPECT 3.1.0-pre
GitHub
Search
Ctrl
+
K
ASPECT
User Guide
Introduction
Assumptions and methods
Basic equations
A comment on adiabatic heating
Boundary conditions
Two-dimensional models
Coefficients
Coefficient self-consistency
Coefficient averaging
Dimensional or non-dimensionalized equations?
Years or seconds?
Static or dynamic pressure?
Pressure normalization
Initial conditions and the adiabatic pressure/temperature
Compositional fields
Constitutive laws
Numerical methods
Approximate equations
The anelastic liquid approximation (ALA)
The truncated anelastic liquid approximation (TALA)
The Boussinesq approximation (BA)
The isothermal/isentropic compression approximation (ICA)
Choosing a formulation
Mass conservation approximation
Temperature equation approximation
Approximation of the buoyancy term
Reference state: The adiabatic profile
Combined formulations
Advection Stabilization
SUPG Stabilization
Entropy viscosity
Free surface calculations
Arbitrary Lagrangian-Eulerian implementation
Free surface stabilization
Calculations with melt transport
Nullspace removal
Particles
Geometric Multigrid
Choosing a nonlinear Stokes solver
Installation
Docker Container
Installing Docker and downloading the ASPECT image
Running ASPECT models
Developing ASPECT within a container
Virtual Machine
Installing VM software and setting up the virtual machine
Running ASPECT models
Local installation
System prerequisites
Using candi to compile dependencies
Obtaining ASPECT and initial configuration
Compiling ASPECT
Building the documentation
Running ASPECT
First steps
Overview
Selecting between 2d and 3d
Debug or optimized mode
Visualizing results
Visualization the graphical output using
VisIt
Visualizing statistical data
Large data issues for parallel computations
Checkpoint/restart support
Making ASPECT run faster
Debug vs. optimized mode
Adjusting solver tolerances
Adjusting solver preconditioner tolerances
Using lower order elements for the temperature/compositional discretization
Limiting postprocessing
Switching off pressure normalization
Regularizing models with large coefficient variation
Using multithreading
File system I/O
Input parameter files
The structure of parameter files
Categories of parameters
How to write Function expressions in parameter files
Compatibility of input files with newer ASPECT versions
Cookbooks
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
Fastscape Eroding Box
Introduction to ASPECT
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)
Thermochemical plume model using multiple P–T look-up tables
Reproducing rheology of Morency and Doin, 2004
Crustal deformation
Continental extension
Inner core convection
Lower crust flow with an obstacle
Melt migration in a 2D mantle convection model
Melt migration in a 2D mid-ocean ridge model
Sublithospheric convection beneath an oceanic plate with a grain size dependent rheology
Using the World Builder to model the thermal structure of oceanic transform faults
Kinematically-driven 2d oceanic subduction
Rift interaction in brittle-ductile coupled systems
Simplified Subduction Model with Parameterized Solid-Fluid Reactions
Mantle convection with continents in an annulus
Viscous inclusions under simple and pure shear
Subduction initiation from Matsumoto and Tomoda (1983)
Van Keken 2008 corner flow recreation
Two-dimensional cylindrical annulus visualization
Mantle convection using tomography data
Future Cookbooks
Setups for teaching
Running a geodynamic model
Convective and conductive heat flow: Cooling of oceanic lithosphere
Onset of convection
Magnetic lineations on the sea floor
Benchmarks
Running benchmarks that require code
Onset of convection benchmark
The van Keken thermochemical composition benchmark
Computation of the van Keken Problem with the Volume-of-Fluid Interface Tracking Method
The Bunge et al. mantle convection experiments
The Blankenbach convection benchmark
The King compressible convection benchmark
The Rayleigh-Taylor instability
The Rayleigh-Taylor instability benchmark
The Rayleigh-Taylor instability with a free surface
Polydiapirism
The sinking block benchmark
The sinking block benchmark files
The SolCx Stokes benchmark
The SolKz Stokes benchmark
The “inclusion” Stokes benchmark
The Burstedde variable viscosity benchmark
The slab detachment benchmark
The hollow sphere benchmark
Particle integration scheme benchmark
The 2D annulus benchmark
The rigid shear benchmark
The “Stokes’ law” benchmark
Viscosity grooves benchmark
Latent heat benchmark
The 2D cylindrical shell benchmarks by Davies et al.
The Crameri et al. benchmarks
The solitary wave benchmark
1D test for water solubility
Benchmarks for operator splitting
The Tosi et al. benchmarks
Layered flow with viscosity contrast
Donea & Huerta 2D box geometry benchmark
Advection stabilization benchmarks
Advection Benchmarks
Yamauchi & Takei anelastic shear wave velocity-temperature conversion benchmark
Thin shell gravity benchmark
Thick shell gravity benchmark
2D Lithosphere flexure benchmark with infill
Gravity field generated by mantle density variations
Brittle thrust wedges benchmark
Compressibility formulation benchmarks
Entropy adiabat benchmark
Geoid Spectral Comparison
Newton Solver Benchmark Set - Nonlinear Channel Flow
Newton Solver Benchmark Set - Spiegelman et at. (2016)
Newton Solver Benchmark Set - Tosi et at. (2015)
The NSinker benchmark
The Spherical Shell NSinker benchmark
Time dependent annulus benchmark
The viscoelastic plastic shear bands benchmarks
Visco(elastic)-plastic shear bands after Gerya (2019)
Grain Size Pinned State
Extending and contributing
The idea of plugins and the
SimulatorAccess
and
Introspection
classes
How to write a plugin
How to write a cookbook
Parameter file
Plugins and additional files
Adding a section to the manual
MyST Quick reference
Available plugin types
Material models
Heating models
Geometry models
Gravity models
Initial conditions for temperature and composition
Velocity and traction boundary conditions
Temperature and compositional boundary conditions
Boundary heat flux
Postprocessors: Evaluating the solution after each time step
Visualization postprocessors
Mesh refinement criteria
Criteria for terminating a simulation
Compatibility of plugins
Extending ASPECT through signals
Extending the basic solver
Testing ASPECT
Running tests
Writing tests
Test properties
Benchmarking run time
Contributing to ASPECT
Future plans for ASPECT
Release Tasklist
Finding answers to questions
Parameter Documentation
Global parameters
Adiabatic conditions model
Boundary composition model
Boundary fluid pressure model
Boundary heat flux model
Boundary temperature model
Boundary traction model
Boundary velocity model
Checkpointing
Compositional fields
Discretization
Formulation
Geometry model
Gravity model
Heating model
Initial composition model
Initial temperature model
Material model
Melt settings
Mesh deformation
Mesh refinement
Nullspace removal
Particles
Particles 2
Postprocess
Prescribed Stokes solution
Solver parameters
Temperature field
Termination criteria
Time stepping
Volume of Fluid
Developer Documentation
Authors
References
Repository
Suggest edit
Open issue
.md
.pdf
Developer Documentation
Developer Documentation
#
ASPECT’s developer documentation is available
here
.
