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.

Author:

Peter Abeles

Constructor Summary

Constructors

Constructor and Description
FactoryDetectDescribe()

Method Summary

Methods

Modifier and Type	Method and Description
static <T extends ImageSingleBand,D extends TupleDesc> DetectDescribePoint<T,D>	fuseTogether(InterestPointDetector<T> detector, OrientationImage<T> orientation, DescribeRegionPoint<T,D> describe) Given independent algorithms for feature detection, orientation, and describing, create a new DetectDescribePoint.
static DetectDescribePoint<ImageFloat32,SurfFeature>	sift(ConfigSiftScaleSpace configSS, ConfigSiftDetector configDetector, ConfigSiftOrientation configOri, ConfigSiftDescribe configDesc) Creates a new SIFT feature detector and describer.
static <T extends ImageSingleBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfColorFast(ConfigFastHessian configDetector, ConfigSurfDescribe.Speed configDesc, ConfigAverageIntegral configOrientation, ImageType<T> imageType) Color version of SURF stable.
static <T extends ImageMultiBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfColorStable(ConfigFastHessian configDetector, ConfigSurfDescribe.Stablility configDescribe, ConfigSlidingIntegral configOrientation, ImageType<T> imageType) Color version of SURF stable feature.
static <T extends ImageSingleBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfFast(ConfigFastHessian configDetector, ConfigSurfDescribe.Speed configDesc, ConfigAverageIntegral configOrientation, Class<T> imageType) Creates a SURF descriptor.
static <T extends ImageSingleBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature>	surfStable(ConfigFastHessian configDetector, ConfigSurfDescribe.Stablility configDescribe, 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 Detail

FactoryDetectDescribe

public FactoryDetectDescribe()

Method Detail

sift

public static DetectDescribePoint<ImageFloat32,SurfFeature> sift(ConfigSiftScaleSpace configSS,
                                                 ConfigSiftDetector configDetector,
                                                 ConfigSiftOrientation configOri,
                                                 ConfigSiftDescribe configDesc)

Creates a new SIFT feature detector and describer.

Parameters:

configSS - Configuration for scale-space. Pass in null for default options.

configDetector - Configuration for detector. Pass in null for default options.

configOri - Configuration for region orientation. Pass in null for default options.

configDesc - Configuration for descriptor. Pass in null for default options.

Returns:

SIFT

surfFast

public static <T extends ImageSingleBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfFast(ConfigFastHessian configDetector,
                                                                                                 ConfigSurfDescribe.Speed configDesc,
                                                                                                 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, DescribePointSurfMultiSpectral

surfColorFast

public static <T extends ImageSingleBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfColorFast(ConfigFastHessian configDetector,
                                                                                                      ConfigSurfDescribe.Speed configDesc,
                                                                                                      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 DetectDescribeSurfMultiSpectral 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, DescribePointSurfMultiSpectral

surfStable

public static <T extends ImageSingleBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfStable(ConfigFastHessian configDetector,
                                                                                                   ConfigSurfDescribe.Stablility configDescribe,
                                                                                                   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:

DescribePointSurfMultiSpectral, FastHessianFeatureDetector, DescribePointSurfMod

surfColorStable

public static <T extends ImageMultiBand,II extends ImageSingleBand> DetectDescribePoint<T,SurfFeature> surfColorStable(ConfigFastHessian configDetector,
                                                                                                       ConfigSurfDescribe.Stablility configDescribe,
                                                                                                       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 DetectDescribeSurfMultiSpectral 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:

DescribePointSurfMultiSpectral, FastHessianFeatureDetector, DescribePointSurfMod

fuseTogether

public static <T extends ImageSingleBand,D extends TupleDesc> DetectDescribePoint<T,D> fuseTogether(InterestPointDetector<T> detector,
                                                                                    OrientationImage<T> orientation,
                                                                                    DescribeRegionPoint<T,D> 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.