org.openimaj.image.processing.face.tracking.clm

Class MultiTracker

java.lang.Object

org.openimaj.image.processing.face.tracking.clm.MultiTracker

public class MultiTracker
extends Object

A CLM Tracker that is able to deal with multiple tracks within the same video. To instantiate use load(InputStream) to get a MultiTracker.TrackerVars object which can be used to construct the Tracker.

MultiTracker t = new MultiTracker( MultiTracker.load( new File("face.tracker.file") ) );

Author:

David Dupplaw (dpd@ecs.soton.ac.uk)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MultiTracker.TrackedFace Encapsulates the variables for a single tracked face.
static class	MultiTracker.TrackerVars This class is used to store the tracker variables when they are loaded from a file.

Field Summary

Fields

Modifier and Type	Field and Description
List<MultiTracker.TrackedFace>	trackedFaces

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MultiTracker() Constructor for making a tracker when loading data.
	MultiTracker(CLM clm, FDet fdet, MFCheck fcheck, Jama.Matrix rshape, double[] simil) Create a tracker using the given model, face detector, failure checker, reference shape and similarity measures.
	MultiTracker(MultiTracker.TrackerVars tv) Create a tracker with the given variables.

Method Summary

Modifier and Type	Method and Description
void	frameReset() Reset frame number (will perform detection in next image)
MultiTracker.TrackerVars	getInitialVars() Returns the initial variables used for each face tracker.
void	initShape(Rectangle r, Jama.Matrix shape, Jama.Matrix _rshape) Initialise the shape within the given rectangle based on the given reference shape.
static MultiTracker.TrackerVars	load(InputStream in) Load a tracker from an input stream.
static MultiTracker.TrackerVars	load(String fname) Load a tracker from a file.
int	track(FImage im, int[] wSize, int fpd, int nIter, double clamp, double fTol, boolean fcheck, float searchAreaSize) Track faces from a previous frame to the given frame.
protected Rectangle	updateTemplate(MultiTracker.TrackedFace f, FImage im, Jama.Matrix s, boolean resize)

Methods inherited from class java.lang.Object

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

Field Detail

trackedFaces

public List<MultiTracker.TrackedFace> trackedFaces

Constructor Detail

MultiTracker

public MultiTracker(CLM clm,
                    FDet fdet,
                    MFCheck fcheck,
                    Jama.Matrix rshape,
                    double[] simil)

Create a tracker using the given model, face detector, failure checker, reference shape and similarity measures. These values will be copied into all trackers.

Parameters:

clm - The local model

fdet - The face detector

fcheck - The failure checker

rshape - The reference shape

simil - The similarity measures

MultiTracker

public MultiTracker(MultiTracker.TrackerVars tv)

Create a tracker with the given variables.

Parameters:

tv - The tracker variables to use for all face trackers.

MultiTracker

protected MultiTracker()

Constructor for making a tracker when loading data.

Method Detail

frameReset

public void frameReset()

Reset frame number (will perform detection in next image)

track

public int track(FImage im,
                 int[] wSize,
                 int fpd,
                 int nIter,
                 double clamp,
                 double fTol,
                 boolean fcheck,
                 float searchAreaSize)

Track faces from a previous frame to the given frame.

Parameters:

im - The video frame

wSize - The window size

fpd - The number of frames between forced redetecs

nIter - The number of iterations for model fitting

clamp - The number s.d.'s in which a model must fit

fTol - The tolerance for model fitting

fcheck - Whether to automatically check for failed tracking

searchAreaSize - The size of the template match search area

Returns:

0 for success, -1 for failure.

initShape

public void initShape(Rectangle r,
                      Jama.Matrix shape,
                      Jama.Matrix _rshape)

Initialise the shape within the given rectangle based on the given reference shape.

Parameters:

r - The rectangle

shape - The shape to initialise

_rshape - The reference shape

updateTemplate

protected Rectangle updateTemplate(MultiTracker.TrackedFace f,
                                   FImage im,
                                   Jama.Matrix s,
                                   boolean resize)

load

public static MultiTracker.TrackerVars load(String fname)
                                     throws FileNotFoundException

Load a tracker from a file.

Parameters:

fname - File name to read from

Returns:

A tracker variable class

Throws:

FileNotFoundException

load

public static MultiTracker.TrackerVars load(InputStream in)

Load a tracker from an input stream.

Parameters:

in - The input stream

Returns:

a tracker

getInitialVars

public MultiTracker.TrackerVars getInitialVars()

Returns the initial variables used for each face tracker.

Returns:

The initial variables