Changeset 4848

Timestamp:

Nov 22, 2007, 2:53:09 PM (17 years ago)

Author:

ole

Message:

Installation guide updated according to ticket:221

File:

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

anuga_core/documentation/user_manual/anuga_installation_guide.tex

@@ -68 +68 @@
 \begin{enumerate}  
  
-  \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 
+  \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 
+  (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 (Install in the order \code{enthon-python2.4-1.0.0.exe}, 
-    \code{ScientificPython-2.4.9.win32-py2.4.exe} and the unpack \code{netcdf-3.6.1-beta1-win32dll.zip} into \code{C:\\bin} as suggested below.
+    \item The supplied ANUGA distribution as under the folder pre_requisites 
+    (Install in the order \code{enthon-python2.4-1.0.0.exe}, 
+    \code{ScientificPython-2.4.9.win32-py2.4.exe} and the unpack 
+    \code{netcdf-3.6.1-beta1-win32dll.zip} into \code{C:\\bin} as 
+    suggested below.
     \item The WEB:
     \begin{itemize}  
-      \item Enthought version of Python2.4: \url{http://code.enthought.com/enthon/}.
+      \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: download the file netcdf-3.6.1-beta1-win32dll.zip from 
-      \url{http://www.unidata.ucar.edu/software/netcdf/binaries.html} (\url{ftp://ftp.unidata.ucar.edu/pub/netcdf/contrib/win32/netcdf-3.6.1-beta1-win32dll.zip}). Unpack this in a folder that is available on the system path. We suggest unpacking it into 
+      \url{http://www.unidata.ucar.edu/software/netcdf/binaries.html} 
+      (\url{ftp://ftp.unidata.ucar.edu/pub/netcdf/contrib/win32/netcdf-3.6.1-beta1-win32dll.zip}). 
+      Unpack this in a folder that is available on the system path. 
+      We suggest unpacking it into 
       \begin{verbatim} 
       C:\bin
@@ -95 +105 @@
   in the python site-packages 
   directory \code{C:$\backslash$Python24$\backslash$Lib$\backslash$site-packages}. This is often done in Windows by 
-  double clicking on the tgz file and then select 'browse to' the destination directory.
+  double clicking on the tgz file and then select 'browse to' the 
+  destination directory.
   \item In the ANUGA root directory (\code{C:$\backslash$Python24$\backslash$Lib$\backslash$site-packages$\backslash$anuga}), 
   run the compilation script (either from the commandline or by clicking on it):
@@ -101 +112 @@
         python compile_all.py
     \end{verbatim}}
-  \item In the ANUGA root directory, run the test suite (e.g. by opening it with IDLE 
-  and running the file)
+  \item In the ANUGA root directory, run the test suite 
+  (e.g. by opening it with IDLE and running the file)
     {\small \begin{verbatim}
         python test_all.py
     \end{verbatim}}
     ANUGA has been succesfully installed if the tests pass.
-  \item To verify that ANUGA succesfully reproduces a series of validation examples, go
-  to the directory \code{anuga_validation} and into \code{automated_validation_tests} in 
+  \item To verify that ANUGA succesfully reproduces a series of validation 
+  examples, go
+  to the directory \code{anuga_validation} and into 
+  \code{automated_validation_tests} in 
   which you can run
   {\small \begin{verbatim}
@@ -135 +148 @@
 
 Try the demos provided in the ANUGA directory \code{anuga\_demos} 
-(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.
+(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 run the ANUGA against the Okushiri Island wave tank validation dataset
@@ -158 +171 @@
 The ANUGA software core (shallow\_water, pmesh, least\_squares, ...) depends on the following software:
 \begin{itemize}
-  \item python 2.3 or later \url{http://www.python.org}/footnote{Note, the
+  \item python 2.3 or later\footnote{Problems have been observed with 
+  Python 2.5 and Numeric on 64 bit platforms. See 
+  \url{https://datamining.anu.edu.au/anuga/ticket/221}} 
+  \url{http://www.python.org}/footnote{Note, the
   dll python2X.dll is needed to compile ANUGA, but is not always
   automatically added for versions 2.4 and above.  Install it into the
@@ -173 +189 @@
 \end{itemize}
 
-Note: All of these can be installed in one go on Windows platforms by using the Enthought Python 
+Note: All of these can be installed in one go on Windows platforms by 
+using the Enthought Python 
 distribution available at \url{http://code.enthought.com/enthon/}.
 
@@ -190 +207 @@
 
 
-The system path on Win32 architectures must contain the directories (this examples assumes the 
-Enthought Python 2.4 distribution has been installed. Path names may vary depending on the 
+The system path on Win32 architectures must contain the 
+directories (this examples assumes the Enthought Python 2.4 distribution 
+has been installed. Path names may vary depending on the 
 exact configuration).
 \begin{verbatim}
@@ -198 +216 @@
 The path should be analoguous for Unix operating systems.
 
-If anuga is not installed in the python site-packages directory the root directory for all 
+If anuga is not installed in the python site-packages directory 
+the root directory for all 
 anuga/inundation modules must be on the pythonpath, e.g.\
 \begin{verbatim}