Package boofcv.alg.feature.associate

Class AssociateThreeByPairs<TD extends TupleDesc<TD>>

java.lang.Object

boofcv.alg.feature.associate.AssociateThreeByPairs<TD>

All Implemented Interfaces:

AssociateThreeDescription<TD>

public class AssociateThreeByPairs<TD extends TupleDesc<TD>>
extends Object
implements AssociateThreeDescription<TD>

Associates features in three view with each other by associating each pair of images individually. Only unique associations are allowed.

Field Summary

Fields

Modifier and Type	Field	Description
protected AssociateDescriptionArraySets<TD>	associator
protected FastAccess<TD>	featuresA
protected FastAccess<TD>	featuresB
protected FastAccess<TD>	featuresC
protected DogArray<AssociatedTripleIndex>	matches
protected DogArray_I32	setsA
protected DogArray_I32	setsB
protected DogArray_I32	setsC
protected DogArray_I32	srcToC
protected FastArray<TD>	tmpA
protected FastArray<TD>	tmpB
protected DogArray_I32	tmpSetsA
protected DogArray_I32	tmpSetsB

Constructor Summary

Constructors

Constructor	Description
AssociateThreeByPairs(AssociateDescription<TD> associator)	Specifies which algorithms to use internally

Method Summary

Modifier and Type	Method	Description
void	associate()	Finds the best match for each item in the source list with an item in the destination list.
DogArray<AssociatedTripleIndex>	getMatches()	List of associated features.
MatchScoreType	getScoreType()	Specifies the type of score which is returned.
void	initialize(int numberOfSets)	Must call first.
boolean	isEachFeatureAssociatedOnlyOnce()	If true then each feature is associated at most one time
void	setFeaturesA(FastAccess<TD> features, DogArray_I32 sets)	Specify descriptors in image A
void	setFeaturesB(FastAccess<TD> features, DogArray_I32 sets)	Specify descriptors in image C
void	setFeaturesC(FastAccess<TD> features, DogArray_I32 sets)	Specify descriptors in image B
void	setMaxScoreThreshold(double score)	Associations are only considered if their score is less than or equal to the specified threshold.

Methods inherited from class java.lang.Object

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

Field Details

associator

protected AssociateDescriptionArraySets<TD extends TupleDesc<TD>> associator

featuresA

protected FastAccess<TD extends TupleDesc<TD>> featuresA

featuresB

protected FastAccess<TD extends TupleDesc<TD>> featuresB

featuresC

protected FastAccess<TD extends TupleDesc<TD>> featuresC

setsA

protected DogArray_I32 setsA

setsB

protected DogArray_I32 setsB

setsC

protected DogArray_I32 setsC

tmpB

protected FastArray<TD extends TupleDesc<TD>> tmpB

tmpA

protected FastArray<TD extends TupleDesc<TD>> tmpA

tmpSetsA

protected DogArray_I32 tmpSetsA

tmpSetsB

protected DogArray_I32 tmpSetsB

matches

protected DogArray<AssociatedTripleIndex> matches

srcToC

protected DogArray_I32 srcToC

Constructor Details

AssociateThreeByPairs

public AssociateThreeByPairs(AssociateDescription<TD> associator)

Specifies which algorithms to use internally

Parameters:

associator - image to image association

Method Details

initialize

public void initialize(int numberOfSets)

Description copied from interface: AssociateThreeDescription

Must call first. It specifies the number of sets feature descriptors can belong inside of

Specified by:

initialize in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

setFeaturesA

public void setFeaturesA(FastAccess<TD> features,
 DogArray_I32 sets)

Description copied from interface: AssociateThreeDescription

Specify descriptors in image A

Specified by:

setFeaturesA in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

Parameters:

features - (Input) feature descriptors. Reference is saved.

sets - (Input) Which sets the features belong to. Reference is saved.

setFeaturesB

public void setFeaturesB(FastAccess<TD> features,
 DogArray_I32 sets)

Description copied from interface: AssociateThreeDescription

Specify descriptors in image C

Specified by:

setFeaturesB in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

Parameters:

features - feature descriptors. Reference is saved.

sets - (Input) Which sets the features belong to. Reference is saved.

setFeaturesC

public void setFeaturesC(FastAccess<TD> features,
 DogArray_I32 sets)

Description copied from interface: AssociateThreeDescription

Specify descriptors in image B

Specified by:

setFeaturesC in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

Parameters:

features - feature descriptors. Reference is saved.

sets - (Input) Which sets the features belong to. Reference is saved.

associate

public void associate()

Description copied from interface: AssociateThreeDescription

Finds the best match for each item in the source list with an item in the destination list.

Specified by:

associate in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

getMatches

public DogArray<AssociatedTripleIndex> getMatches()

Description copied from interface: AssociateThreeDescription

List of associated features. Indexes refer to the index inside the input lists.

Specified by:

getMatches in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

Returns:

List of associated features.

setMaxScoreThreshold

public void setMaxScoreThreshold(double score)

Description copied from interface: AssociateThreeDescription

Associations are only considered if their score is less than or equal to the specified threshold. To remove any threshold test set this value to Double.MAX_VALUE

Specified by:

setMaxScoreThreshold in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

Parameters:

score - The threshold.

getScoreType

public MatchScoreType getScoreType()

Description copied from interface: AssociateThreeDescription

Specifies the type of score which is returned.

Specified by:

getScoreType in interface AssociateThreeDescription<TD extends TupleDesc<TD>>

Returns:

Type of association score.

isEachFeatureAssociatedOnlyOnce

public boolean isEachFeatureAssociatedOnlyOnce()

Description copied from interface: AssociateThreeDescription

If true then each feature is associated at most one time

Specified by:

isEachFeatureAssociatedOnlyOnce in interface AssociateThreeDescription<TD extends TupleDesc<TD>>