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

== Install {{{Subversion}}} ==

We need {{{subversion}}} (or {{{git}}}) to install {{{anuga}}}. 

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

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

== Install {{{anuga}}} ==

Now from your home directory, use subversion to download the {{{anuga}}} source via

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

We need to install a fairly large number of packages, but we a script ({{{tools/install_ubuntu.sh}}}) which will run through the installation process for you. 

Change into the newly downloaded {{{anuga_core}}} directory and run the installation script (this will take 5 to 10 minutes depending on your network connection)

{{{
cd anuga_core
bash tools/install_ubuntu.sh
}}}

If all has been successful then {{{anuga}}} should be installed.

To check the installation 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 build and install the code and check the unit tests via

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