CollapseTracklets (and related tools)

Jonathan Myers, 11/24/08

----------------------------------------

WHAT'S HERE:

This dump includes command-line tools, unit tests and SWIG bindings
for Python for all of the following: CollapseTracklets,
purifyTracklets, and removeSubsets.



BUILDING:

The tools use GSL for linear fitting and the Boost unit testing
framework for the unit tests.  GSL should be in use at PanSTARRS and
LSST; Boost is used by LSST only but building the unit tests is
optional.  Futher, Boost's unit test framework requires no dynamic
libraries, just a header file.

Lastly, there are SWIG-based interfaces to Python available; to build
these you'll need to set the PYTHON_INCLUDE_DIR as well as the path to
swig.

In this directory you should find gsl/ and boost/ directories which
contain all the files needed to build and run the command-line tools
and the 
should be able to do the following:

$export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$PWD/gsl/lib

$make tools tests


To use your own installation of GSL and/or Boost, simply edit the
Makefile directly: change GSL_DIR and BOOST_DIR to reflect the
locations of GSL and BOOST on your system.


If you wish to build just the command-line tools (no test) use 

$make tools

For the unit tests, do

$make tests

for SWIG interfaces, use

$make swigInterfaces

and for all three use

$make all


There is also a SConstruct file present; this is for building in the
LSST system, which uses some custom LSST extensions to SCons.  Simply
run

$scons 

to get everything.
