Package boofcv.alg.feature.detect.selector

Class FeatureSelectNBest<Point>

java.lang.Object

boofcv.alg.feature.detect.selector.FeatureSelectNBest<Point>

All Implemented Interfaces:

FeatureSelectLimitIntensity<Point>

public class FeatureSelectNBest<Point>
extends Object
implements FeatureSelectLimitIntensity<Point>

Selects and sorts up to the N best features based on their intensity.

Constructor Summary

Constructors

Constructor	Description
FeatureSelectNBest()
FeatureSelectNBest(SampleIntensity<Point> sampler)

Method Summary

Modifier and Type	Method	Description
void	select(@Nullable GrayF32 intensity, int width, int height, boolean positive, @Nullable FastAccess<Point> prior, FastAccess<Point> detected, int limit, FastArray<Point> selected)	Selects features using a rule given the limit on detection objects.
void	setSampler(SampleIntensity<Point> sampler)	Specifies how the intensity will be sampled.

Methods inherited from class java.lang.Object

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

Constructor Details

FeatureSelectNBest

public FeatureSelectNBest(SampleIntensity<Point> sampler)

FeatureSelectNBest

public FeatureSelectNBest()

Method Details

select

public void select(@Nullable
 @Nullable GrayF32 intensity,
 int width,
 int height,
 boolean positive,
 @Nullable
 @Nullable FastAccess<Point> prior,
 FastAccess<Point> detected,
 int limit,
 FastArray<Point> selected)

Description copied from interface: FeatureSelectLimitIntensity

Selects features using a rule given the limit on detection objects. If the limit is higher than the number of detected features and prior is null then the detected features should be copied into selected. How prior features are used is dependent upon the implementation and their affect isn't specified in general.

NOTE: The reason a null input image is supported is for the situation where the intensity image is no longer available and intensity has been copied into points. See SIFT

Specified by:

select in interface FeatureSelectLimitIntensity<Point>

Parameters:

intensity - (Input) Intensity image. If null that means the point will provide intensity information. Nullable.

width - (Input) if image is null then this must be the image's width

height - (Input) if image is null then this must be the image's height

positive - (Input) true if better features have more positive values, false if it's more negative values

prior - (Input) Locations of previously detected features. Nullable

detected - (Input) Locations of newly detected features

limit - (Input) The maximum number of new features detected

selected - (Output) Selected features. Element count not exceed the limit. Reset on every call.

setSampler

public void setSampler(SampleIntensity<Point> sampler)

Description copied from interface: FeatureSelectLimitIntensity

Specifies how the intensity will be sampled.

Specified by:

setSampler in interface FeatureSelectLimitIntensity<Point>