Package boofcv.alg.structure

Interface LookUpSimilarImages

All Known Implementing Classes:

SimilarImagesData, SimilarImagesFromTracks, SimilarImagesSceneRecognition, SimilarImagesTrackThenMatch

public interface LookUpSimilarImages

Interface for finding images with a similar appearance and identifying point features which are related between the two images. This is typically used as an initial step when performing scene reconstruction. For scene reconstruction a geometric constraint is applied afterwards to remove false positives matches and associated features.

Method Summary

Modifier and Type	Method	Description
void	findSimilar(String target, BoofLambdas.Filter<String> filter, List<String> similarImages)	Given an imageID, it will find list of similar images.
List<String>	getImageIDs()	Returns a list of all images by ID that it has in its data base
boolean	lookupAssociated(String similarD, DogArray<AssociatedIndex> pairs)	Looks up pairs of associated features from a similar image which was returned in the most recent call to findSimilar(java.lang.String, boofcv.misc.BoofLambdas.Filter<java.lang.String>, java.util.List<java.lang.String>).
void	lookupPixelFeats(String target, DogArray<Point2D_F64> features)	Looks up pixel observations of features in the specified view.

Method Details

getImageIDs

List<String> getImageIDs()

Returns a list of all images by ID that it has in its data base

findSimilar

void findSimilar(String target,
 @Nullable
 BoofLambdas.Filter<String> filter,
 List<String> similarImages)

Given an imageID, it will find list of similar images. Similarity is defined from the perspective of the 'target', so viewA might think viewB is similar to it, but viewB might think viewA is not similar to it.

Parameters:

target - (Input) ID of target image

filter - (Input) Filter results by ID. true = keep, false = reject. Null means no filter.

similarImages - (Output) Storage for IDs of similar images. Cleared upon each call

Throws:

IllegalArgumentException - If the target is not known

lookupPixelFeats

void lookupPixelFeats(String target,
 DogArray<Point2D_F64> features)

Looks up pixel observations of features in the specified view.

Parameters:

target - ID of target image

features - Storage for pixel observations. Cleared upon each call

Throws:

IllegalArgumentException - If the target is not known

lookupAssociated

boolean lookupAssociated(String similarD,
 DogArray<AssociatedIndex> pairs)

Looks up pairs of associated features from a similar image which was returned in the most recent call to findSimilar(java.lang.String, boofcv.misc.BoofLambdas.Filter<java.lang.String>, java.util.List<java.lang.String>). The src will be the target in 'findSimilar' and the dst will be the requested similar image.

Parameters:

similarD - ID of a similar image to the target when calling findSimilar(java.lang.String, boofcv.misc.BoofLambdas.Filter<java.lang.String>, java.util.List<java.lang.String>).

pairs - Storage for associated features. Cleared upon each call

Returns:

true if views are similar and have known associations. False if not and results should be ignored

Throws:

IllegalArgumentException - If the one of the views is not known