[cig-commits] r15493 - doc/CitcomS/manual

[tan2 at geodynamics.org]

Author: tan2
Date: 2009-07-31 14:36:25 -0700 (Fri, 31 Jul 2009)
New Revision: 15493

Modified:
   doc/CitcomS/manual/citcoms.lyx
Log:
- Added notes about backward incompatibility in v3.1.1
- Explained the convergence criterion of Stokes solver.


Modified: doc/CitcomS/manual/citcoms.lyx
===================================================================
--- doc/CitcomS/manual/citcoms.lyx	2009-07-31 19:58:11 UTC (rev 15492)
+++ doc/CitcomS/manual/citcoms.lyx	2009-07-31 21:36:25 UTC (rev 15493)
@@ -107,7 +107,7 @@
 \begin_inset Newline newline
 \end_inset
 
-Version 3.1.0
+Version 3.1.1
 \end_layout
 
 \begin_layout Date
@@ -726,7 +726,7 @@
  Other enhancements includes: Allowing tracers in global model with nproc
  > 2 by changing the mesh slightly; The convergence of Stokes solver is
  controlled by parameter ``accuracy'' in [CitcomS.solver.vsolver].
- ``tole_compressibility'' is not used anymore.
+ ``tole_compressibility'' and ``relative_err_accuracy'' are not used anymore.
  Also, the norms of div(u), u, and p are no longer dependent on the grid
  size; Adding self-gravitational effect on geoid and adding Consistent-Boundary-
 Flux (CBF) method to compute dynamic topography, contributed by Shijie Zhong;
@@ -754,6 +754,28 @@
  and ``rheol'' options.
 \end_layout
 
+\begin_layout Standard
+Some of the aforementioned features are backward-incompatible, including:
+ 1) The global mesh is changed.
+ The coordinates of all nodes are shifted laterally slightly.
+ The change is not discernible by eyes, but does affect the solution compared
+ to previous versions.
+ 2) The convergence criterion of the Stokes solver is changed.
+ A single parameter ``accuracy'' is used to control the accuracy of the
+ continuity and momentum equations.
+ The default value of ``accuracy'' was 
+\begin_inset Formula $10^{-6}$
+\end_inset
+
+ and is now 
+\begin_inset Formula $10^{-4}$
+\end_inset
+
+.
+ 3) The input parameter ``mantle_temp'' is moved from [CitcomS.solver.param]
+ to [CitcomS.solver.ic] section.
+\end_layout
+
 \begin_layout Section
 About Pyre
 \end_layout
@@ -11442,6 +11464,28 @@
 p
 \family default
 .
+ The convergence of Stokes solver is achieved if either 1) 
+\family typewriter
+div/v 
+\family default
+is less than
+\family typewriter
+ accuracy
+\family default
+ or 2) both 
+\family typewriter
+dv/v
+\family default
+ and 
+\family typewriter
+dp/p
+\family default
+ are less than 
+\family typewriter
+accuracy
+\family default
+ for two consecutive iterations.
+ In this example, the second condition is met.
 \end_layout
 
 \begin_layout LyX-Code