CRUSH 1.62 Setup For UNIX Environments:
=======================================


1. CRUSH will try to use java in your path. If you want it to use a 
different version of Java, then modify the JAVA variable in 'setup.sh':

	JAVA={Your-Java-Path}/java

You'll need Java 1.5.0 or newer.

A note of warning! Some linux distributions (e.g. Fedora) come with the GNU
java compiler installed by default. I have found this version of java rather
buggy. It can cause all sorts of problems while running CRUSH. I recommend 
that you get Java from SUN (java.sun.com) or IBM instead. Those versions are
a lot more stable!

2. Edit crush.cfg change RAW_DATA_PATH to point to the directory containing
SHARC2 scan data, and REDUCED_MAP_PATH to point to the directory where you 
wish to place files generated by the reduction. Alternatively, you can place
these keywords (or others) into a file named .crush inside your home directory.
This allows localized settings that will always override the defaults in 
crush.cfg inside the distribution directory. (This is useful for keeping 
localized settings that are common to all distributions and updates!!!)

3. Adjust the maximum amount of memory for your system that Java can use.
You can do this by changing the value of the -Xmx= option to java inside 
the executabe shell script 'crush'. You may similarly wish to change the 
memory settings in the other executable scripts 'imagetool', 'coadd', 'show',
'calibrate', 'covarsee' and 'jiggle' as well. 
(Note, on 32-bit machines the limit is 2GB (2000M), or a little lower. On
64-bit architectures the limit may be 4GB (4000M) or no limit, depending on
the operating system (kernel) addressing convention but you may need to add the
-d64 option also to specify a 64-bit data model)

4. You may create symbolic links of the crush executables in a binary directory of your choice (e.g. '/usr/local/bin' for global setup or '~/bin' for a user
account setup) by running 'install.sh' from within the crush distribution
directory. This way you have convenient access to the crush executables
from anywhere on the filesystem as long as the specified directory is part
of the standard search path. (Type 'echo $PATH' to see which directories
will be searched on your system.)

5. CRUSH has been tested under Linux, MacOS X, Solaris and Windows XP 
environments, and has been confirmed to yield identical results. (Although,
it should be mentioned that the Windows testing was not very rigorous). If you
identify bugs or problems, please contact <attila@submm.caltech.edu>.


