Package boofcv.factory.feature.detdesc

Class FactoryDetectDescribe

java.lang.Object

boofcv.factory.feature.detdesc.FactoryDetectDescribe

public class FactoryDetectDescribe
extends Object

Creates instances of DetectDescribePoint for different feature detectors/describers.

Constructor Summary

Constructors

Constructor	Description
FactoryDetectDescribe()

Method Summary

Modifier and Type	Method	Description
protected static <II extends ImageGray<II>> DetectDescribeSurfPlanar<II>	createDescribeSurfPlanar(FastHessianFeatureDetector<II> detector, OrientationIntegral<II> orientation, DescribePointSurfPlanar<II> describeMulti)
static <T extends ImageGray<T>, TD extends TupleDesc<TD>> DetectDescribePoint<T,TD>	fuseTogether(InterestPointDetector<T> detector, @Nullable OrientationImage<T> orientation, DescribePointRadiusAngle<T,TD> describe)	Given independent algorithms for feature detection, orientation, and describing, create a new DetectDescribePoint.
static <Image extends ImageGray<Image>, Desc extends TupleDesc<Desc>> DetectDescribePoint<Image,Desc>	generic(ConfigDetectDescribe config, Class<Image> imageType)	Generic factory for all detector / descriptors
static <T extends ImageGray<T>> DetectDescribePoint<T,TupleDesc_F64>	sift(@Nullable ConfigCompleteSift config, Class<T> imageType)	Creates a new SIFT feature detector and describer.
static <T extends ImageGray<T>, II extends ImageGray<II>> DetectDescribePoint<T,TupleDesc_F64>	surfColorFast(@Nullable ConfigFastHessian configDetector, ConfigSurfDescribe.Fast configDesc, @Nullable ConfigAverageIntegral configOrientation, ImageType<T> imageType)	Color version of SURF stable.
static <T extends ImageMultiBand<T>, II extends ImageGray<II>> DetectDescribePoint<T,TupleDesc_F64>	surfColorStable(@Nullable ConfigFastHessian configDetector, ConfigSurfDescribe.Stability configDescribe, @Nullable ConfigSlidingIntegral configOrientation, ImageType<T> imageType)	Color version of SURF stable feature.
static <T extends ImageGray<T>, II extends ImageGray<II>> DetectDescribePoint<T,TupleDesc_F64>	surfFast(@Nullable ConfigFastHessian configDetector, ConfigSurfDescribe.Fast configDesc, @Nullable ConfigAverageIntegral configOrientation, Class<T> imageType)	Creates a SURF descriptor.
static <T extends ImageGray<T>, II extends ImageGray<II>> DetectDescribePoint<T,TupleDesc_F64>	surfStable(@Nullable ConfigFastHessian configDetector, ConfigSurfDescribe.Stability configDescribe, @Nullable ConfigSlidingIntegral configOrientation, Class<T> imageType)	Creates a SURF descriptor.

Methods inherited from class java.lang.Object

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

Constructor Details

FactoryDetectDescribe

public FactoryDetectDescribe()

Method Details

generic

public static <Image extends ImageGray<Image>,
Desc extends TupleDesc<Desc>>
DetectDescribePoint<Image,Desc> generic(ConfigDetectDescribe config,
 Class<Image> imageType)

Generic factory for all detector / descriptors

sift

public static <T extends ImageGray<T>>
DetectDescribePoint<T,TupleDesc_F64> sift(@Nullable
 @Nullable ConfigCompleteSift config,
 Class<T> imageType)

Creates a new SIFT feature detector and describer.

Parameters:

config - Configuration for the SIFT detector and descriptor.

Returns:

SIFT

See Also:

• CompleteSift

surfFast

public static <T extends ImageGray<T>,
II extends ImageGray<II>>
DetectDescribePoint<T,TupleDesc_F64> surfFast(@Nullable
 @Nullable ConfigFastHessian configDetector,
 @Nullable
 ConfigSurfDescribe.Fast configDesc,
 @Nullable
 @Nullable ConfigAverageIntegral configOrientation,
 Class<T> imageType)

Creates a SURF descriptor. SURF descriptors are invariant to illumination, orientation, and scale. BoofCV provides two variants. Creates a variant which is designed for speed at the cost of some stability. Different descriptors are created for color and gray-scale images.

