This is the run directory for making GASpAR runs
quickly using canned scripts. There should be
two subdirectories:

build: where the objects of the build will be placed
data:  grid data location

Also, there are scripts for 4 test problems (*.csh), 
and the run data for each problem (*.dat). [One might 
legitimately ask why the run data isn't contained in 
the 'data' subdirectory.... For canned problems, this 
was deemed easiest.]

To run a problem, type 

> make
> ./gauss_test.csh

Note: This build removes all compiler optimizations, 
since these are compiler-dependent. Also, if at
run-time a shared object (.so) file cannot be found,
the shell in which the code is run (e.g. within the
run shell script), may have to set the following
environment variable, e.g. for csh or tcsh:

setenv LD_LIBRARY_PATH <location of .so's>

The codes compiled by default above run the adaptive
Gaussian sphere test, described in the User's Guide 
(../doc/user_guide.pdf(ps). The User's Guide also
describes in Chapter 2 how to run the other canned
problems, and also how to set up a problem of your 
own.

The 4 scripts that run the canned problems are:

(1) gauss_test.csh (BURGERS)--default
(2) nwave_test.csh (BURGERS)
(3) heat_test.csh  (BURGERS)
(4) kov_test.csh   (NS)

In parantheses are provided the solver used for the problem.
The default solver is BURGERS. To run the 'kov_test.csh'
script, the code must use the NS solver. The user may
change this by editing the ./build/makefile, to set
SOLVER=NS, instead of SOLVER=BURGERS. 

To run a different problem, the user must overwrite the
'guser.cpp' and 'guser.h' files in the ../src/user
directory with one of the named 'guser_*/cpp', and
associated 'guser_*.h' files. These files have 
names comparable to the script that makes the runs.

After either the SOLVER type or the 'guser'
file has been changed, the user must then return to 
the ./test directory and type

> make clean
> make

before running the associated script. The details of the
output and the required data are provided in the User's
Guide.
