[cig-commits] r5839 - in long/3D/Gale/trunk: . documentation

walter at geodynamics.org walter at geodynamics.org
Fri Jan 19 13:19:24 PST 2007 

Author: walter
Date: 2007-01-19 13:19:23 -0800 (Fri, 19 Jan 2007)
New Revision: 5839

Modified:
   long/3D/Gale/trunk/
   long/3D/Gale/trunk/documentation/gale.lyx
Log:
 r1455 at earth:  boo | 2007-01-19 13:15:27 -0800
 Fixes to the manual



Property changes on: long/3D/Gale/trunk
___________________________________________________________________
Name: svk:merge
   - 3a629746-de10-0410-b17b-fd6ecaaa963e:/cig:1449
   + 3a629746-de10-0410-b17b-fd6ecaaa963e:/cig:1455

Modified: long/3D/Gale/trunk/documentation/gale.lyx
===================================================================
--- long/3D/Gale/trunk/documentation/gale.lyx	2007-01-19 20:14:41 UTC (rev 5838)
+++ long/3D/Gale/trunk/documentation/gale.lyx	2007-01-19 21:19:23 UTC (rev 5839)
@@ -985,10 +985,28 @@
 input/cookbook/template.xml
 \family default
 ) to create customized input files.
- Unless otherwise specified, when we say to add something, that text should
- be added after the line
+ Unless otherwise specified, when we say to add something
+\begin_inset Foot
+status collapsed
+
+\begin_layout Standard
+To copy and paste from this PDF with Adobe Acrobat, right click to get the
+ context menu and select 
+\begin_inset Quotes sld
+\end_inset
+
+Allow Hand Tool to Select Text
+\begin_inset Quotes srd
+\end_inset
+
+.
 \end_layout
 
+\end_inset
+
+, that text should be added after the line
+\end_layout
+
 \begin_layout LyX-Code
 <struct name="components">
 \end_layout
@@ -1037,6 +1055,19 @@
 \end_layout
 
 \begin_layout Standard
+First, copy 
+\family typewriter
+template.xml
+\family default
+ to 
+\family typewriter
+myviscous.xml
+\family default
+ and edit that.
+ 
+\end_layout
+
+\begin_layout Standard
 The first thing we have to do is add in a material.
  The simplest variety is a purely viscous material.
  So we add a box covering the whole domain
@@ -1160,6 +1191,11 @@
 
 \begin_layout Standard
 Save this file, as it will be the basis for many other examples.
+ You can compare your result with the worked example in the file 
+\family typewriter
+input/cookbook/viscous.xml
+\family default
+.
 \end_layout
 
 \begin_layout Subsection
@@ -1173,15 +1209,57 @@
 \begin_layout Standard
 This input file is valid, but there are no dynamics.
  Gale will complain if you try to run it.
- So we also make the right boundary move by changing the line in the right
- 
+\end_layout
+
+\begin_layout Standard
+First, copy 
 \family typewriter
-WallVC
+myviscous.xml
 \family default
- struct near the end of the file from
+ to 
+\family typewriter
+myviscous_extension.xml
+\family default
+.
 \end_layout
 
+\begin_layout Standard
+We make the right boundary move by changing the line after 
+\end_layout
+
 \begin_layout LyX-Code
+<param name="type">WallVC</param>
+\end_layout
+
+\begin_layout LyX-Code
+<param name="wall">right</param>
+\end_layout
+
+\begin_layout LyX-Code
+<list name="variables">
+\end_layout
+
+\begin_layout LyX-Code
+  <struct>
+\end_layout
+
+\begin_layout LyX-Code
+    <param name="name">vx</param>
+\end_layout
+
+\begin_layout LyX-Code
+    <param name="type">double</param>
+\end_layout
+
+\begin_layout LyX-Code
+
+\end_layout
+
+\begin_layout Standard
+from
+\end_layout
+
+\begin_layout LyX-Code
 <param name="value">0.0</param>
 \end_layout
 
@@ -1194,15 +1272,55 @@
 \end_layout
 
 \begin_layout Standard
+Be careful! There are several 
+\family typewriter
+WallVC
+\family default
+ structs: 
+\family typewriter
+front
+\family default
+, 
+\family typewriter
+back
+\family default
+, 
+\family typewriter
+left
+\family default
+, 
+\family typewriter
+right
+\family default
+, 
+\family typewriter
+top
+\family default
+ and 
+\family typewriter
+bottom
+\family default
+.
+ Only modify 
+\family typewriter
+right.
+\end_layout
+
+\begin_layout Standard
 We can now run this example, and the output will go into the directory 
 \family typewriter
 output.template
 \family default
 .
+ If we want to run in 3D, we only need to change the line after
 \end_layout
 
+\begin_layout LyX-Code
+<param name="outputPath">./output.template</param> 
+\end_layout
+
 \begin_layout Standard
-If we want to run in 3D, we need only change the line
+from
 \end_layout
 
 \begin_layout LyX-Code
@@ -1217,6 +1335,14 @@
 <param name="dims">3</param>
 \end_layout
 
