org.openimaj.feature.local.matcher.consistent

Class LocalConsistentKeypointMatcher<T extends Keypoint>

java.lang.Object

org.openimaj.feature.local.matcher.BasicMatcher<T>

org.openimaj.feature.local.matcher.FastBasicKeypointMatcher<T>

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

Type Parameters:

T - The type of keypoint

All Implemented Interfaces:

ModelFittingLocalFeatureMatcher<T>, LocalFeatureMatcher<T>

public class LocalConsistentKeypointMatcher<T extends Keypoint>
extends FastBasicKeypointMatcher<T>
implements ModelFittingLocalFeatureMatcher<T>

Improved version of ConsistentKeypointMatcher. Much much faster! We use a b-tree to implement scale space search & stop the matcher after a number of iterations and attempt to find a model with what we have.

Author:

Jonathon Hare

Field Summary

Fields inherited from class org.openimaj.feature.local.matcher.FastBasicKeypointMatcher

modelKeypointsKNN

Fields inherited from class org.openimaj.feature.local.matcher.BasicMatcher

matches, modelKeypoints, thresh

Constructor Summary

Constructors

Constructor and Description
LocalConsistentKeypointMatcher(int threshold) Default constructor

Method Summary

Modifier and Type	Method and Description
boolean	findMatches(List<T> keys1) Given a pair of images and their keypoints, pick the first keypoint from one image and find its closest match in the second set of keypoints.
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> map) Set the features that represent the database to match queries against

Methods inherited from class org.openimaj.feature.local.matcher.BasicMatcher

checkForMatch, setThreshold

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalConsistentKeypointMatcher

public LocalConsistentKeypointMatcher(int threshold)

Default constructor

Parameters:

threshold - threshold for determining matching keypoints

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 Keypoint>

Overrides:

getMatches in class BasicMatcher<T extends Keypoint>

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 Keypoint>

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 class: FastBasicKeypointMatcher

Given a pair of images and their keypoints, pick the first keypoint from one image and find its closest match in the second set of keypoints. Then write the result to a file.

Specified by:

findMatches in interface ModelFittingLocalFeatureMatcher<T extends Keypoint>

Specified by:

findMatches in interface LocalFeatureMatcher<T extends Keypoint>

Overrides:

findMatches in class FastBasicKeypointMatcher<T extends Keypoint>

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 Keypoint>

Parameters:

mf - fitting model

setModelFeatures

public void setModelFeatures(List<T> map)

Description copied from interface: LocalFeatureMatcher

Set the features that represent the database to match queries against

Specified by:

setModelFeatures in interface LocalFeatureMatcher<T extends Keypoint>

Overrides:

setModelFeatures in class FastBasicKeypointMatcher<T extends Keypoint>

Parameters:

map - database of features