----------------------------------------------------------------------
FastJet
-------

The FastJet package, written by Matteo Cacciari and Gavin Salam and
with more recent contributions by Gregory Soyez, provides a fast
implementation of a several longitudinally invariant sequential
recombination jet algorithms, in particular the longitudinally
invariant kt jet algorithm, the inclusive longitudinally invariant
version of the Cambridge/Aachen jet-algorithm, and the inclusive
anti-kt algorithm.

The implementation is based on the geometrical methods described in
M. Cacciari and G.P. Salam, Phys. Lett. B 641 (2006) 57 [hep-ph/0512210].

Means are also provided for accessing external jet-algorithm software
via a common (plugin) interface and this release notably includes
SISCone, an infrared safe seedless stable-cone type algorithm introduced
in G.P. Salam and G. Soyez, JHEP 0705 (2007) 086 [arXiv:0704.0292].

Various tools are also provided related to jet areas. They can be used
with any infrared safe jet algorithm, both native and plugin. They are
described in M. Cacciari, G.P. Salam and G. Soyez, LPTHE-07-02.

----------------------------------------------------------------------
Installation
------------
Installation instructions are provided in the INSTALL file.

Note that to benefit from NlnN implementation (relevant for N greater 
than 10000 roughly) of the kt (and anti-kt) jet algorithm , you will 
need to download CGAL from http://www.cgal.org/ and compile it before 
compiling the FastJet library. The NlnN implementation of the 
Cambridge/Aachen jet-algorithm is independent of CGAL.

Automatic documentation can be generated by running the doxygen command 
(if not installed on your system see www.doxygen.org) in the main 
directory. It will  create the html/ and latex/ directories containing 
detailed technical documentation.

----------------------------------------------------------------------
Directory structure
-------------------

doc/		Documentation
src/		the .cc files for the FastJet library
include/	the include (.hh) files for the FastJet library
lib/            destination for the libfastjet.a library
example/        contains some example programs
example/data/   contains some files with data for events
plugins/        the various plugin jet algorithms

----------------------------------------------------------------------
Known bugs
----------

See the FastJet web page, http://www.lpthe.jussieu.fr/~salam/fastjet/
and associated links.
