Preamble:
********

The accompanying programs are free software; you can redistribute them
and/or modify them under the terms of the GNU General Public
License as published by the Free Software Foundation; either version
2, or (at your option) any later version.

These programs are distributed in the hope that they will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with these programs (see the file GPL.txt); if not, write to 
the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, 
MA 02111-1307, USA.

Contents of this directory:
**************************

This directory should contain the following files and directories:

ch-muse.pdf
input/
Makefile
output/
_README.current
_README.orig
src/

To run the code:
***************

Type "make" to compile ch, the main executable. 
Type "make ch.gif" to compile ch, run it, and create an animated gif of the decomposition process
Type "make clean" for cleaning
Type "make veryclean" for aggressive cleaning

Contents of the input/ directory:
********************************

composition_information
constants
system_size
time_information

Contents of the output/ directory:
*********************************

At the end of a run, the output directory would contain:

input_data_test_information
README
gif files corresponding to visualization of the sample at various times

Contents of the src/ directory:
******************************

cahn_hilliard.c
evolve.c
snapshot.c
test_input_data.c

cahn_hilliard.c is the main file. It reads the inputs, tests them by
calling the function "test_input_data.c", and, evolves the microstructure
by calling "evolve.c". The function evolve.c calls "snapshot.c"
to generate gif files visualizing the microstructure.