Installation and Usage Notes for the Maxit Application
                            (Binary Distribution)

Note: Binary distribution contains an additional submodule, called PROCHECK,
which does more structure checking. This submodule is not available in
source distribution.


1.  Installation

a.  Uncompress and unbundle the distribution using the following command:

        zcat maxit-vX.XXX-XXX.tar.gz | tar -xf - 

    The result of this command is a subdirectory maxit-vX.XXX-XXX in the
    current directory, which contains the following:

        bin - subdirectory that contains application executable "maxit-v8.01-O"
        data - subdirectory that contains some data files needed by the
          application. 
        etc - subdirectory that contains utility scripts and application
          software license agreement.
        procheck - subdirectory that contains executables for "procheck"

b.  Set up the environment variables.

    - Define RCSBROOT environment variable to point to the installation
    directory. Assuming that the installation directory is
    /home/username/maxit-vX.XXX-XXX, execute in the shell:

        For C shell users:
          setenv RCSBROOT /home/username/maxit-vX.XXX-XXX

        For Bourne shell users:
          RCSBROOT=/home/username/maxit-vX.XXX-XXX; export RCSBROOT

    - Add "bin" subdirectory to the PATH environment variable.
    Execute in the shell:

        For C shell users:
          setenv PATH "$RCSBROOT/bin:"$PATH

        For Bourne shell users:
          PATH="$RCSBROOT/bin:"$PATH; export PATH

c.  Make binary data from ASCII data

    - Position in the maxit-vX.XXX-XXX/etc directory and run the script
    binary.sh:
    
        cd maxit-vX.XXX-XXX/etc
        ./binary.sh 

    This command will create certain binary data files, using the ASCII data
    files in data/ascii directory. The resulting files are stored in
    data/binary directory. Note that it may take several minutes for this
    step to complete. This step must be executed before the tool can be
    utilized.


2.  Application Usage Notes

Maxit application supports many options for all kinds of data processing
operations. To see all supported options, execute:

    maxit-v8.01-O -

For the purpose of data deposit, only three options are necessary for preparing
the deposit file.

1. This will translate a PDB format file into mmCIF format file. The output file
name is file_name.pdb.cif (with extension .cif).

    maxit-v8.01-O -i file_name.pdb -o 1 -exchange_out

2. This will translate a mmCIF format file into PDB format file. The output file
name is file_name.cif.pdb (with extension .pdb).

    maxit-v8.01-O -i file_name.cif -o 2 -exchange_in

3. This will update a mmCIF format file. The output file name is
file_name.cif.cif (with extension .cif).

    maxit-v8.01-O -i file_name.cif -o 8 -exchange_in -exchange_out