Update.
authorFrancois Fleuret <francois@fleuret.org>
Fri, 24 Aug 2012 00:27:02 +0000 (17:27 -0700)
committerFrancois Fleuret <francois@fleuret.org>
Fri, 24 Aug 2012 00:27:02 +0000 (17:27 -0700)
README.txt

index 8c38d68..5975edf 100644 (file)
@@ -1,14 +1,22 @@
+
 This is a very simple implementation of the KSP applied to
 This is a very simple implementation of the KSP applied to
-multi-target tracking. It is dubbed Multi-Tracked Path.
+multi-target tracking. It is dubbed Multi-Tracked Path since it
+differs a bit from the standard KSP. It works with negative edge
+length and stops when it can not find path of negative length anymore
+instead of fixing the total number of paths to a constant.
 
 The two main classes are MTPGraph and Tracker.
 
 
 The two main classes are MTPGraph and Tracker.
 
-MTPGraph allows to define a directed acyclic graph (DAG), to associate
-a length to each of its edge (which can be negative), and to compute
-the family of paths in this graph that minimize the sum of the length
-of their edges.
+The MTPGraph class stores a directed acyclic graph (DAG), with a
+length for each edge (which can be negative), and can compute the
+family of paths in this graph that minimizes the sum of edge
+lengths.
+
+This means that it will iteratively add paths as long as it can find
+some with negative length. If there are no such path, it will compute
+no path at all. Note that the solution it finds is globally optimal.
 
 
-Tracker allows
+The Tracker class allows
 
  (1) to define a spatial topology composed of
 
 
  (1) to define a spatial topology composed of
 
@@ -27,7 +35,18 @@ consistent with the topology, which maximizes the overall detection
 score (i.e. the sum of the detection scores of the nodes visited by
 the trajectories)
 
 score (i.e. the sum of the detection scores of the nodes visited by
 the trajectories)
 
-The file mtp.cc gives a very simple example.
+The Tracker class uses the MTPGraph. From the definition of the
+spatial topology, it builds a graph with one source, one sink, and two
+nodes per location and time. This structure ensures the trajectories
+computed by the tracker to be node-disjoint by forcing the paths
+computed by the MTPGraph to be edge-disjoint. The edges from the
+source or to the sink, or between these pairs, are of length zero, and
+the edge between the two nodes of such a pair has a length equal to
+the opposite of the detection score.
+
+The file mtp.cc gives a very simple usage example of the Tracker
+class.
 
 
+--
 François Fleuret
 August 2012
 François Fleuret
 August 2012