--------------------------------------------------------------------------
  Bundler v0.1 Installation Guide
    copyright 2008 Noah Snavely (snavely@cs.washington.edu)
  
  based on the Photo Tourism work of Noah Snavely, Steven M. Seitz, 
    (University of Washington) and Richard Szeliski (Microsoft Research)

  For more technical information, visit http://phototour.cs.washington.edu

  The source provided in this distribution can be accessed at
    http://phototour.cs.washington.edu/bundler/
--------------------------------------------------------------------------

This distribution contains source code for Bundler as well as several
libraries and utility programs.  Note that you'll need several other
libraries installed on your system in order to successfully compile
and link Bundler.  Note that the binary distribution is *highly
recommended*, as compiling from source is currently much less
user-friendly than using the pre-compiled binaries.  Compilation has
been tested on Linux, but has also worked under Windows using Cygwin
(with some slight modifications).

Before compiling, you'll need to make sure the following libraries are
installed on your system (links to distributions of these packages are
provided):

 - LAPACK  (the Linear Algebra PACKage, http://www.netlib) 
      Link: http://www.netlib.org/lapack/
      Direct link: http://www.netlib.org/lapack/lapack.tgz

 - BLAS    (Basic Linear Algebra Subprograms)
      Link: http://www.netlib.org/blas/
      Direct link: http://www.netlib.org/blas/blas.tgz

 - CBLAS   (C interface to BLAS)
      Link: http://www.netlib.org/blas
      Direct link: http://www.netlib.org/blas/blast-forum/cblas.tgz

   (Note that LAPACK, BLAS, and CBLAS implementations are also
    provided as part of Intel's Math Kernel Library -- these
    implementations can be significantly faster than the ones linked
    to here.)

 - MINPACK (non-linear minimization library)
      Link: http://www.netlib.org/minpack/
      [Note that only the lmdif1.f source file (plus dependencies) is
       required.  These can be downloaded through this link:
       http://www.netlib.org/cgi-bin/netlibfiles.pl?filename=/minpack/lmdif1.f]

 - f2c     (fortran to C library)
      Link: http://www.netlib.org/f2c/
      Direct link: http://www.netlib.org/f2c/libf2c.zip

You may need to edit the Bundler Makefile (src/Makefile) to make sure
that these libraries are all visible at link-time (or just copy the
compiled libraries to the $(BASE_PATH)/lib directory).  In addition to
these libraries, the standard libjpeg and libz libraries must be
installed on your system.

This distribution also contains a modified version of the Approximate
Nearest Neighbors (ANN) v1.1 library of David M. Mount and Sunil Arya
(http://www.cs.umd.edu/~mount/ANN/), and the Sparse Bundle Adjustment
(SBA) v.1.2.1 package of Manolis Lourakis and Antonis Argyros
(http://www.ics.forth.gr/~lourakis/sba/).

On a Linux system, typing "make" in the base directory will compile
Bundler and its dependencies (assuming all goes well).  Upon
successful compilation, an executable called 'bundler' will be copied
to the bin directory, along with an executable called 'KeyMatchAll'.

See the README.txt file for more information on running Bundler.
