Install ANUGA on Ubuntu

Stephen Roberts edited this page Sep 12, 2016 · 8 revisions

The current development version of anuga now resides on github at anuga_core

Use apt-get to install git via:

sudo apt-get install git

Now from your home directory, use git to download the anuga source via:

git clone https://github.com/GeoscienceAustralia/anuga_core.git

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

Parallel Support

At this stage you can decide whether you want Parallel support or not. We support two versions of MPI, mpich and openmpi

Just during the setup stage, you should create an environment variable ANUGA_PARALLEL via:

export ANUGA_PARALLEL="openmpi"

or:

export ANUGA_PARALLEL="mpich"

then the install script will load the mpich or openmpi libraries and binaries respectively.

If you don't want parallel support set the variable to something else, e.g:

export ANUGA_PARALLEL="false"

Running the installation script

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.

Check Installation

To check the installation run the over 1200 unit tests (which should take 5 - 10 minutes) via:

python runtests.py

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.

What Next

Have a look at the examples in the directory anuga_core/examples and the user_manual in the anuga_core/doc directory 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 git command:

git pull

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