[cig-commits] r11548 - in short/3D/PyLith/trunk/doc/userguide: . benchmarks benchmarks/strikeslip materials tutorials/twohex8

willic3 at geodynamics.org willic3 at geodynamics.org
Tue Mar 25 12:09:06 PDT 2008 

Author: willic3
Date: 2008-03-25 12:09:06 -0700 (Tue, 25 Mar 2008)
New Revision: 11548

Modified:
   short/3D/PyLith/trunk/doc/userguide/benchmarks/benchmarks.lyx
   short/3D/PyLith/trunk/doc/userguide/benchmarks/strikeslip/strikeslip.lyx
   short/3D/PyLith/trunk/doc/userguide/materials/materials.lyx
   short/3D/PyLith/trunk/doc/userguide/tutorials/twohex8/twohex8.lyx
   short/3D/PyLith/trunk/doc/userguide/userguide.lyx
Log:
Added materials output section, and added related material in twohex8
tutorial.



Modified: short/3D/PyLith/trunk/doc/userguide/benchmarks/benchmarks.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/benchmarks/benchmarks.lyx	2008-03-25 18:41:11 UTC (rev 11547)
+++ short/3D/PyLith/trunk/doc/userguide/benchmarks/benchmarks.lyx	2008-03-25 19:09:06 UTC (rev 11548)
@@ -1,4 +1,4 @@
-#LyX 1.5.2 created this file. For more info see http://www.lyx.org/
+#LyX 1.5.3 created this file. For more info see http://www.lyx.org/
 \lyxformat 276
 \begin_document
 \begin_header

Modified: short/3D/PyLith/trunk/doc/userguide/benchmarks/strikeslip/strikeslip.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/benchmarks/strikeslip/strikeslip.lyx	2008-03-25 18:41:11 UTC (rev 11547)
+++ short/3D/PyLith/trunk/doc/userguide/benchmarks/strikeslip/strikeslip.lyx	2008-03-25 19:09:06 UTC (rev 11548)
@@ -1,4 +1,4 @@
-#LyX 1.5.2 created this file. For more info see http://www.lyx.org/
+#LyX 1.5.3 created this file. For more info see http://www.lyx.org/
 \lyxformat 276
 \begin_document
 \begin_header
@@ -183,7 +183,7 @@
 \begin_layout Standard
 \align center
 \begin_inset Graphics
-	filename figs/geometry.png
+	filename figs/geometry.eps
 	scale 75
 
 \end_inset

Modified: short/3D/PyLith/trunk/doc/userguide/materials/materials.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/materials/materials.lyx	2008-03-25 18:41:11 UTC (rev 11547)
+++ short/3D/PyLith/trunk/doc/userguide/materials/materials.lyx	2008-03-25 19:09:06 UTC (rev 11548)
@@ -1,4 +1,4 @@
-#LyX 1.5.1 created this file. For more info see http://www.lyx.org/
+#LyX 1.5.3 created this file. For more info see http://www.lyx.org/
 \lyxformat 276
 \begin_document
 \begin_header
@@ -317,6 +317,273 @@
  a different material model, would be used for each material group.
 \end_layout
 
