[cig-commits] r9359 - in short/3D/PyLith/trunk/examples/twocells: twoquad4 twotri3

brad at geodynamics.org brad at geodynamics.org
Thu Feb 14 21:35:13 PST 2008


Author: brad
Date: 2008-02-14 21:35:13 -0800 (Thu, 14 Feb 2008)
New Revision: 9359

Modified:
   short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.cfg
   short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.spatialdb
   short/3D/PyLith/trunk/examples/twocells/twoquad4/axialtract.cfg
   short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.cfg
   short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.spatialdb
   short/3D/PyLith/trunk/examples/twocells/twotri3/dislocation.cfg
   short/3D/PyLith/trunk/examples/twocells/twotri3/sheardisp.cfg
Log:
Improved documentation of twotri3 and twoquad4 examples.

Modified: short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.cfg
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.cfg	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.cfg	2008-02-15 05:35:13 UTC (rev 9359)
@@ -1,6 +1,6 @@
 # -*- Python -*-
 
-# To run this problem, type "pylith axialtract.cfg". The settings in
+# To run this problem, type "pylith axialdisp.cfg". The settings in
 # pylithapp.cfg will be read by default. See the README for how to run
 # other problems in this directory.
 #

Modified: short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.spatialdb
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.spatialdb	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twoquad4/axialdisp.spatialdb	2008-02-15 05:35:13 UTC (rev 9359)
@@ -1,9 +1,6 @@
-#SPATIAL.ascii 1
-
 // This database is used to specify the boundary conditions for the axial
 // displacement example.
