User Guide#
- Introduction
- Installation
- Governing Equations
- Finite-Element Formulation with PETSc
- Elasticity
- Incompressible Elasticity
- Poroelasticity with Infinitesimal Strain and No Faults
- Running PyLith
- Overview of Running PyLith
- PyLith Application
- PETSc Options
- Finite-Element Mesh
- Utilities
- PyLith Parameter Viewer
- Troubleshooting
- Mesh generation with Cubit and Gmsh
- Defining Simulations
- Physics Implementations
- Materials
- Boundary Conditions
- Fault Interface Conditions
- PyLith Components
- Component Implementations
- apps
- bc
- faults
- materials
- AuxSubfieldsElasticity
- AuxSubfieldsIsotropicLinearElasticity
- AuxSubfieldsIsotropicLinearGenMaxwell
- AuxSubfieldsIsotropicLinearMaxwell
- AuxSubfieldsIsotropicLinearPoroelasticity
- AuxSubfieldsIsotropicPowerLaw
- AuxSubfieldsPoroelasticity
- DerivedSubfieldsElasticity
- DerivedSubfieldsPoroelasticity
- Elasticity
- Homogeneous
- IncompressibleElasticity
- IsotropicLinearElasticity
- IsotropicLinearGenMaxwell
- IsotropicLinearIncompElasticity
- IsotropicLinearMaxwell
- IsotropicLinearPoroelasticity
- IsotropicPowerLaw
- Material
- Poroelasticity
- RheologyElasticity
- RheologyIncompressibleElasticity
- RheologyPoroelasticity
- meshio
- problems
- GreensFns
- InitialCondition
- InitialConditionDomain
- InitialConditionPatch
- Physics
- Problem
- ProblemDefaults
- ProgressMonitor
- ProgressMonitorStep
- ProgressMonitorTime
- SingleProblem
- SolnDisp
- SolnDispLagrange
- SolnDispPres
- SolnDispPresLagrange
- SolnDispPresTracStrain
- SolnDispPresTracStrainLagrange
- SolnDispPresTracStrainVelPdotTdot
- SolnDispPresTracStrainVelPdotTdotLagrange
- SolnDispPresVel
- SolnDispVel
- SolnDispVelLagrange
- Solution
- SolutionSubfield
- SubfieldDisplacement
- SubfieldLagrangeFault
- SubfieldPressure
- SubfieldPressureDot
- SubfieldTemperature
- SubfieldTraceStrain
- SubfieldTraceStrainDot
- SubfieldVelocity
- TimeDependent
- testing
- topology
- utils
- Examples
- Overview
- Examples
- Axial and Shear Deformation (2D Box)
- Axial and Shear Deformation (3D Box)
- Horizontal Cross-Section of Strike-Slip Fault (2D)
- Overview
- Example Workflow
- Gmsh Mesh
- Cubit Mesh
- Common Information
- Step 1: Static Coseismic Slip
- Step 2: Single Earthquake Rupture and Velocity Boundary Conditions
- Step 3: Multiple Earthquake Ruptures and Velocity Boundary Conditions
- Step 4: Variable Coseismic Slip
- Step 5: Green’s Functions
- Step 6: Least Squares Fault Slip Inversion
- Step 7: Bayesian Fault Slip Inversion
- Suggested Exercises
- Vertical Cross-Section of a Reverse Fault with Splay (2D)
- Overview
- Example Workflow
- Gmsh Mesh
- Cubit Mesh
- Common Information
- Step 1: Gravitational Body Forces
- Step 2: Gravitational Body Forces with Reference Stress
- Step 3: Gravitational Body Forces with Incompressible Elasticity
- Step 4: Surface Tractions
- Step 5: Static Coseismic Slip
- Step 6: Slip on Two Faults and Elastic Materials
- Step 7: Slip on Two Faults and Maxwell Viscoelastic Materials
- Step 8: Slip on Two Faults and Power-law Viscoelastic Materials
- Suggested Exercises
- Horizontal Cross-Section of Intersecting Strike-Slip Faults (2D)
- Intersecting Strike-Slip Faults (3D)
- Vertical Cross-Section of Subduction Zone (2D)
- Subduction Zone (3D)
- Overview
- Example Workflow
- Cubit Mesh
- Common Information
- Step 1: Axial Compression
- Step 2: Earthquake Rupture and Postseismic Relaxation
- Step 3: Interseismic Deformation
- Step 4: Earthquake Cycle with Prescribed Slip
- Step 5: Spontaneous Rupture Driven by Subducting Slab
- Step 6: Prescribed Slow Slip Events
- Step 7: Generation of Green’s Functions and Slow Slip Inversion
- Step 8: Use of Gravitational Body Forces
- Suggested Exercises
- 2D Magma Reservoir Using Poroelasticity
- 2D Outer-Rise Hydration Using Poroelasticity
- Troubleshooting (2D)
- Example Workflow
- Error Messages
- Step 1: Gravitational Body Forces
- Step 1: Error 1
- Step 1: Error 2
- Step 1: Error 3
- Step 1: Error 4
- Step 1: Error 5
- Step 6: Slip on Two Faults
- Step 6: Error 1
- Step 6: Error 2
- Step 6: Error 3
- Step 6: Error 4
- Step 6: Error 5
- Step 6: Error 6
- Step 6: Error 7
- Step 6: Error 8
- Step 6: Error 9
- Step 6: Error 10
- Example Workflow
- Additional Examples
- Benchmarks
- Glossary
- File Formats
- Appendices