[cig-commits] r4291 - mc/3D/CitcomS/trunk/doc/manual

[tan2 at geodynamics.org]

Author: tan2
Date: 2006-08-15 11:43:34 -0700 (Tue, 15 Aug 2006)
New Revision: 4291

Modified:
   mc/3D/CitcomS/trunk/doc/manual/citcoms.lyx
Log:
Fixed various typos/inconsistency/errors
Added some comments (started with 'tan2:')                                      


Modified: mc/3D/CitcomS/trunk/doc/manual/citcoms.lyx
===================================================================
--- mc/3D/CitcomS/trunk/doc/manual/citcoms.lyx	2006-08-15 14:02:10 UTC (rev 4290)
+++ mc/3D/CitcomS/trunk/doc/manual/citcoms.lyx	2006-08-15 18:43:34 UTC (rev 4291)
@@ -3983,14 +3983,8 @@
 \begin_inset Formula $10^{5}$
 \end_inset
 
- and perturbation on the initial temperature field which has a degree
-\begin_inset Formula $^{3}$
-\end_inset
-
- and an order
-\begin_inset Formula $^{2}$
-\end_inset
-
+ and perturbation on the initial temperature field which has a degree-3
+ and an order-2
  pattern, after 100 time steps, the convection pattern remains relatively
  steady.
 \end_layout
@@ -4213,8 +4207,9 @@
 \end_inset
 
 ).
- In addition, to determine the temperature, the temperature field associated
- only with this imposed velocity, reset the initial perturbation to zero
+
+In addition, the initial temperature field has a linear conductive profile.
+ The amplitude of horizontal temperature perturbation is set to zero
  using the 
 \family typewriter
 solver.ic
@@ -4436,10 +4431,10 @@
 Cookbook\InsetSpace ~
 2: \InsetSpace ~
 Velocity\InsetSpace ~
-boundary\InsetSpace ~
-conditions.
- This model highlights a region of the overall sphere and the heated upwellings
- (warm colors), downwellings (cool colors), and the even distribution of
+Boundary\InsetSpace ~
+Conditions.
+ This model highlights a region of the sphere and the heated upwellings
+ (warm colors), downwellings (cool colors), and
  the velocities (yellow arrows).
 \end_layout
 
@@ -4453,18 +4448,17 @@
 \end_layout
 
 \begin_layout Standard
-Using OpenDX to visualize the results 
+Using OpenDX to visualize the results (Figure 
 \begin_inset LatexCommand \ref{fig:Cookbook-2:-Velocity}
 
 \end_inset
-
-, this model allows you to create a plate-model of convection in which there
+), this model allows you to create a plate-driven convection in which there
  is a thermal upwelling on one wall, a thermal downwelling on another, and
  uniform horizontal velocity across the top.
  The downwelling is not exactly subduction because the default boundary
  conditions are close to zero shear stress on the boundaries.
  This means that there is a symmetrical downwelling in a vertical domain
- on the other side, which gives rise to symmetrical downwelling.
+ on the other side.
  
 \end_layout
 
@@ -4827,11 +4821,10 @@
 \begin_layout Caption
 Cookbook\InsetSpace ~
 3:\InsetSpace ~
-Velocity\InsetSpace ~
-Boundary\InsetSpace ~
-Conditions.
+Temperature-Dependent\InsetSpace ~
+Viscosity.
  This model highlights a region that features both the heated upwelling
- (warm colors) and the even distribution of the velocities (dark gray arrows).
+ (warm colors) and the even distribution of the velocities (arrows).
 \end_layout
 
 \end_inset
@@ -4850,7 +4843,7 @@
 \begin_layout Standard
 Frequently for convection problems, particularly those with variable viscosity,
  there are features with strong gradients in temperature or viscosity that
- can be better resolved with retired meshes.
+ can be better resolved with refined meshes.
  For example, for the problem just studied in Cookbook 3, temperature-dependent
  viscosity, a higher resolution is required for a narrow hot upwelling while
  a lower resolution is sufficient for the wider cold downwelling.
@@ -4873,7 +4866,7 @@
 \family default
  to 
 \family typewriter