-
-// This follows the format for a Simple DB (the only type presently available).
+#SPATIAL.ascii 1
 SimpleDB {
 
   // There are two values specified in the database, corresponding to the

Modified: short/3D/PyLith/trunk/examples/twocells/twoquad4/axialtract.cfg
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twoquad4/axialtract.cfg	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twoquad4/axialtract.cfg	2008-02-15 05:35:13 UTC (rev 9359)
@@ -97,4 +97,5 @@
 
 # Give basename for VTK output of traction BC information.
 [pylithapp.timedependent.bc.x_pos.output]
+cell_info_fields = [tractions]
 writer.filename = axialtract-tractions.vtk

Modified: short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.cfg
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.cfg	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.cfg	2008-02-15 05:35:13 UTC (rev 9359)
@@ -1,28 +1,36 @@
 # -*- Python -*-
 
-# The settings in this file (axialdisp.cfg) will be read if it is
-# specified on the command line:
-# 'pylith axialdisp.cfg'
+# To run this problem, type "pylith axialdisp.cfg". The settings in
+# pylithapp.cfg will be read by default. See the README for how to run
+# other problems in this directory.
+#
+#                ^
+#                |
+#     ------------ ->
+#     |\         |
+#     |  \       |
+#     |    \     |
+#     |      \   |
+#     |        \ |
+#  <- ------------
+#     |                      
+#     ^
+#
+# Axial tension is applied by pulling on the bottom left and upper
+# right corners.
 
-# If this file is given, the settings in this file will override all
-# others except for parameters specified directly on the command line.
-
-# These setting define an implicit problem with Dirichlet (displacement)
-# boundary conditions extending the diamond-shaped mesh along the x-axis.
-
 [pylithapp]
 
 # ----------------------------------------------------------------------
 # problem
 # ----------------------------------------------------------------------
 # Specify the problem settings.
-# This is a time-dependent problem so we use that facility.
 [pylithapp.timedependent]
 
 # We want an implicit formulation.
 formulation = pylith.problems.Implicit
 
-# This is a container for a boundary condition specified at a point.
+# Select a boundary condition container with 1 BC.
 bc = pylith.bc.BCSingle
 
 # ----------------------------------------------------------------------
@@ -34,13 +42,13 @@
 # We are fixing the 0 (x) and 1 (y) degrees of freedom.
 fixed_dof = [0, 1]
 
-# The nodes associated with this boundary condition have the name
-# 'end points' in the mesh file.
+# The group of vertices in the mesh file associated with this boundary
+# condition have the name 'end points'.
 label = end points
 
-# Change spatial database for initial value from FixedDOFDB (which has
-# a uniform spatial distribution) to SimpleDB (which uses a data file
-# to specify a spatial variation).
+# Change the spatial database for the Dirichlet BC initial values from
+# FixedDOFDB (which has a uniform spatial distribution) to SimpleDB
+# (which uses a data file to specify a spatial variation).
 db = spatialdata.spatialdb.SimpleDB
 
 # We are assigning the label 'Dirichlet BC' to the database.

Modified: short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.spatialdb
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.spatialdb	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twotri3/axialdisp.spatialdb	2008-02-15 05:35:13 UTC (rev 9359)
@@ -1,9 +1,6 @@
-#SPATIAL.ascii 1
-
 // This database is used to specify the boundary conditions for the axial
 // displacement example.
-
-// This follows the format for a Simple DB (the only type presently available).
+#SPATIAL.ascii 1
 SimpleDB {
 
   // There are two values specified in the database, corresponding to the

Modified: short/3D/PyLith/trunk/examples/twocells/twotri3/dislocation.cfg
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twotri3/dislocation.cfg	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twotri3/dislocation.cfg	2008-02-15 05:35:13 UTC (rev 9359)
@@ -1,15 +1,22 @@
 # -*- Python -*-
 
-# The settings in this file (dislocation.cfg) will be read if it is
-# specified on the command line:
-# 'pylith dislocation.cfg'
+# To run this problem, type "pylith dislocation.cfg". The settings in
+# pylithapp.cfg will be read by default. See the README for how to run
+# other problems in this directory.
+#
+#                v
+#     ------------<
+#     |\         |
+#     |  \       |
+#     |    \     |
+#     |      \   |
+#     |        \ |
+#    >------------
+#     ^
+#
+# Left-lateral slip is applied with Dirichlet (fixed displacement) BC
+# in the bottom left and upper right corners.
 
-# If this file is given, the settings in this file will override all
-# others except for parameters specified directly on the command line.
-
-# These settings define an implicit problem using a fault with
-# kinematically-specified slip.
-
 [pylithapp]
 
 # ----------------------------------------------------------------------
@@ -24,22 +31,20 @@
 # problem
 # ----------------------------------------------------------------------
 # Specify the problem settings.
-# This is a time-dependent problem so we use that facility.
 [pylithapp.timedependent]
 
 # We want an implicit formulation.
 formulation = pylith.problems.Implicit
 
-# This is a container for a boundary condition specified at a point.
+# Select a boundary condition container with 1 BC.
 bc = pylith.bc.BCSingle
 
-# This is a container for a single fault.
+# Select a fault container with 1 fault.
 interfaces = pylith.faults.SingleFault
 
 # ----------------------------------------------------------------------
 # boundary conditions
 # ----------------------------------------------------------------------
-# Provide information on the boundary conditions.
 [pylithapp.timedependent.bc.bc]
 
 # We use the default spatial database for the Dirichlet BC which sets
@@ -48,8 +53,8 @@
 # We are fixing the 0 (x) and 1 (y) degrees of freedom.
 fixed_dof = [0, 1]
 
-# The nodes associated with this boundary condition have the name
-# 'end points' in the mesh file.
+# The group of vertices in the mesh file associated with this boundary
+# condition have the name 'end points'.
 label = end points
 
 # We are assigning the label 'Dirichlet BC' to the database.
@@ -58,25 +63,21 @@
 # ----------------------------------------------------------------------
 # faults
 # ----------------------------------------------------------------------
-# Provide information on the fault (interface).
+# Faults are interior interfaces.
 [pylithapp.timedependent.interfaces]
 
-# Define fault properties.
+# Define settings for the single fault.
 [pylithapp.timedependent.interfaces.fault]
 
-# The nodes associated with this fault have the name 'fault' in the mesh file.
+# The group of vertices in the mesh file associated with this boundary
+# condition have the name 'fault'.
 label = fault
 
-# NOTE: It is possible to assign an ID number to a fault (e.g.,
-# 'id = 10').  Care must be taken when doing this, however, because the
-# assigned ID will become the material ID for the cohesive element.
-# This ID must not conflict with any of the material ID numbers for
-# volume elements.  The default ID for a fault is 100.  If you have a
-# fault in your mesh you must:
-# 1.  If you create your own fault ID, make sure it does not conflict
-#     with any of you material ID's.
-# 2.  If you use the default fault ID, make sure that none of your
-#     material ID's are equal to 100.
+# NOTE: In generally, you should set the 'id' for the fault. Care must
+# be taken when doing this, however, because the assigned 'id' will
+# tag the cohesive cells associated with the fault. The 'id' MUST be
+# unique across all faults as well as all materials. The default 'id'
+# for a fault is 100.
 
 # We need the material database for the fault to properly condition the
 # system of equations.

Modified: short/3D/PyLith/trunk/examples/twocells/twotri3/sheardisp.cfg
===================================================================
--- short/3D/PyLith/trunk/examples/twocells/twotri3/sheardisp.cfg	2008-02-15 05:05:32 UTC (rev 9358)
+++ short/3D/PyLith/trunk/examples/twocells/twotri3/sheardisp.cfg	2008-02-15 05:35:13 UTC (rev 9359)
@@ -1,35 +1,47 @@
 # -*- Python -*-
 
-# The settings in this file (sheardisp.cfg) will be read if it is
-# specified on the command line:
-# 'pylith sheardisp.cfg'
+# To run this problem, type "pylith sheardisp.cfg". The settings in
+# pylithapp.cfg will be read by default. See the README for how to run
+# other problems in this directory.
+#
+#     |          ^
+#     v          |
+#    >------------
+#     |\         |
+#     |  \       |
+#     |    \     |
+#     |      \   |
+#     |        \ |
+#    >------------
+#     |          ^
+#     v          |            
+#      
+#
+# We apply shear using Dirichlet (prescribed displacement) BC. The
+# left boundary is fixed in the horizontal direction with downward
+# vertical motion. The right boundary is free in the horizontal
+# direvtion with upward vertical motion.
 
-# If this file is given, the settings in this file will override all
-# others except for parameters specified directly on the command line.
+# -*- Python -*-
 
-# These setting define an implicit problem with Dirichlet (displacement)
-# boundary conditions that shear the mesh.
 [pylithapp]
 
 # ----------------------------------------------------------------------
 # problem
 # ----------------------------------------------------------------------
 # Specify the problem settings.
-# This is a time-dependent problem so we use that facility.
 [pylithapp.timedependent]
 
 # We want an implicit formulation.
 formulation = pylith.problems.Implicit
 formulation.solver = pylith.solver.SolverLinear
 
-# This is a container for a boundary condition specified on four sides
-# of a rectangular domain.
+# Select a boundary condition container with 4 BCs.
 bc = pylith.bc.BCFourSides
 
 # ----------------------------------------------------------------------
 # boundary conditions
 # ----------------------------------------------------------------------
-# Provide information on the boundary conditions.
 
 # Boundary conditions to be applied to the negative x-side of the mesh.
 [pylithapp.timedependent.bc.x_neg]
@@ -37,8 +49,8 @@
 # We are fixing the 0 (x) and 1 (y) degrees of freedom.
 fixed_dof = [0, 1]
 
-# The nodes associated with this boundary condition have the name
-# 'x_neg' in the mesh file.
+# The group of vertices in the mesh file associated with this boundary
+# condition have the name 'x_neg'.
 label = x_neg
 
 # Change spatial database for initial value from FixedDOFDB (which has
@@ -60,8 +72,8 @@
 # We are only fixing the 1 (y) degree of freedom.
 fixed_dof = [1]
 
-# The nodes associated with this boundary condition have the name
-# 'x_pos' in the mesh file.
+# The group of vertices in the mesh file associated with this boundary
+# condition have the name 'x_pos'.
 label = x_pos
 
 # Change spatial database for initial value from FixedDOFDB (which has



More information about the cig-commits mailing list