A hacker's guide to building, editing, and running OpenBR.

Linux

  1. Install GCC 4.7.3

    $ sudo apt-get update
$ sudo apt-get install build-essential

  2. Install CMake 2.8.10.1

    $ sudo apt-get install cmake cmake-curses-gui

  3. Download OpenCV 2.4.5, note Build OpenCV with video support

    $ cd ~/Downloads
$ tar -xf opencv-2.4.5.tar.gz
$ cd opencv-2.4.5
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ make -j4
$ sudo make install
$ cd ../..
$ rm -rf opencv-2.4.5*

  4. Install Qt 5.0.1

    $ sudo apt-get install qt5-default libqt5svg5-dev qtcreator

  5. Create a GitHub account, follow their instructions for setting up Git.

    $ git clone https://github.com/biometrics/openbr.git
$ cd openbr
$ git checkout 0.5
$ git submodule init
$ git submodule update

  6. Build OpenBR!

    $ mkdir build # from the OpenBR root directory
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ make -j4
$ sudo make install

  7. Hack OpenBR!

    1. Open Qt Creator IDE

      $ qtcreator &

    2. From the Qt Creator "File" menu select "Open File or Project...".

    3. Select "openbr/CMakeLists.txt" then "Open".
    4. Browse to your pre-existing build directory "openbr/build" then select "Next".
    5. Select "Run CMake" then "Finish".
    6. You're all set! You can find more information on Qt Creator here if you need it.

  8. (Optional) Test OpenBR!

    $ cd openbr/scripts
$ ./downloadDatasets.sh
$ cd ../build
$ make test

  9. (Optional) Package OpenBR!

    $ cd openbr/build
$ sudo cpack -G TGZ

  10. (Optional) Build OpenBR documentation!

Need to rewrite this step for the new docs!

OSX

  1. Download and install the latest "Xcode" and "Command Line Tools" from the Apple Developer Downloads page.

  2. Download CMake 2.8.11.2

        $ cd ~/Downloads
    $ tar -xf cmake-2.8.11.2.tar.gz
    $ cd cmake-2.8.11.2
    $ ./configure
    $ make -j4
    $ sudo make install
    $ cd ..
    $ rm -rf cmake-2.8.11.2*

  3. Download OpenCV 2.4.6.1

    $ cd ~/Downloads
$ tar -xf opencv-2.4.6.1.tar.gz
$ cd opencv-2.4.6.1
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ make -j4
$ sudo make install
$ cd ../..
$ rm -rf opencv-2.4.6.1*

  4. Download and install Qt 5.1.1

  5. Create a GitHub account, follow their instructions for setting up Git.

    $ git clone https://github.com/biometrics/openbr.git
$ cd openbr
$ git checkout 0.5
$ git submodule init
$ git submodule update

  6. Build OpenBR!

    $ mkdir build # from the OpenBR root directory
$ cd build
$ cmake -DCMAKE_PREFIX_PATH=~/Qt5.1.1/5.1.1/clang_64 -DCMAKE_BUILD_TYPE=Release ..
$ make -j4
$ sudo make install

  7. Hack OpenBR!

    1. Open Qt Creator IDE

      $ open ~/Qt5.1.1/Qt\ Creator.app

    2. From the Qt Creator "File" menu select "Open File or Project...".

    3. Select "openbr/CMakeLists.txt" then "Open".
    4. Browse to your pre-existing build directory "openbr/build" then select "Continue".
    5. Select "Run CMake" then "Done".
    6. You're all set! You can find more information on Qt Creator here if you need it.

  8. (Optional) Test OpenBR!

    $ cd openbr/scripts
$ ./downloadDatasets.sh
$ cd ../build
$ make test

  9. (Optional) Package OpenBR!

    $ cd openbr/build
$ sudo cpack -G TGZ

  10. (Optional) Build OpenBR documentation!

Need to remake this step with the new docs!

Windows

  1. Download Visual Studio 2012 Express Edition for Windows Desktop and install.

    1. Consider the free open source program WinCDEmu if you need a program to mount ISO images.
    2. You will have to register with Microsoft after installation, but it's free.
    3. Grab any available Visual Studio Updates.
    4. Download and install Windows 8 SDK.

  2. Download and Install CMake 2.8.11.2

    1. During installation setup select "add CMake to PATH".

  3. Download OpenCV 2.4.6.1

    1. Consider the free open source program 7-Zip if you need a program to unarchive tarballs.
    2. Move the "opencv-2.4.6.1" folder to "C:\".
    3. Open "VS2012 x64 Cross Tools Command Prompt" (from the Start Menu, select "All Programs" -> "Microsoft Visual Studio 2012" -> "Visual Studio Tools" -> "VS2012 x64 Cross Tools Command Prompt") and enter:
      $ cd C:\opencv-2.4.6.1
