source: documentation/user_manual/anuga_installation_guide.tex @ 2363

\documentclass{report}
%\usepackage{url}

\newcommand{\url}{\texttt}  %Hack until \url is installed

\title{AnuGA Installation Guide}
\author{Howard Silcock, Ole Nielsen, Duncan Gray, Jane Sexton}

\setlength{\parindent}{0mm} %\setlength{\parskip}{3pt}
\setlength{\oddsidemargin}{0.6in}\setlength{\evensidemargin}{0.6in}
\addtolength{\textheight}{1in} \addtolength{\textwidth}{0.5in}
\setlength{\marginparwidth}{0in}
\setlength{\topmargin}{0mm}\setlength{\headheight}{0in}

\begin{document}
\maketitle


%Subversion keywords:
%
%$LastChangedDate: 2006-01-13 16:43:01 +1100 (Fri, 13 Jan 2006) $
%$LastChangedRevision: 2206 $
%$LastChangedBy: steve $

\section*{Introduction}

This document outlines the required software for installing the Anuga toolbox.
All components are licensed as open source and readily available from the net.



\subsection{Pre-requisites}

The Anuga software core (pyvolution, pmesh, least\_squares, ...) depends on the following:

\begin{itemize}  
  \item python 2.3 or later \url{http://www.python.org}
  \item python-numeric
  \item python-dev (Interestingly, numeric seems to be installed as well)
  \item python-scientific (to provide python-netcdf) \url{http://www-md.fsl.noaa.gov/eft/developer/netCDFPythonInterface.html} 
    (The file netcdf.dll shipped with python-scientific must be copied to a location somewhere on the system PATH - e.g.\ in C:\\bin)
  \item A C compiler such as gcc (from GNU in case of Linux and MinGW in case of Windows)
\end{itemize} 


\subsection{Recommended software}

\begin{itemize} 
  \item psyco \url{http://psyco.sourceforge.net/index.html}
  \item visual python \url{http://vpython.org}
  \item matplotlib (pylab) for quality 2d plotting
\end{itemize} 



\subsection*{Systom configuration}


The system path on Win32 architectures must contain the directories 
\begin{verbatim} 
  PATH=C:\Python24;C:\MinGW\bin;C:\Program Files\swollen
\end{verbatim}   
(similar for Linux....)

In addition the root directory for all anuga/inundation modules must be on the pythonpath, e.g.\
\begin{verbatim} 
PYTHONPATH=V:\1\cit\risk_assessment_methods_project\inundation\sandpits\onielsen\anuga\inundation
\end{verbatim}   

  
  



\subsection*{Installation}

(Explain how to check out from svn or obtain from elsewhere)


In directory inundation, run the compilation script:
{\small \begin{verbatim}
  python compile_all.py
\end{verbatim}}



\subsection{Testing}


In directory inundation, run the test suite:
{\small \begin{verbatim}
  python test_all.py
\end{verbatim}}




\section{Other stuff to be included}

\begin{verbatim} 
Install tortoise from downloads (IT`s didnt integrate wih explorer).
In settings set proxy to proxy.agso.gov.au  8080


Install swollen from latest distro (in subversion)


\end{verbatim} 
  



\end{document}