PREREQUISITES
-------------
This package requires version 2.2 or newer of the CMake install system
(http://www.cmake.org/) and version 1.1.0 or newer of the VXL library
(http://vxl.sourceforge.net/).
You will also need the 'convert' tool from ImageMagick
(http://www.imagemagick.org/) if you want to have some flexibility in the
image formats you can use.


Step 1
------
You must modify the CMakeLists.txt file so the vxl_inc_root and vxl_build_root
lines point respectively to the source directory of VXL (i.e. $VXLSRC in the
VXL installation manual) and the installation directory ($VXLBIN in the
installation manual).

Optionally, you can install the nurbs++ library
(http://libnurbs.sourceforge.net/). However, this is only required to enable
the parallellogram regions which give very little performance increase, so we
disrecommend it unless you have specific reasons to use this. To compile this
library with a version of GCC above 3.1, you must patch the source code (which
hasn't been updated since 2002). A patch is available on SourceForge, or you
can apply the included patch with the command "patch -p1 <nurbs_gcc41.patch"
from within the nurbs++-3.0.11 source directory.


Step 2
------
Create a new directory in which you want to install the Image Exploration
libraries and binaries. (The software can also be compiled inside the source
directory.) From within this installation directory, call:

  [c]cmake <path to VxLRegionsLinux directory>

'cmake' is a basic command-line tool, 'ccmake' will show an interface in which
some parameters can be modified. For instance, most people will want to set
CMAKE_BUILD_TYPE to "Release". Press 'c' until the option "Press [g]" appears,
then press 'g' to generate the Makefile.

After running cmake or ccmake, call "make".


Step 3
------
The programs require some external binaries, which are provided in the
directory 'mikolajczyk'.  You can either install these binaries in a standard
location that is in your default $PATH like /usr/local/bin, or set the
environment variable $EXPLORATION_TOOLS_PATH to point to the full path of the
'mikolajczyk' directory.  If there are any problems with these binaries, you
can look for newer versions or support at
http://www.robots.ox.ac.uk/~vgg/research/affine/


TROUBLESHOOTING
---------------
It is recommended to use shared libraries for VXL. This is not the default, so
when installing VXL you must activate the BUILD_SHARED_LIBS option. The
alternative is to modify this project's CMakeLists.txt files to use static
libraries.

In case of problems with linking, make sure you aren't mixing different
versions of GCC. This software has been tested with GCC 3.4.6 and 4.1.1, but
older versions may work too.