+\begin_layout Standard
+By default the output manager for a material does not output any information.
+ This behavior may be changed by specifying output files for each material
+ group:
+\end_layout
+
+\begin_layout LyX-Code
+[pylithapp.timedependent.materials.elastic_upper.output]
+\end_layout
+
+\begin_layout LyX-Code
+cell_filter = pylith.meshio.CellFilterAvg
+\end_layout
+
+\begin_layout LyX-Code
+writer.filename = dislocation-statevars-upper.vtk
+\end_layout
+
+\begin_layout LyX-Code
+ 
+\end_layout
+
+\begin_layout LyX-Code
+[pylithapp.timedependent.materials.elastic_lower.output]
+\end_layout
+
+\begin_layout LyX-Code
+cell_filter = pylith.meshio.CellFilterAvg
+\end_layout
+
+\begin_layout LyX-Code
+writer.filename = dislocation-statevars-lower.vtk
+\end_layout
+
+\begin_layout Standard
+These settings again correspond to the problem in 
+\family typewriter
+examples/3d/hex8
+\family default
+.
+ The specification of a state variable base filename (
+\family typewriter
+writer.filename
+\family default
+ settings) will cause two files to be created for each material group: an
+ info file, which describes the material properties used in the model, and
+ a state variables file, which contains the state variable information.
+ If the problem has more than one time step, a state variable output file
+ will be created for each requested time step.
+ We have requested that the values be averaged over each cell.
+ Otherwise, output would be produced for each quadrature point, which can
+ cause problems with some visualization packages.
+ For this example problem, the material is three-dimensional isotropic elastic,
+ and is thus described by only three material properties (
+\begin_inset Formula $\lambda$
+\end_inset
+
+, 
+\begin_inset Formula $\mu$
+\end_inset
+
+, 
+\begin_inset Formula $\rho$
+\end_inset
+
+), as described below.
+ These properties are output by default.
+ Other material models require additional parameters, and if users want
+ these to be output, they must be specified.
+ Similarly, other material models require state variables in addition to
+ the default stress and strain variables that are used by all material models.
+ Additional output may be requested for a material model, as in this example
+ (
+\family typewriter
+examples/twocells/twohex8
+\family default
+):
+\end_layout
+
+\begin_layout LyX-Code
+[pylithapp.timedependent.materials.material.output]
+\end_layout
+
+\begin_layout LyX-Code
+cell_data_fields = [total-strain,viscous-strain,stress]
+\end_layout
+
+\begin_layout LyX-Code
+cell_info_fields = [mu,lambda,density,Maxwell-time]
+\end_layout
+
+\begin_layout Standard
+The properties and state variable available for output in each material
+ model are listed in 
+\begin_inset LatexCommand ref
+reference "tab:material-model-output"
+
+\end_inset
+
+.
+ For the generalized Maxwell model, values of shear-ratio and Maxwell-time
+ are given for each Maxwell element in the model (there are presently three,
+ as described below).
+ Similarly, there are three sets of viscous-strain values for the generalized
+ Maxwell model.
+\end_layout
+
+\begin_layout Standard
+\begin_inset Float table
+wide false
+sideways false
+status open
+
+\begin_layout Standard
+\begin_inset LatexCommand label
+name "tab:material-model-output"
+
+\end_inset
+
+
+\begin_inset Tabular
+<lyxtabular version="3" rows="4" columns="3">
+<features>
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" width="0">
+<column alignment="center" valignment="top" leftline="true" rightline="true" width="0">
+<row topline="true" bottomline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+Model
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+Properties
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+State Variables
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row topline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+Elastic
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+[mu,lambda,density]
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+[total-strain,stress]
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row topline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+Maxwell Viscoelastic
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+[mu,lambda,density,Maxwell-time]
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+[total-strain,viscous-strain,stress]
+\end_layout
+
+\end_inset
+</cell>
+</row>
+<row topline="true" bottomline="true">
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+Generalized Maxwell Viscoelastic
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+[mu,lambda,density,shear-ratio,Maxwell-time]
+\end_layout
+
+\end_inset
+</cell>
+<cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
+\begin_inset Text
+
+\begin_layout Standard
+[total-strain,viscous-strain,stress]
+\end_layout
+
+\end_inset
+</cell>
+</row>
+</lyxtabular>
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+\begin_inset Caption
+
+\begin_layout Standard
+Properties and state variables available for output for existing material
+ models.
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
 \begin_layout Section
 Elastic Material Models
 \end_layout