-ON (solver.mesher.coor=on)
+on (solver.mesher.coor=on)
 \family default
  in order to read the uneven mesh point coordinates from an input file (such
  as 
@@ -4885,50 +4878,8 @@
 \family typewriter
 coor_file
 \family default
-, is as follows: the file is an ASCII file with only one column, with each
- line for each mesh point, separated in three parts.
- Each part corresponds to the coordinates in the colatitude (in radians
- between 
-\family typewriter
-theta_min
-\family default
- and 
-\family typewriter
-theta_max
-\family default
-), longitude (in radians between 
-\family typewriter
-fi_min
-\family default
- and 
-\family typewriter
-fi_max
-\family default
-) and radial (non-dimensional between 
-\family typewriter
-radius_inner
-\family default
- and 
-\family typewriter
-radius_outer
-\family default
-) directions.
- The number of entries within each part must correspond exactly to the number
- of entries for the other parts.
- Also, each part has a header as follows: 
-\family typewriter
-nsd=1
-\family default
-, 
-\family typewriter
-nsd=2
-\family default
- and 
-\family typewriter
-nsd=3
-\family default
- for colatitude, longitude and radial direction respectively.
- 
+, is described in Appendix B, Coordinate files.
+(tan2: Sue, can you please cross-reference the above line?)
 \end_layout
 
 \begin_layout Subsection
@@ -5284,6 +5235,7 @@
 \end_layout
 
 \begin_layout Caption
+(tan2: Sue, can you put the correct caption title "Cookbook 4: Regionally Refined Mesher"?)
 Cookbook\InsetSpace ~
 4: This model shows the temperature (upwelling -- warm colors, downwelli
 ng -- cool colors) and the uneven distribution of the velocities (yellow
@@ -5348,7 +5300,7 @@
  centered along the equator, with two different Euler poles (see Figure
  
 \begin_inset LatexCommand \ref{fig:Global-Model-"Caps":}
-
+(tan2: Sue, please change the link to figure 5.7)
 \end_inset
 
 ).
@@ -5357,7 +5309,7 @@
  2 cm/yr for the right plate).
  After 30 Ma a pole jump occurred for the right slab only, so the Euler
  pole moved closer.
- Since we impose a top velocity boundary in our model, the following facilities
+ Since we impose a top velocity boundary in our model, the following parameters
  should be turned on: 
 \end_layout
 
@@ -5399,7 +5351,7 @@
 \end_layout
 
 \begin_layout Standard
-Since the starting age is set to 55 Ma, there will be 56 velocity files,
+Since the starting age is set to 55 Ma, there will be 57 velocity files,
  one for each Ma (
 \family typewriter
 vel.dat0, vel.dat1,...vel.dat55, vel.dat56
@@ -5421,7 +5373,7 @@
 There will be as many lines as the total number of nodes for the top plane
  (
 \family typewriter
-n_theta * n_fi
+nodex*nodey
 \family default
 ).
  
@@ -5793,10 +5745,13 @@
 
 \end_layout
 
+(tan2: Sue, please insert caption title: "Suduction Models", also please
+ move up the figure to section 5.6.2)
 \begin_layout Caption
 Cookbook\InsetSpace ~
 5: Left (A): initially, both plates have Euler poles (magenta and
- green dots) situated far apart, so the velocities are approximate constants
+ green dots) situated far apart from the plate, so the velocities
+ are approximate constants
  (about 5 cm/yr for the left plate and about 2 cm/yr for the right plate).
  Right (B): after 30 Ma a pole jump occurred for the right slab only, so
  the Euler pole moved closer.
@@ -5892,7 +5847,7 @@
 \end_layout
 
 \begin_layout Enumerate
-On the nodes of the top surface, topography increment computed is by integrating
+On the nodes of the top surface, topography increment is computed by integrating
  normal velocity over time.
  
 \end_layout
@@ -5955,11 +5910,11 @@
 \end_layout
 
 \begin_layout Itemize
-tsolver.fixed_timestep=7.770000e-10 (= ~1000 yrs)
+solver.tsolver.fixed_timestep=7.770000e-10 (= ~1000 yrs)
 \end_layout
 
 \begin_layout Itemize
-vsolver.BC.pseudo_free_surf=on/off
+solver.bc.pseudo_free_surf=on/off
 \end_layout
 
 \begin_layout Itemize
@@ -11451,11 +11406,7 @@
 
 \end_inset
 
-CitComS,
-\family typewriter
- retrieve
-\family default
- Output File Format
+CitComS Output File Format
 \end_layout
 
 \begin_layout Section*
@@ -11467,7 +11418,7 @@
 \end_layout
 
 \begin_layout Section*
-Postprocessed Output
+Postprocessed Cap Output
 \end_layout
 
 \begin_layout Standard