Interface FeatureSelectLimitIntensity<Point>

All Known Implementing Classes:
ConvertLimitToIntensity, FeatureSelectNBest, FeatureSelectUniformBest

public interface FeatureSelectLimitIntensity<Point>
Selects features inside the image until it hits a limit. Feature intensity is available to aide in the selection process. By using SampleIntensity it's possible to support approaches which use the intensity image and ones which have features with intensity image and no access to an intensity image.
  • 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.
  • Method Details

    • select

      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)

      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

      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

      void setSampler​(SampleIntensity<Point> sampler)
      Specifies how the intensity will be sampled.