[1] Add tech report when its finished. See SURF performance web page for now.

Parameters:

configDetector - Configuration for SURF detector

configDesc - Configuration for SURF descriptor

configOrientation - Configuration for orientation

Returns:

SURF detector and descriptor

See Also:

• FastHessianFeatureDetector
• DescribePointSurf
• DescribePointSurfPlanar

surfColorFast

public static <T extends ImageGray<T>,
II extends ImageGray<II>>
DetectDescribePoint<T,TupleDesc_F64> surfColorFast(@Nullable
 @Nullable ConfigFastHessian configDetector,
 @Nullable
 ConfigSurfDescribe.Fast configDesc,
 @Nullable
 @Nullable ConfigAverageIntegral configOrientation,
 ImageType<T> imageType)

Color version of SURF stable. Features are detected in a gray scale image, but the descriptors are computed using a color image. Each band in the page adds to the descriptor length. See DetectDescribeSurfPlanar for details.

Parameters:

configDetector - Configuration for SURF detector

configDesc - Configuration for SURF descriptor

configOrientation - Configuration for orientation

Returns:

SURF detector and descriptor

See Also:

• FastHessianFeatureDetector
• DescribePointSurf
• DescribePointSurfPlanar

createDescribeSurfPlanar

protected static <II extends ImageGray<II>>
DetectDescribeSurfPlanar<II> createDescribeSurfPlanar(FastHessianFeatureDetector<II> detector,
 OrientationIntegral<II> orientation,
 DescribePointSurfPlanar<II> describeMulti)

surfStable

public static <T extends ImageGray<T>,
II extends ImageGray<II>>
DetectDescribePoint<T,TupleDesc_F64> surfStable(@Nullable
 @Nullable ConfigFastHessian configDetector,
 @Nullable
 ConfigSurfDescribe.Stability configDescribe,
 @Nullable
 @Nullable ConfigSlidingIntegral configOrientation,
 Class<T> imageType)

Creates a SURF descriptor. SURF descriptors are invariant to illumination, orientation, and scale. BoofCV provides two variants. Creates a variant which is designed for stability. Different descriptors are created for color and gray-scale images.

[1] Add tech report when its finished. See SURF performance web page for now.

Parameters:

configDetector - Configuration for SURF detector. Null for default.

configDescribe - Configuration for SURF descriptor. Null for default.

configOrientation - Configuration for region orientation. Null for default.

imageType - Specify type of input image.

Returns:

SURF detector and descriptor

See Also:

• DescribePointSurfPlanar
• FastHessianFeatureDetector
• DescribePointSurfMod

surfColorStable

public static <T extends ImageMultiBand<T>,
II extends ImageGray<II>>
DetectDescribePoint<T,TupleDesc_F64> surfColorStable(@Nullable
 @Nullable ConfigFastHessian configDetector,
 @Nullable
 ConfigSurfDescribe.Stability configDescribe,
 @Nullable
 @Nullable ConfigSlidingIntegral configOrientation,
 ImageType<T> imageType)

Color version of SURF stable feature. Features are detected in a gray scale image, but the descriptors are computed using a color image. Each band in the page adds to the descriptor length. See DetectDescribeSurfPlanar for details.

Parameters:

configDetector - Configuration for SURF detector. Null for default.

configDescribe - Configuration for SURF descriptor. Null for default.

configOrientation - Configuration for region orientation. Null for default.

imageType - Specify type of color input image.

Returns:

SURF detector and descriptor

See Also:

• DescribePointSurfPlanar
• FastHessianFeatureDetector
• DescribePointSurfMod

fuseTogether

public static <T extends ImageGray<T>,
TD extends TupleDesc<TD>>
DetectDescribePoint<T,TD> fuseTogether(InterestPointDetector<T> detector,
 @Nullable
 @Nullable OrientationImage<T> orientation,
 DescribePointRadiusAngle<T,TD> describe)

Given independent algorithms for feature detection, orientation, and describing, create a new DetectDescribePoint.

Parameters:

detector - Feature detector

orientation - Orientation estimation. Optionally, can be null.

describe - Feature descriptor

Returns:

DetectDescribePoint.