[cig-commits] r18632 - in short/3D/PyLith/trunk: . doc/releasenotes

[brad at geodynamics.org]

Author: brad
Date: 2011-06-14 20:31:22 -0700 (Tue, 14 Jun 2011)
New Revision: 18632

Modified:
   short/3D/PyLith/trunk/README
   short/3D/PyLith/trunk/doc/releasenotes/announce_v1.6.0.txt
Log:
Added notes on where new features are used in the examples. Updated README to v1.6.0.

Modified: short/3D/PyLith/trunk/README
===================================================================
--- short/3D/PyLith/trunk/README	2011-06-15 02:17:17 UTC (rev 18631)
+++ short/3D/PyLith/trunk/README	2011-06-15 03:31:22 UTC (rev 18632)
@@ -1,4 +1,4 @@
-We are pleased to announce release of PyLith version 1.5.2
+We are pleased to announce release of PyLith version 1.6.0
 
 Please submit bug reports via the World Wide Web at:
     http://geodynamics.org/roundup    
@@ -62,6 +62,76 @@
 
 
 ======================================================================
+MIGRATING FROM VERSION 1.5 TO 1.6
+======================================================================
+
+No changes in parameters are required.
+
+----------------------------------------------------------------------
+Version 1.6.0
+----------------------------------------------------------------------
+
+* New features
+
+  * Parallel binary output via HDF5
+
+    Provides much faster output by writing HDF5 files in parallel,
+    which can be accessed directly from Matlab or indirectly from
+    ParaView or Visit via automatically created Xdmf files. Temporal
+    data is stored in 3-D arrays, permitting slicing in time and/or
+    space. See examples/3d/hex8 Steps 6-9 and examples/2d/subduction
+    in the tutorials for examples.
+
+ * 2-D generalized Maxwell viscoelastic bulk rheology
+
+    Added a 2-D generalized Maxwell viscoelastic bulk rheology
+    corresponding to the plane strain version of the 3-D generalized
+    Maxwell viscoelastic model.
+
+ * Time-weakening fault constitutive model
+
+    Added a linear time-weakening fault constitutive model. Some
+    spontaneous rupture modelers prefer this model over linear
+    slip-weakening because it is easier to maintain resolution of the
+    cohesive zone.
+
+ * Global uniform parallel mesh refinement
+
+    Permits running larger problems through uniform global refinement
+    of the mesh by a factor of 2 (reduces the node spacing by a factor
+    of 2) after the mesh is distributed among processors. This allows
+    running problems that are 4x larger in 2-D and 8x larger in
+    3-D. See examples/3d/tet4 Steps 2 and 4 for examples.
+  
+ * Custom algebraic multigrid preconditioner
+
+    Adds a custom preconditioner for Lagrange multiplier degrees of
+    freedom associated with fault slip via prescribed slip or
+    spontaneous ruptures with algebraic multigrid preconditioning for
+    quasi-static solutions. In most cases, this results in fewer
+    iterations in the linear solve and the number of iterations
+    increases much less with problem size. See examples/3d/tet4 Steps
+    2 and 4 for examples.
+
+  * PyLith installer utility
+
+    This utility provides a much more robust method for building
+    PyLith and all of its dependencies from source, including
+    dependency checking, installation to a central location, and
+    creation of a shell script to set environment variables. 
+
+* Bug fixes
+
+    - Fixed the fault friction implementation to correctly update Lagrange
+      multiplier values when the slip is overestimated in an
+      iteration. This primary fixes problems encountered with the use
+      of the Dieterich-Ruina rate and state fault constitutive model.
+
+    - Corrected viscoelastic rheologies to properly account for a
+      nonzero initial strain tensor.
+
+
+======================================================================
 MIGRATING FROM VERSION 1.4 TO 1.5
 ======================================================================
 

Modified: short/3D/PyLith/trunk/doc/releasenotes/announce_v1.6.0.txt
===================================================================
--- short/3D/PyLith/trunk/doc/releasenotes/announce_v1.6.0.txt	2011-06-15 02:17:17 UTC (rev 18631)
+++ short/3D/PyLith/trunk/doc/releasenotes/announce_v1.6.0.txt	2011-06-15 03:31:22 UTC (rev 18632)
@@ -38,7 +38,8 @@
     which can be accessed directly from Matlab or indirectly from
     ParaView or Visit via automatically created Xdmf files. Temporal
     data is stored in 3-D arrays, permitting slicing in time and/or
-    space.
+    space. See examples/3d/hex8 Steps 6-9 and examples/2d/subduction
+    in the tutorials for examples.
 
  * 2-D generalized Maxwell viscoelastic bulk rheology
 
@@ -58,7 +59,8 @@
     Permits running larger problems through uniform global refinement
     of the mesh by a factor of 2 (reduces the node spacing by a factor
     of 2) after the mesh is distributed among processors. This allows
-    running problems that are 4x larger in 2-D and 8x larger in 3-D.
+    running problems that are 4x larger in 2-D and 8x larger in
+    3-D. See examples/3d/tet4 Steps 2 and 4 for examples.
   
  * Custom algebraic multigrid preconditioner
 
@@ -67,7 +69,8 @@
     spontaneous ruptures with algebraic multigrid preconditioning for
     quasi-static solutions. In most cases, this results in fewer
     iterations in the linear solve and the number of iterations
-    increases much less with problem size.
+    increases much less with problem size. See examples/3d/tet4 Steps
+    2 and 4 for examples.
 
   * PyLith installer utility