-------------------------------------------------------------------------------
This README file is Copyright (c) 1994 Christopher W. Churchill
See the COPYRIGHT file which must be in this directory for details.
-------------------------------------------------------------------------------

This directory structure contains the HAMSCATT software and supporting
software necessary for linking and executing the echelle spectrograph
illumination correction algorithms described in the paper by Churchill
and Allen (PASP 1994, submitted).

-------------------------------------------------------------------------------

Terms of distribution, modification, and usage are described in the COPYRIGHT 
file.  The contents and directory structure are outlined in the CONTENTS file.
Directions on how to build this utility are presented in the INSTALL file.

-------------------------------------------------------------------------------

The FORTRAN 77 code HAMSCATT must be compiled and linked in the IRAF environ-
ment using the 'fc' command.  The required libraries are the IRAF IMFORT 
library (described by Tody URL=ftp://iraf.tuc.noao.edu/iraf/docs/imfort.ps) 
and a portion of the NETLIB SLATEC library (URL=http://www.netlib.org).  The
former library is not included in this distribution; the required subset of
SLATEC is included in this distribution.  

In particular, the included SLATEC files are all that is needed to execute 
dnls1.f, the least squares solver called by HAMSCATT.  The machine constants 
have been set for Sun 4 systems.  If you are running a different machine, you 
will need to comment/uncomment the appropriate data blocks in the files: 
d1mach.f, i1mach.f, r1mach.f.  Failure to do so will result in bogus con-
vergence conditions from dnls1.f.

-------------------------------------------------------------------------------

(not yet available)
An IRAF cl script is provided as an interface during run time, so that one 
remains in the IRAF environment once the utility is built.  This script
queries for model input and output, manages temporary intermediate files,
and pipes various steps into a continuous invisible process.  However,
HAMSCATT is not interactive in its present form.

-------------------------------------------------------------------------------

HAMSCATT written at the University of California, Santa Cruz under the
auspices of the Board of Astronomy and Astrophysics while Churchill
was a graduate student.

Contact Information:
Chris Churchill
Department of Astronomy
New Mexico State University
email: cwc[at]nmsu[dot]edu
-------------------------------------------------------------------------------