Modified: short/3D/PyLith/trunk/doc/userguide/tutorials/twohex8/twohex8.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/tutorials/twohex8/twohex8.lyx	2008-03-25 18:41:11 UTC (rev 11547)
+++ short/3D/PyLith/trunk/doc/userguide/tutorials/twohex8/twohex8.lyx	2008-03-25 19:09:06 UTC (rev 11548)
@@ -1,4 +1,4 @@
-#LyX 1.5.1 created this file. For more info see http://www.lyx.org/
+#LyX 1.5.3 created this file. For more info see http://www.lyx.org/
 \lyxformat 276
 \begin_document
 \begin_header
@@ -432,9 +432,9 @@
 \begin_layout Description
 pylithapp.timedependent.materials.material.output Defines the filter to be used
  when writing cell state variables (average over the quadrature points of
- the cell), gives the base filename for state variable output files, and
- defines the format to use when defining the output filenames for each time
- step.
+ the cell), specifies which state variables and properties to output, gives
+ the base filename for state variable output files, and defines the format
+ to use when defining the output filenames for each time step.
 \end_layout
 
 \begin_layout Standard
@@ -449,8 +449,23 @@
 .
  Since data are being specified using two control points (rather than being
  uniform over the mesh, for example), the data dimension is one.
+ Note that since we are using a Maxwell viscoelastic model, additional state
+ variables and properties may be output if they are specified.
+ Otherwise, the default values will be used:
 \end_layout
 
+\begin_layout LyX-Code
+[pylithapp.timedependent.materials.material.output]
+\end_layout
+
+\begin_layout LyX-Code
+cell_data_fields = [total-strain,viscous-strain,stress]
+\end_layout
+
+\begin_layout LyX-Code
+cell_info_fields = [mu,lambda,density,Maxwell-time]
+\end_layout
+
 \begin_layout Standard
 The files containing common information (
 \family typewriter
@@ -500,7 +515,8 @@
 \family default
  is the time in seconds for which output has been produced.
  These files contain the state variables for each cell at the given time.
- The default fields are the total strain and stress fields.
+ The default fields are the total strain and stress fields; however, we
+ have also requested the viscous strains.
  As specified in 
 \family typewriter
 axialdisp.cfg
@@ -511,7 +527,7 @@
 axialdisp-statevars_info.vtk
 \family default
 ) gives the material properties used for the problem.
- Since we have not specified which properties to write, the default properties
+ We have requested all of the properties available for this material model
  (
 \family typewriter
 mu
@@ -524,7 +540,11 @@
 \family typewriter
 density
 \family default
-) are written.
+, 
+\family typewriter
+Maxwell-time
+\family default
+).
  All of the 
 \family typewriter
 .vtk
@@ -663,9 +683,9 @@
 \begin_layout Description
 pylithapp.timedependent.materials.material.output Defines the filter to be used
  when writing cell state variables (average over the quadrature points of
- the cell), gives the base filename for state variable output files, and
- defines the format to use when defining the output filenames for each time
- step.
+ the cell), specifies which state variables and properties to output, gives
+ the base filename for state variable output files, and defines the format
+ to use when defining the output filenames for each time step.
 \end_layout
 
 \begin_layout Standard
@@ -680,8 +700,23 @@
 .
  Data are being specified at two control points (rather than being uniform
  over the mesh, for example), so the data dimension is one.
+ Note that since we are using a Maxwell viscoelastic model, additional state
+ variables and properties may be output if they are specified.
+ Otherwise, the default values will be used:
 \end_layout
 
+\begin_layout LyX-Code
+[pylithapp.timedependent.materials.material.output]
+\end_layout
+
+\begin_layout LyX-Code
+cell_data_fields = [total-strain,viscous-strain,stress]
+\end_layout
+
+\begin_layout LyX-Code
+cell_info_fields = [mu,lambda,density,Maxwell-time]
+\end_layout
+
 \begin_layout Standard
 The files containing common information (
 \family typewriter
@@ -731,7 +766,8 @@
 \family default
  is the time in seconds for which output has been produced.
  These files contain the state variables for each cell at the given time.
- The default fields are the total strain and stress fields.
+ The default fields are the total strain and stress fields; however, we
+ have also requested the viscous strains.
  As specified in 
 \family typewriter
 sheardisp.cfg
@@ -742,7 +778,7 @@
 sheardisp-statevars_info.vtk
 \family default
 ) gives the material properties used for the problem.
