|
1 | 1 | # C++ KCF Tracker
|
2 |
| -This package includes a C++ class with several tracking methods based on the Kernelized Correlation Filter (KCF) [1, 2]. |
3 |
| - |
| 2 | +This package includes a C++ class with several tracking methods based on the Kernelized Correlation Filter (KCF) [1, 2]. |
4 | 3 | It also includes an executable to interface with the VOT benchmark.
|
5 | 4 |
|
6 |
| - |
7 |
| -[1] J. F. Henriques, R. Caseiro, P. Martins, J. Batista, |
| 5 | +[1] J. F. Henriques, R. Caseiro, P. Martins, J. Batista, |
8 | 6 | "High-Speed Tracking with Kernelized Correlation Filters", TPAMI 2015.
|
9 | 7 |
|
10 |
| -[2] J. F. Henriques, R. Caseiro, P. Martins, J. Batista, |
| 8 | +[2] J. F. Henriques, R. Caseiro, P. Martins, J. Batista, |
11 | 9 | "Exploiting the Circulant Structure of Tracking-by-detection with Kernels", ECCV 2012.
|
12 | 10 |
|
13 | 11 |
|
14 |
| -Authors: Joao Faro, Christian Bailer, Joao F. Henriques |
15 |
| - |
16 |
| - |
17 |
| - |
18 |
| -Institute of Systems and Robotics - University of Coimbra / Department of Augmented Vision DFKI |
19 |
| - |
| 12 | +Authors: Joao Faro, Christian Bailer, Joao F. Henriques |
| 13 | + |
| 14 | +Institute of Systems and Robotics - University of Coimbra / Department of Augmented Vision DFKI |
20 | 15 |
|
21 | 16 | ### Algorithms (in this folder) ###
|
22 | 17 |
|
23 |
| -"KCFC++", command: ./KCF |
24 |
| - |
| 18 | +"KCFC++", command: ./KCF |
25 | 19 | Description: KCF on HOG features, ported to C++ OpenCV. The original Matlab tracker placed 3rd in VOT 2014.
|
26 | 20 |
|
| 21 | +"KCFLabC++", command: ./KCF lab |
| 22 | +Description: KCF on HOG and Lab features, ported to C++ OpenCV. The Lab features are computed by quantizing CIE-Lab colors into 15 centroids, obtained from natural images by k-means. |
27 | 23 |
|
28 |
| -"KCFLabC++", command: ./KCF lab |
29 |
| - |
30 |
| -Description: KCF on HOG and Lab features, ported to C++ OpenCV. The Lab features are computed by quantizing CIE-Lab colors into 15 centroids, obtained from natural images by k-means. |
31 |
| - |
32 |
| - |
33 |
| -The CSK tracker [2] is also implemented as a bonus, simply by using raw grayscale as features (the filter becomes single-channel). |
34 |
| - |
| 24 | +The CSK tracker [2] is also implemented as a bonus, simply by using raw grayscale as features (the filter becomes single-channel). |
35 | 25 |
|
36 | 26 | ### Compilation instructions ###
|
37 |
| -There are no external dependencies other than OpenCV 3.0.0. Tested on a freshly installed Ubuntu 14.04. |
38 |
| - |
39 |
| -1) cmake CMakeLists.txt |
40 |
| - |
41 |
| -2) make |
| 27 | +There are no external dependencies other than OpenCV 3.0.0. Tested on a freshly installed Ubuntu 14.04. |
42 | 28 |
|
| 29 | +1) cmake CMakeLists.txt |
| 30 | +2) make |
43 | 31 |
|
44 | 32 | ### Running instructions ###
|
45 | 33 |
|
46 |
| -The runtracker.cpp is prepared to be used with the VOT toolkit. The executable "KCF" should be called as: |
47 |
| - |
| 34 | +The runtracker.cpp is prepared to be used with the VOT toolkit. The executable "KCF" should be called as: |
48 | 35 |
|
49 | 36 | ./KCF [OPTION_1] [OPTION_2] [...]
|
50 | 37 |
|
| 38 | +Options available: |
51 | 39 |
|
52 |
| -Options available: |
53 |
| - |
54 |
| - |
55 |
| -gray - Use raw gray level features as in [1]. |
56 |
| - |
57 |
| -hog - Use HOG features as in [2]. |
58 |
| - |
59 |
| -lab - Use Lab colorspace features. This option will also enable HOG features by default. |
60 |
| - |
61 |
| -singlescale - Performs single-scale detection, using a variable-size window. |
62 |
| - |
63 |
| -fixed_window - Keep the window size fixed when in single-scale mode (multi-scale always used a fixed window). |
64 |
| - |
65 |
| -show - Show the results in a window. |
66 |
| - |
| 40 | +gray - Use raw gray level features as in [1]. |
| 41 | +hog - Use HOG features as in [2]. |
| 42 | +lab - Use Lab colorspace features. This option will also enable HOG features by default. |
| 43 | +singlescale - Performs single-scale detection, using a variable-size window. |
| 44 | +fixed_window - Keep the window size fixed when in single-scale mode (multi-scale always used a fixed window). |
| 45 | +show - Show the results in a window. |
67 | 46 |
|
68 | 47 | To include it in your project, without the VOT toolkit you just need to:
|
69 | 48 |
|
|
0 commit comments