[cig-commits] [commit] knepley/upgrade-petsc-interface: More work on release notes. (b8f09f2)

[cig_noreply at geodynamics.org]

Repository : ssh://geoshell/pylith

On branch  : knepley/upgrade-petsc-interface
Link       : https://github.com/geodynamics/pylith/compare/ab65d9444d780a462a1282b0cf6048c4743e6d88...b8f09f2dec2e4531e4a15d949bbaccc5a5bdd760

>---------------------------------------------------------------

commit b8f09f2dec2e4531e4a15d949bbaccc5a5bdd760
Author: Brad Aagaard <baagaard at usgs.gov>
Date:   Fri Feb 14 09:53:35 2014 -0800

    More work on release notes.


>---------------------------------------------------------------

b8f09f2dec2e4531e4a15d949bbaccc5a5bdd760
 README                               |   8 +++
 doc/releasenotes/announce_v2.0.0.txt | 114 ++++++++++++++++++++++++++++-------
 2 files changed, 101 insertions(+), 21 deletions(-)

diff --git a/README b/README
index 3574724..7abe270 100644
--- a/README
+++ b/README
@@ -121,8 +121,16 @@ Version 2.0.0
 * Several small improvements to various sections of the manual based
   on feedback and questions from users.
 
+  - Added more information about the workflow involved in using PyLith.
+
   - Added a discussion of how to set scales for nondimensionalization.
 
+  - Added a discussion of how the stable time step is computed for the
+    various materials.
+
+  - Updated and expanded the discussion of using initial state
+    variables.
+
 * Bug fixes
 
   - Fixed two MPI related bugs in computing Green's functions in
diff --git a/doc/releasenotes/announce_v2.0.0.txt b/doc/releasenotes/announce_v2.0.0.txt
index a5289cd..41ea8d1 100644
--- a/doc/releasenotes/announce_v2.0.0.txt
+++ b/doc/releasenotes/announce_v2.0.0.txt
@@ -4,14 +4,12 @@ I am pleased to announce the release of PyLith 2.0.0, a finite-element
 code designed to solve dynamic elastic problems and quasi-static
 viscoelastic problems in tectonic deformation.
 
-This release fixes several bugs in PyLith v1.8.0. We strongly recommend
-all users of previous PyLith releases switch to this latest
-release.
+This release fixes several bugs in PyLith v1.9.0 and contains major
+under-the-hood improvements. We strongly recommend all users of
+previous PyLith releases switch to this latest release.
 
-No changes are needed in .cfg files to switch from v1.8.0 to
-v2.0.0. Version 2.0.0 does includes some changes to the friction and
-material model interfaces, so extensions do require changes. See the
-templates for details.
+A few small changes are needed in .cfg files to switch from v1.9.0 to
+v2.0.0. 
 
 You can download the source code and binaries from
 
@@ -22,29 +20,100 @@ User Manual with detailed building instructions for a few platforms in
 the INSTALL file bundled with the PyLith Installer utility.
 
 
+======================================================================
+MIGRATING FROM VERSION 1.9 TO 2.0
+======================================================================
+
+Changes to various C++ objects permitted simplifying the specification
+of a number of components. The map below indicates the name changes.
+
+  CellFilterAvgMesh -> CellFilterAvg
+  DataWriterVTKMesh -> DataWriterVTK
+  DataWriterVTKSubMesh -> DataWriterVTK
+  DataWriterVTKSubSubMesh -> DataWriterVTK
+  DataWriterHDF5Mesh -> DataWriterHDF5
+  DataWriterHDF5SubMesh -> DataWriterHDF5
+  DataWriterHDF5SubSubMesh -> DataWriterHDF5
+  DataWriterHDF5ExtMesh -> DataWriterHDF5Ext
+  DataWriterHDF5ExtSubMesh -> DataWriterHDF5Ext
+  DataWriterHDF5ExtSubSubMesh -> DataWriterHDF5Ext
+
+  Running the script:
+
+    bash $PYLITH_DIR/doc/developer/update_1.9to2.0.sh
+
+  will update all .cfg files in the current directory and all
+  subdirectories with the new names (you will need to replace
+  $PYLITH_DIR with the directory containing the PyLith source code).
+
+
+PyLith allows use of the Chaco and ParMetis/Metis partitioners. The
+name of the ParMetis/Metis partitioner was changed from "parmetis" to
+"metis".
+
+  [pylithapp.mesh_generator]
+  distributor.partitioner = metis
+
+======================================================================
 RELEASE NOTES - PyLith v2.0.0
+======================================================================
+
+* Replaced C++ Sieve implementation of finite-element data structures
+  with C DMPlex implementation.
+
+  DMPlex provides a simpler, more efficient implementation of the
+  finite-element data structures that conforms to the PETSc data
+  management (DM) interface. This provides tighter integration with
+  the rest of PETSc. Additionally, this rewrite of the data structures
+  results in a more efficient memory layout, resulting in better
+  performance.
 
-* New features
+* Switched from using Subversion to Git for version control.
 
-  * Added Newton-Raphson algorithm for spontaneous rupture simulations
-    with explicit-stepping.
+  The source code repository changed from a CIG maintained Subversion
+  repository to a Git repository at Github.com. The URL for the Git
+  repository is https://github.com/geodynamics/pylith. The installer
+  has been updated accordingly.
 
-    Enforcing the friction criterion in a spontaneous rupture
-    simulation with explicit time-stepping now uses a Newton-Raphson
-    algorithm to find the correct traction increment. This provides a
-    more stable numerical solution and eliminates oscillatory behavior
-    when using rate-state friction. 
+* Added ability to recursively refine a mesh.
 
-    Added SCEC spontaneous rupture benchmark TPV102 to the benchmark
-    repository. PyLith produces results very similar to several other
-    finite-element codes.
+  Global uniform refinement can now be done recursively. Each
+  refinement reduces the vertex spacing by a factor of two. Using more
+  than one level of refinement should be done carefully as the mesh
+  quality will generally deteriorate with more levels of refinement.
+
+* Directories for output are created as necessary.
+
+  Directories where output files are written will be created if
+  necesary. Previously, the directories would not be created, so that
+  opening the output files in a nonexistent directory would generate
+  an error.
+
+* Improved error messages.
+
+  Error messages originating in PETSc will include a stack trace that
+  includes both PyLith and PETSc code. Previously, only the PETSc code
+  was included. This provides significantly more information for
+  debugging.
+
+* Several small improvements to various sections of the manual based
+  on feedback and questions from users.
+
+  - Added more information about the workflow involved in using PyLith.
+
+  - Added a discussion of how to set scales for nondimensionalization.
+
+  - Added a discussion of how the stable time step is computed for the
+    various materials.
+
+  - Updated and expanded the discussion of using initial state
+    variables.
 
 * Bug fixes
 
   - Fixed two MPI related bugs in computing Green's functions in
     parallel. The number of impulses corresponded to only those on
-    process 0 and the output of the impulses for vertices on processor
-    boundaries was inconsistent.
+    process 0.
 
   - Corrected computation of fault tractions (Lagrange multipliers) on
     process boundaries for prescribed slip with explicit time stepping.
@@ -60,5 +129,8 @@ RELEASE NOTES - PyLith v2.0.0
 
   - Corrected two typos in the manual related to fault opening and
     tractions in examples/3d/hex8/step20 and updating to the use of
-    cell.dimension for the quadrature scheme with tetrahedral cells.
+    cell.dimension for the quadrature scheme with tets.
+
+  - Fixed stable time step computed for power-law viscoelastic
+    rheology to match manual.