- Since we have not specified which properties to write, the default properties
+ We have requested all of the properties available for this material model
  (
 \family typewriter
 mu
@@ -755,7 +791,11 @@
 \family typewriter
 density
 \family default
-) are written.
+, 
+\family typewriter
+Maxwell-time
+\family default
+).
  All of the 
 \family typewriter
 .vtk
@@ -913,8 +953,9 @@
 \begin_layout Description
 pylithapp.timedependent.materials.material.output Defines the filter to be used
  when writing cell state variables (average the quadrature points for the
- cell), gives the base filename for state variable output files, and defines
- the format to use when defining the output filenames for each time step.
+ cell), specifies which state variables and properties to output, gives
+ the base filename for state variable output files, and defines the format
+ to use when defining the output filenames for each time step.
 \end_layout
 
 \begin_layout Standard
@@ -949,8 +990,23 @@
 dislocation_sliptime.spatialdb
 \family default
 .
+ Note that since we are using a Maxwell viscoelastic model, additional state
+ variables and properties may be output if they are specified.
+ Otherwise, the default values will be used:
 \end_layout
 
+\begin_layout LyX-Code
+[pylithapp.timedependent.materials.material.output]
+\end_layout
+
+\begin_layout LyX-Code
+cell_data_fields = [total-strain,viscous-strain,stress]
+\end_layout
+
+\begin_layout LyX-Code
+cell_info_fields = [mu,lambda,density,Maxwell-time]
+\end_layout
+
 \begin_layout Standard
 The files containing common information (
 \family typewriter
@@ -1012,7 +1068,8 @@
 \family default
  is the time for which output has been produced.
  These files contain the state variables for each cell at the given time.
- The default fields are the total strain and stress fields.
+ The default fields are the total strain and stress fields; however, we
+ have also requested the viscous strains.
  As specified in 
 \family typewriter
 dislocation.cfg
@@ -1030,7 +1087,7 @@
 dislocation-statevars_info.vtk
 \family default
 ) gives the material properties used for the problem.
- Since we have not specified which properties to write, the default properties
+ We have requested all of the properties available for this material model
  (
 \family typewriter
 mu
@@ -1043,7 +1100,11 @@
 \family typewriter
 density
 \family default
-) are written.
+, 
+\family typewriter
+Maxwell-time
+\family default
+).
  The final additional file (
 \family typewriter
 dislocation-fault_info.vtk

Modified: short/3D/PyLith/trunk/doc/userguide/userguide.lyx
===================================================================
--- short/3D/PyLith/trunk/doc/userguide/userguide.lyx	2008-03-25 18:41:11 UTC (rev 11547)
+++ short/3D/PyLith/trunk/doc/userguide/userguide.lyx	2008-03-25 19:09:06 UTC (rev 11548)
@@ -1,4 +1,4 @@
-#LyX 1.5.2 created this file. For more info see http://www.lyx.org/
+#LyX 1.5.3 created this file. For more info see http://www.lyx.org/
 \lyxformat 276
 \begin_document
 \begin_header
@@ -57,13 +57,13 @@
 placement H
 wide false
 sideways false
-status collapsed
+status open
 
 \begin_layout Standard
 \noindent
 \align center
 \begin_inset Graphics
-	filename /Users/sue/pylith/pylith-1.0/pylith_cover.pdf
+	filename pylith_cover.pdf
 	width 75page%
 
 \end_inset

More information about the cig-commits mailing list