A tool for visually tracking a moving target on a calibrated ground plane and recording position and angle in 2-dimensions.
Clone or download
akramhussein Merge pull request #12 from mb354/dyson-dev
Merge in to develop branch:

* Execute loss recovery when it doesn't track.
* Removed some asserts that were causing trouble.
* Take into account the orientation of the robot when creating a patch for tracking the target
* Corrected m_pos when lost near the limits of the window due to offsets. 
Otherwise it get in a state where ncc2 returns 0 and lossRecovery never recovers.
* Speed up the loss recovery it computes cross correlation only on pixels divisible by 2.
* Tidy up to README
Latest commit ef30eee Jun 23, 2014

README.md

Ground Truth System

Ground Truth System - A tool for visually tracking a moving target on a calibrated ground plane and recording position and angle in 2-dimensions.

Build Status

Screenshot

Additional functionality is included to facilitate the generation of IEC specific results.

Requirements

Linux

CMake (2.8.10.1)

sudo apt-get install cmake

Qt (4.8.1)

sudo apt-get install libqt4-dev qt4-dev-tools

Unicap (0.9.12)

sudo apt-get install libunicap2-dev

Compiling OpenCV on Linux (2.4.6)

git clone https://github.com/Itseez/opencv.git 
git checkout 2.4.6
mkdir build && cd build
cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/path/to/opencv/install ..
cmake --build . --target install

Unicap (0.9.12)

sudo apt-get install libunicap2-dev

Windows

OpenCV (2.4.6)

cd C:\
git clone https://github.com/Itseez/opencv.git 
git checkout 2.4.6
cd opencv
mkdir build && cd build
cmake -G"MinGW Makefiles" -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX="C:\opencv\install" ..
cmake --build . --target install

MinGW Only

Visual Studio Only

Installer

Compiling

Linux From root directory:

$ mkdir build && cd build
$ cmake [options] ../
    e.g. cmake -DOpenCV_ROOT_DIR=/path/to/opencv/install -DCMAKE_BUILD_TYPE=Debug -DGTS_TESTS=ON ../
$ cmake --build . --target install

Windows (MinGW)

mkdir build
cd build
cmake.exe -G"MinGW Makefiles" -DOpenCV_ROOT_DIR="C:\opencv\install" -DCMAKE_INSTALL_PREFIX="C:\GTS" ..   
cmake --build . --target install

Alternatively, call scripts/minGW_app.bat from root directory.

Windows (VS2010)

mkdir build
cd build
cmake.exe -G"NMake Makefiles" -DOpenCV_ROOT_DIR=C:\PATH-TO-OPENCV-INSTALL ..
cmake --build . --target install

Alternatively, call scripts/vs2010_app.bat from root directory.

CMake Options

  • OpenCV_ROOT_DIR - Path to OpenCV libraries and includes (REQUIRED on Windows, looks in standard places on Linux)
  • GTS_TESTS - Build Google Test Unit Tests (default=OFF).
  • GTS_HELP - Build GTS Help Assistant (default=ON).
  • CMAKE_INSTALL_PREFIX - Location for make install to place binary and help files.

##Windows Installer

To redistribute this application on Windows, an installer is available. You will first need to download the 2 additional files (Xvid and Microsoft VS2010 Redist package as linked in the DOWNLOADS file.

MinGW

mkdir build
cd build
cmake.exe -G"MinGW Makefiles" -DOpenCV_ROOT_DIR=C:\PATH-TO-OPENCV-INSTALL ..
mingw32-make package

Alternatively, call scripts/minGW_installer.bat from root directory.

VS2010

mkdir build
cd build
cmake.exe -G"NMake Makefiles" -DOpenCV_ROOT_DIR=C:\PATH-TO-OPENCV-INSTALL .. 
nmake package

Alternatively, call scripts/vs2010_installer.bat from root directory.

Unit Tests

GTS uses the Google Test Framework for unit testing. A few tests have been included, but we hope to add to these over time and welcome any additions.

Supported Cameras

The Unicap library on Linux and DirectShow on Windows are used to enumerate cameras. OpenCV is used for recording and tracking of videos. Therefore cameras that are supported by these libraries should work on the GTS.

Issues

Bugs and feature requests should be added to the Issues section of this repository. If you have a fix for such, please see below to have it considered to be merged in.

Contributions

For contributions to be considered we require that users first read and follow the steps in the CONTRIBUTING file.

Documentation

In addition to the help tool that can be compiled alongside the app, the documentation can be found in the Wiki.

License

This application is distributed under the GPLv3 license found in the LICENSE file.

Attributions and licenses for third-party libraries can be found in the OPEN SOURCE LICENSES file.