Package boofcv.abst.feature.associate

Class AssociateDescTo2D<D>

java.lang.Object

boofcv.abst.feature.associate.AssociateDescTo2D<D>

All Implemented Interfaces:

Associate<D>, AssociateDescription2D<D>

public class AssociateDescTo2D<D>
extends Object
implements AssociateDescription2D<D>

Wrapper around AssociateDescription that allows it to be used inside of AssociateDescription2D

Constructor Summary

Constructors

Constructor	Description
AssociateDescTo2D(AssociateDescription<D> alg)

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.
Class<D>	getDescriptionType()	Returns the type of object it can associate
FastAccess<AssociatedIndex>	getMatches()	List of associated features.
MatchScoreType	getScoreType()	Specifies the type of score which is returned.
DogArray_I32	getUnassociatedDestination()	Indexes of features in the destination set which are not associated.
DogArray_I32	getUnassociatedSource()	Indexes of features in the source set which are not associated.
void	initialize(int imageWidth, int imageHeight)	Initialize by specifying the image width/height.
void	setDestination(FastAccess<Point2D_F64> location, FastAccess<D> descriptions)	Provide the location and descriptions for destination features.
void	setMaxScoreThreshold(double score)	Associations are only considered if their score is less than or equal to the specified threshold.
void	setSource(FastAccess<Point2D_F64> location, FastAccess<D> descriptions)	Provide the location and descriptions for source features.
boolean	uniqueDestination()	If at most one match is returned for each destination feature.
boolean	uniqueSource()	If at most one match is returned for each source feature.

Methods inherited from class java.lang.Object

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

Constructor Details

AssociateDescTo2D

public AssociateDescTo2D(AssociateDescription<D> alg)

Method Details

initialize

public void initialize(int imageWidth,
 int imageHeight)

Description copied from interface: AssociateDescription2D

Initialize by specifying the image width/height. Used to precompute internal data structures and set thresholds. If images are different sizes just use the largest width/height

Specified by:

initialize in interface AssociateDescription2D<D>

Parameters:

imageWidth - Input image width

imageHeight - Input image height

setSource

public void setSource(FastAccess<Point2D_F64> location,
 FastAccess<D> descriptions)

Description copied from interface: AssociateDescription2D

Provide the location and descriptions for source features.

Specified by:

setSource in interface AssociateDescription2D<D>

Parameters:

location - Feature locations.

descriptions - Feature descriptions.

setDestination

public void setDestination(FastAccess<Point2D_F64> location,
 FastAccess<D> descriptions)

Description copied from interface: AssociateDescription2D

Provide the location and descriptions for destination features.

Specified by:

setDestination in interface AssociateDescription2D<D>

Parameters:

location - Feature locations.

descriptions - Feature descriptions.

associate

public void associate()

Description copied from interface: Associate

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

Specified by:

associate in interface Associate<D>

getMatches

public FastAccess<AssociatedIndex> getMatches()

Description copied from interface: Associate

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

Specified by:

getMatches in interface Associate<D>

Returns:

List of associated features.

getUnassociatedSource

public DogArray_I32 getUnassociatedSource()

Description copied from interface: Associate

Indexes of features in the source set which are not associated. WARNING: In some implementations the unassociated list is recomputed each time this function is invoked. In other implementations it was found virtually for free while the matches are found.

Specified by:

getUnassociatedSource in interface Associate<D>

Returns:

List of unassociated source features by index.

getUnassociatedDestination

public DogArray_I32 getUnassociatedDestination()

Description copied from interface: Associate

Indexes of features in the destination set which are not associated. WARNING: In some implementations the unassociated list is recomputed each time this function is invoked. In other implementations it was found virtually for free while the matches are found.

Specified by:

getUnassociatedDestination in interface Associate<D>

Returns:

List of unassociated destination features by index.

setMaxScoreThreshold

public void setMaxScoreThreshold(double score)

Description copied from interface: Associate

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 Associate<D>

Parameters:

score - The threshold.

getScoreType

public MatchScoreType getScoreType()

Description copied from interface: Associate

Specifies the type of score which is returned.

Specified by:

getScoreType in interface Associate<D>

Returns:

Type of association score.

uniqueSource

public boolean uniqueSource()

Description copied from interface: Associate

If at most one match is returned for each source feature.

Specified by:

uniqueSource in interface Associate<D>

Returns:

true for unique source association

uniqueDestination

public boolean uniqueDestination()

Description copied from interface: Associate

If at most one match is returned for each destination feature.

Specified by:

uniqueDestination in interface Associate<D>

Returns:

true for unique destination association

getDescriptionType

public Class<D> getDescriptionType()

Description copied from interface: Associate

Returns the type of object it can associate

Specified by:

getDescriptionType in interface Associate<D>