This directory contains the routines and plotting scripts necessary to
produce the results for the tsunami computation, shown in the paper:

(1)	Wave Propagation Software, Computational Science, and Reproducible
        Research, by R.J. LeVeque.
	To appear in the Proceedings of the International Congress of
	Mathematicians, Madrid, 2006.

--------------------------------------------------------------
Here is a brief description of the contents of this directory:
--------------------------------------------------------------

1. The parent directory, tc_ICM/, contains several fortran routines
necessary for the compilation of xtsunami---the executable that runs the
tsunami computation. It also contains input data files and several matlab
plotting scripts, as well as more documentation---TsunamiClawDoc.pdf
and clawuser.pdf---for the tsunamiclaw and clawpack software.

2. The subdirectory tc_ICM/Bath/ contains the large ascii text bathymetry
files necessary for the computation.

3. The subdirectory tc_ICM/lib/ contains library fortran routines
necessary to make the executable---xtsunami.

4. The subdirectory tc_ICM/matlab/ contains a library of Matlab
plotting routines (.m scripts) that are the standard clawpack plotting
routines. Specialized scripts for plotting with 'TsunamiClaw,' and
producing the figures in (1) are in the parent directory, tc_ICM/.

-------------------------------------------------------------------------
Running  'xtsunami' This is a brief description of
how to make and run 'xtsunami.' For more detailed
information, please read the enclosed TsunamiClawDoc.pdf
-------------------------------------------------------------------------

1. Compile the library fortran routines into object files, necessary for
making the executable xtsunami. To do this, cd into tc_ICM/lib, and type
"make" at the propt.

2. Compile the executable: from the parent directory tc_ICM/, type
"make xtsunami"

3. To run the executable, type "./xtsunami" at the prompt.

4. The results will be output to the files fort.tXXXX and fort.qXXXX. (see
the standard documentation for more details.)


--------------------------------------------------------------
Plotting the results with Matlab
-------------------------------------------------------------

1. Make sure that the subdirectory tc_ICM/matlab is in your matlab path.
If you are a clawpack user, you can also use the standard Clawpack
plotting routines.

2. To ensure that the specialized TsunamiClaw plotting routines are used
(which have the same name as several standard clawpack routines), make
sure that your current directory is higher on your Matlab path than
the clawpack plotting scripts. (This is the standard default behavior
of Matlab).

3. From the Matlab prompt, run "plotclaw2." Answer "yes" when
prompted about setplot2. Follow the on-screen instructions. For
more information see the standard documentation included.
--------------------------------------------------------------

David George June 23, 2006.  dgeorge@amath.washington.edu