boofcv.alg.tracker.tld

Class TldFernClassifier<T extends boofcv.struct.image.ImageGray<T>>

java.lang.Object

boofcv.alg.tracker.tld.TldFernClassifier<T>

public class TldFernClassifier<T extends boofcv.struct.image.ImageGray<T>>
extends java.lang.Object

Manages ferns, creates their descriptions, compute their values, and handles their probabilities.

Field Summary

Fields

Modifier and Type	Field and Description
protected TldFernDescription[]	ferns
protected TldFernManager[]	managers
protected int	maxN
protected int	maxP

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TldFernClassifier()
	TldFernClassifier(java.util.Random rand, int numFerns, int descriptorSize, int numLearnRandom, float fernLearnNoise, boofcv.alg.interpolate.InterpolatePixelS<T> interpolate) Configures fern algorithm

Method Summary

Modifier and Type	Method and Description
protected int	computeFernValue(float c_x, float c_y, float rectWidth, float rectHeight, TldFernDescription fern) Computes the value of the specified fern at the specified location in the image.
protected int	computeFernValueRand(float c_x, float c_y, float rectWidth, float rectHeight, TldFernDescription fern) Computes the value of a fern after adding noise to the image being sampled.
int	getMaxN()
int	getMaxP()
void	learnFern(boolean positive, boofcv.struct.ImageRectangle r) Learns a fern from the specified region.
void	learnFernNoise(boolean positive, boofcv.struct.ImageRectangle r) Computes the value for each fern inside the region and update's their P and N value.
boolean	lookupFernPN(TldRegionFernInfo info) For the specified regions, computes the values of each fern inside of it and then retrives their P and N values.
void	renormalizeN() Renormalizes fern.numN to avoid overflow
void	renormalizeP() Renormalizes fern.numP to avoid overflow
void	reset() Discard all information on fern values and their probabilities
void	setImage(T gray) Call before any other functions.

Methods inherited from class java.lang.Object

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

Field Detail

maxP

protected int maxP

maxN

protected int maxN

ferns

protected TldFernDescription[] ferns

managers

protected TldFernManager[] managers

Constructor Detail

TldFernClassifier

public TldFernClassifier(java.util.Random rand,
                         int numFerns,
                         int descriptorSize,
                         int numLearnRandom,
                         float fernLearnNoise,
                         boofcv.alg.interpolate.InterpolatePixelS<T> interpolate)

Configures fern algorithm

Parameters:

rand - Random number generated used for creating ferns

numFerns - Number of ferns to created. Typically 10

descriptorSize - Size of each fern's descriptor. Typically 10

numLearnRandom - Number of ferns which will be generated by adding noise to the image

fernLearnNoise - The noise's standard deviation

interpolate - Interpolation function for the image

TldFernClassifier

protected TldFernClassifier()

Method Detail

reset

public void reset()

Discard all information on fern values and their probabilities

setImage

public void setImage(T gray)

Call before any other functions. Provides the image that is being sampled.

Parameters:

gray - Input image.

learnFern

public void learnFern(boolean positive,
                      boofcv.struct.ImageRectangle r)

Learns a fern from the specified region. No noise is added.

learnFernNoise

public void learnFernNoise(boolean positive,
                           boofcv.struct.ImageRectangle r)

Computes the value for each fern inside the region and update's their P and N value. Noise is added to the image measurements to take in account the variability.

lookupFernPN

public boolean lookupFernPN(TldRegionFernInfo info)

For the specified regions, computes the values of each fern inside of it and then retrives their P and N values. The sum of which is stored inside of info.

Parameters:

info - (Input) Location/Rectangle (output) P and N values

Returns:

true if a known value for any of the ferns was observed in this region

computeFernValue

protected int computeFernValue(float c_x,
                               float c_y,
                               float rectWidth,
                               float rectHeight,
                               TldFernDescription fern)

Computes the value of the specified fern at the specified location in the image.

computeFernValueRand

protected int computeFernValueRand(float c_x,
                                   float c_y,
                                   float rectWidth,
                                   float rectHeight,
                                   TldFernDescription fern)

Computes the value of a fern after adding noise to the image being sampled.

renormalizeP

public void renormalizeP()

Renormalizes fern.numP to avoid overflow

renormalizeN

public void renormalizeN()

Renormalizes fern.numN to avoid overflow

getMaxP

public int getMaxP()

getMaxN

public int getMaxN()