Package boofcv.abst.feature.detdesc

Class Surf_DetectDescribe<T extends ImageGray<T>,II extends ImageGray<II>>

java.lang.Object

boofcv.abst.feature.detdesc.Surf_DetectDescribe<T,II>

Type Parameters:

T - Input image type

II - Integral image type

All Implemented Interfaces:

DescriptorInfo<TupleDesc_F64>, DetectDescribePoint<T,TupleDesc_F64>, FeatureSets, FoundPointSO, InterestPointDetector<T>

Direct Known Subclasses:

Surf_DetectDescribe_MT

public class Surf_DetectDescribe<T extends ImageGray<T>,II extends ImageGray<II>>
extends Object
implements DetectDescribePoint<T,TupleDesc_F64>

Wrapper around SURF algorithms for DetectDescribePoint.

See Also:

• FastHessianFeatureDetector
• OrientationIntegral
• DescribePointSurf

Field Summary

Fields

Modifier and Type	Field	Description
protected DescribePointSurf<II>	describe
protected FastHessianFeatureDetector<II>	detector
protected DogArray_F64	featureAngles
protected DogArray<TupleDesc_F64>	features
protected List<ScalePoint>	foundPoints
protected II	ii
protected OrientationIntegral<II>	orientation

Constructor Summary

Constructors

Constructor	Description
Surf_DetectDescribe(FastHessianFeatureDetector<II> detector, OrientationIntegral<II> orientation, DescribePointSurf<II> describe, Class<T> imageType)

Method Summary

Modifier and Type	Method	Description
protected void	computeDescriptors()
TupleDesc_F64	createDescription()	Creates new description instance which can be processed by this class
void	detect(T input)	Detects interest points inside the provided image.
TupleDesc_F64	getDescription(int index)	Returns the feature descriptor at the specified index.
Class<TupleDesc_F64>	getDescriptionType()	The type of region descriptor generated
ImageType<T>	getInputType()	Get the expected input image type
Point2D_F64	getLocation(int featureIndex)	The center location of the feature inside the image.
int	getNumberOfFeatures()	Returns the number of interest points found.
int	getNumberOfSets()	The number of feature sets.
double	getOrientation(int featureIndex)	Returns the features found orientation.
double	getRadius(int featureIndex)	Returns the detected object's circular radius
int	getSet(int index)	Returns the set that a feature belongs in
boolean	hasOrientation()	If the interest point detector estimates the feature's orientation
boolean	hasScale()	Does the interest point detector have scale information.

Methods inherited from class java.lang.Object

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

Field Details

detector

protected FastHessianFeatureDetector<II extends ImageGray<II>> detector

orientation

protected OrientationIntegral<II extends ImageGray<II>> orientation

describe

protected DescribePointSurf<II extends ImageGray<II>> describe

ii

protected II extends ImageGray<II> ii

features

protected DogArray<TupleDesc_F64> features

foundPoints

protected List<ScalePoint> foundPoints

featureAngles

protected DogArray_F64 featureAngles

Constructor Details

Surf_DetectDescribe

public Surf_DetectDescribe(FastHessianFeatureDetector<II> detector,
 OrientationIntegral<II> orientation,
 DescribePointSurf<II> describe,
 Class<T> imageType)

Method Details

createDescription

public TupleDesc_F64 createDescription()

Description copied from interface: DescriptorInfo

Creates new description instance which can be processed by this class

Specified by:

createDescription in interface DescriptorInfo<T extends ImageGray<T>>

Returns:

New descriptor

getDescription

public TupleDesc_F64 getDescription(int index)

Description copied from interface: DetectDescribePoint

Returns the feature descriptor at the specified index.

WARNING: The returned data structure is recycled each time InterestPointDetector.detect(boofcv.struct.image.ImageBase) is called. Create a copy if this is a problem.

Specified by:

getDescription in interface DetectDescribePoint<T extends ImageGray<T>,II extends ImageGray<II>>

Parameters:

index - Which feature

Returns:

Feature descriptor

getInputType

public ImageType<T> getInputType()

Description copied from interface: InterestPointDetector

Get the expected input image type

Specified by:

getInputType in interface InterestPointDetector<T extends ImageGray<T>>

getDescriptionType

public Class<TupleDesc_F64> getDescriptionType()

Description copied from interface: DescriptorInfo

The type of region descriptor generated

Specified by:

getDescriptionType in interface DescriptorInfo<T extends ImageGray<T>>

Returns:

Returns the descriptor type.

detect

public void detect(T input)

Description copied from interface: InterestPointDetector

Detects interest points inside the provided image.

Specified by:

detect in interface InterestPointDetector<T extends ImageGray<T>>

Parameters:

input - Input features are detected inside of.

getNumberOfSets

public int getNumberOfSets()

Description copied from interface: FeatureSets

The number of feature sets.

Specified by:

getNumberOfSets in interface FeatureSets

Returns:

number of feature sets

getSet

public int getSet(int index)

Description copied from interface: FeatureSets

Returns the set that a feature belongs in

Specified by:

getSet in interface FeatureSets

Parameters:

index - Which feature

computeDescriptors

protected void computeDescriptors()

getNumberOfFeatures

public int getNumberOfFeatures()

Description copied from interface: FoundPointSO

Returns the number of interest points found.

Specified by:

getNumberOfFeatures in interface FoundPointSO

Returns:

Number of interest points.

getLocation

public Point2D_F64 getLocation(int featureIndex)

Description copied from interface: FoundPointSO

The center location of the feature inside the image.

WARNING: Do not save the returned reference, copy instead. The returned point can be recycled each time this function is called.

Specified by:

getLocation in interface FoundPointSO

Parameters:

featureIndex - The feature's index.

Returns:

Location of the feature in image pixels.

getRadius

public double getRadius(int featureIndex)

Description copied from interface: FoundPointSO

Returns the detected object's circular radius

Specified by:

getRadius in interface FoundPointSO

Parameters:

featureIndex - Feature whose radius is being requested.

Returns:

Object's radius

getOrientation

public double getOrientation(int featureIndex)

Description copied from interface: FoundPointSO

Returns the features found orientation.

Specified by:

getOrientation in interface FoundPointSO

Parameters:

featureIndex - Feature whose

Returns:

Orientation in radians.

hasScale

public boolean hasScale()

Description copied from interface: InterestPointDetector

Does the interest point detector have scale information. This made available through the radius.

Specified by:

hasScale in interface InterestPointDetector<T extends ImageGray<T>>

Returns:

true if it has scale information and false otherwise

hasOrientation

public boolean hasOrientation()

Description copied from interface: InterestPointDetector

If the interest point detector estimates the feature's orientation

Specified by:

hasOrientation in interface InterestPointDetector<T extends ImageGray<T>>

Returns:

true if it estimates the orientation