README

Introduction
------------
This module contains a f95 implementation of the exact solutions for 
isothermal ice sheet models developed by Ed Bueler et al [1]. The f95 code
is based on their matlab code which is included in this module with their 
agreement.

Prerequisites
-------------
You will need a recent installation of GLIMMER [2]. If you want to produce
the images you will also need PyCF which you can also get from the GLIMMER
website and its dependencies.

Compilation
-----------
./configure --with-glimmer-prefix=DIR_WHERE_GLIMMER_IS_INSTALLED
make

Running the Test Suite
----------------------
Running the entire test suite for all resolutions takes quite some time. If 
you are willing to wait you can just run
make png
in the tests directory. Alternatively, you can run individual tests using the
run_verif.py script. Run "run_verif.py -h" for a list of options.

Licensing
---------
The code is licensed under the GNU General Public Licence. A copy of the GPL
is included in this module. See the file COPYING.


References
----------
[1] E. Bueler, C. S. Lingle, J. A. Kallen-Brown, D. N. Covey, L. N. Bowman 
(2005) "Exact solutions and numerical verification for isothermal ice sheets,"
J. Glaciol. 51 (no. 173), 291--306.

[2] http://glimmer.forge.nesc.ac.uk/