boofcv.alg.scene

Class FeatureToWordHistogram_F64

java.lang.Object

boofcv.alg.scene.FeatureToWordHistogram_F64

All Implemented Interfaces:

FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>

public class FeatureToWordHistogram_F64
extends java.lang.Object
implements FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>

Creates a normalized histogram which represents the frequency of different visual words from the set of features. Both hard and soft assignment can be used. For hard assignment all the weight is given to the word which is the best fit to the feature. In soft the relative similarity between the words is used to assign values to the histogram.

With hard assignment a single word is selected. With soft a fraction is assigned to each word based on a distance metric. See AssignCluster for the details.

Constructor Summary

Constructors

Constructor and Description
FeatureToWordHistogram_F64(org.ddogleg.clustering.AssignCluster<double[]> assignment, boolean hardAssignment) Assigns and configures internal algorithms.

Method Summary

Modifier and Type	Method and Description
void	addFeature(boofcv.struct.feature.TupleDesc_F64 feature) Adds a feature to the histogram
double[]	getHistogram() Histogram of word frequencies.
int	getTotalWords() The total number of words used to create this histogram
void	process() No more features are being added.
void	reset() Must be called before FeatureToWordHistogram.addFeature(boofcv.struct.feature.TupleDesc) is called.

Methods inherited from class java.lang.Object

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

Constructor Detail

FeatureToWordHistogram_F64

public FeatureToWordHistogram_F64(org.ddogleg.clustering.AssignCluster<double[]> assignment,
                                  boolean hardAssignment)

Assigns and configures internal algorithms.

Parameters:

assignment - Specifies the assignment algorithm

hardAssignment - true for hard assignment and false for soft assignment

Method Detail

reset

public void reset()

Description copied from interface: FeatureToWordHistogram

Must be called before FeatureToWordHistogram.addFeature(boofcv.struct.feature.TupleDesc) is called.

Specified by:

reset in interface FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>

addFeature

public void addFeature(boofcv.struct.feature.TupleDesc_F64 feature)

Description copied from interface: FeatureToWordHistogram

Adds a feature to the histogram

Specified by:

addFeature in interface FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>

Parameters:

feature - A feature which is to be matched to words. Not modified.

process

public void process()

No more features are being added. Normalized the computed histogram.

Specified by:

process in interface FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>

getHistogram

public double[] getHistogram()

Histogram of word frequencies. Normalized such that the sum is equal to 1.

Specified by:

getHistogram in interface FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>

Returns:

histogram

getTotalWords

public int getTotalWords()

The total number of words used to create this histogram

Specified by:

getTotalWords in interface FeatureToWordHistogram<boofcv.struct.feature.TupleDesc_F64>