This repository has been archived by the owner on Feb 25, 2019. It is now read-only.
forked from zk00006/OpenTLD
-
Notifications
You must be signed in to change notification settings - Fork 14
/
Copy pathREADME
94 lines (69 loc) · 4.15 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
################################################################################
# ATTENTION:
# This branch of the source code is a development version including Octave
# (http://www.gnu.org/software/octave/) compatibility measures, and is not
# an official version!
# Tracking is working in Octave now, with some changes w.r.t. Zdenek's branch
# See https://github.com/bilderbuchi/OpenTLD/issues/2 for more information.
#
#
# Webcam support:
# This is working in Matlab WITHOUT Image Acquisition Toolbox
# through stream_server.c using sockets and OpenCV.
# You have to compile stream_server on your own for now, the command may look
# similar to this: gcc stream_server.c -lcv -lhighgui -o stream_server
#
# Webcam in octave is near completion. Frames are grabbed properly from the
# server but problems with mouse input arise when selectin object boudaries.
# For stream_server.c to work in octave, the package sockets should be present.
################################################################################
TLD (aka Predator)
----------------------------------------------------------------------------
TLD is an algorithm for tracking of unknown objects in unconstrained video streams. The object of interest is defined by a bounding box in a single frame. TLD simultaneously tracks the object, learns its appearance and detects it whenever it appears in the video.
1. License
This source code is released under the GPL license version 3.0. For alternative licensing options contact the main author: [email protected].
2. Project website
You can find more information about TLD at: http://info.ee.surrey.ac.uk/Personal/Z.Kalal/tld.html. This includes the description of TLD, links to research papers, posters and the licensing options.
3. Wiki
Many questions regarding TLD are already answered at the following wiki: https://github.com/zk00006/OpenTLD/wiki. These questions include installation and common errors. Make sure to check the wiki first.
4. Discussion group
If you do not find your answer in the wiki, ask the question directly at the following discussion group: http://groups.google.com/group/opentld. There are currently around 250 participants and it is likely you will get the answer soon.
5. Feedback
Predator learns from its errors; let us do the same in this community! Therefore, if you get an answer that was not covered in the wiki, please update the wiki so that other people do not have to face the same problem. The wiki is freely editable at the moment.
6. Citations
In case you use TLD in an academic work, please cite the following paper:
@article{Kalal2010,
author = {Kalal, Z and Matas, J and Mikolajczyk, K},
journal = {Conference on Computer Vision and Pattern Recognition},
title = {{P-N Learning: Bootstrapping Binary Classifiers by Structural Constraints}},
year = {2010}
}
Installation
============
1. Windows
Tested on: Matlab R2010a, VS2010, Windows 7 (32-bit, 64-bit), OpenCV2.2
1.1 Install OpenCV
a) make sure to compile opencv
b) make sure that system variable PATH includes the directory to the OpenCV DLLs
1.2 Check paths in 'compile.m' file
1.3 run 'compile.m', if you get errors go to OpenTLD discussion group
1.4 run 'run_TLD.m', TLD should track a motorbike
2. Mac
...
3. Linux
1.1 Install OpenCV
sudo apt-get install libcv-dev (this will most probably be 2.1)
1.2a Install Matlab (>= R2009b). Possibly you will need some extension toolboxes
include:
Image Acquisition Toolbox
Image Processing Toolbox
Signal Processing Toolbox
Statistics Toolbox
1.2b There are efforts underway to make TLD work with Octave, an open source alternative to Matlab
You will need to install octave >=3.4.
Also, install octave extension packages miscellaneous, image, statistics from http://octave.sourceforge.net/packages.php
1.3 Check paths in 'compile.m' file
1.4 run 'compile.m', (either in matlab or octave). If you get errors go to OpenTLD discussion group
1.5 run 'run_TLD.m', TLD should track a motorbike
----------------------------------------------------------------------------
(c) 2011 Zdenek Kalal, [email protected]