Click or drag to resize
Accord.NET (logo)

SusanCornersDetector Class

Susan corners detector.
Inheritance Hierarchy
SystemObject
  Accord.ImagingBaseFeatureExtractorCornerFeaturePoint
    Accord.ImagingBaseSparseFeatureExtractorCornerFeaturePoint
      Accord.ImagingBaseCornersDetector
        Accord.ImagingSusanCornersDetector

Namespace:  Accord.Imaging
Assembly:  Accord.Imaging (in Accord.Imaging.dll) Version: 3.8.0
Syntax
public class SusanCornersDetector : BaseCornersDetector
Request Example View Source

The SusanCornersDetector type exposes the following members.

Constructors
  NameDescription
Public methodSusanCornersDetector
Initializes a new instance of the SusanCornersDetector class.
Public methodSusanCornersDetector(Int32, Int32)
Initializes a new instance of the SusanCornersDetector class.
Top
Properties
Methods
  NameDescription
Public methodClone
Creates a new object that is a copy of the current instance.
(Inherited from BaseFeatureExtractorTFeature.)
Protected methodClone(ISetPixelFormat)
Creates a new object that is a copy of the current instance.
(Overrides BaseFeatureExtractorTFeatureClone(ISetPixelFormat).)
Public methodDispose
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Inherited from BaseFeatureExtractorTFeature.)
Protected methodDispose(Boolean)
Releases unmanaged and - optionally - managed resources.
(Inherited from BaseFeatureExtractorTFeature.)
Public methodEquals
Determines whether the specified object is equal to the current object.
(Inherited from Object.)
Protected methodFinalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object.)
Public methodGetHashCode
Serves as the default hash function.
(Inherited from Object.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Protected methodInnerProcess
This method should be implemented by inheriting classes to implement the actual corners detection, transforming the input image into a list of points.
(Overrides BaseCornersDetectorInnerProcess(UnmanagedImage).)
Protected methodInnerTransform
This method should be implemented by inheriting classes to implement the actual feature extraction, transforming the input image into a list of features.
(Inherited from BaseCornersDetector.)
Protected methodMemberwiseClone
Creates a shallow copy of the current Object.
(Inherited from Object.)
Public methodProcessImage(Bitmap)
Process image looking for corners.
(Inherited from BaseCornersDetector.)
Public methodProcessImage(BitmapData)
Process image looking for corners.
(Inherited from BaseCornersDetector.)
Public methodProcessImage(UnmanagedImage)
Process image looking for corners.
(Inherited from BaseCornersDetector.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodTransform(Bitmap)
Applies the transformation to an input, producing an associated output.
(Inherited from BaseFeatureExtractorTFeature.)
Public methodTransform(Bitmap)
Applies the transformation to an input, producing an associated output.
(Inherited from BaseFeatureExtractorTFeature.)
Public methodTransform(UnmanagedImage)
Applies the transformation to an input, producing an associated output.
(Inherited from BaseFeatureExtractorTFeature.)
Public methodTransform(UnmanagedImage)
Applies the transformation to an input, producing an associated output.
(Inherited from BaseFeatureExtractorTFeature.)
Public methodTransform(Bitmap, IEnumerableTFeature)
Applies the transformation to a set of input vectors, producing an associated set of output vectors.
(Inherited from BaseFeatureExtractorTFeature.)
Public methodTransform(UnmanagedImage, IEnumerableTFeature)
Applies the transformation to a set of input vectors, producing an associated set of output vectors.
(Inherited from BaseFeatureExtractorTFeature.)
Top
Extension Methods
  NameDescription
Public Extension MethodHasMethod
Checks whether an object implements a method with the given name.
(Defined by ExtensionMethods.)
Public Extension MethodIsEqual
Compares two objects for equality, performing an elementwise comparison if the elements are vectors or matrices.
(Defined by Matrix.)
Public Extension MethodTo(Type)Overloaded.
Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime.
(Defined by ExtensionMethods.)
Public Extension MethodToTOverloaded.
Converts an object into another type, irrespective of whether the conversion can be done at compile time or not. This can be used to convert generic types to numeric types during runtime.
(Defined by ExtensionMethods.)
Top
Remarks

The class implements Susan corners detector, which is described by S.M. Smith in: S.M. Smith, "SUSAN - a new approach to low level image processing", Internal Technical Report TR95SMS1, Defense Research Agency, Chobham Lane, Chertsey, Surrey, UK, 1995.

Note Note
Some implementation notes:
  • Analyzing each pixel and searching for its USAN area, the 7x7 mask is used, which is comprised of 37 pixels. The mask has circle shape:
      xxx
     xxxxx
    xxxxxxx
    xxxxxxx
    xxxxxxx
     xxxxx
      xxx
  • In the case if USAN's center of mass has the same coordinates as nucleus (central point), the pixel is not a corner.
  • For noise suppression the 5x5 square window is used.

The class processes only grayscale 8 bpp and color 24/32 bpp images. In the case of color image, it is converted to grayscale internally using GrayscaleBT709 filter.

Sample usage:

// create corners detector's instance
SusanCornersDetector scd = new SusanCornersDetector( );
// process image searching for corners
List<IntPoint> corners = scd.ProcessImage( image );
// process points
foreach ( IntPoint corner in corners )
{
    // ... 
}
See Also