+\begin_layout Standard
+A worked example is in 
+\family typewriter
+input/cookbook/myviscous-example.xml
+\family default
+.
+\end_layout
+
 \begin_layout Subsection
 Viscous Material with Complex Boundaries
 \end_layout
@@ -1264,7 +1390,15 @@
 \end_layout
 
 \begin_layout Standard
-So we modify the bottom boundary condition to
+First, copy 
+\family typewriter
+myviscous_extension.xml
+\family default
+ to 
+\family typewriter
+myviscous_split.xml
+\family default
+, then modify the bottom boundary condition to
 \end_layout
 
 \begin_layout LyX-Code
@@ -1357,6 +1491,36 @@
 <param name="StepFunctionLessThan">False</param>
 \end_layout
 
+\begin_layout Standard
+to the end of the file (just before 
+\family typewriter
+</StGermain
+\family default
+Data
+\family typewriter
+>
+\family default
+).
+ Do not add it in the list named 
+\family typewriter
+
+\begin_inset Quotes sld
+\end_inset
+
+variables
+\begin_inset Quotes srd
+\end_inset
+
+
+\family default
+.
+ A worked example is in the file 
+\family typewriter
+input/cookbook/viscous_split.xml
+\family default
+.
+\end_layout
+
 \begin_layout Subsection
 Viscous Material with Inflow/Outflow Boundaries
 \end_layout
@@ -1404,12 +1568,21 @@
 \end_layout
 
 \begin_layout Standard
-Taking the input file we created in section 
+To start, copy the file 
+\family typewriter
+myviscous.xml
+\family default
+ that we created in section 
 \begin_inset LatexCommand \ref{sub:Viscous-Material}
 
 \end_inset
 
-, first we need to tell Gale to keep the left and bottom sides fixed, no
+ to 
+\family typewriter
+myviscous_inflow.xml
+\family default
+.
+ Then, we need to tell Gale to keep the left and bottom sides fixed, no
  matter what, by adding the lines
 \end_layout
 
@@ -1426,19 +1599,7 @@
 \family typewriter
 wrapTop
 \family default
- in the 
-\family typewriter
-velocityRemesher
-\family default
- struct in the 
-\family typewriter
-EulerDeform
-\family default
- struct (
-\family typewriter
-EulerDeform
-\family default
- comes after the list of components, but before the boundary conditions).
+.
 \end_layout
 
 \begin_layout Standard
@@ -1491,7 +1652,11 @@
 \end_layout
 
 \begin_layout Standard
-and add the variables
+and add the variables at the end of the file (just before 
+\family typewriter
+</StGermain/Data>
+\family default
+)
 \end_layout
 
 \begin_layout LyX-Code
@@ -1571,7 +1736,11 @@
 \end_layout
 
 \begin_layout Standard
-and add the variables
+and add the variables to the end of the file (just before 
+\family typewriter
+</StGermainData>
+\family default
+)
 \end_layout
 
 \begin_layout LyX-Code
@@ -1598,6 +1767,14 @@
 <param name="StepFunctionProduct2Value">-1.0</param>
 \end_layout
 
+\begin_layout Standard
+A worked example is in the file 
+\family typewriter
+input/cookbook/viscous_inflow.xml
+\family default
+.
+\end_layout
+
 \begin_layout Subsection
 Viscous Material with Stress Boundaries
 \end_layout
@@ -1645,13 +1822,22 @@
 \end_layout
 
 \begin_layout Standard
-Again, taking the input file we created in section 
+Again, copy the file 
+\family typewriter
+myviscous.xml
+\family default
+ that we created in section 
 \begin_inset LatexCommand \ref{sub:Viscous-Material}
 
 \end_inset
 
-, we need only add a 
+ to 
 \family typewriter
+myviscous_stressbc.xml
+\family default
+.
+ We add a 
+\family typewriter
 StressBC
 \family default
  component
@@ -1690,7 +1876,11 @@
 \end_layout
 
 \begin_layout Standard
-and corresponding variables
+and corresponding variables to the end of the file (just before 
+\family typewriter
+</StGermainData>
+\family default
+)
 \end_layout
 
 \begin_layout LyX-Code
@@ -1705,6 +1895,14 @@
 <param name="StepFunctionProduct1Value">1.0</param>
 \end_layout
 
+\begin_layout Standard
+A worked example is in the file 
+\family typewriter
+input/cookbook/viscous_stressbc.xml
+\family default
+.
+\end_layout
+
 \begin_layout Subsection
 \begin_inset LatexCommand \label{sub:Viscous-Initially-Deformed}
 
@@ -1714,8 +1912,7 @@
 \end_layout
 
 \begin_layout Standard
-All of the examples we so far have started out as a regular rectangular
- box.
+All of the previous examples are set up as a regular rectangular box.
  However, Gale can also start with the top initially deformed.
  A simple example is to make it sinusoidal as in Figure 
 \begin_inset LatexCommand \ref{fig:Sinusoidal-Top}
@@ -1757,8 +1954,17 @@
 \end_layout
 
 \begin_layout Standard
