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 apart from this README
file:

CH-muSE.out
GPL.txt
headers/
input/
Makefile
output/
src/

Except for Makefile, GPL.txt, and CH-muSE.out (which is an executable), all 
the others are directories. If you find any .o files, type "make clean".

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

Type "make" to compile. Note that the compilations are carried out
with the "-Wall" option of gcc. So, it might spew lots of warning
messages. If you do not want the warnings and want make to be silent, 
type "make -s" or "make --silent". 

"a.out" will run the code. It might be a better idea to run the code
in the background: This you can do using "nohup ./a.out &".

Contents of the headers/ directory:
**********************************

functions.h - For global declaration of the function prototypes

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
ps and binary data files corresponding to various times

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

cahn_hilliard.c
evolve.c
psfile_generator.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 "psfile_generator"
to generate the microstructures.

---

Copyright (c) 2003 Computational Materials Science Laboratory,
Department of Metallurgy, Indian Institute of Science, Bangalore 
560 012. INDIA.