Added README.md
[mtp.git] / mtp_tracker.cc
1
2 /*
3  *  mtp is the ``Multi Tracked Paths'', an implementation of the
4  *  k-shortest paths algorithm for multi-target tracking.
5  *
6  *  Copyright (c) 2012 Idiap Research Institute, http://www.idiap.ch/
7  *  Written by Francois Fleuret <francois.fleuret@idiap.ch>
8  *
9  *  This file is part of mtp.
10  *
11  *  mtp is free software: you can redistribute it and/or modify it
12  *  under the terms of the GNU General Public License version 3 as
13  *  published by the Free Software Foundation.
14  *
15  *  mtp is distributed in the hope that it will be useful, but WITHOUT
16  *  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
17  *  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
18  *  License for more details.
19  *
20  *  You should have received a copy of the GNU General Public License
21  *  along with selector.  If not, see <http://www.gnu.org/licenses/>.
22  *
23  */
24
25 #include "mtp_tracker.h"
26
27 #include <iostream>
28
29 using namespace std;
30
31 void MTPTracker::free() {
32   delete[] _edge_lengths;
33   delete _graph;
34   deallocate_array<scalar_t>(detection_scores);
35   deallocate_array<int>(allowed_motions);
36   deallocate_array<int>(exits);
37   deallocate_array<int>(entrances);
38 }
39
40 void MTPTracker::allocate(int t, int l) {
41   free();
42
43   nb_locations = l;
44   nb_time_steps = t;
45
46   detection_scores = allocate_array<scalar_t>(nb_time_steps, nb_locations);
47   allowed_motions = allocate_array<int>(nb_locations, nb_locations);
48
49   entrances = allocate_array<int>(nb_time_steps, nb_locations);
50   exits = allocate_array<int>(nb_time_steps, nb_locations);
51
52   for(int l = 0; l < nb_locations; l++) {
53     for(int m = 0; m < nb_locations; m++) {
54       allowed_motions[l][m] = 0;
55     }
56   }
57
58   for(int t = 0; t < nb_time_steps; t++) {
59     for(int l = 0; l < nb_locations; l++) {
60       detection_scores[t][l] = 0.0;
61       entrances[t][l] = 0;
62       exits[t][l] = 0;
63     }
64   }
65
66   _edge_lengths = 0;
67   _graph = 0;
68 }
69
70 void MTPTracker::write(ostream *os) {
71   (*os) << nb_locations << " " << nb_time_steps << endl;
72
73   (*os) << endl;
74
75   for(int l = 0; l < nb_locations; l++) {
76     for(int m = 0; m < nb_locations; m++) {
77       (*os) << allowed_motions[l][m];
78       if(m < nb_locations - 1) (*os) << " "; else (*os) << endl;
79     }
80   }
81
82   (*os) << endl;
83
84   for(int t = 0; t < nb_time_steps; t++) {
85     for(int l = 0; l < nb_locations; l++) {
86       (*os) << entrances[t][l];
87       if(l < nb_locations - 1) (*os) << " "; else (*os) << endl;
88     }
89   }
90
91   (*os) << endl;
92
93   for(int t = 0; t < nb_time_steps; t++) {
94     for(int l = 0; l < nb_locations; l++) {
95       (*os) << exits[t][l];
96       if(l < nb_locations - 1) (*os) << " "; else (*os) << endl;
97     }
98   }
99
100   (*os) << endl;
101
102   for(int t = 0; t < nb_time_steps; t++) {
103     for(int l = 0; l < nb_locations; l++) {
104       (*os) << detection_scores[t][l];
105       if(l < nb_locations - 1) (*os) << " "; else (*os) << endl;
106     }
107   }
108 }
109
110 void MTPTracker::read(istream *is) {
111   int l = 0, t = 0;
112
113   (*is) >> l >> t;
114
115   allocate(t, l);
116
117   for(int l = 0; l < nb_locations; l++) {
118     for(int m = 0; m < nb_locations; m++) {
119       (*is) >> allowed_motions[l][m];
120     }
121   }
122
123   for(int t = 0; t < nb_time_steps; t++) {
124     for(int l = 0; l < nb_locations; l++) {
125       (*is) >> entrances[t][l];
126     }
127   }
128
129   for(int t = 0; t < nb_time_steps; t++) {
130     for(int l = 0; l < nb_locations; l++) {
131       (*is) >> exits[t][l];
132     }
133   }
134
135   for(int t = 0; t < nb_time_steps; t++) {
136     for(int l = 0; l < nb_locations; l++) {
137       (*is) >> detection_scores[t][l];
138     }
139   }
140 }
141
142 void MTPTracker::write_trajectories(ostream *os) {
143   (*os) << nb_trajectories() << endl;
144   for(int t = 0; t < nb_trajectories(); t++) {
145     (*os) << t
146          << " " << trajectory_entrance_time(t)
147          << " " << trajectory_duration(t)
148          << " " << trajectory_score(t);
149     for(int u = 0; u < trajectory_duration(t); u++) {
150       (*os) << " " << trajectory_location(t, u);
151     }
152     (*os) << endl;
153   }
154 }
155
156 MTPTracker::MTPTracker() {
157   nb_locations = 0;
158   nb_time_steps = 0;
159
160   detection_scores = 0;
161   allowed_motions = 0;
162
163   entrances = 0;
164   exits = 0;
165
166   _edge_lengths = 0;
167   _graph = 0;
168 }
169
170 MTPTracker::~MTPTracker() {
171   free();
172 }
173
174 int MTPTracker::early_pair_node(int t, int l) {
175   return 1 + (2 * t + 0) * nb_locations + l;
176 }
177
178 int MTPTracker::late_pair_node(int t, int l) {
179   return 1 + (2 * t + 1) * nb_locations + l;
180 }
181
182 void MTPTracker::build_graph() {
183   // Delete the existing graph if there was one
184   delete[] _edge_lengths;
185   delete _graph;
186
187   int nb_motions = 0, nb_exits = 0, nb_entrances = 0;
188
189   for(int l = 0; l < nb_locations; l++) {
190     for(int t = 0; t < nb_time_steps; t++) {
191       if(exits[t][l]) nb_exits++;
192       if(entrances[t][l]) nb_entrances++;
193     }
194     for(int m = 0; m < nb_locations; m++) {
195       if(allowed_motions[l][m]) nb_motions++;
196     }
197   }
198
199   int nb_vertices = 2 + 2 * nb_time_steps * nb_locations;
200
201   int nb_edges =
202     // The edges from the source to the entrances and from the exits
203     // to the sink
204     nb_exits + nb_entrances +
205     // The edges for the motions, between every successive frames
206     (nb_time_steps - 1) * nb_motions +
207     // The edges inside the duplicated nodes
208     nb_locations * nb_time_steps;
209
210   int *node_from = new int[nb_edges];
211   int *node_to = new int[nb_edges];
212
213   int source = 0, sink = nb_vertices - 1;
214   int e = 0;
215
216   _edge_lengths = new scalar_t[nb_edges];
217
218   // We put the in-node edges first, since these are the ones whose
219   // lengths we will have to change before tracking, according to the
220   // detection scores
221
222   for(int t = 0; t < nb_time_steps; t++) {
223     for(int l = 0; l < nb_locations; l++) {
224       node_from[e] = early_pair_node(t, l);
225       node_to[e] = late_pair_node(t, l);
226       e++;
227     }
228   }
229
230   // The edges between frames, corresponding to allowed motions
231
232   for(int t = 0; t < nb_time_steps - 1; t++) {
233     for(int l = 0; l < nb_locations; l++) {
234       for(int k = 0; k < nb_locations; k++) {
235         if(allowed_motions[l][k]) {
236           node_from[e] = late_pair_node(t, l);
237           node_to[e] = early_pair_node(t+1, k);
238           _edge_lengths[e] = 0.0;
239           e++;
240         }
241       }
242     }
243   }
244
245   // The edges from the source to the entrances, and from the exits to
246   // the sink
247
248   for(int t = 0; t < nb_time_steps; t++) {
249     for(int l = 0; l < nb_locations; l++) {
250       if(entrances[t][l]) {
251         node_from[e] = source;
252         node_to[e] = early_pair_node(t, l);
253         _edge_lengths[e] = 0.0;
254         e++;
255       }
256       if(exits[t][l]) {
257         node_from[e] = late_pair_node(t, l);
258         node_to[e] = sink;
259         _edge_lengths[e] = 0.0;
260         e++;
261       }
262     }
263   }
264
265   // We are done, build the graph
266
267   _graph = new MTPGraph(nb_vertices, nb_edges,
268                         node_from, node_to,
269                         source, sink);
270
271   delete[] node_from;
272   delete[] node_to;
273 }
274
275 void MTPTracker::print_graph_dot(ostream *os) {
276   int e = 0;
277   for(int t = 0; t < nb_time_steps; t++) {
278     for(int l = 0; l < nb_locations; l++) {
279       _edge_lengths[e++] = - detection_scores[t][l];
280     }
281   }
282   _graph->print_dot(os);
283 }
284
285 void MTPTracker::track() {
286   ASSERT(_graph);
287
288   int e = 0;
289   for(int t = 0; t < nb_time_steps; t++) {
290     for(int l = 0; l < nb_locations; l++) {
291       _edge_lengths[e++] = - detection_scores[t][l];
292     }
293   }
294
295   _graph->find_best_paths(_edge_lengths);
296   _graph->retrieve_disjoint_paths();
297
298 #ifdef VERBOSE
299   for(int p = 0; p < _graph->nb_paths; p++) {
300     Path *path = _graph->paths[p];
301     cout << "PATH " << p << " [length " << path->nb_nodes << "] " << path->nodes[0];
302     for(int n = 1; n < path->nb_nodes; n++) {
303       cout << " -> " << path->nodes[n];
304     }
305     cout << endl;
306   }
307 #endif
308 }
309
310 int MTPTracker::nb_trajectories() {
311   return _graph->nb_paths;
312 }
313
314 scalar_t MTPTracker::trajectory_score(int k) {
315   return -_graph->paths[k]->length;
316 }
317
318 int MTPTracker::trajectory_entrance_time(int k) {
319   return (_graph->paths[k]->nodes[1] - 1) / (2 * nb_locations);
320 }
321
322 int MTPTracker::trajectory_duration(int k) {
323   return (_graph->paths[k]->nb_nodes - 2) / 2;
324 }
325
326 int MTPTracker::trajectory_location(int k, int time_from_entry) {
327   return (_graph->paths[k]->nodes[2 * time_from_entry + 1] - 1) % nb_locations;
328 }