To obtain a copy of SUNTANS, you can either download the latest tarball
the suntans web page, or download the latest version from the cvs server
using the directions in Section 1.2. If you have a working key, you should
be able to download the latest source with
cvs checkout suntanswhich will download the following three directories (not including the
suntans/main: Contains the main source code and some examples in
suntans/mfiles: Some useful m-files for use with matlab.
suntans/papers: Contains this user guide.
tar xzvf suntans.tgz.
If you have the GNU C compiler installed (
gcc) you should be able to enter
compile SUNTANS with
makeOtherwise, you will need to specify the correct C compiler with the variable
suntans/main/Makefile. With an appropriate C compiler, the example in
suntans/main/examples/iwavesshould also compile without any further installation (after changing
suntans/main/examples/iwaves/Makefileif necessary). To run the example, enter that directory and type
make testThis will run an internal waves example on a one-dimensional grid of equilateral triangles. To view the results, return to
suntans/mainand compile the graphical user interface with
make sunplotThis will create the
sunplotexecutable, which can then be used to view the results of the internal waves example with
./sunplot --datadir=examples/iwaves/dataNote: This GUI requires the existence of the
Xliblibraries and it is assumed that these are located in
/usr/X11R6. Make sure the
XLIBDIRvariables are specified correctly in the
sunplotdoes not compile.
In order to run the other examples (as described in Section 6), the grid generation package Triangle  must be installed, and to run them in parallel, the message-passing interface (MPI) and the parallel graph partitioning libraries (ParMetis ) must be installed. Instructions for downloading and installing these packages are available from the individual websites for each package:
MPINote that you must compile the triangle libraries as object files by making them with