Copyright 2010 Jens Stoye. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are
permitted provided that the following conditions are met:

   1. Redistributions of source code must retain the above copyright notice, this list of
      conditions and the following disclaimer.

   2. Redistributions in binary form must reproduce the above copyright notice, this list
      of conditions and the following disclaimer in the documentation and/or other materials
      provided with the distribution.

THIS SOFTWARE IS PROVIDED BY <COPYRIGHT HOLDER> ``AS IS'' AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL <COPYRIGHT HOLDER> OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those of the
authors and should not be interpreted as representing official policies, either expressed
or implied, of Jens Stoye.

#******************************************************************************
# FILE   : README
# AUTHOR : Jens Stoye, Constantin Bannert
#******************************************************************************
#
# 2000/05/26: Inital version (Jens).
# 2002/01/31: Added documentation for jscan (Conni).
# 2002/10/23: Updated link to WWW home page (Jens).
#
#******************************************************************************

This distribution contains three executables:

jali:    This program takes as input a protein sequence and a multiple
         alignment of a protein family and computes a jumping alignment
         of the sequence and the alignment.

jsearch: This program takes as input a protein database and a multiple
         alignment of a protein family, compares all proteins from the
         database to the alignment, and then outputs the database in sorted
         order with respect to the computed jumping alignment score.
	 
jscan:	 This program takes as input a protein sequence and a database of
	 multiple alignments of protein sequences (PRODOM format).
	 jscan computes a jumping alignment for the sequence and each
	 multiple alignment from the database; and then outputs the cluster
	 names with the associated score, respectively.

All sequence, alignment and database input requires FASTA format, except the
database for jscan, which requires the PRODOM format.


USAGE

> jali [options] sequence.fasta alignment.fasta
> jsearch [options] sequence-db.fasta alignment.fasta ...
> jscan [options] sequence.fasta alignment-db.prodom

Options:
  -w weights_filename      //amino acid similarity matrix (default: vt160)
  -i gap_initiation_cost   //must be smaller or equal to zero (default: -24)
  -e gap_extension_cost    //must be smaller or equal to zero (default: -6)
  -j jump_cost             //must be smaller or equal to zero (default: -22)
  -f format_ID             //output format: 0:ASCII (default)  1:HTML
                           //               2:double-spaced HTML
  -p                       //print alignment (jali only)
  -o                       //run in verbose mode
  -v                       //print version
  -h                       //print this help message


INSTALLATION

First, unwrap the package. On the UNIX prompt type

> gunzip jali-VVV.XXX.tar.gz
> tar xvf jali-VVV.XXX.tar

where VVV is the current version of JALI and XXX is your operating system.
This will create a directory "jali-VVV.XXX" containing the executables.
You might want to include this directory in your PATH environment.


TESTING

To test your installation of jali, cd into the jali-VVV.XXX directory and
type the following:
 
> jali sample_sequence sample_alignment

The output of the program should be:

44

To get the actual alignment, type:

> jali -p sample_sequence sample_alignment

To test the correct installation of jsearch, type:

> jsearch sample_sequence_db sample_alignment

The output of the program should be a list of the 19 database sequences with
a score at the end of each line (the higher the score, the better fits the
database sequence into the family represented by the sample_alignment).

To test the correct installation of jscan, type:

> jscan sample_sequence sample_alignment_db

The output of the program should be a list of the 18 database alignments
included in the 'sample_alignment_db' with a score at the end of each line
(the higher the score, the better fits the sample_sequence into the family
represented by the respective alignment).



FURTHER INFORMATION

For further information please consult the JALI WWW Home Page:

              http://bibiserv.techfak.uni-bielefeld.de/jali/

#******************************************************************************
