+------------------------------------+
|             HBTprogs               |
|           version 1.0              |
|                                    |
|       UCRL-CODE-2002-032           |
|                                    |
|    authors: David A. Brown         |
|             Pawel Danielewicz      |
|                                    |
+------------------------------------+

This is the README file for a set of programs 
that we developed to invert angle averaged 
correlation functions.  

You are free to use and modify the codes, we 
only ask that you reference either the manual 
or references [1,2,3] in any publications using 
results obtained with these codes.  You may 
not commercialize any of the code.  Please see 
the NOTICE1 file for more information.

We are not responsible for any misuse 
of these codes.  If you have any questions, 
comments, suggestions or bug fixes regarding 
the programs or the documentation, please 
contact David Brown at brown170@llnl.gov or 
Pawel Danielewicz at danielewicz@nscl.msu.edu.

+-----------------------------------------------+
QUICKSTART

  To install and use the codes, you will need
  tar, gzip, make, sh, f77, and CERNLIB

 1) set the environment variable CERNLIB to the 
    path to the CERNLIB files libmathlib.a and
    libpacklib.a
 2) unpack the tarball:
      % gunzip HBTprogs.tar.gz
      % tar xf HBTprogs.tar
 3) run configure:
      % ./configure
 4) do a make install:
      % make install
 5) read the manual in doc/
 6) rerun the example in doc/example/

+-----------------------------------------------+
IF YOU HAVE PROBLEMS

If you have problems, there are two immediate 
sources of information:  
 1) The INSTALL file which discribes the various
    options of the configure script
 2) The manual doc/HBTmanual.ps
 
If this doesn't help, contact David Brown.  His
contact information is listed in the AUTHORS 
file.

+-----------------------------------------------+
REFERENCES 

[1] David A. Brown and Pawel Danielewicz.
    Imaging of sources in heavy-ion reactions.
    Phys. Lett. B, 398:252--258, 1997.

[2] David A. Brown and Pawel Danielewicz.
    Optimized discretization of sources imaged
    in heavy-ion reactions.
    Phys. Rev. C, 57(5):2474--2483, May 1998.
    
[3] David A. Brown and Pawel Danielewicz.
    Observing non-Gaussian sources in heavy-ion reactions.
    Phys. Rev. C 64: 014902 (2000).