boofcv.alg.tracker.klt

Class PyramidKltTracker<InputImage extends boofcv.struct.image.ImageGray,DerivativeImage extends boofcv.struct.image.ImageGray>

java.lang.Object

boofcv.alg.tracker.klt.PyramidKltTracker<InputImage,DerivativeImage>

public class PyramidKltTracker<InputImage extends boofcv.struct.image.ImageGray,DerivativeImage extends boofcv.struct.image.ImageGray>
extends java.lang.Object

A pyramid Kanade-Lucas-Tomasi (KLT) tracker that allows features to be tracker over a larger region than the basic (KltTracker) implementation. A feature is tracked at multiple resolutions, large motions can be detected at low resolution and are refined at higher resolutions.

Tracking is allowed along the image border. A track is dropped if the smallest track is outside the image.

Field Summary

Fields

Modifier and Type	Field and Description
protected DerivativeImage[]	derivX
protected DerivativeImage[]	derivY
protected boofcv.struct.pyramid.ImagePyramid<InputImage>	image
protected KltTracker<InputImage,DerivativeImage>	tracker

Constructor Summary

Constructors

Constructor and Description
PyramidKltTracker(KltTracker<InputImage,DerivativeImage> tracker)

Method Summary

Modifier and Type	Method and Description
float	getError() Average error between track template and the image.
boolean	setDescription(PyramidKltFeature feature) Sets the feature's description up.
void	setImage(boofcv.struct.pyramid.ImagePyramid<InputImage> image) Only sets the image pyramid.
void	setImage(boofcv.struct.pyramid.ImagePyramid<InputImage> image, DerivativeImage[] derivX, DerivativeImage[] derivY) Sets the current input images for the tracker to use.
KltTrackFault	track(PyramidKltFeature feature) Finds the feature's new location in the image.

Methods inherited from class java.lang.Object

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

Field Detail

tracker

protected KltTracker<InputImage extends boofcv.struct.image.ImageGray,DerivativeImage extends boofcv.struct.image.ImageGray> tracker

image

protected boofcv.struct.pyramid.ImagePyramid<InputImage extends boofcv.struct.image.ImageGray> image

derivX

protected DerivativeImage extends boofcv.struct.image.ImageGray[] derivX

derivY

protected DerivativeImage extends boofcv.struct.image.ImageGray[] derivY

Constructor Detail

PyramidKltTracker

public PyramidKltTracker(KltTracker<InputImage,DerivativeImage> tracker)

Method Detail

setDescription

public boolean setDescription(PyramidKltFeature feature)

Sets the feature's description up. The feature's (x,y) must have already been set and setImage(boofcv.struct.pyramid.ImagePyramid<InputImage>, DerivativeImage[], DerivativeImage[]) been called.

Parameters:

feature - Feature's whose description is being setup.

Returns:

true if there was sufficient information to create a feature or false if not

setImage

public void setImage(boofcv.struct.pyramid.ImagePyramid<InputImage> image,
                     DerivativeImage[] derivX,
                     DerivativeImage[] derivY)

Sets the current input images for the tracker to use.

Parameters:

image - Original image pyramid.

derivX - Derivative along x-axis.

derivY - Derivative along y-axis.

setImage

public void setImage(boofcv.struct.pyramid.ImagePyramid<InputImage> image)

Only sets the image pyramid. The derivatives are set to null. Only use this when tracking.

Parameters:

image - Image pyramid

track

public KltTrackFault track(PyramidKltFeature feature)

Finds the feature's new location in the image. The feature's position can be modified even if tracking fails.

NOTE: The feature's description is not updated and tracking over several frames can break down if its description is not updated.

Parameters:

feature - The feature being tracked.

Returns:

If tracking failed or not.

getError

public float getError()

Average error between track template and the image.

Returns:

error

See Also:

KltTracker.getError()