Changeset 7299


Ignore:
Timestamp:
Jul 3, 2009, 4:34:48 PM (15 years ago)
Author:
rwilson
Message:

Updated guide for new numpy release.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • anuga_core/documentation/user_manual/anuga_installation_guide.tex

    r6960 r7299  
    5757
    5858To run ANUGA you will need a Windows PC (XP or Vista) or a Linux PC with at
    59 least 512MB RAM.
     59least 512MB RAM.  As ANUGA is a memory-intensive numerical system, more memory is better than less.
    6060
    6161The viewer (Windows only) requires a graphics adapter that
     
    6464Intel(R) 82915G Express chipset family.
    6565
     66The instructions below are written for the numpy version of ANUGA.  ANUGA changed from
     67relying on the Numeric package to the numpy package early in July, 2009.  If you have a Numeric ANUGA,
     68you should refer to the installation instructions for that version.  The last Numeric version of
     69ANUGA had a build number of 7163.
     70
     71Where the text below refers to a specific package file such as \code{python-2.5.msi} you will find that
     72file in a download area linked through the \emph{numpy_support_software} link on the page
     73\url{https://datamining.anu.edu.au/anuga/wiki/NumpyInstall}.
     74
    6675
    6776\section{Installation}
    6877
    69 Below are the install procedures for Windows XP, Windows Vista and Linux.
    70 
    71 \subsection{Quick install - Windows XP}
     78Below are the install procedures for Windows XP, Windows Vista (both 32 bit) and Linux (32 and 64 bit).
     79
     80\subsection{Quick install - Windows XP (32 bit)}
    7281\label{sec:winxp}
    7382
    7483This procedure assumes that you do not have python installed on the target machine.
    7584If you do have a python installed already then skip the installation of python as
    76 long as you have version 2.3 or later installed.
    77 
    78 \begin{enumerate} 
    79   \item Install the support software.
    80     These packages are available from either:
    81     \begin{itemize}
    82       \item The supplied ANUGA distribution folder: \code{pre_requisites$\backslash$2.5}.
    83         Install in order:
     85long as you have version 2.5 or later installed.
     86
     87\begin{itemize} 
     88  \item Install the support software, in order.
     89    \begin{enumerate}
     90      \item Execute \code{python-2.5.4.msi} to install python.
     91
     92      \item Install MinGW from \code{MinGW-5.1.4.exe}.  Install components:
    8493        \begin{enumerate}
    85           \item Execute \code{python-2.5.msi} to install python.
    86           \item Execute \code{Numeric-23.8.2.win32-py2.5.exe} to install Numeric Python.
    87           \item Execute \code{ScientificPython-2.7.8.win32-py2.5.exe} to install Scientific Python.
    88           \item Execute \code{MinGW-5.1.4.exe} to install MinGW.
    89         \end{enumerate} and then unpack \code{netcdf-3.6.1-win32dll.zip} into a folder that is available on the system path.
    90         We suggest unpacking it into \code{C:$\backslash$bin}.
    91       \item The Internet. Install in order:
    92         \begin{enumerate} 
    93           \item \url{http://www.python.org/download/}. Click on the \code{Python 2.5.x Windows installer} link to get
    94             \code{python-2.5.x.msi}. Execute this file to install python.
    95           \item \url{http://sourcesup.cru.fr/frs/?group\%5Fid=180}. Download \code{Numeric-23.8.2.win32-py2.5.exe}
    96             and execute it to install Numeric Python.
    97           \item \url{http://sourcesup.cru.fr/frs/?group\%5Fid=180}. Download \code{ScientificPython-2.X.X.win32-py2.5.exe}
    98             and execute it to install Scientific Python.
    99           \item \url{http://sourceforge.net/project/showfiles.php?group\%5Fid=2435}. Click on the \code{Download} link for
    100             the \code{Automated MinGW Installer}.  Download and execute the file \code{MinGW-5.X.X.exe} to install the MinGW environment.
    101             Note that you need a working internet connection to install WinGW.
    102           \item \url{http://www.unidata.ucar.edu/software/netcdf/binaries.html}. Click on the
    103             \code{Windows DLL} link in the NetCDF 3.6.1 section.  This will download the file \code{netcdf-3.6.1-win32.zip}.
    104             Unpack this in a folder that is available on the system path.
    105             We suggest unpacking it into \code{C:$\backslash$bin}.
    106         \end{enumerate}   
    107     \end{itemize}   
     94          \item MinGW base tools
     95          \item g++ compiler
     96          \item MinGW Make
     97        \end{enumerate}
     98        Note that you will need an internet connection for the above install.
     99
     100      \item Execute \code{numpy-1.3.0-win32-superpack-python2.5.exe} to install numpy.
     101
     102      \item Execute \code{netCDF_binary_4.0.exe} to install NetCDF.
     103
     104      \item Execute \code{ScientificPython-2.9.0.win32-py2.5.exe} to install Scientific Python.
    108105 
    109   \item Add the following to the PATH environment variable:
    110     \begin{verbatim}PATH=C:\Python25;C:\MingW\bin;C:\bin\end{verbatim}
     106      \item Execute \code{matplotlib-0.98.5.2.win32-py2.5.exe} to install matplotlib.
     107    \end{enumerate}
     108 
     109  \item Add the following to the end of the PATH environment variable:
     110    \begin{verbatim};C:\Python25;C:\MingW\bin;C:\netcdf4\bin\end{verbatim}
    111111    For details on how to do this under Windows please refer to Appendix \ref{sec:setwindowspath}.
    112 
    113     Note that if you have another version of python installed, 2.4  say, you would replace any
    114     \code{Python25} above with \code{Python24}.
    115     A similar replacement should be made in all following steps wherever you see \code{Python25}.
    116 
     112\end{itemize} 
     113
     114\subsubsection{ANUGA Installation}
     115\label{sec:ANUGA}
     116
     117\begin{itemize} 
    117118  \item Unpack the ANUGA source code (\code{anuga-1.0_xxxx.tgz})\footnote{Internet Explorer has the habit of renaming the .tgz files to .gz -
    118119                                                                          the remedy is to rename them back or use another browser such as Firefox.}
     
    152153    \url{http://datamining.anu.edu.au/\%7Eole/anuga/user\%5Fmanual/anuga\%5Fuser\%5Fmanual.pdf})
    153154    and view the resulting \code{.sww} files with the ANUGA viewer.
    154 \end{enumerate}   
     155\end{itemize}   
    155156
    156157
     
    167168\label{sec:winvista}
    168169
    169 There has been one reported instance of ANUGA being installed successfully on Windows Vista.
    170 The following steps should be read in conjunction with the windows XP procedures above:
    171 
    172 \begin{enumerate} 
    173   \item Install \code{python-2.5.msi}.
    174   \item Add the directory \code{C:$\backslash$Python25} to the \code{PATH} environment variable (appendix \ref{sec:setwindowspath}).
    175   \item Install \code{Numeric-23.8.2.win32-py2.5.exe} (as administrator).
    176   \item Install \code{ScientificPython-2.7.8.win32-py2.5.exe} (as administrator).
    177   \item Install \code{MinGW-5.1.4.exe} (as administrator). Use the default package selection.  Don't use old packages and let it make fresh downloads.
    178   \item Unpack \code{netcdf-3.6.1-beta1-win32dll.zip} into \code{C:$\backslash$bin}.
    179   \item Add the directory \code{C:$\backslash$bin} to the \code{PATH} environment variable (appendix \ref{sec:setwindowspath}).
    180   \item Install \code{pysco-1.6.win32-py2.5.exe} (as administrator).
    181   \item Install \code{matplotlib-0.91.2.win32-py2.5.exe} (as administrator).
    182   \item Install \code{numpy-1.1.0-win32-superpack-python2.5.exe} (as administrator).
    183   \item Check that the system variable \code{PATH} contains
    184         \code{C:$\backslash$Python2.5;C:$\backslash$Python25$\backslash$DLLs;C:$\backslash$bin;C:$\backslash$MinGW$\backslash$bin}
    185         (appendix \ref{sec:setwindowspath}).
    186   \item Now follow the Windows XP install steps from the ANUGA source code install step.
    187 \end{enumerate}
    188 
    189 Some of the installed packages above are optional and may not be required, but this is the reported working install we have received.
     170The installation of the suuport software and the ANUGA software should be the same as for Windows XP above.
     171The installation and use of ANUGA under Windows Vista has not been heavily tested.  Feedback on any aspect
     172of using ANUGA under Vista is welcomed.
    190173
    191174\subsection{Quick install - Linux}
     
    197180The steps below assume that you do not have python installed on the target machine.
    198181If you do have a python installed already then skip the installation of python as
    199 long as you have version 2.3 or later.
     182long as you have version 2.5 or later.
    200183
    201184Note that even if you already have python installed you should still check if things like
    202185\code{python-dev} and \code{python-profiler} need to be installed.
    203186
    204 \begin{itemize}
    205   \item Install support software (in order):
    206     \begin{enumerate} 
    207       \item Install python development environment, either through Synaptic or by:
    208         \begin{verbatim}sudo apt-get install python python-dev python-profiler\end{verbatim}
    209       \item Install Numeric Python, either through Synaptic or by:
    210         \begin{verbatim}sudo apt-get install python-numeric\end{verbatim}
    211       \item Install Scientific Python, either through Synaptic or by:
    212         \begin{verbatim}sudo apt-get install python-scientific\end{verbatim}
    213       \item Install NetCDF, either through Synaptic or by:
    214         \begin{verbatim}sudo apt-get install python-netcdf\end{verbatim}
    215       \item Install \code{gcc} and its development environment if you don't have it, either through Synaptic or by:
    216         \begin{verbatim}sudo apt-get install gcc libc6-dev\end{verbatim}
    217         Ensure that \code{libc6-dev} is installed even if \code{gcc} is already installed.
    218     \end{enumerate}   
     187\subsubsection{Support Software - Linux 32 bit}
     188\label{sec:linux32bit}
     189
     190Install support software (in order):
     191\begin{enumerate} 
     192  \item Install the python development environment, either through Synaptic or by:
     193    \begin{verbatim}sudo apt-get install python python-dev python-profiler\end{verbatim}
     194    If you already have python 2.5 or later installed, don't include \code{python} above.
     195
     196  \item Install g++, either through Synaptic or by:
     197    \begin{verbatim}sudo apt-get install g++\end{verbatim}
     198
     199  \item Install the numpy package, either through Synaptic or by:
     200    \begin{verbatim}sudo apt-get install python-numpy\end{verbatim}
     201
     202  \item Install the NetCDF package from the .tar.gz file:
     203    \begin{verbatim}tar xzf netcdf.tar.gz
     204cd netcdf-4.0.1
     205./configure
     206make check
     207sudo make install
     208cd\end{verbatim}
     209
     210  \item Install the ScientificPython package from the .tar.gz file:
     211    \begin{verbatim}tar xzf ScientificPython-2.9.0.tar.gz
     212cd ScientificPython-2.9.0
     213python setup.py build --numpy
     214sudo python setup.py install
     215cd\end{verbatim}
     216
     217  \item Install matplotlib, either through Synaptic or by:
     218    \begin{verbatim}sudo apt-get install python-matplotlib\end{verbatim}
     219\end{enumerate}   
     220
     221\subsubsection{Support Software - Linux 64 bit}
     222\label{sec:linux64bit}
     223
     224Install support software (in order):
     225\begin{enumerate} 
     226  \item Install the python development environment, either through Synaptic or by:
     227    \begin{verbatim}sudo apt-get install python python-dev python-profiler\end{verbatim}
     228    If you already have python 2.5 or later installed, don't include \code{python} above.
     229
     230  \item Install g++, either through Synaptic or by:
     231    \begin{verbatim}sudo apt-get install g++\end{verbatim}
     232
     233  \item Define a CFLAGS value:
     234    \begin{verbatim}export CFLAGS=-fPIC\end{verbatim}
     235
     236  \item Install the numpy package, either through Synaptic or by:
     237    \begin{verbatim}sudo apt-get install python-numpy\end{verbatim}
     238
     239  \item Install the NetCDF package from the .tar.gz file:
     240    \begin{verbatim}tar xzf netcdf.tar.gz
     241cd netcdf-4.0.1
     242./configure
     243make check
     244sudo make install
     245cd\end{verbatim}
     246
     247  \item Install the ScientificPython package from the .tar.gz file:
     248    \begin{verbatim}tar xzf ScientificPython-2.9.0.tar.gz
     249cd ScientificPython-2.9.0
     250python setup.py build --numpy
     251sudo python setup.py install
     252cd\end{verbatim}
     253
     254  \item Install matplotlib, either through Synaptic or by:
     255    \begin{verbatim}sudo apt-get install python-matplotlib\end{verbatim}
     256\end{enumerate}   
     257
     258\subsubsection{ANUGA Installation - 32 or 64 bit}
     259\label{sec:ANUGA32-64bit}
     260
     261\begin{enumerate} 
    219262  \item Get the ANUGA source from \url{http://sourceforge.net/projects/anuga} (\code{anuga-1.0_5789.tgz} say),
    220263    and expand it into the python site-packages directory \code{/usr/lib/python2.5/site-packages}.
    221264    In the unpacked ANUGA directory \code{/usr/lib/python2.5/site-packages/anuga} run the command:
    222265    \begin{verbatim}sudo python compile_all.py\end{verbatim}
     266
    223267  \item In the ANUGA root directory (\code{/usr/lib/python2.5/site-packages/anuga})
    224268    run the test suite:
    225269    \begin{verbatim}python test_all.py\end{verbatim} ANUGA has been succesfully installed if the tests pass.
     270
    226271  \item To verify that ANUGA succesfully reproduces a series of validation examples, go
    227272    to the directory
     
    231276    \begin{verbatim}python validate_all.py\end{verbatim}
    232277    This may take some time.
    233 
    234 \end{itemize}
     278\end{enumerate}
    235279
    236280\section{Optional but recommended software}
    237281This software is not required to run the ANUGA toolbox, but it is recommended.
    238282\begin{itemize}
    239   \item psyco. Speeds up ANUGA by about 30\%. Under Ubuntu install either through Synaptic or by:
     283  \item psyco. Speeds up ANUGA by about 30\%, so is strongly recommended.
     284    Under Ubuntu install either through Synaptic or by:
    240285    \begin{verbatim}sudo apt-get install python-psyco\end{verbatim}
    241286    Under Windows install the file \code{psyco-1.6.win32-py25.exe}
    242     which you can find from the \url{http://psyco.sourceforge.net/download.html} page.
    243   \item matplotlib. For quality 2d plotting (moving towards mandatory requirement). Under Ubuntu install either through Synaptic or by:
    244     \begin{verbatim}sudo apt-get install python-matplotlib\end{verbatim}
    245     Under Windows install the file \code{matplotlib-0.98.3.win32-py2.5.exe}
    246     which you can find from the \url{http://sourceforge.net/projects/matplotlib} page.
     287    which you can find on the \url{http://psyco.sourceforge.net/download.html} page.
     288
    247289  \item VTK. The Visualization Toolkit. Under Ubuntu install either through Synaptic or by:
    248290    \begin{verbatim}sudo apt-get install python-vtk\end{verbatim}
    249     Under Windows install the file \code{vtk-5.2.0-win32.exe}
    250     from the \url{http://www.vtk.org/get-software.php} page.
     291    Under Windows install the file \code{vtk-5.4.2-win32.exe}
     292    from the \url{http://www.vtk.org/VTK/resources/software.html} page.
    251293\end{itemize}
    252294
Note: See TracChangeset for help on using the changeset viewer.