Installation of the Viewer on Ubuntu

NOTE Ubuntu 14.04

At present (June 2014) the packaged version of openscenegraph is missing the plugin for working with freetype fonts. This causes an error when running the viewer. We don't have a simple work around at present. The following instructions work well for earlier versions of Ubuntu.

Packages to Install

Install the following packages.

sudo apt-get install libopenscenegraph-dev libgdal-dev make subversion 

Download the Code

The latest version of the code is available from googlecode. Don't use the version on sourceforge.

From your home directory, download the anuga viewer code via

svn checkout http://anuga-viewer.googlecode.com/svn/trunk/ anuga-viewer

Change into the new directory anuga-viewer. From this directory build and install the viewer via

make
sudo make install

Finally we need to setup some environment variables.

Put the following in your .bashrc file (if you use the bash shell).

export SWOLLEN_BINDIR=/home/******/anuga-viewer/bin
export PATH=$PATH:$SWOLLEN_BINDIR

where you should replace ***** by the name of your home directory. With some versions of linux you need to put this command in the file .profile

You should rerun your .bashrc file with

source .bashrc

Actually it is usually safer to fire up a new terminal to see if you have been successful in setting up the PATH and SWOLLEN_BINDIR

You can check your PATH with the command

printenv PATH

Check Installation

Change into the anuga-viewer/data directory and run the anuga_viewer via the command

anuga_viewer cairns.sww

Hopefully the viewer fires up and you will see a simple flow. Use the space bar to start the visualisation.