org.openimaj.feature.local.matcher.consistent

Class ConsistentLocalFeatureMatcher2d<T extends LocalFeature<?,?> & Point2d>

java.lang.Object

org.openimaj.feature.local.matcher.consistent.ConsistentLocalFeatureMatcher2d<T>

Type Parameters:

T - The type of LocalFeature

All Implemented Interfaces:

ModelFittingLocalFeatureMatcher<T>, LocalFeatureMatcher<T>

public class ConsistentLocalFeatureMatcher2d<T extends LocalFeature<?,?> & Point2d>
extends Object
implements ModelFittingLocalFeatureMatcher<T>

Object to attempt to find a consistent geometric mapping of two sets of local features according to a given model. The initial matching is performed by a separate matcher that is provided in the constructor. The list of initial matches is then passed to the modelfitter which attempts to estimate the model and provide a list of inlier pairs, which are then used to populate the consistent matches.

Author:

Jonathon Hare

Field Summary

Fields

Modifier and Type	Field and Description
protected List<Pair<T>>	consistentMatches
protected LocalFeatureMatcher<T>	innerMatcher
protected RobustModelFitting<Point2d,Point2d,?>	modelfit

Constructor Summary

Constructors

Constructor and Description
ConsistentLocalFeatureMatcher2d(LocalFeatureMatcher<T> innerMatcher) Default constructor
ConsistentLocalFeatureMatcher2d(LocalFeatureMatcher<T> innerMatcher, RobustModelFitting<Point2d,Point2d,?> fit) Default constructor

Method Summary

Methods

Modifier and Type	Method and Description
boolean	findMatches(List<T> keys1) Attempt to find matches between the model features from the database, and given query features and learn the parameters of the underlying model that links the two sets of features.
List<Pair<T>>	getAllMatches()
List<Pair<T>>	getMatches() Get the matches detected by the underlying algorithm
Model<Point2d,Point2d>	getModel() Get the model that has been learned.
void	setFittingModel(RobustModelFitting<Point2d,Point2d,?> mf) Set the object which robustly attempts to fit matches to the model
void	setModelFeatures(List<T> modelkeys) Set the features that represent the database to match queries against

Methods inherited from class java.lang.Object

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

Field Detail

innerMatcher

protected LocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d> innerMatcher

modelfit

protected RobustModelFitting<Point2d,Point2d,?> modelfit

consistentMatches

protected List<Pair<T extends LocalFeature<?,?> & Point2d>> consistentMatches

Constructor Detail

ConsistentLocalFeatureMatcher2d

public ConsistentLocalFeatureMatcher2d(LocalFeatureMatcher<T> innerMatcher)

Default constructor

Parameters:

innerMatcher - the internal matcher for getting seed matches

ConsistentLocalFeatureMatcher2d

public ConsistentLocalFeatureMatcher2d(LocalFeatureMatcher<T> innerMatcher,
                               RobustModelFitting<Point2d,Point2d,?> fit)

Default constructor

Parameters:

innerMatcher - the internal matcher for getting seed matches

fit - the points against which to test consistency

Method Detail

getMatches

public List<Pair<T>> getMatches()

Description copied from interface: LocalFeatureMatcher

Get the matches detected by the underlying algorithm

Specified by:

getMatches in interface LocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d>

Returns:

a list of consistent matching keypoints according to the estimated model parameters.

getAllMatches

public List<Pair<T>> getAllMatches()

Returns:

a list of all matches irrespective of whether they fit the model

getModel

public Model<Point2d,Point2d> getModel()

Description copied from interface: ModelFittingLocalFeatureMatcher

Get the model that has been learned. Do this after finding matches!

Specified by:

getModel in interface ModelFittingLocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d>

Returns:

the model found between the model features and object features after a findMatches operation.

findMatches

public boolean findMatches(List<T> keys1)

Description copied from interface: ModelFittingLocalFeatureMatcher

Attempt to find matches between the model features from the database, and given query features and learn the parameters of the underlying model that links the two sets of features.

Specified by:

findMatches in interface ModelFittingLocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d>

Specified by:

findMatches in interface LocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d>

Parameters:

keys1 - features from the query

Returns:

whether matches were found

setFittingModel

public void setFittingModel(RobustModelFitting<Point2d,Point2d,?> mf)

Description copied from interface: ModelFittingLocalFeatureMatcher

Set the object which robustly attempts to fit matches to the model

Specified by:

setFittingModel in interface ModelFittingLocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d>

Parameters:

mf - fitting model

setModelFeatures

public void setModelFeatures(List<T> modelkeys)

Description copied from interface: LocalFeatureMatcher

Set the features that represent the database to match queries against

Specified by:

setModelFeatures in interface LocalFeatureMatcher<T extends LocalFeature<?,?> & Point2d>

Parameters:

modelkeys - database of features