[cig-commits] [commit] knepley/upgrade-petsc-interface: Fixed discussion of initial state variables. (ab65d94)

[cig_noreply at geodynamics.org]

Repository : ssh://geoshell/pylith

On branch  : knepley/upgrade-petsc-interface
Link       : https://github.com/geodynamics/pylith/compare/1cdc9e82c7457b3a0025d9b630ac4eca20efcbe0...ab65d9444d780a462a1282b0cf6048c4743e6d88

>---------------------------------------------------------------

commit ab65d9444d780a462a1282b0cf6048c4743e6d88
Author: Brad Aagaard <baagaard at usgs.gov>
Date:   Fri Feb 14 09:44:33 2014 -0800

    Fixed discussion of initial state variables.


>---------------------------------------------------------------

ab65d9444d780a462a1282b0cf6048c4743e6d88
 doc/userguide/makepdf.sh              |  3 +--
 doc/userguide/materials/materials.lyx | 34 ++++++++++++++++++++++++++++++++--
 2 files changed, 33 insertions(+), 4 deletions(-)

diff --git a/doc/userguide/makepdf.sh b/doc/userguide/makepdf.sh
index a1c9f77..0231b91 100644
--- a/doc/userguide/makepdf.sh
+++ b/doc/userguide/makepdf.sh
@@ -16,7 +16,6 @@
 # ----------------------------------------------------------------------
 #
 
-for i in `find . -name "*.eps"`; do epstopdf $i; done
-lyx -e pdf userguide.lyx
+lyx -e pdf2 userguide.lyx
 
 # End of file
diff --git a/doc/userguide/materials/materials.lyx b/doc/userguide/materials/materials.lyx
index b554aaf..2cedeaa 100644
--- a/doc/userguide/materials/materials.lyx
+++ b/doc/userguide/materials/materials.lyx
@@ -5993,9 +5993,11 @@ Specification of Initial State Variables
 \end_layout
 
 \begin_layout Standard
-Since state variables are specific to a given material, initial values for
+State variables are specific to a given material, so initial values for
  state variables are specified as part of the material description.
- By default, initial state values are not used.
+ The default is that no initial state variables are specified.
+ In computing the elastic prestep, appropriate values for the state variables
+ are set; otherwise the state variables are set to zero.
  To override this behavior, specify a spatial database for the initial stress,
  strain, and/or state variables as in the example from the tutorial in Section
  
@@ -6020,6 +6022,34 @@ db_initial_stress = spatialdata.spatialdb.SimpleDB
 db_initial_stress.iohandler.filename = initial_stress.spatialdb
 \end_layout
 
+\begin_layout Quote
+
+\series bold
+\color red
+Warning:
+\color inherit
+ 
+\series default
+Using the elastic prestep with initial state variables will generally lead
+ to the state variables being ignored (the initial out of plane stress is
+ the exception), because the elastic prestep will set the state variables
+ based on the elastic solution.
+\end_layout
+
+\begin_layout Quote
+
+\series bold
+\color red
+Warning:
+\color inherit
+ 
+\series default
+Currently, PyLith assumes initial displacements and velocities of zero,
+ so any initial strain and state variables should be consistent with these
+ initial conditions.
+ This limitation will be removed in future releases.
+\end_layout
+
 \begin_layout Standard
 As mentioned in section 
 \begin_inset CommandInset ref