[cig-commits] r16513 - doc/snac

[echoi at geodynamics.org]

Author: echoi
Date: 2010-04-08 18:16:31 -0700 (Thu, 08 Apr 2010)
New Revision: 16513

Modified:
   doc/snac/snac.lyx
Log:
Added a subsection for GNU Scientific Library as a requirment package.



Modified: doc/snac/snac.lyx
===================================================================
--- doc/snac/snac.lyx	2010-04-08 22:21:05 UTC (rev 16512)
+++ doc/snac/snac.lyx	2010-04-09 01:16:31 UTC (rev 16513)
@@ -1,4 +1,4 @@
-#LyX 1.6.4.1 created this file. For more info see http://www.lyx.org/
+#LyX 1.6.2 created this file. For more info see http://www.lyx.org/
 \lyxformat 345
 \begin_document
 \begin_header
@@ -2634,6 +2634,10 @@
 Libxml2
 \end_layout
 
+\begin_layout Itemize
+GNU Scientific Library
+\end_layout
+
 \begin_layout Standard
 MPI installations are typically configured for a particular compiler, and
  provide a special wrapper command to invoke the right compiler.
@@ -2780,11 +2784,7 @@
 \begin_layout Standard
 We highly recommend that you set up the environment variables that allow
  StGermain to use MPI.
- 
-\end_layout
-
-\begin_layout Standard
-This is done by setting the following environment variables so the VMake
+ This is done by setting the following environment variables so the VMake
  build system knows where to find MPICH.
 \end_layout
 
@@ -2902,6 +2902,52 @@
 \end_layout
 
 \begin_layout Subsection
+GNU Scientific Library
+\end_layout
+
+\begin_layout Standard
+GNU Scientific Library (GSL) is a numerical library for C and C++ programmers
+ (see 
+\begin_inset CommandInset href
+LatexCommand href
+name "http://www.gnu.org/software/gsl"
+target "http://www.gnu.org/software/gsl/"
+
+\end_inset
+
+).
+ SNAC needs this library for remeshing.
+ The Superconvergent Patch Recovery (SPR) method (Zienkiewicz and Zhu, 1992)
+ is used to transfer element-based variables from an old mesh to a new one
+ and, since based on least square optimization, this method requires a matrix
+ inversion.
+ So, GSL's linear algebra routines are utilized in SNAC's remesher plugin.
+ Although remesher is a plugin, it is expected to be used in most geodynamic
+ applications.
+ Also, the use of GSL will be expanded in the future development.
+ So, GSL has become a requirment.
+\end_layout
+
+\begin_layout Standard
+SNAC's build scripts will be able to find and link it if the library is
+ installed in a standard location.
+ But if it is installed locally, one should define an environment variable,
+ 
+\family typewriter
+GSL_DIR
+\family default
+, as follows:
+\end_layout
+
+\begin_layout LyX-Code
+In bash: export GSL_DIR="/home/raq/opt/gsl" 
+\end_layout
+
+\begin_layout LyX-Code
+In tcsh: setenv GSL_DIR /home/raq/opt/gsl
+\end_layout
+
+\begin_layout Subsection
 Other Environment Variables
 \end_layout