Changeset 3921 for anuga_core/documentation/user_manual/anuga_installation_guide.tex

Timestamp:

Nov 6, 2006, 5:39:10 PM (17 years ago)

Author:

ole

Message:

Updated installation guide

File:

• anuga_core/documentation/user_manual/anuga_installation_guide.tex (modified) (5 diffs)

anuga_core/documentation/user_manual/anuga_installation_guide.tex

@@ -52 +52 @@
 
 \begin{enumerate}  
-  \item Download and install the Enthought version of Python2.4 from \url{http://code.enthought.com/enthon/}.
-  \item Download and install Scientific Python: \url{http://sourcesup.cru.fr/frs/download.php/745/ScientificPython-2.4.9.win32-py2.4.exe}\footnote{This step will become unneccesary once Enthought sorts out netcdf support (see https://svn.enthought.com/enthought/ticket/917)}.
-  
-  %NETCDF ftp://ftp.unidata.ucar.edu/pub/netcdf/contrib/win32/netcdf-3.6.1-beta1-win32dll.zip
-  %Separate Scientific Python: http://sourcesup.cru.fr/frs/download.php/745/ScientificPython-2.4.9.win32-py2.4.exe
+ 
+  \item Install Python pre-requisites: The Enthought version of Python2.4, Scientific Python 
+  and the NetCDF library\footnote{Separate installation of Scientific Python and NetCDF 
+  will become unneccesary once Enthought sorts out netcdf support 
+  (see \url{https://svn.enthought.com/enthought/ticket/917})}. These are available from either 
+  \begin{itemize} 
+    \item The supplied ANUGA distribution as under the folder pre_requisites
+    \item The WEB:
+    \begin{itemize}  
+      \item Enthought version of Python2.4: \url{http://code.enthought.com/enthon/}.
+      \item Scientific Python: \url{http://sourcesup.cru.fr/frs/download.php/745/ScientificPython-2.4.9.win32-py2.4.exe}
+      \item NETCDF \url{ftp://ftp.unidata.ucar.edu/pub/netcdf/contrib/win32/netcdf-3.6.1-beta1-win32dll.zip}
+    \end{itemize}   
+  \end{itemize}   
   
   \item Add the following to the PATH environment variable
@@ -62 +71 @@
       PATH=C:\Python24;C:\Python24\Enthought\MingW\bin;C:\Program Files\anuga_viewer
     \end{verbatim} 
-  \item Unpack the ANUGA source code (anuga.tgz) in the python site-packages 
-  directory (C:\Python24\Lib\site-packages)
-  \item In the ANUGA root directory (C:\Python24\Lib\site-packages\anuga), run the compilation script:
+  \item Unpack the ANUGA source code (\code{anuga-1.0_xxxx.tgz}) 
+  in the python site-packages 
+  directory \code{C:\\Python24\\Lib\\site-packages}
+  \item In the ANUGA root directory (\code{C:\\Python24\\Lib\\site-packages\\anuga}), 
+  run the compilation script (either from the commandline or by clicking on it):
     {\small \begin{verbatim}
         python compile_all.py
@@ -77 +88 @@
 To install the anuga\_viewer
 \begin{enumerate} 
-  \item Unpack the distribution () in 
+  \item Unpack the distribution (\code{anuga_viewer_1.0.tgz}) in 
     \begin{verbatim} 
-      C:\Program Files\anuga_viewer
+      C:\Program Files
     \end{verbatim}
   \item Associate .sww files with the executable
@@ -91 +102 @@
 \end{enumerate} 
 
-Try the demos provided in the ANUGA root directory (also discussed in the ANUGA user manual 
+Try the demos provided in the ANUGA root directory 
+(also discussed in the ANUGA user manual available with the distribution and also at 
 \url{http://datamining.anu.edu.au/~ole/anuga/user_manual/anuga_user_manual.pdf}) and 
 view the resulting sww files with the anuga\_viewer.
 
-
-
+To verify that the installed version of ANUGA validates satisfactorily
+against the Okushiri Island wave tank validation dataset
+(\url{http://www.cee.cornell.edu/longwave/index.cfm?page=benchmark&problem=2})
+unpack the distribution (\code{anuga_validation_1.0_xxxx.tgz}) into
+any directory and run the scripts \code{create_okushiri.py},
+\code{run_okushiri.py} and \code{compare_timeseries.py}.  See also the
+\code{README.txt} file that comes with the validation scripts for more
+details.
+
+
+
+\clearpage
 \section{Pre-requisites}
 \label{sec:prerequisites}
 
-The Anuga software core (shallow\_water, pmesh, least\_squares, ...) depends on the following:
+This and the following sections is for custom installations and installations using Linux.
+
+The ANUGA software core (shallow\_water, pmesh, least\_squares, ...) depends on the following:
 
 
@@ -156 +180 @@
 \section{Installation of source zip file}
 Get a source zip file, for example, anuga_source_3807.zip, and expand
-it in the python site-packages directory (C:\Python24\Lib\site-packages)
-
-In the ANUGA root directory (C:\Python24\Lib\site-packages\anuga), run the compilation script:
+it in the python site-packages directory (\code{C:\\Python24\\Lib\\site-packages})
+
+In the ANUGA root directory (\code{C:\\Python24\\Lib\\site-packages\\anuga}), 
+run the compilation script:
 {\small \begin{verbatim}
   python compile_all.py