Types of Simulations#

PyLith currently supports two types of problems:

  • Time dependent, and

  • Static Green’s functions.

Time-Dependent Problem (TimeDependent)#

This type of problem solves a time-dependent boundary value problem and applies to static, quasistatic, and dynamic simulations. We use the PETSc object to manage the time-stepping, including the selection of the time-stepping algorithm. By default PyLith uses the backward Euler time-stepping algorithm.

Pyre User Interface

See TimeDependent Component for Pyre properties and facilities and configuration examples.

Initial Conditions#

Note

New in v3.0.0.

The initial conditions for a simulation are specified via a combination of initial values for the solution and initial values for state variables. The initial values for state variables are specified via the spatial databases for the auxiliary field of each material. In this section we discuss how to set the initial values of the solution field.

InitialConditionDomain#

We use this object when we want to specify the initial values of solution subfields across the entire domain using a single spatial database.

Pyre User Interface

See InitialConditionDomain Component for Pyre properties and facilities and configuration examples.

InitialConditionPatch#

We use this object when we want to specify the initial values of solution subfields across patches of the domain defined by materials.

Important

Initial conditions over a patch currently only work for Gmsh input files. Exodus II files from Cubit do not contain the information needed by the current PyLith implementation.

In creating the physical group in Gmsh, you must include the cells and all lower dimension entities (faces, edges, and vertices). The easiest way to do this is to use the VertexGroup provided in the pylith.meshio.gmsh_utils Python module. By default, the lower dimension entities will be included in the physical group.

Pyre User Interface

See InitialConditionPatch Component for Pyre properties and facilities and configuration examples.

Numerical Damping in Explicit Time Stepping#

Danger

Not yet reimplemented in v3.x.

Green’s Functions Problem (GreensFns)#

This type of problem applies to computing static Green’s functions for elastic deformation. The GreensFns problem loops over a suite of fault slip impulses and computes the static solution for each impulse using the linear solver. In the output files, the deformation at each “time step” is the deformation for a different slip impulse. The fault slip impulses are specified using FaultCohesiveImpulses for the fault. See Fault Slip Impulses (FaultCohesiveImpulses) for more information.

Warning

The GreensFns problem generates slip impulses on a fault. PyLith currently requires that impulses be applied to a single fault of type FaultCohesiveImpulses.

Pyre User Interface

See GreensFns Component for Pyre properties and facilities and configuration examples.