Home

Welcome to the FeatureDetection wiki!

Installation instructions

Linux

1. Create a dir for the whole project, e.g. cd ~ && mkdir ffd && cd ffd
2. Checkout the code: git ... (e.g. git clone git://github.com/elador/FeatureDetection.git). It will create a directory ~/ffd/FeatureDetection/ with all the source files. This is your source-directory.
3. Edit ~/ffd/FeatureDetection/initial_cache.cmake and change the paths to the installed libraries (if necessary).
4. mkdir build && cd build. This is your build-directory. We will build the projects in here.
5. Run cmake -C ../FeatureDetection/initial_cache.cmake -D CMAKE_BUILD_TYPE=Release ../FeatureDetection. A Makefile will be built in this directory.
6. Type make to build everything.
7. Run e.g. ~/ffd/build/ffpDetectApp/ffpDetectApp or ~/ffd/build/faceTrackingApp/faceTrackingApp -c 0.

Note: In the future, there will be an install command that installs the built libs and programs to some dir like ~/ffd/bin/. This is a TODO.

Windows

1. Install all dependencies (see below).
2. Install the git app from http://windows.github.com/. Recommended: Use git gui for windows (http://windows.github.com/)
3. Open a command-line (cmd.exe), go to e.g. D:\ and create a dir for the whole project, e.g. cd D:\, mkdir ffd, cd ffd
4. Checkout the code: Open GitHub and check-out into D:\ffd. It will create a directory D:/ffd/FeatureDetection/ with all the source files. This is your source-directory.
5. mkdir build, cd build. This is your build-directory. We will build the projects in here. You should be in D:\ffd\build now.
6. Run cmake -C ..\FeatureDetection\initial_cache.cmake ..\FeatureDetection. A Makefile will be built in this directory. If some library can't be found, edit D:/ffd/FeatureDetection/initial_cache.cmake.
7. Open the Visual Studio solution file that has been built in D:/ffd/build/*.sln, and compile in VisualStudio!
8. Run e.g. ffpDetectApp.

Installing of the windows dependencies

CMake: Install cmake from here: http://www.cmake.org/cmake/resources/software.html.

Boost: Download the newest boost binaries (win32) here: http://www.boostpro.com/download/ and install everything.

OpenCV: Possibility 1: Download the latest OpenCV win binaries here: http://sourceforge.net/projects/opencvlibrary/files/ and install (Note: not tested. I used possibility 2)

Possibility 2: Follow the manual installation here (compile OpenCV by yourself): http://opencv.willowgarage.com/wiki/InstallGuide

C:\opencvsvn\build\bin{Debug}|{Release} needs to be in system-path (or copy the libs to .exe dir).

Dependencies

libFeatureDetection needs Matlab (libmat, libmx) and OpenCV (core, imgproc, highgui).

libTracking needs libFeatureDetection (and therefore Matlab and OpenCV).

ffpDetectApp needs Matlab (libmat, libmx) and OpenCV (core, imgproc, highgui) and boost (boost_program_options).

faceTrackingApp needs libTracking, libFeatureDetection, Matlab (libmat), OpenCV (core, highgui) and boost (system, filesystem).

Random notes

git-cola is a nice git-GUI for linux.