INSTALLATION INSTRUCTIONS FOR CHIMERA GRID TOOLS:

(1) Extract files from chimeraxxx.tar.gz:
    gzcat chimeraxxx.tar.gz | tar xfv -

(2) Type ./configure at the command line to establish the proper
    compiler flags.  This will create Makefiles that will be used by
    "make".  If different compiler flags are needed, many of these
    can be specified on the command line:

    configure -with-fort=fortran_compiler
              -with-cc=c_compiler
              -with-fflags=fortran_flags_for_.f_files
              -with-f90flags=fortran_flags_for_.f90_files
              -with-cflags=c_flags

    Further modifications can be made be editing the configure
    script directly.

    The flags in the configure script are located by searching for
    * in the script, e.g., alpha flags are located by
    searching for alpha*. Re-run configure to generate Makefiles with
    the updated flags.

    Type ./configure -help for the different options available.

    configure

            DEFAULT                            OTHER OPTIONS

        single precision                 -enable-dp (double precision)
        optimization of -O               -enable-debug, -enable-nobyteswap
                                         -enable-mips2, -enable-mips3,
                                         -enable-mips4
        installdir = chimeraxxx/bin      -installdir=DIR
        installalldir = /usr/local       -installalldir=DIR

    make

      update (compiles everything,       CMD=install, CMD=installall,
      and leaves them in chimeraxxx/src) CMD=clean (rm temporary files),
                                         CMD=clobber (rm executables, .f, .a)

    Examples of using configure:

     To compile programs and install in $HOME/bin:
	% ./configure -installdir=$HOME/bin

     To compile programs for double precision:
	% ./configure -enable-dp

     To compile programs with debug:
	% ./configure -enable-debug

     To compile programs with no byteswapio on Linux Portland Group compiler:
	% ./configure -enable-nobyteswap

     To compile programs, and install all executables and documentation
     in some place other than the chimeraxxx directory:
        % ./configure -installalldir=DIR
	      where executables will be placed in DIR/bin, and
	      documentation will put in DIR/doc

    Special notes on specific machines:

    SGI: -mips4 seems to create bad code occasionally. Use at your own risk!

    Linux: Three Linux machine types are automatically detected by configure:
           i686 (pentium, athlon), itanium and opteron. Based on the detected machine
           type, a default Fortran 90 compiler is automatically selected:

           i686 or opteron - pgf90
           itanium         - ifort

           The user can override the default by specifying -with-fort=compiler on
           the configure command line. If the specified compiler belongs to the
           following list: pgf90, ifc, efc, ifort; appropriate flags will be
           automatically selected. For the itanium and opteron, flags for 64-bit
           mode are automatically loaded.

    Mac OS/X (Intel) : The configure script will assume the Intel Fortran
       and C compilers when darwin is detected.

(3) Compile by typing "make"

(4) Install by typing "make CMD=install"

(5) The graphical user interface OVERGRID has its own make file and
    installation instructions. See overgrid.html in chimeraxxx/gui.

(6) Make sure that the location of the compiled executables is within your $path
    variable, for easy access.

(7) The use of the automated scripts in chimeraxxx/bin require that
    the environment variable SCRIPTLIB be set to point at the 
    chimeraxxx/scriptlib directory and that chimeraxxx/bin is within 
    your $path.  The easiest way to set the environment variable is 
    to add the following to your .cshrc file if you are using C-Shell:
    
          setenv SCRIPTLIB $HOME/chimeraxxx/scriptlib
    
    where the above path matches the location of your chimeraxxx directory.
    Use "echo $SCRIPTLIB" to test for the correct assignment.  This is
    necessary for seamless access to the library of routines in this
    directory.

(8) To install both single and double precision executables:

  
 Expand chimeraxxx.tar.gz into chimeraxxx in base directory
  
 Rename chimeraxxx to chimeraxxx_dp
  
 Type ``configure -enable-dp'' in chimeraxxx_dp
  
 Type ``make CMD=install'' to make double precision executables
  in chimeraxxx_dp/bin
  
 Go back to base directory and expand chimeraxxx.tar.gz into chimeraxxx
  
 Type ``configure'' in chimeraxxx
  
 Type ``make CMD=install'' to make single precision executables
  in chimeraxxx/bin