Toggle navigation sidebar
Toggle in-page Table of Contents
ASPECT 2.5.0
ASPECT
User Guide
Introduction
Modeling assumptions and numerical 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 and generating 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
Input parameter files
The structure of parameter files
Categories of parameters
A note on the syntax of formulas in input files
Compatibility of input files with newer ASPECT versions
A graphical user interface
Installing parameter-GUI
Using ASPECT-GUI
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
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
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 Rayleigh-Taylor instability
The Rayleigh-Taylor instability benchmark
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
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
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)
Extending and contributing to ASPECT
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
Prescribed velocity boundary conditions
Temperature boundary conditions
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
How to contribute
Future plans for ASPECT
Release Tasklist
Finding answers to more 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
Postprocess
Prescribed Stokes solution
Solver parameters
Temperature field
Termination criteria
Time stepping
Volume of Fluid
References
repository
open issue
suggest edit
.md
.pdf
Virtual Machine
Virtual Machine
#
Installing VM software and setting up the virtual machine
Running ASPECT models