]> rtime.felk.cvut.cz Git - hercules2020/kcf.git/blob - src/kcf.cpp
Merge branch 'visual-debug'
[hercules2020/kcf.git] / src / kcf.cpp
1 #include "kcf.h"
2 #include <numeric>
3 #include <thread>
4 #include <algorithm>
5 #include "threadctx.hpp"
6 #include "debug.h"
7
8 #ifdef FFTW
9 #include "fft_fftw.h"
10 #define FFT Fftw
11 #elif defined(CUFFT)
12 #include "fft_cufft.h"
13 #define FFT cuFFT
14 #else
15 #include "fft_opencv.h"
16 #define FFT FftOpencv
17 #endif
18
19 #ifdef OPENMP
20 #include <omp.h>
21 #endif // OPENMP
22
23 DbgTracer __dbgTracer;
24
25 template <typename T>
26 T clamp(const T& n, const T& lower, const T& upper)
27 {
28     return std::max(lower, std::min(n, upper));
29 }
30
31 template <typename T>
32 void clamp2(T& n, const T& lower, const T& upper)
33 {
34     n = std::max(lower, std::min(n, upper));
35 }
36
37 #if CV_MAJOR_VERSION < 3
38 template<typename _Tp> static inline
39 cv::Size_<_Tp> operator / (const cv::Size_<_Tp>& a, _Tp b)
40 {
41     return cv::Size_<_Tp>(a.width / b, a.height / b);
42 }
43 #endif
44
45 class Kcf_Tracker_Private {
46     friend KCF_Tracker;
47     std::vector<ThreadCtx> threadctxs;
48 };
49
50 KCF_Tracker::KCF_Tracker(double padding, double kernel_sigma, double lambda, double interp_factor,
51                          double output_sigma_factor, int cell_size)
52     : p_cell_size(cell_size), fft(*new FFT()), p_padding(padding), p_output_sigma_factor(output_sigma_factor), p_kernel_sigma(kernel_sigma),
53       p_lambda(lambda), p_interp_factor(interp_factor), d(*new Kcf_Tracker_Private)
54 {
55 }
56
57 KCF_Tracker::KCF_Tracker() : fft(*new FFT()), d(*new Kcf_Tracker_Private) {}
58
59 KCF_Tracker::~KCF_Tracker()
60 {
61     delete &fft;
62     delete &d;
63 }
64
65 void KCF_Tracker::train(cv::Mat input_rgb, cv::Mat input_gray, double interp_factor)
66 {
67     TRACE("");
68
69     // obtain a sub-window for training
70     // TODO: Move Mats outside from here
71     MatScaleFeats patch_feats(1, p_num_of_feats, feature_size);
72     DEBUG_PRINT(patch_feats);
73     MatScaleFeats temp(1, p_num_of_feats, feature_size);
74     get_features(input_rgb, input_gray, p_current_center.x, p_current_center.y,
75                  p_windows_size.width, p_windows_size.height,
76                  p_current_scale).copyTo(patch_feats.scale(0));
77     DEBUG_PRINT(patch_feats);
78     fft.forward_window(patch_feats, p_xf, temp);
79     DEBUG_PRINTM(p_xf);
80     p_model_xf = p_model_xf * (1. - interp_factor) + p_xf * interp_factor;
81     DEBUG_PRINTM(p_model_xf);
82
83     ComplexMat alphaf_num, alphaf_den;
84
85     if (m_use_linearkernel) {
86         ComplexMat xfconj = p_xf.conj();
87         alphaf_num = xfconj.mul(p_yf);
88         alphaf_den = (p_xf * xfconj);
89     } else {
90         // Kernel Ridge Regression, calculate alphas (in Fourier domain)
91         cv::Size sz(Fft::freq_size(feature_size));
92         ComplexMat kf(sz.height, sz.width, 1);
93         (*gaussian_correlation)(kf, p_model_xf, p_model_xf, p_kernel_sigma, true, *this);
94         DEBUG_PRINTM(kf);
95         p_model_alphaf_num = p_yf * kf;
96         p_model_alphaf_den = kf * (kf + p_lambda);
97     }
98     p_model_alphaf = p_model_alphaf_num / p_model_alphaf_den;
99     DEBUG_PRINTM(p_model_alphaf);
100     //        p_model_alphaf = p_yf / (kf + p_lambda);   //equation for fast training
101 }
102
103 static int round_pw2_down(int x)
104 {
105         for (int i = 1; i < 32; i <<= 1)
106             x |= x >> i;
107         x++;
108         return x >> 1;
109 }
110
111
112 void KCF_Tracker::init(cv::Mat &img, const cv::Rect &bbox, int fit_size_x, int fit_size_y)
113 {
114     __dbgTracer.debug = m_debug;
115     TRACE("");
116
117     // check boundary, enforce min size
118     double x1 = bbox.x, x2 = bbox.x + bbox.width, y1 = bbox.y, y2 = bbox.y + bbox.height;
119     if (x1 < 0) x1 = 0.;
120     if (x2 > img.cols - 1) x2 = img.cols - 1;
121     if (y1 < 0) y1 = 0;
122     if (y2 > img.rows - 1) y2 = img.rows - 1;
123
124     if (x2 - x1 < 2 * p_cell_size) {
125         double diff = (2 * p_cell_size - x2 + x1) / 2.;
126         if (x1 - diff >= 0 && x2 + diff < img.cols) {
127             x1 -= diff;
128             x2 += diff;
129         } else if (x1 - 2 * diff >= 0) {
130             x1 -= 2 * diff;
131         } else {
132             x2 += 2 * diff;
133         }
134     }
135     if (y2 - y1 < 2 * p_cell_size) {
136         double diff = (2 * p_cell_size - y2 + y1) / 2.;
137         if (y1 - diff >= 0 && y2 + diff < img.rows) {
138             y1 -= diff;
139             y2 += diff;
140         } else if (y1 - 2 * diff >= 0) {
141             y1 -= 2 * diff;
142         } else {
143             y2 += 2 * diff;
144         }
145     }
146
147     p_init_pose.w = x2 - x1;
148     p_init_pose.h = y2 - y1;
149     p_init_pose.cx = x1 + p_init_pose.w / 2.;
150     p_init_pose.cy = y1 + p_init_pose.h / 2.;
151
152     cv::Mat input_gray, input_rgb = img.clone();
153     if (img.channels() == 3) {
154         cv::cvtColor(img, input_gray, CV_BGR2GRAY);
155         input_gray.convertTo(input_gray, CV_32FC1);
156     } else
157         img.convertTo(input_gray, CV_32FC1);
158
159     // don't need too large image
160     if (p_init_pose.w * p_init_pose.h > 100. * 100.) {
161         std::cout << "resizing image by factor of " << 1 / p_downscale_factor << std::endl;
162         p_resize_image = true;
163         p_init_pose.scale(p_downscale_factor);
164         cv::resize(input_gray, input_gray, cv::Size(0, 0), p_downscale_factor, p_downscale_factor, cv::INTER_AREA);
165         cv::resize(input_rgb, input_rgb, cv::Size(0, 0), p_downscale_factor, p_downscale_factor, cv::INTER_AREA);
166     }
167
168     // compute win size + fit to fhog cell size
169     p_windows_size.width = round(p_init_pose.w * (1. + p_padding) / p_cell_size) * p_cell_size;
170     p_windows_size.height = round(p_init_pose.h * (1. + p_padding) / p_cell_size) * p_cell_size;
171
172     if (fit_size_x == 0 || fit_size_y == 0) {
173         // Round down to the next highest power of 2
174         fit_size = cv::Size(round_pw2_down(p_windows_size.width),
175                             round_pw2_down(p_windows_size.height));
176     } else if (fit_size_x == -1 || fit_size_y == -1) {
177         fit_size =  p_windows_size;
178     } else {
179         fit_size = cv::Size(fit_size_x, fit_size_y);
180     }
181
182     feature_size = fit_size / p_cell_size;
183
184     p_scales.clear();
185     for (int i = -int(p_num_scales) / 2; i <= int(p_num_scales) / 2; ++i)
186         p_scales.push_back(std::pow(p_scale_step, i));
187
188 #ifdef CUFFT
189     if (Fft::freq_size(feature_size).area() > 1024) {
190         std::cerr << "Window after forward FFT is too big for CUDA kernels. Plese use -f to set "
191                      "the window dimensions so its size is less or equal to "
192                   << 1024 * p_cell_size * p_cell_size * 2 + 1
193                   << " pixels. Currently the size of the window is: " << fit_size
194                   << " which is  " << fit_size.area() << " pixels. " << std::endl;
195         std::exit(EXIT_FAILURE);
196     }
197
198     if (m_use_linearkernel) {
199         std::cerr << "cuFFT supports only Gaussian kernel." << std::endl;
200         std::exit(EXIT_FAILURE);
201     }
202 #endif
203
204 #if defined(CUFFT) || defined(FFTW)
205     uint width = feature_size.width / 2 + 1;
206 #else
207     uint width = feature_size.width;
208 #endif
209     p_model_xf.create(feature_size.height, width, p_num_of_feats);
210     p_yf.create(feature_size.height, width, 1);
211     p_xf.create(feature_size.height, width, p_num_of_feats);
212
213 #ifndef BIG_BATCH
214     for (auto scale: p_scales)
215         d.threadctxs.emplace_back(feature_size, p_num_of_feats, scale);
216 #else
217     d.threadctxs.emplace_back(feature_size, p_num_of_feats, p_num_scales);
218 #endif
219
220     gaussian_correlation.reset(new GaussianCorrelation(1, feature_size));
221
222     p_current_center = p_init_pose.center();
223     p_current_scale = 1.;
224
225     double min_size_ratio = std::max(5. * p_cell_size / p_windows_size.width, 5. * p_cell_size / p_windows_size.height);
226     double max_size_ratio =
227         std::min(floor((img.cols + p_windows_size.width / 3) / p_cell_size) * p_cell_size / p_windows_size.width,
228                  floor((img.rows + p_windows_size.height / 3) / p_cell_size) * p_cell_size / p_windows_size.height);
229     p_min_max_scale[0] = std::pow(p_scale_step, std::ceil(std::log(min_size_ratio) / log(p_scale_step)));
230     p_min_max_scale[1] = std::pow(p_scale_step, std::floor(std::log(max_size_ratio) / log(p_scale_step)));
231
232     std::cout << "init: img size " << img.size() << std::endl;
233     std::cout << "init: win size " << p_windows_size;
234     if (p_windows_size != fit_size)
235         std::cout << " resized to " << fit_size;
236     std::cout << std::endl;
237     std::cout << "init: FFT size " << feature_size << std::endl;
238     std::cout << "init: min max scales factors: " << p_min_max_scale[0] << " " << p_min_max_scale[1] << std::endl;
239
240     p_output_sigma = std::sqrt(p_init_pose.w * p_init_pose.h * double(fit_size.area()) / p_windows_size.area())
241            * p_output_sigma_factor / p_cell_size;
242
243     fft.init(feature_size.width, feature_size.height, p_num_of_feats, p_num_scales);
244     fft.set_window(MatDynMem(cosine_window_function(feature_size.width, feature_size.height)));
245
246     // window weights, i.e. labels
247     MatScales gsl(1, feature_size);
248     gaussian_shaped_labels(p_output_sigma, feature_size.width, feature_size.height).copyTo(gsl.plane(0));
249     fft.forward(gsl, p_yf);
250     DEBUG_PRINTM(p_yf);
251
252     // train initial model
253     train(input_rgb, input_gray, 1.0);
254 }
255
256 void KCF_Tracker::setTrackerPose(BBox_c &bbox, cv::Mat &img, int fit_size_x, int fit_size_y)
257 {
258     init(img, bbox.get_rect(), fit_size_x, fit_size_y);
259 }
260
261 void KCF_Tracker::updateTrackerPosition(BBox_c &bbox)
262 {
263     BBox_c tmp = bbox;
264     if (p_resize_image) {
265         tmp.scale(p_downscale_factor);
266     }
267     p_current_center = tmp.center();
268 }
269
270 BBox_c KCF_Tracker::getBBox()
271 {
272     BBox_c tmp;
273     tmp.cx = p_current_center.x;
274     tmp.cy = p_current_center.y;
275     tmp.w = p_init_pose.w * p_current_scale;
276     tmp.h = p_init_pose.h * p_current_scale;
277
278     if (p_resize_image)
279         tmp.scale(1 / p_downscale_factor);
280
281     return tmp;
282 }
283
284 double KCF_Tracker::getFilterResponse() const
285 {
286     return this->max_response;
287 }
288
289 void KCF_Tracker::resizeImgs(cv::Mat &input_rgb, cv::Mat &input_gray)
290 {
291     if (p_resize_image) {
292         cv::resize(input_gray, input_gray, cv::Size(0, 0), p_downscale_factor, p_downscale_factor, cv::INTER_AREA);
293         cv::resize(input_rgb, input_rgb, cv::Size(0, 0), p_downscale_factor, p_downscale_factor, cv::INTER_AREA);
294     }
295 }
296
297 double KCF_Tracker::findMaxReponse(uint &max_idx, cv::Point2d &new_location) const
298 {
299     double max = -1.;
300 #ifndef BIG_BATCH
301     for (uint j = 0; j < d.threadctxs.size(); ++j) {
302         if (d.threadctxs[j].max.response > max) {
303             max = d.threadctxs[j].max.response;
304             max_idx = j;
305         }
306     }
307 #else
308     for (uint j = 0; j < p_scales.size(); ++j) {
309         if (d.threadctxs[0].max[j].response > max) {
310             max = d.threadctxs[0].max[j].response;
311             max_idx = j;
312         }
313     }
314 #endif
315
316     if (m_visual_debug) {
317         cv::Mat all_responses(cv::Size(p_num_angles * 100, p_num_scales * 100),
318                               d.threadctxs[max_idx].response.plane(0).type(), cv::Scalar::all(0));
319         for (size_t i = 0; i < p_num_scales; ++i) {
320             for (size_t j = 0; j < p_num_angles; ++j) {
321                 cv::Mat in_roi(all_responses, cv::Rect(j * 100, i * 100, 100, 100));
322                 cv::Mat copy_response = d.threadctxs[p_num_angles * i + j].response.plane(0).clone();
323
324                 copy_response = copy_response(cv::Rect(0, 0, copy_response.cols & -2, copy_response.rows & -2));
325
326                 int cx = copy_response.cols / 2;
327                 int cy = copy_response.rows / 2;
328                 cv::Mat q0(copy_response, cv::Rect(0, 0, cx, cy));
329                 cv::Mat q1(copy_response, cv::Rect(cx, 0, cx, cy));
330                 cv::Mat q2(copy_response, cv::Rect(0, cy, cx, cy));
331                 cv::Mat q3(copy_response, cv::Rect(cx, cy, cx, cy));
332                 cv::Mat tmp;
333                 q0.copyTo(tmp);
334                 q3.copyTo(q0);
335                 tmp.copyTo(q3);
336                 q1.copyTo(tmp);
337                 q2.copyTo(q1);
338                 tmp.copyTo(q2);
339
340                 copy_response.copyTo(in_roi);
341             }
342         }
343         cv::namedWindow("All responses", CV_WINDOW_AUTOSIZE);
344         cv::imshow("All responses", all_responses);
345         cv::waitKey();
346     }
347
348     cv::Point2i &max_response_pt = IF_BIG_BATCH(d.threadctxs[0].max[max_idx].loc,        d.threadctxs[max_idx].max.loc);
349     cv::Mat max_response_map     = IF_BIG_BATCH(d.threadctxs[0].response.plane(max_idx), d.threadctxs[max_idx].response.plane(0));
350
351     DEBUG_PRINTM(max_response_map);
352     DEBUG_PRINT(max_response_pt);
353
354     // sub pixel quadratic interpolation from neighbours
355     if (max_response_pt.y > max_response_map.rows / 2) // wrap around to negative half-space of vertical axis
356         max_response_pt.y = max_response_pt.y - max_response_map.rows;
357     if (max_response_pt.x > max_response_map.cols / 2) // same for horizontal axis
358         max_response_pt.x = max_response_pt.x - max_response_map.cols;
359
360
361     if (m_use_subpixel_localization) {
362         new_location = sub_pixel_peak(max_response_pt, max_response_map);
363     } else {
364         new_location = max_response_pt;
365     }
366     DEBUG_PRINT(new_location);
367     return max;
368 }
369
370 void KCF_Tracker::track(cv::Mat &img)
371 {
372     __dbgTracer.debug = m_debug;
373     TRACE("");
374
375     cv::Mat input_gray, input_rgb = img.clone();
376     if (img.channels() == 3) {
377         cv::cvtColor(img, input_gray, CV_BGR2GRAY);
378         input_gray.convertTo(input_gray, CV_32FC1);
379     } else
380         img.convertTo(input_gray, CV_32FC1);
381
382     // don't need too large image
383     resizeImgs(input_rgb, input_gray);
384
385 #ifdef ASYNC
386     for (auto &it : d.threadctxs)
387         it.async_res = std::async(std::launch::async, [this, &input_gray, &input_rgb, &it]() -> void {
388             it.track(*this, input_rgb, input_gray);
389         });
390     for (auto const &it : d.threadctxs)
391         it.async_res.wait();
392
393 #else  // !ASYNC
394     NORMAL_OMP_PARALLEL_FOR
395     for (uint i = 0; i < d.threadctxs.size(); ++i)
396         d.threadctxs[i].track(*this, input_rgb, input_gray);
397 #endif
398
399     cv::Point2d new_location;
400     uint max_idx;
401     max_response = findMaxReponse(max_idx, new_location);
402
403     new_location.x *= double(p_windows_size.width) / fit_size.width;
404     new_location.y *= double(p_windows_size.height) / fit_size.height;
405
406     p_current_center += p_current_scale * p_cell_size * new_location;
407
408     clamp2(p_current_center.x, 0.0, img.cols - 1.0);
409     clamp2(p_current_center.y, 0.0, img.rows - 1.0);
410
411     // sub grid scale interpolation
412     if (m_use_subgrid_scale) {
413         p_current_scale *= sub_grid_scale(max_idx);
414     } else {
415         p_current_scale *= p_scales[max_idx];
416     }
417
418     clamp2(p_current_scale, p_min_max_scale[0], p_min_max_scale[1]);
419
420     // train at newly estimated target position
421     train(input_rgb, input_gray, p_interp_factor);
422 }
423
424 void ThreadCtx::track(const KCF_Tracker &kcf, cv::Mat &input_rgb, cv::Mat &input_gray)
425 {
426     TRACE("");
427
428     BIG_BATCH_OMP_PARALLEL_FOR
429     for (uint i = 0; i < IF_BIG_BATCH(kcf.p_num_scales, 1); ++i)
430     {
431         kcf.get_features(input_rgb, input_gray, kcf.p_current_center.x, kcf.p_current_center.y,
432                          kcf.p_windows_size.width, kcf.p_windows_size.height,
433                          kcf.p_current_scale * IF_BIG_BATCH(kcf.p_scales[i], scale))
434                 .copyTo(patch_feats.scale(i));
435         DEBUG_PRINT(patch_feats.scale(i));
436     }
437
438     kcf.fft.forward_window(patch_feats, zf, temp);
439     DEBUG_PRINTM(zf);
440
441     if (kcf.m_use_linearkernel) {
442         kzf = zf.mul(kcf.p_model_alphaf).sum_over_channels();
443     } else {
444         gaussian_correlation(kzf, zf, kcf.p_model_xf, kcf.p_kernel_sigma, false, kcf);
445         DEBUG_PRINTM(kzf);
446         kzf = kzf.mul(kcf.p_model_alphaf);
447     }
448     kcf.fft.inverse(kzf, response);
449
450     DEBUG_PRINTM(response);
451
452     /* target location is at the maximum response. we must take into
453     account the fact that, if the target doesn't move, the peak
454     will appear at the top-left corner, not at the center (this is
455     discussed in the paper). the responses wrap around cyclically. */
456     double min_val, max_val;
457     cv::Point2i min_loc, max_loc;
458 #ifdef BIG_BATCH
459     for (size_t i = 0; i < kcf.p_scales.size(); ++i) {
460         cv::minMaxLoc(response.plane(i), &min_val, &max_val, &min_loc, &max_loc);
461         DEBUG_PRINT(max_loc);
462         double weight = kcf.p_scales[i] < 1. ? kcf.p_scales[i] : 1. / kcf.p_scales[i];
463         max[i].response = max_val * weight;
464         max[i].loc = max_loc;
465     }
466 #else
467     cv::minMaxLoc(response.plane(0), &min_val, &max_val, &min_loc, &max_loc);
468
469     DEBUG_PRINT(max_loc);
470     DEBUG_PRINT(max_val);
471
472     double weight = scale < 1. ? scale : 1. / scale;
473     max.response = max_val * weight;
474     max.loc = max_loc;
475 #endif
476 }
477
478 // ****************************************************************************
479
480 cv::Mat KCF_Tracker::get_features(cv::Mat &input_rgb, cv::Mat &input_gray, int cx, int cy,
481                                   int size_x, int size_y, double scale) const
482 {
483     cv::Size scaled = cv::Size(floor(size_x * scale), floor(size_y * scale));
484
485     cv::Mat patch_gray = get_subwindow(input_gray, cx, cy, scaled.width, scaled.height);
486     cv::Mat patch_rgb = get_subwindow(input_rgb, cx, cy, scaled.width, scaled.height);
487
488     // resize to default size
489     if (scaled.area() > fit_size.area()) {
490         // if we downsample use  INTER_AREA interpolation
491         // note: this is just a guess - we may downsample in X and upsample in Y (or vice versa)
492         cv::resize(patch_gray, patch_gray, fit_size, 0., 0., cv::INTER_AREA);
493     } else {
494         cv::resize(patch_gray, patch_gray, fit_size, 0., 0., cv::INTER_LINEAR);
495     }
496
497     // get hog(Histogram of Oriented Gradients) features
498     std::vector<cv::Mat> hog_feat = FHoG::extract(patch_gray, 2, p_cell_size, 9);
499
500     // get color rgb features (simple r,g,b channels)
501     std::vector<cv::Mat> color_feat;
502     if ((m_use_color || m_use_cnfeat) && input_rgb.channels() == 3) {
503         // resize to default size
504         if (scaled.area() > (fit_size / p_cell_size).area()) {
505             // if we downsample use  INTER_AREA interpolation
506             cv::resize(patch_rgb, patch_rgb, fit_size / p_cell_size, 0., 0., cv::INTER_AREA);
507         } else {
508             cv::resize(patch_rgb, patch_rgb, fit_size / p_cell_size, 0., 0., cv::INTER_LINEAR);
509         }
510     }
511
512     if (m_use_color && input_rgb.channels() == 3) {
513         // use rgb color space
514         cv::Mat patch_rgb_norm;
515         patch_rgb.convertTo(patch_rgb_norm, CV_32F, 1. / 255., -0.5);
516         cv::Mat ch1(patch_rgb_norm.size(), CV_32FC1);
517         cv::Mat ch2(patch_rgb_norm.size(), CV_32FC1);
518         cv::Mat ch3(patch_rgb_norm.size(), CV_32FC1);
519         std::vector<cv::Mat> rgb = {ch1, ch2, ch3};
520         cv::split(patch_rgb_norm, rgb);
521         color_feat.insert(color_feat.end(), rgb.begin(), rgb.end());
522     }
523
524     if (m_use_cnfeat && input_rgb.channels() == 3) {
525         std::vector<cv::Mat> cn_feat = CNFeat::extract(patch_rgb);
526         color_feat.insert(color_feat.end(), cn_feat.begin(), cn_feat.end());
527     }
528
529     hog_feat.insert(hog_feat.end(), color_feat.begin(), color_feat.end());
530
531     int size[] = {p_num_of_feats, feature_size.height, feature_size.width};
532     cv::Mat result(3, size, CV_32F);
533     for (uint i = 0; i < hog_feat.size(); ++i)
534         hog_feat[i].copyTo(cv::Mat(size[1], size[2], CV_32FC1, result.ptr(i)));
535
536     return result;
537 }
538
539 cv::Mat KCF_Tracker::gaussian_shaped_labels(double sigma, int dim1, int dim2)
540 {
541     cv::Mat labels(dim2, dim1, CV_32FC1);
542     int range_y[2] = {-dim2 / 2, dim2 - dim2 / 2};
543     int range_x[2] = {-dim1 / 2, dim1 - dim1 / 2};
544
545     double sigma_s = sigma * sigma;
546
547     for (int y = range_y[0], j = 0; y < range_y[1]; ++y, ++j) {
548         float *row_ptr = labels.ptr<float>(j);
549         double y_s = y * y;
550         for (int x = range_x[0], i = 0; x < range_x[1]; ++x, ++i) {
551             row_ptr[i] = std::exp(-0.5 * (y_s + x * x) / sigma_s); //-1/2*e^((y^2+x^2)/sigma^2)
552         }
553     }
554
555     // rotate so that 1 is at top-left corner (see KCF paper for explanation)
556     MatDynMem rot_labels = circshift(labels, range_x[0], range_y[0]);
557     // sanity check, 1 at top left corner
558     assert(rot_labels.at<float>(0, 0) >= 1.f - 1e-10f);
559
560     return rot_labels;
561 }
562
563 cv::Mat KCF_Tracker::circshift(const cv::Mat &patch, int x_rot, int y_rot)
564 {
565     cv::Mat rot_patch(patch.size(), CV_32FC1);
566     cv::Mat tmp_x_rot(patch.size(), CV_32FC1);
567
568     // circular rotate x-axis
569     if (x_rot < 0) {
570         // move part that does not rotate over the edge
571         cv::Range orig_range(-x_rot, patch.cols);
572         cv::Range rot_range(0, patch.cols - (-x_rot));
573         patch(cv::Range::all(), orig_range).copyTo(tmp_x_rot(cv::Range::all(), rot_range));
574
575         // rotated part
576         orig_range = cv::Range(0, -x_rot);
577         rot_range = cv::Range(patch.cols - (-x_rot), patch.cols);
578         patch(cv::Range::all(), orig_range).copyTo(tmp_x_rot(cv::Range::all(), rot_range));
579     } else if (x_rot > 0) {
580         // move part that does not rotate over the edge
581         cv::Range orig_range(0, patch.cols - x_rot);
582         cv::Range rot_range(x_rot, patch.cols);
583         patch(cv::Range::all(), orig_range).copyTo(tmp_x_rot(cv::Range::all(), rot_range));
584
585         // rotated part
586         orig_range = cv::Range(patch.cols - x_rot, patch.cols);
587         rot_range = cv::Range(0, x_rot);
588         patch(cv::Range::all(), orig_range).copyTo(tmp_x_rot(cv::Range::all(), rot_range));
589     } else { // zero rotation
590         // move part that does not rotate over the edge
591         cv::Range orig_range(0, patch.cols);
592         cv::Range rot_range(0, patch.cols);
593         patch(cv::Range::all(), orig_range).copyTo(tmp_x_rot(cv::Range::all(), rot_range));
594     }
595
596     // circular rotate y-axis
597     if (y_rot < 0) {
598         // move part that does not rotate over the edge
599         cv::Range orig_range(-y_rot, patch.rows);
600         cv::Range rot_range(0, patch.rows - (-y_rot));
601         tmp_x_rot(orig_range, cv::Range::all()).copyTo(rot_patch(rot_range, cv::Range::all()));
602
603         // rotated part
604         orig_range = cv::Range(0, -y_rot);
605         rot_range = cv::Range(patch.rows - (-y_rot), patch.rows);
606         tmp_x_rot(orig_range, cv::Range::all()).copyTo(rot_patch(rot_range, cv::Range::all()));
607     } else if (y_rot > 0) {
608         // move part that does not rotate over the edge
609         cv::Range orig_range(0, patch.rows - y_rot);
610         cv::Range rot_range(y_rot, patch.rows);
611         tmp_x_rot(orig_range, cv::Range::all()).copyTo(rot_patch(rot_range, cv::Range::all()));
612
613         // rotated part
614         orig_range = cv::Range(patch.rows - y_rot, patch.rows);
615         rot_range = cv::Range(0, y_rot);
616         tmp_x_rot(orig_range, cv::Range::all()).copyTo(rot_patch(rot_range, cv::Range::all()));
617     } else { // zero rotation
618         // move part that does not rotate over the edge
619         cv::Range orig_range(0, patch.rows);
620         cv::Range rot_range(0, patch.rows);
621         tmp_x_rot(orig_range, cv::Range::all()).copyTo(rot_patch(rot_range, cv::Range::all()));
622     }
623
624     return rot_patch;
625 }
626
627 // hann window actually (Power-of-cosine windows)
628 cv::Mat KCF_Tracker::cosine_window_function(int dim1, int dim2)
629 {
630     cv::Mat m1(1, dim1, CV_32FC1), m2(dim2, 1, CV_32FC1);
631     double N_inv = 1. / (static_cast<double>(dim1) - 1.);
632     for (int i = 0; i < dim1; ++i)
633         m1.at<float>(i) = float(0.5 * (1. - std::cos(2. * CV_PI * static_cast<double>(i) * N_inv)));
634     N_inv = 1. / (static_cast<double>(dim2) - 1.);
635     for (int i = 0; i < dim2; ++i)
636         m2.at<float>(i) = float(0.5 * (1. - std::cos(2. * CV_PI * static_cast<double>(i) * N_inv)));
637     cv::Mat ret = m2 * m1;
638     return ret;
639 }
640
641 // Returns sub-window of image input centered at [cx, cy] coordinates),
642 // with size [width, height]. If any pixels are outside of the image,
643 // they will replicate the values at the borders.
644 cv::Mat KCF_Tracker::get_subwindow(const cv::Mat &input, int cx, int cy, int width, int height) const
645 {
646     cv::Mat patch;
647
648     int x1 = cx - width / 2;
649     int y1 = cy - height / 2;
650     int x2 = cx + width / 2;
651     int y2 = cy + height / 2;
652
653     // out of image
654     if (x1 >= input.cols || y1 >= input.rows || x2 < 0 || y2 < 0) {
655         patch.create(height, width, input.type());
656         patch.setTo(double(0.f));
657         return patch;
658     }
659
660     int top = 0, bottom = 0, left = 0, right = 0;
661
662     // fit to image coordinates, set border extensions;
663     if (x1 < 0) {
664         left = -x1;
665         x1 = 0;
666     }
667     if (y1 < 0) {
668         top = -y1;
669         y1 = 0;
670     }
671     if (x2 >= input.cols) {
672         right = x2 - input.cols + width % 2;
673         x2 = input.cols;
674     } else
675         x2 += width % 2;
676
677     if (y2 >= input.rows) {
678         bottom = y2 - input.rows + height % 2;
679         y2 = input.rows;
680     } else
681         y2 += height % 2;
682
683     if (x2 - x1 == 0 || y2 - y1 == 0)
684         patch = cv::Mat::zeros(height, width, CV_32FC1);
685     else {
686         cv::copyMakeBorder(input(cv::Range(y1, y2), cv::Range(x1, x2)), patch, top, bottom, left, right,
687                            cv::BORDER_REPLICATE);
688         //      imshow( "copyMakeBorder", patch);
689         //      cv::waitKey();
690     }
691
692     // sanity check
693     assert(patch.cols == width && patch.rows == height);
694
695     return patch;
696 }
697
698 void KCF_Tracker::GaussianCorrelation::operator()(ComplexMat &result, const ComplexMat &xf, const ComplexMat &yf,
699                                                   double sigma, bool auto_correlation, const KCF_Tracker &kcf)
700 {
701     TRACE("");
702     xf.sqr_norm(xf_sqr_norm);
703     if (auto_correlation) {
704         yf_sqr_norm = xf_sqr_norm;
705     } else {
706         yf.sqr_norm(yf_sqr_norm);
707     }
708     xyf = auto_correlation ? xf.sqr_mag() : xf * yf.conj(); // xf.muln(yf.conj());
709     DEBUG_PRINTM(xyf);
710
711     // ifft2 and sum over 3rd dimension, we dont care about individual channels
712     ComplexMat xyf_sum = xyf.sum_over_channels();
713     DEBUG_PRINTM(xyf_sum);
714     kcf.fft.inverse(xyf_sum, ifft_res);
715     DEBUG_PRINTM(ifft_res);
716 #ifdef CUFFT
717     // FIXME
718     cuda_gaussian_correlation(ifft_res.deviceMem(), k.deviceMem(), xf_sqr_norm.deviceMem(),
719                               auto_correlation ? xf_sqr_norm.deviceMem() : yf_sqr_norm.deviceMem(), sigma,
720                               xf.n_channels, xf.n_scales, kcf.feature_size.height, kcf.feature_size.width);
721 #else
722
723     float numel_xf_inv = 1.f / (xf.cols * xf.rows * (xf.channels() / xf.n_scales));
724     for (uint i = 0; i < xf.n_scales; ++i) {
725         cv::Mat plane = ifft_res.plane(i);
726         DEBUG_PRINT(ifft_res.plane(i));
727         cv::exp(-1. / (sigma * sigma) * cv::max((xf_sqr_norm[i] + yf_sqr_norm[0] - 2 * ifft_res.plane(i))
728                 * numel_xf_inv, 0), plane);
729         DEBUG_PRINTM(plane);
730     }
731 #endif
732     kcf.fft.forward(ifft_res, result);
733 }
734
735 float get_response_circular(cv::Point2i &pt, cv::Mat &response)
736 {
737     int x = pt.x;
738     int y = pt.y;
739     assert(response.dims == 2); // ensure .cols and .rows are valid
740     if (x < 0) x = response.cols + x;
741     if (y < 0) y = response.rows + y;
742     if (x >= response.cols) x = x - response.cols;
743     if (y >= response.rows) y = y - response.rows;
744
745     return response.at<float>(y, x);
746 }
747
748 cv::Point2f KCF_Tracker::sub_pixel_peak(cv::Point &max_loc, cv::Mat &response) const
749 {
750     // find neighbourhood of max_loc (response is circular)
751     // 1 2 3
752     // 4   5
753     // 6 7 8
754     cv::Point2i p1(max_loc.x - 1, max_loc.y - 1), p2(max_loc.x, max_loc.y - 1), p3(max_loc.x + 1, max_loc.y - 1);
755     cv::Point2i p4(max_loc.x - 1, max_loc.y), p5(max_loc.x + 1, max_loc.y);
756     cv::Point2i p6(max_loc.x - 1, max_loc.y + 1), p7(max_loc.x, max_loc.y + 1), p8(max_loc.x + 1, max_loc.y + 1);
757
758     // clang-format off
759     // fit 2d quadratic function f(x, y) = a*x^2 + b*x*y + c*y^2 + d*x + e*y + f
760     cv::Mat A = (cv::Mat_<float>(9, 6) <<
761                  p1.x*p1.x, p1.x*p1.y, p1.y*p1.y, p1.x, p1.y, 1.f,
762                  p2.x*p2.x, p2.x*p2.y, p2.y*p2.y, p2.x, p2.y, 1.f,
763                  p3.x*p3.x, p3.x*p3.y, p3.y*p3.y, p3.x, p3.y, 1.f,
764                  p4.x*p4.x, p4.x*p4.y, p4.y*p4.y, p4.x, p4.y, 1.f,
765                  p5.x*p5.x, p5.x*p5.y, p5.y*p5.y, p5.x, p5.y, 1.f,
766                  p6.x*p6.x, p6.x*p6.y, p6.y*p6.y, p6.x, p6.y, 1.f,
767                  p7.x*p7.x, p7.x*p7.y, p7.y*p7.y, p7.x, p7.y, 1.f,
768                  p8.x*p8.x, p8.x*p8.y, p8.y*p8.y, p8.x, p8.y, 1.f,
769                  max_loc.x*max_loc.x, max_loc.x*max_loc.y, max_loc.y*max_loc.y, max_loc.x, max_loc.y, 1.f);
770     cv::Mat fval = (cv::Mat_<float>(9, 1) <<
771                     get_response_circular(p1, response),
772                     get_response_circular(p2, response),
773                     get_response_circular(p3, response),
774                     get_response_circular(p4, response),
775                     get_response_circular(p5, response),
776                     get_response_circular(p6, response),
777                     get_response_circular(p7, response),
778                     get_response_circular(p8, response),
779                     get_response_circular(max_loc, response));
780     // clang-format on
781     cv::Mat x;
782     cv::solve(A, fval, x, cv::DECOMP_SVD);
783
784     float a = x.at<float>(0), b = x.at<float>(1), c = x.at<float>(2), d = x.at<float>(3), e = x.at<float>(4);
785
786     cv::Point2f sub_peak(max_loc.x, max_loc.y);
787     if (b > 0 || b < 0) {
788         sub_peak.y = ((2.f * a * e) / b - d) / (b - (4 * a * c) / b);
789         sub_peak.x = (-2 * c * sub_peak.y - e) / b;
790     }
791
792     return sub_peak;
793 }
794
795 double KCF_Tracker::sub_grid_scale(uint index)
796 {
797     cv::Mat A, fval;
798     if (index >= p_scales.size()) {
799         // interpolate from all values
800         // fit 1d quadratic function f(x) = a*x^2 + b*x + c
801         A.create(p_scales.size(), 3, CV_32FC1);
802         fval.create(p_scales.size(), 1, CV_32FC1);
803         for (size_t i = 0; i < p_scales.size(); ++i) {
804             A.at<float>(i, 0) = float(p_scales[i] * p_scales[i]);
805             A.at<float>(i, 1) = float(p_scales[i]);
806             A.at<float>(i, 2) = 1;
807             fval.at<float>(i) = d.threadctxs.back().IF_BIG_BATCH(max[i].response, max.response);
808         }
809     } else {
810         // only from neighbours
811         if (index == 0 || index == p_scales.size() - 1)
812            return p_scales[index];
813
814         A = (cv::Mat_<float>(3, 3) <<
815              p_scales[index - 1] * p_scales[index - 1], p_scales[index - 1], 1,
816              p_scales[index + 0] * p_scales[index + 0], p_scales[index + 0], 1,
817              p_scales[index + 1] * p_scales[index + 1], p_scales[index + 1], 1);
818 #ifdef BIG_BATCH
819         fval = (cv::Mat_<float>(3, 1) <<
820                 d.threadctxs.back().max[index - 1].response,
821                 d.threadctxs.back().max[index + 0].response,
822                 d.threadctxs.back().max[index + 1].response);
823 #else
824         fval = (cv::Mat_<float>(3, 1) <<
825                 d.threadctxs[index - 1].max.response,
826                 d.threadctxs[index + 0].max.response,
827                 d.threadctxs[index + 1].max.response);
828 #endif
829     }
830
831     cv::Mat x;
832     cv::solve(A, fval, x, cv::DECOMP_SVD);
833     float a = x.at<float>(0), b = x.at<float>(1);
834     double scale = p_scales[index];
835     if (a > 0 || a < 0)
836         scale = -b / (2 * a);
837     return scale;
838 }