boofcv.alg.tracker.combined

Class CombinedTrackerScalePoint<I extends ImageGray,D extends ImageGray,TD extends TupleDesc>

java.lang.Object

boofcv.alg.tracker.combined.CombinedTrackerScalePoint<I,D,TD>

public class CombinedTrackerScalePoint<I extends ImageGray,D extends ImageGray,TD extends TupleDesc>
extends java.lang.Object

Combines a KLT tracker with Detect-Describe-Associate type trackers. Features are nominally tracked using KLT, but after KLT drops a track it is deactivated and made dormant. Upon request, it will attempt to reactivate a dormant track by associating it with newly detected features. After a track has been reactivated it will be tracked normally.

Constructor Summary

Constructors

Constructor and Description
CombinedTrackerScalePoint(PyramidKltForCombined<I,D> trackerKlt, DetectDescribePoint<I,TD> detector, AssociateDescription<TD> associate) Configures tracker

Method Summary

Modifier and Type	Method and Description
void	associateAllToDetected() Associate all tracks in any state to the latest observations.
void	dropAllTracks() Drops all tracks and recycles the data
boolean	dropTrack(CombinedTrack<TD> track) Stops tracking the specified track and recycles its data.
DetectDescribePoint<I,TD>	getDetector()
java.util.List<CombinedTrack<TD>>	getDormant()
java.util.List<CombinedTrack<TD>>	getPureKlt()
java.util.List<CombinedTrack<TD>>	getReactivated()
java.util.List<CombinedTrack<TD>>	getSpawned()
PyramidKltForCombined<I,D>	getTrackerKlt()
void	reset() Sets the tracker into its initial state.
void	spawnTracksFromDetected() From the found interest points create new tracks.
void	updateTracks(I input, PyramidDiscrete<I> pyramid, D[] derivX, D[] derivY) Updates the location and description of tracks using KLT.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CombinedTrackerScalePoint

public CombinedTrackerScalePoint(PyramidKltForCombined<I,D> trackerKlt,
                                 DetectDescribePoint<I,TD> detector,
                                 AssociateDescription<TD> associate)

Configures tracker

Parameters:

trackerKlt - KLT tracker used nominally

detector - Feature detector

associate - Association algorithm

Method Detail

reset

public void reset()

Sets the tracker into its initial state. Previously declared track data structures are saved for re-use.

updateTracks

public void updateTracks(I input,
                         PyramidDiscrete<I> pyramid,
                         D[] derivX,
                         D[] derivY)

Updates the location and description of tracks using KLT. Saves a reference to the input image for future processing.

Parameters:

input - Input image.

pyramid - Image pyramid of input.

derivX - Derivative pyramid of input x-axis

derivY - Derivative pyramid of input y-axis

spawnTracksFromDetected

public void spawnTracksFromDetected()

From the found interest points create new tracks. Tracks are only created at points where there are no existing tracks. Note: Must be called after associateAllToDetected().

associateAllToDetected

public void associateAllToDetected()

Associate all tracks in any state to the latest observations. If a dormant track is associated it will be reactivated. If a reactivated track is associated it's state will be updated. PureKLT tracks are left unmodified.

dropTrack

public boolean dropTrack(CombinedTrack<TD> track)

Stops tracking the specified track and recycles its data.

Parameters:

track - The track being dropped

Returns:

true if the track was being tracked and data was recycled false if not.

getSpawned

public java.util.List<CombinedTrack<TD>> getSpawned()

getPureKlt

public java.util.List<CombinedTrack<TD>> getPureKlt()

getReactivated

public java.util.List<CombinedTrack<TD>> getReactivated()

getDormant

public java.util.List<CombinedTrack<TD>> getDormant()

getTrackerKlt

public PyramidKltForCombined<I,D> getTrackerKlt()

getDetector

public DetectDescribePoint<I,TD> getDetector()

dropAllTracks

public void dropAllTracks()

Drops all tracks and recycles the data