= 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.