$ mkdir build-msvc2012
$ cd build-msvc2012
$ cmake -G "NMake Makefiles" -DBUILD_PERF_TESTS=OFF -DBUILD_TESTS=OFF -DWITH_FFMPEG=OFF -DCMAKE_BUILD_TYPE=Debug ..
$ nmake
$ nmake install
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ nmake
$ nmake install
$ nmake clean

  4. Download and Install Qt 5.1.1

  5. Create a GitHub account and follow their instructions for setting up Git.

    1. Launch "Git Bash" from the Desktop and clone OpenBR:
      $ cd /c
$ git clone https://github.com/biometrics/openbr.git
$ cd openbr
$ git checkout 0.5
$ git submodule init
$ git submodule update

  6. Build OpenBR!

    1. From the VS2012 x64 Cross Tools Command Prompt:

      $ cd C:\openbr
$ mkdir build-msvc2012
$ cd build-msvc2012
$ cmake -G "CodeBlocks - NMake Makefiles" -DCMAKE_PREFIX_PATH="C:/opencv-2.4.6.1/build-msvc2012/install;C:/Qt/Qt5.1.1/5.1.1/msvc2012_64" -DCMAKE_INSTALL_PREFIX="./install" -DBR_INSTALL_DEPENDENCIES=ON -DCMAKE_BUILD_TYPE=Release ..
$ nmake
$ nmake install

    2. Check out the "install" folder.

  7. Hack OpenBR!

    1. From the VS2012 x64 Cross Tools Command Prompt: $ C:\Qt\Qt5.1.1\Tools\QtCreator\bin\qtcreator.exe
    2. From the Qt Creator "Tools" menu select "Options..."
    3. Under "Kits" select "Desktop (default)"
    4. For "Compiler:" select "Microsoft Visual C++ Compiler 11.0 (x86_amd64)" and click "OK"
    5. From the Qt Creator "File" menu select "Open File or Project...".
    6. Select "C:\openbr\CMakeLists.txt" then "Open".
    7. If prompted for the location of CMake, enter "C:\Program Files (x86)\CMake 2.8\bin\cmake.exe".
    8. Browse to your pre-existing build directory "C:\openbr\build-msvc2012" then select "Next".
    9. Select "Run CMake" then "Finish".
    10. You're all set! You can find more information on Qt Creator here if you need.

  8. (Optional) Package OpenBR!

    1. From the VS2012 x64 Cross Tools Command Prompt: $ cd C:\openbr\build-msvc2012 $ cpack -G ZIP

Raspian

  1. Install CMake 2.8.9

    $ sudo apt-get install cmake

  2. Download OpenCV 2.4.9

    $ wget http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/2.4.9/opencv-2.4.9.zip
$ unzip opencv-2.4.9.zip
$ cd opencv-2.4.9
$ mkdir build
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ make
$ sudo make install
$ cd ../..
$ rm -rf opencv-2.4.9*

  3. Install Qt5

    1. Modify source list

      $ nano /etc/apt/sources.list

      by changing:

      $ deb http://mirrordirector.raspbian.org/raspbian/ wheezy main contrib non-free rpi

      to:

      $ deb http://mirrordirector.raspbian.org/raspbian/ jessie main contrib non-free rpi

  4. Update apt-get

    $ sudo apt-get update

  5. Install packages

    $ sudo apt-get install qt5-default libqt5svg5-dev

  6. Create a GitHub account, follow their instructions for setting up Git.

    $ git clone https://github.com/biometrics/openbr.git
$ cd openbr
$ git checkout 0.5
$ git submodule init
$ git submodule update

  7. Build OpenBR!

    $ mkdir build # from the OpenBR root directory
$ cd build
$ cmake -DCMAKE_BUILD_TYPE=Release ..
$ make
$ sudo make install

  8. (Optional) Test OpenBR!

    $ cd openbr/scripts
$ ./downloadDatasets.sh
$ cd ../build
$ make test