= Installing current version of ANUGA research code on Ubuntu  14.04 =


We need {{{subversion}}} to install {{{anuga}}}. 

Use {{{apt-get}}} to install subversion via

{{{
sudo apt-get install subversion
}}}

Now from your home directory, we can get the {{{anuga}}} source via

{{{
svn checkout https://anuga.anu.edu.au/svn/anuga/trunk/anuga_core anuga_core
}}}

q



== Packages to install ==

Install the following packages via the commands

{{{
sudo apt-get install subversion python-dev python-numpy python-scipy python-matplotlib netcdf-bin libnetcdf-dev libhdf5-serial-dev python-gdal  python-pip
}}}

Be sure that the version of {{{python}}} you are using is 2.7. This is the version for which we are developing. 

=== Pre Ubuntu 12.04 === 
Also need to install the following packages

{{{
sudo apt-get install python-argparse
sudo apt-get install python-profiler
}}}

=== Other Python Packages ===

We also need a few other python packages. We can use {{{pip}}} to install these via the command

{{{
sudo pip install nose netCDF4 pyproj
}}}

=== Parallel support ===

On {{{Linux}}} it is easy to setup parallel support. You can use either {{{mpich2}}} or {{{openmpi}}}. 

Here is the command to install {{{mpich2}}} support

{{{
sudo apt-get install mpich2
}}}

We interface {{{mpi}}} with {{{Python}}} via the {{{pypar}}} package. 

Download {{{pypar}}} with 

{{{
svn checkout https://github.com/daleroberts/pypar
}}}

and then change into the {{{pypar}}} directory and install, via
{{{
pushd pypar
python setup.py build
sudo python setup.py install
popd
}}}

== Installing anuga ==

Now we should have installed all the packages necessary to run anuga. 
So now to actually installing anuga. 

=== Checkout anuga via svn ===

First we need to get the actual anuga source code. We do this by checking out the anuga 
repository using subversion. 

From your home directory run:

{{{
svn checkout https://anuga.anu.edu.au/svn/anuga/trunk/anuga_core anuga_core
}}}

This should produce an anuga_core directory in your home directory


=== Compile ANUGA Code ===

Now go to the directory anuga_core and install via:

{{{
python setup.py build
sudo python setup.py install
}}}

=== Run Unit tests ===

From the anuga_core directory run the unit tests via:

{{{
python runtests.py
}}}

== Conclusion ==

Hopefully all the unit tests pass. As this is bleeding edge there are sometimes a small number of failures as this is a work in progress. Have a look at the demos in the directory anuga_core/documentation/user_manual/demos (along with the user manual) to see how to use anuga.

== Updating ==

From time to time you should update your version of anuga. This is fairly easy. From your {{{anuga_core}}} directory update the anuga code via the subversion command

{{{
svn update
}}}

Then again from the {{{anuga_core}}} directory recompile the code and check the unit tests via

{{{
python compile_all.py
python test_all.py
}}}