##################################################
Author:	Philippe PÉREZ DE SAN ROMAN,
		Master Image Processing & Computer Vision,
		Universities:
			Pazmany Peter Katolikus egyetem
			Autonom de madrid
			Bordeaux
		promotion N°1: 2015-2016
Status: Master Thesis interneship Labri & INCIA 01-2016 to 07-2016
Project: INCIA arm prosthesis (SuVIPP) Matching
Funding: INCIA University of Bordeaux
Month-Years: 01-2016 to 07-2016 

##################################################
Description:

A study about improving robotic arm prosthesis to grab objects using Computer Vision. The project use Tobii Glasses 2 (an eyetracker system) and a GoProp stereoscopic 3D system (to compute depth). The main idea was to identifie the object to grab using wooding maps computed using Tobii Glasses 2 data, then, localize it in the stereoscopic recordings in order to get the object pixels depth and finally the object distance.
This project is on going.

This folder contains tools for:
- Producing video+saliency recordings from data recorded using Tobii Glasses 2.
- Annotation of the above video.
- Sampling of image patch to use as training set for deep-learning.

##################################################
Build by this project:

--------------------------------------------------
./Build/Libraries/TobiiSDK (Static Library):
This library regroup data types associated to data sent by the Tobii Glasses 2, such as eye tracking and video.
It also provides algorithm to compute different visualisation of the fixation points on the video, like Saliency and Heat-Map.
And it implement the framework to:
- Read data in separate file
- Syncronise the two (video/fixations)
- Interpolate fixations
- Compute visualisation (GPU version also)
- Save the output
location=./Sources/TobiiSDK

--------------------------------------------------
Various example applications are provided in the "/Build/Binaries" fodler as executables:
- LiveGaze display a circle on the video to visualize the gaze fixation
- LiveSaliency display the saliency video (same for the GPU version)
- LiveHeatMap display the saliency on top of the video as heat-map (same for the GPU version)
- LiveWeightedMap uses saliency to ponderate brightness in the video.
location=./Sources/Binaries

All subfolder of the /Sources/Binaries folder are compile as independant target,
and are link to Qt5, opencv2, TobiiSDK and any other dependances of this porject.

--------------------------------------------------
./Build/Binaries/AnnotationTool (Executable):
This is the GUI associate to the SDK, providing user controle over all the above functionalities.
It also provide a first solution to semi-automated annotation (using thresholding of the saliency).
A complete guide to this tool is provided along this README.
location=./Sources/Binaries/AnnotationTool

--------------------------------------------------
./Build/Binaries/DataSetManger (Executable):
Read all the video in the given dataset folder and checks all images of all videos.
It is imperative to run this before the SamplingTool
location=/Sources/Binaries/DataSetManger

--------------------------------------------------
SamplingTool (Executable):
Reads all the video in the dataset (in parallel) and extract patch on them.
Patches are saved as images in a given folder, and the path to them are listed in an index file (Index.txt).
location=/Sources/Binaries/SamplingTool

##################################################