-To create this example, we simply add a 
+To create this example, copy 
 \family typewriter
+myviscous.xml
+\family default
+ to 
+\family typewriter
+myviscous_sinusoid.xml
+\family default
+.
+ Then add a 
+\family typewriter
 SurfaceAdaptor
 \family default
  component to the input file from section 
@@ -1814,7 +2020,12 @@
 \end_layout
 
 \begin_layout Standard
-This example has no moving boundaries, so the material will simply relax
+This example has no moving boundaries, so the material will simply relax.
+ A worked example is in 
+\family typewriter
+input/cookbook/viscous_sinusoid.xml
+\family default
+.
 \end_layout
 
 \begin_layout LyX-Code
@@ -1867,14 +2078,27 @@
 \end_layout
 
 \begin_layout Standard
-Starting from the simple extension input file (Section 
+Copy 
+\family typewriter
+myviscous_extension.xml
+\family default
+ (see Section 
 \begin_inset LatexCommand \ref{sub:Viscous-Extension}
 
 \end_inset
 
-), we first need to create the sphere.
+) to 
+\family typewriter
+mymulti_material.xml
+\family default
+.
+ 
 \end_layout
 
+\begin_layout Standard
+First we create the sphere.
+\end_layout
+
 \begin_layout LyX-Code
 <struct name="sphereShape">
 \end_layout
@@ -1900,7 +2124,7 @@
 \end_layout
 
 \begin_layout Standard
-Then add the new material.
+Then we add the new material.
 \end_layout
 
 \begin_layout LyX-Code
@@ -1990,12 +2214,12 @@
 \end_layout
 
 \begin_layout Standard
-Finally, we replace the original viscous material's shape with this new
- 
+Finally, we modify the original viscous material to use this new 
 \family typewriter
 nonSphereShape
 \family default
 .
+ So we change the line after 
 \end_layout
 
 \begin_layout LyX-Code
@@ -2006,34 +2230,30 @@
   <param name="Type">RheologyMaterial</param>
 \end_layout
 
-\begin_layout LyX-Code
-  <param name="Shape">nonSphereShape</param>
+\begin_layout Standard
+from 
 \end_layout
 
 \begin_layout LyX-Code
-  <param name="density">1.0</param>
+<param name="Shape">boxShape</param>
 \end_layout
 
-\begin_layout LyX-Code
-  <list name="Rheology">
+\begin_layout Standard
+to
 \end_layout
 
 \begin_layout LyX-Code
-    <param>backgroundViscosity</param>
+<param name="Shape">nonSphereShape</param>
 \end_layout
 
-\begin_layout LyX-Code
-    <param>storeViscosity</param>
+\begin_layout Standard
+A worked example is in 
+\family typewriter
+input/cookbook/multi_material.xml
+\family default
+.
 \end_layout
 
-\begin_layout LyX-Code
-  </list>
-\end_layout
-
-\begin_layout LyX-Code
-</struct>
-\end_layout
-
 \begin_layout Subsection
 Yielding Material in Simple Extension
 \end_layout
@@ -2041,8 +2261,17 @@
 \begin_layout Standard
 We can make the previous example more interesting by replacing the background
  viscous material with a yielding material.
- First we create a 
+ First we copy 
 \family typewriter
+mymulti_material.xml
+\family default
+ to 
+\family typewriter
+myyielding.xml
+\family default
+.
+ Then we create a 
+\family typewriter
 StrainWeakening
 \family default
  component and a 
@@ -2145,11 +2374,49 @@
 \end_layout
 
 \begin_layout Standard
-Finally, we replace the existing viscous 
+Finally, we remove the existing viscous 
 \family typewriter
 RheologyMaterial
-\family default
- with a yielding 
+\end_layout
+
+\begin_layout LyX-Code
+<struct name="viscous">
+\end_layout
+
+\begin_layout LyX-Code
+  <param name="Type">RheologyMaterial</param>
+\end_layout
+
+\begin_layout LyX-Code
+  <param name="Shape">nonSphereShape</param>
+\end_layout
+
+\begin_layout LyX-Code
+  <param name="density">1.0</param>
+\end_layout
+
+\begin_layout LyX-Code
+  <list name="Rheology">
+\end_layout
+
+\begin_layout LyX-Code
+    <param>backgroundViscosity</param>
+\end_layout
+
+\begin_layout LyX-Code
+    <param>storeViscosity</param>
+\end_layout
+
+\begin_layout LyX-Code
+  </list>
+\end_layout
+
+\begin_layout LyX-Code
+</struct>
+\end_layout
+
+\begin_layout Standard
+and replace it with a yielding 
 \family typewriter
 RheologyMaterial
 \end_layout
@@ -2190,8 +2457,12 @@
 </struct>
 \end_layout
 
-\begin_layout LyX-Code
-
+\begin_layout Standard
+A worked example is in 
+\family typewriter
+input/cookbook/yielding.xml
+\family default
+.
 \end_layout
 
 \begin_layout Section

More information about the cig-commits mailing list