[cig-commits] r16890 - in short/3D/PyLith/trunk/doc/userguide: . runpylith
brad at geodynamics.org
brad at geodynamics.org
Thu Jun 3 19:51:45 PDT 2010
Author: brad
Date: 2010-06-03 19:51:45 -0700 (Thu, 03 Jun 2010)
New Revision: 16890
Modified:
short/3D/PyLith/trunk/doc/userguide/components.lyx
short/3D/PyLith/trunk/doc/userguide/runpylith/runpylith.lyx
Log:
Added small strain formulation stuff to list of formulations. Updated list of user-selectable components.
Modified: short/3D/PyLith/trunk/doc/userguide/components.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/components.lyx 2010-06-04 02:30:41 UTC (rev 16889)
+++ short/3D/PyLith/trunk/doc/userguide/components.lyx 2010-06-04 02:51:45 UTC (rev 16890)
@@ -1,4 +1,4 @@
-#LyX 1.6.2 created this file. For more info see http://www.lyx.org/
+#LyX 1.6.5 created this file. For more info see http://www.lyx.org/
\lyxformat 345
\begin_document
\begin_header
@@ -110,24 +110,90 @@
\begin_inset Newline newline
\end_inset
-Implicit time stepping for static and quasi-static simulations.
+Implicit time stepping for static and quasi-static simulations with infinitesima
+l strains.
\end_layout
\begin_layout Description
\family typewriter
+ImplicitLgDeform pylith.problems.ImplicitLgDeform
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Implicit time stepping for static and quasi-static simulations including
+ the effects of rigid body motion and small strains.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
Explicit pylith.problems.Explicit
\family default
\begin_inset Newline newline
\end_inset
-Explicit time stepping for dynamic simulations.
+Explicit time stepping for dynamic simulations with infinitesimal strains.
\end_layout
\begin_layout Description
\family typewriter
+ExplicitLgDeform pylith.problems.ExplicitLgDeform
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Explicit time stepping for dynamic simulations including the effects of
+ rigid body motion and small strains.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
+ExplicitLumped pylith.problems.ExplicitLumped
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Explicit time stepping for dynamic simulations with a lumped system Jacobian
+ matrix.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
+ExplicitLumpedTri3 pylith.problems.ExplicitLumpedTri3
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Optimized elasticity formulation for linear triangular cells and one quadrature
+ point for explicit time stepping in dynamic simulations.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
+ExplicitLumpedTet4 pylith.problems.ExplicitLumpedTet4
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Optimized elasticity formulation for linear tetrahedral cells and one quadrature
+ point for explicit time stepping in dynamic simulations.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
SolverLinear pylith.problems.SolverLinear
\family default
@@ -152,6 +218,18 @@
\begin_layout Description
\family typewriter
+SolverLumped pylith.problems.SolverLumped
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Built-in simple, optimized solver for solving systems with a lumped Jacobian.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
TimeStepUniform pylith.problems.TimeStepUniform
\family default
@@ -205,6 +283,18 @@
\begin_layout Description
\family typewriter
+EventLogger pylith.utils.EventLogger
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+PETSc event logger.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
MemoryLogger pylith.perf.MemoryLogger
\family default
@@ -361,6 +451,18 @@
\begin_layout Description
\family typewriter
+MaxwellPlaneStrain pylith.materials.MaxwellPlaneStrain
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Linear Maxwell viscoelastic bulk constitutive model for plane strain problems.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
GenMaxwellIsotropic3D pylith.materials.GenMaxwellIsotropic3D
\family default
@@ -385,6 +487,18 @@
\begin_layout Description
\family typewriter
+DruckerPrage3D pylith.materials.DruckerPrager3D
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Drucker-Prager elastoplastic bulk constitutive model.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
Homogeneous pylith.materials.Homogeneous
\family default
@@ -492,6 +606,18 @@
\begin_layout Description
\family typewriter
+FaultCohesiveDyn pylith.faults.FaultCohesive
+\family default
+Dyn
+\begin_inset Newline newline
+\end_inset
+
+Fault surface with dynamic (friction) slip implemented using cohesive elements.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
EqKinSrc pylith.faults.EqKinSrc
\family default
@@ -565,6 +691,46 @@
\end_layout
\begin_layout Subsection
+Friction components
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
+StaticFriction pylith.friction.StaticFriction
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Static friction fault constitutive model.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
+SlipWeakening pylith.friction.SlipWeakening
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Linear slip-weakening friction fault constitutive model.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
+RateStateAgeing pylith.friction.RateStateAgeing
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Dieterich-Ruina rate and state friction with ageing law state variable evolution.
+\end_layout
+
+\begin_layout Subsection
Discretization components
\end_layout
@@ -723,6 +889,18 @@
\begin_layout Description
\family typewriter
+OutputFaultDyn pylith.meshio.OutputFaultDyn
+\family default
+
+\begin_inset Newline newline
+\end_inset
+
+Output manager for fault with dynamic (friction) earthquake ruptures.
+\end_layout
+
+\begin_layout Description
+
+\family typewriter
OutputMatElastic pylith.meshio.OutputMatElastic
\family default
Modified: short/3D/PyLith/trunk/doc/userguide/runpylith/runpylith.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/runpylith/runpylith.lyx 2010-06-04 02:30:41 UTC (rev 16889)
+++ short/3D/PyLith/trunk/doc/userguide/runpylith/runpylith.lyx 2010-06-04 02:51:45 UTC (rev 16890)
@@ -1,4 +1,4 @@
-#LyX 1.6.4 created this file. For more info see http://www.lyx.org/
+#LyX 1.6.5 created this file. For more info see http://www.lyx.org/
\lyxformat 345
\begin_document
\begin_header
@@ -224,7 +224,7 @@
\begin_layout Standard
All dimensional parameters require units.
- The units are specified using Python and Fortran syntax, so square meters
+ The units are specified using Python and FORTRAN syntax, so square meters
is m**2.
Whitespace is not allowed in the string, for units and dimensioned quantities
are multiplied by the units string; for example, two meters per second
@@ -1157,7 +1157,7 @@
Beginning with CUBIT 11.0, the names of the nodesets are included in the
Exodus II files and PyLith can use these nodeset names or revert to using
the nodeset ids.
- The properties and components associated withthe MeshIOCubit object are:
+ The properties and components associated with the MeshIOCubit object are:
\end_layout
\begin_layout Description
@@ -1181,7 +1181,7 @@
output from LaGriT.
PyLith will automatically detect whether the files are ASCII or binary.
We attempt to provide support for experimental 64-bit versions of LaGriT
- via flags indicating whether the Fortran code is using 32-bit or 64-bit
+ via flags indicating whether the FORTRAN code is using 32-bit or 64-bit
integers.
The MeshIOLagrit properties and components are:
\end_layout
@@ -1205,7 +1205,7 @@
\end_layout
\begin_layout Description
-record_header_32bt Flag indicating Fortran record header is 32-bit (default
+record_header_32bt Flag indicating FORTRAN record header is 32-bit (default
is True)
\end_layout
@@ -1253,8 +1253,8 @@
\end_layout
\begin_layout Description
-writer_paritition Flag indicating that the partition information should
- be written to a file (default is False).
+writer_partition Flag indicating that the partition information should be
+ written to a file (default is False).
\end_layout
\begin_layout Description
@@ -2127,58 +2127,72 @@
facility to the general-problem.
The formulation specifies the time-stepping formulation to integrate the
elasticity equation.
- Implicit time stepping is used for quasi-static problems and neglects interial
- terms (see Section
+ PyLith provides several alternative formulations, each specific to a different
+ type of problem.
+ Future versions of PyLith will likely include support for additional formulatio
+ns, such as large deformations with a lumped Jacobian matrix.
+\end_layout
+
+\begin_layout Description
+Implicit Implicit time stepping for static and quasi-static problems with
+ infinitesimal strains.
+ The implicit formulation neglects inertial terms (see Section
\begin_inset CommandInset ref
LatexCommand ref
reference "eq:elasticity:integral:quasistatic"
\end_inset
-), whereas explicit time stepping is used for dynamic problems and includes
- inertial terms.
- There are two general options for explicit time-stepping: using a full,
- consistent Jacobian matrix and a lumped Jacobian matrix.
- In the lumped Jacobian formulation, the Jacobian is a diagonal matrix and
- stored as a vector, and PyLith employs an optimized built-in solver rather
- than a PETSc solver.
- PyLith automatically switches to using the optimized built-in when the
- lumped formulation is chosen.
- PyLith also provides two optimized time-stepping options, one for single
- point quadrature in linear triangular cells and one for single point quadrature
- in linear tetrahedral cells.
+).
\end_layout
-\begin_layout Standard
-An example of setting the formulation facility to the implicit time stepping
- component is:
+\begin_layout Description
+ImplicitLgDeform Implicit time stepping for static and quasi-static problems
+ including the effects of rigid body motion and small strains.
+ This formulation requires the use of the nonlinear solver, which is selected
+ automatically.
\end_layout
-\begin_layout LyX-Code
-[pylithapp.timedependent]
+\begin_layout Description
+Explicit Explicit time stepping for dynamic problems with infinitesimal
+ strains.
+ This formulation uses consistent mass and damping matrices for the system
+ Jacobian matrix.
\end_layout
-\begin_layout LyX-Code
-formulation = pylith.problems.Implicit
+\begin_layout Description
+ExplicitLgDeform Explicit time stepping for dynamic problems including the
+ effects of rigid body motion and small strains.
+ This formulation requires the use of the nonlinear solver, which is selected
+ automatically.
\end_layout
-\begin_layout Standard
-An example of setting the formulation facility to the explicit time stepping
- component is:
+\begin_layout Description
+ExplicitLumped Explicit time stepping for dynamic problems with infinitesimal
+ strains and lumped system Jacobian.
+ The cell matrices are lumped before assembly, permitting use of a vector
+ for the diagonal system Jacobian matrix.
+ The built-in lumped solver is selected automatically.
\end_layout
-\begin_layout LyX-Code
-[pylithapp.timedependent]
+\begin_layout Description
+ExplicitLumpedTri3 Optimized elasticity formulation for linear triangular
+ cells with one point quadrature for dynamic problems with infinitesimal
+ strains and lumped system Jacobian.
+ The built-in lumped solver is selected automatically.
\end_layout
-\begin_layout LyX-Code
-formulation = pylith.problems.Explicit
+\begin_layout Description
+ExplicitLumpedTet4 Optimized elasticity formulation for linear tetrahedral
+ cells with one point quadrature for dynamic problems with infinitesimal
+ strains and lumped system Jacobian.The built-in lumped solver is selected
+ automatically.
\end_layout
\begin_layout Standard
-An example of setting the formulation facility to the lumped explicit time
- stepping component is:
+An example of setting the formulation facility to the implicit time stepping
+ component is:
\end_layout
\begin_layout LyX-Code
@@ -2186,36 +2200,13 @@
\end_layout
\begin_layout LyX-Code
-formulation = pylith.problems.ExplicitLumped
+formulation = pylith.problems.Implicit
\end_layout
\begin_layout Standard
-An example of setting the formulation facility to the lumped explicit time
- stepping component optimized for linear triangular cells with one point
- quadrature is:
+The formulation can be set to the other formulations in a similar fashion.
\end_layout
-\begin_layout LyX-Code
-[pylithapp.timedependent]
-\end_layout
-
-\begin_layout LyX-Code
-formulation = pylith.problems.ExplicitLumpedTri3
-\end_layout
-
-\begin_layout Standard
-An example of setting the formulation facility to the lumped explicit time
- stepping component optimized for linear tetrehedral cells is:
-\end_layout
-
-\begin_layout LyX-Code
-[pylithapp.timedependent]
-\end_layout
-
-\begin_layout LyX-Code
-formulation = pylith.problems.ExplicitLumpedTet4
-\end_layout
-
\begin_layout Subsection
Time-Stepping Formulation
\end_layout
@@ -2290,7 +2281,7 @@
\end_layout
\begin_layout LyX-Code
-matrix_type = sbaij ; Nonsymmetric sparse matrix is aij
+matrix_type = sbaij ; Non-symmetric sparse matrix is aij
\end_layout
\begin_layout LyX-Code
@@ -3206,7 +3197,7 @@
history may be shifted with a spatial variation in the onset time and scaled
with a spatial variation in the amplitude.
The time history database uses a simple ASCII file which is simpler than
- the one used by the SimpleDB spatial databse.
+ the one used by the SimpleDB spatial database.
The file format is described in Section
\begin_inset CommandInset ref
LatexCommand ref
More information about the CIG-COMMITS
mailing list