simplified Proposal Selection Tracker (sPST)
This code implements a method for single-camera, single-target, short-term, causal, model-free tracking, submitted to the VOT2015 and VOT-TIR2015 challenges. It is a simplified version of the Proposal-Selection Tracker in our ICCV 2015 paper.
Copyright (c) 2017 Yang Hua, Henrique Morimitsu, Karteek Alahari, Cordelia Schmid, Inria Grenoble Rhône-Alpes, France.
Contact: Yang Hua (yanghuacv[at]gmail.com), Henrique Morimitsu (henriquem87[at]gmail.com)
Download
- Code
- Raw results
Requirements
- Matlab
- Matlab Image Processing Toolbox
- Piotr Dollar's Toolbox [1]
- Piotr Dollar's SedToolbox [2]
- openssl: Usually available from your Linux distro repository. E.g. in Ubuntu 16.04 you can install with:
sudo apt install libssl-dev
The code was tested on a machine with Linux Xubuntu 16.04 and Matlab R2014b/R2016a.
Usage
Quick start
- Run
src/spst_demo.m
in Matlab - In case you get MEX related errors, you will need to compile the MEX binaries for your machine:
- Compile the tracker MEX binaries by executing
src/compile_mex.m
in Matlab - Compile the third-party MEX binaries by following the instructions provided in the respective directories in
src/3rdparty
- Compile the tracker MEX binaries by executing
Detailed explanation
Before starting, you may need to install some third-party libraries. We have
included all the necessary libraries in this package except openssl. Should you prefer,
you can download and configure each library yourself. Instructions for doing this are
available in the file INSTALL_3RDPARTYLIBS.md
.
You can change certain parameters and configurations in the file
src/tracker/Config.m
. This is not mandatory, and the tracker can be tested without changing
the configuration, i.e., downloading and extracting sequences from the
datasets (e.g., VOT, OTB) to the sequences
folder. We provide a few sample
results computed for the VOT video "pedestrian1" in the results
folder.
The binary MEX files are compiled in Xubuntu 16.04. If you need to recompile
them, run the script src/compile_mex.m
for tracker MEX files, and also follow the instructions
provided in src/3rdparty
.
If you run into issues when executing src/spst_demo.m
, you may need to add
libstdc++.so.6
in your system environment (i.e., LD_PRELOAD
). For Xubuntu 16.04,
you can set LD_PRELOAD="/usr/lib/x86_64-linux-gnu/libstdc++.so.6"
.
It is worth noting that we use fixed sequence in sPST code, so it will provide identical results in all environments.
Testing with other sequences
Place the additional video sequences in the folder defined by "datasetPath" in the config file. The easiest way to do this is by
adapting your sequences to either the VOT or the OTB standards and then
setting the "datasetFormatFlag" in the file src/tracker/Config.m
to either
'vot' or 'otb' (with quotes) accordingly.
License
We use the BSD 3-clause license. Check the file license.txt for more details.
History
- Ver1.1: Release version with better interface and easy-to-use config file
- Ver1.0: Original version submitted to VOT2015 and VOT-TIR2015 challenges
References
[1] Piotr Dollar. Piotr's Computer Vision Matlab Toolbox (PMT). https://github.com/pdollar/toolbox.
[2] C. Lawrence Zitnick, and Piotr Dollar. Edge Boxes: Locating Object Proposals from Edges. In ECCV, 2014.