[cig-commits] r11393 - short/3D/PyLith/trunk/doc/userguide/tutorials/twotri3

Mon Mar 10 11:55:54 PDT 2008

Author: willic3
Date: 2008-03-10 11:55:54 -0700 (Mon, 10 Mar 2008)
New Revision: 11393

Modified:
   short/3D/PyLith/trunk/doc/userguide/tutorials/twotri3/twotri3.lyx
Log:
Updated twotri3 example.



Modified: short/3D/PyLith/trunk/doc/userguide/tutorials/twotri3/twotri3.lyx
===================================================================

--- short/3D/PyLith/trunk/doc/userguide/tutorials/twotri3/twotri3.lyx	2008-03-10 18:45:34 UTC (rev 11392)
+++ short/3D/PyLith/trunk/doc/userguide/tutorials/twotri3/twotri3.lyx	2008-03-10 18:55:54 UTC (rev 11393)
@@ -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
@@ -41,6 +41,7 @@
 \tracking_changes false
 \output_changes false
 \author "" 
+\author "" 
 \end_header
 
 \begin_body
@@ -269,16 +270,21 @@
 \end_layout
 
 \begin_layout Description
-pylithapp.problem.formulation.output.output Gives the base filename for VTK
- output (
+pylithapp.problem.formulation.output.output.writer Gives the base filename for
+ VTK output (
 \family typewriter
 axialdisp.vtk
 \family default
 ).
 \end_layout
 
-\begin_layout Standard
-ADD MORE STUFF ON OUTPUT HERE
+\begin_layout Description
+pylithapp.timedependent.materials.material.output Gives the base filename for
+ state variable output files (
+\family typewriter
+axialdisp-statevars.vtk
+\family default
+).
 \end_layout
 
 \begin_layout Standard
@@ -328,11 +334,54 @@
 \end_layout
 
 \begin_layout Standard
-Once the problem has run, a file called 
+Once the problem has run, three files will be produced.
+ The first file is named 
 \family typewriter
-axialdisp_t0.vtk
+axialdisp_t0000000.vtk
 \family default
- is produced which may be used with a number of visualization packages.
+.
+ The 
+\family typewriter
+t0000000
+\family default
+ indicates that the output is for the first (and only) time step, corresponding
+ to an elastic solution.
+ This file contains mesh information as well as displacement values at the
+ mesh vertices.
+ The second file is named 
+\family typewriter
+axialdisp-statevars_t0000000.vtk
+\family default
+.
+ This file contains the state variables for each cell.
+ The default fields are the total strain and stress fields.
+ Since the cells are linear triangles, there is a single quadrature point
+ for each cell and thus a single set of stress and strain values for each
+ cell.
+ The final file (
+\family typewriter
+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
+ (
+\family typewriter
+mu
+\family default
+, 
+\family typewriter
+lambda
+\family default
+, 
+\family typewriter
+density
+\family default
+) are written.
+ All of the 
+\family typewriter
+.vtk
+\family default
+ files may be used with a number of visualization packages.
  If the problem ran correctly, you should be able to generate a figure such
  as 
 \begin_inset LatexCommand vref
@@ -349,7 +398,7 @@
 \begin_inset Float figure
 wide false
 sideways false
-status collapsed
+status open
 
 \begin_layout Standard
 \align center
@@ -451,32 +500,21 @@
 \end_layout
 
 \begin_layout Description
-pylithapp.problem.formulation.output.output Gives the base filename for VTK
- output (
+pylithapp.problem.formulation.output.output.writer Gives the base filename for
+ VTK output (
 \family typewriter
 sheardisp.vtk
 \family default
 ).
 \end_layout
 
-\begin_layout Standard
-ADD MORE ABOUT OUTPUT HERE
-\end_layout
-
-\begin_layout Standard
-The boundary conditions are described in the file 
+\begin_layout Description
+pylithapp.timedependent.materials.material.output Gives the base filename for
+ state variable output files (
 \family typewriter
-sheardisp.spatialdb
+sheardisp-statevars.vtk
 \family default
-, as specified in 
-\family typewriter
-sheardisp.cfg
-\family default
-.
- In this case, the desired displacement values are given at two points,
- corresponding to the two edges we want to constrain.
- Since data is being specified at points (rather than being uniform over
- the mesh, for example), the data dimension is one.
+).
 \end_layout
 
 \begin_layout Standard
@@ -509,11 +547,54 @@
 \end_layout
 
 \begin_layout Standard
-Once the problem has run, a file called 
+Once the problem has run, three files will be produced.
+ The first file is named 
 \family typewriter
-sheardisp_t0.vtk
+sheardisp_t0000000.vtk
 \family default
- is produced which may be used with a number of visualization packages.
+.
+ The 
+\family typewriter
+t0000000
+\family default
+ indicates that the output is for the first (and only) time step, corresponding
+ to an elastic solution.
+ This file contains mesh information as well as displacement values at the
+ mesh vertices.
+ The second file is named 
+\family typewriter
+sheardisp-statevars_t0000000.vtk
+\family default
+.
+ This file contains the state variables for each cell.
+ The default fields are the total strain and stress fields.
+ Since the cells are linear triangles, there is a single quadrature point
+ for each cell and thus a single set of stress and strain values for each
+ cell.
+ The final file (
+\family typewriter
+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
+ (
+\family typewriter
+mu
+\family default
+, 
+\family typewriter
+lambda
+\family default
+, 
+\family typewriter
+density
+\family default
+) are written.
+ All of the 
+\family typewriter
+.vtk
+\family default
+ files may be used with a number of visualization packages.
  If the problem ran correctly, you should be able to generate a figure such
  as 
 \begin_inset LatexCommand vref
@@ -530,7 +611,7 @@
 \begin_inset Float figure
 wide false
 sideways false
-status collapsed
+status open
 
 \begin_layout Standard
 \align center
@@ -604,15 +685,11 @@
 \family typewriter
 twotri3.mesh
 \family default
-) defining the points desired, assigns a label to the boundary condition
- set, and gives the name of the spatial database defining the boundary condition
-s (
-\family typewriter
-dislocation_disp
-\newline
-.spatialdb
-\family default
-).
+) defining the points desired, and assigns a label to the boundary condition
+ set.
+ In this case, rather than specifying a spatialial database file to define
+ the boundary conditions, the default for Dirichlet BC is used, which sets
+ the displacements to zero for all time.
 \end_layout
 
 \begin_layout Description
@@ -626,36 +703,39 @@
 \end_layout
 
 \begin_layout Description
-pylithapp.problem.formulation.output.output Gives the base filename for VTK
- output (
+pylithapp.problem.formulation.output.output.writer Gives the base filename for
+ VTK output (
 \family typewriter
-dislocation
-\newline
-.vtk
+dislocation.vtk
 \family default
 ).
 \end_layout
 
-\begin_layout Standard
-ADD MORE ABOUT OUTPUT HERE
+\begin_layout Description
+pylithapp.timedependent.interfaces.fault.output.writer Gives the base filename
+ for cohesive cell output files (
+\family typewriter
+dislocation-fault.vtk
+\family default
+).
 \end_layout
 
-\begin_layout Standard
-The boundary conditions are described in the file 
+\begin_layout Description
+pylithapp.timedependent.materials.material.output Gives the base filename for
+ state variable output files (
 \family typewriter
-dislocation_disp.spatialdb
+dislocation-statevars.vtk
 \family default
-, as specified in 
-\family typewriter
-dislocation.cfg
-\family default
-.
- In this case, the desired displacement values are given at a single point.
- Since data is being specified uniformly for all the labeled points, the
- data dimension is 0.
+).
 \end_layout
 
 \begin_layout Standard
+Rather than specifying the displacement boundary conditions in a spatial
+ database file, we use the default behavior for Dirichlet boundary conditions,
+ which is a uniform displacement of zero applied at all times.
+\end_layout
+
+\begin_layout Standard
 The fault example requires three additional database files that were not
  needed for the simple displacement examples.
  The first file (
@@ -708,10 +788,6 @@
 \family default
 , 
 \family typewriter
-dislocation_disp.spatialdb
-\family default
-, 
-\family typewriter
 dislocation_slip.spatialdb
 \family default
 , 
@@ -732,11 +808,67 @@
 \end_layout
 
 \begin_layout Standard
-Once the problem has run, a file called 
+Once the problem has run, five files are produced.
+ The first file is named 
 \family typewriter
-dislocation_t0.vtk
+dislocation_t0000000.vtk
 \family default
- is produced which may be used with a number of visualization packages.
+.
+ The 
+\family typewriter
+t0000000
+\family default
+ indicates that the output is for the first (and only) time step, corresponding
+ to an elastic solution.
+ This file contains mesh information as well as displacement values at the
+ mesh vertices.
+ The second file is named 
+\family typewriter
+dislocation-statevars_t0000000.vtk
+\family default
+.
+ This file contains the state variables for each cell.
+ The default fields are the total strain and stress fields.
+ Since the cells are linear triangles, there is a single quadrature point
+ for each cell and thus a single set of stress and strain values for each
+ cell.
+ The third file is named 
+\family typewriter
+dislocation-fault_t0000000.vtk
+\family default
+.
+ This file gives the specified fault slip for each vertex on the fault,
+ along with the computed traction change for the cohesive cell.
+ The fourth file (
+\family typewriter
+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
+ (
+\family typewriter
+mu
+\family default
+, 
+\family typewriter
+lambda
+\family default
+, 
+\family typewriter
+density
+\family default
+) are written.
+ The final file (
+\family typewriter
+dislocation-fault_info.vtk
+\family default
+) provides information such as the normal direction, final slip, and slip
+ time for each vertex on the fault.
+ All of the 
+\family typewriter
+.vtk
+\family default
+ files may be used with a number of visualization packages.
  If the problem ran correctly, you should be able to generate a figure such
  as 
 \begin_inset LatexCommand vref
@@ -753,7 +885,7 @@
 \begin_inset Float figure
 wide false
 sideways false
-status collapsed
+status open
 
 \begin_layout Standard
 \align center

