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