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

Wed Aug 20 15:23:01 PDT 2008

Author: brad
Date: 2008-08-20 15:23:01 -0700 (Wed, 20 Aug 2008)
New Revision: 12689

Added:
   short/3D/PyLith/trunk/doc/releasenotes/announce_v1.3.0.txt
Modified:
   short/3D/PyLith/trunk/README
Log:
Added release annoucement for v1.3.0. Updated README for v1.3.

Modified: short/3D/PyLith/trunk/README
===================================================================

--- short/3D/PyLith/trunk/README	2008-08-20 21:48:26 UTC (rev 12688)
+++ short/3D/PyLith/trunk/README	2008-08-20 22:23:01 UTC (rev 12689)
@@ -1,4 +1,4 @@
-We are pleased to announce release of PyLith version 1.2.0.
+We are pleased to announce release of PyLith version 1.3.0.
 
 Please submit bug reports via the World Wide Web at:
     http://geodynamics.org/roundup    
@@ -8,15 +8,14 @@
 
 PyLith is free software.  See the file COPYING for copying conditions.
 
-This release allows the solution of both quasi-static and dynamic  
-problems in one, two, or three dimensions, and represents a complete  
-rewrite of the original PyLith. The code runs in either serial or  
-parallel mode, and the design allows for relatively easy scripting  
-using the Python programming language. Material properties and  
-parameters for boundary and fault conditions are specified using a  
-spatial database, which permits easy prescription of complex spatial  
-variations of properties and parameters. Simulation parameters are  
-generally specified through the use of simple ASCII files or the  
+This release allows the solution of both quasi-static and dynamic
+problems in one, two, or three dimensions. The code runs in either
+serial or parallel mode, and the design allows for relatively easy
+scripting using the Python programming language. Material properties
+and parameters for boundary and fault conditions are specified using a
+spatial database, which permits easy prescription of complex spatial
+variations of properties and parameters. Simulation parameters are
+generally specified through the use of simple ASCII files or the
 command line.
 
 You can download the source code and binaries from
@@ -35,6 +34,15 @@
 
 
 ======================================================================
+MIGRATING FROM VERSION 1.2 TO 1.3
+======================================================================
+
+The implementation of different options for controlling the time step
+requires adjusting input parameters from those used with PyLith
+1.2. The time stepping is not specified under the time-stepping
+formulation rather than the problem (i.e., one level deeper).
+
+======================================================================
 MIGRATING FROM VERSION 1.1 TO 1.2
 ======================================================================
 
@@ -95,6 +103,35 @@
 
 
 ----------------------------------------------------------------------
+Version 1.3
+----------------------------------------------------------------------
+
+  * New time stepping options
+
+    In addition to a uniform, user-specified time step, which is the
+    default, there are two new time-stepping options. The user may
+    supply a file with nonuniform time steps or, for quasi-static
+    simulations, the user can request the code to compute the time
+    step automatically. For the current bulk constitutive models, the
+    automatically determined time step is independent of the
+    deformation rate, so it is uniform.
+
+  * Initial stresses
+
+    Users may optionally supply an initial stress state for each
+    material via a spatial database. The initial stress state can
+    balance the gravitational body forces so that the model is in
+    equilibrium without any deformation. This implementation of an
+    initial stress state is a prelude to specifying an initial state
+    for each material, which will be available in a future release.
+
+  * Bug fixes
+
+    - Fixed labeling of physical properties in output for the Maxwell
+      viscoelastic and generalized Maxwell viscoelastic materials (mu
+      and lambda were switched).
+
+----------------------------------------------------------------------
 Version 1.2
 ----------------------------------------------------------------------
 

Added: short/3D/PyLith/trunk/doc/releasenotes/announce_v1.3.0.txt
===================================================================
--- short/3D/PyLith/trunk/doc/releasenotes/announce_v1.3.0.txt	                        (rev 0)
+++ short/3D/PyLith/trunk/doc/releasenotes/announce_v1.3.0.txt	2008-08-20 22:23:01 UTC (rev 12689)
@@ -0,0 +1,55 @@
+Greetings,
+
+I am pleased to announce the release of PyLith 1.3.0, a finite-element
+code designed to solve dynamic elastic problems and quasi-static
+viscoelastic problems in tectonic deformation.
+
+This release adds two new time stepping options (nonuniform
+user-specified and automatic constitutive model controlled) and
+permits specification of an initial stress state. This release also
+includes some minor improvements to the Sieve implementation, fixes
+one bug, and corrects typos in the manual and installation
+instructions. We encourage all users of previous PyLith releases to
+switch to this latest release.
+
+You can download the source code and binaries from
+
+    http://geodynamics.org/cig/software/packages/short/pylith
+
+Installation instructions are in the bundled README and INSTALL  
+files, as well as in the User Manual on the web page.
+
+
+RELEASE NOTES
+
+  * Time stepping options
+
+    In addition to a uniform, user-specified time step, which is the
+    default, there are two new time-stepping options. The user may
+    supply a file with nonuniform time steps or, for quasi-static
+    simulations, the user can request the code to compute the time
+    step automatically. For the current bulk constitutive models, the
+    automatically determined time step is independent of the
+    deformation rate, so it is uniform.
+
+  * Initial stresses
+
+    Users may optionally supply an initial stress state for each
+    material via a spatial database. The initial stress state can
+    balance the gravitational body forces so that the model is in
+    equilibrium without any deformation. This implementation of an
+    initial stress state is a prelude to specifying an initial state
+    for each material, which will be available in a future release.
+
+  * Bug fixes
+
+    - Fixed labeling of physical properties in output for the Maxwell
+      viscoelastic and generalized Maxwell viscoelastic materials (mu
+      and lambda were switched).
+
+MIGRATING FROM VERSION 1.2 TO 1.3
+
+  The implementation of different options for controlling the time
+  step requires adjusting input parameters from those used with PyLith
+  1.2. The time stepping is not specified under the time-stepping
+  formulation rather than the problem (i.e., one level deeper).

