org.openimaj.image.processing.edges

Class SUSANEdgeDetector

java.lang.Object

org.openimaj.image.processing.edges.SUSANEdgeDetector

All Implemented Interfaces:

ImageProcessor<FImage>, Processor<FImage>, SinglebandImageProcessor<Float,FImage>

@Reference(author="S. M. Smith",
           title="A new class of corner finder",
           type=Article,
           url="http://users.fmrib.ox.ac.uk/~steve/susan/susan/node4.html",
           year="1992",
           booktitle="Proc. 3rd British Machine Vision Conference",
           pages="139-148")
public class SUSANEdgeDetector
extends Object
implements SinglebandImageProcessor<Float,FImage>

Implementations of the SUSAN edge detection algorithm. The default processor uses the simple version; there are static methods for the other versions which are pretty slow. However, the circular version allows you to detect "fat" lines which would otherwise be detected as two separate lines.

Author:

David Dupplaw (dpd@ecs.soton.ac.uk)

Created:

18 Jun 2012

Nested Class Summary

Nested classes/interfaces inherited from interface org.openimaj.image.processor.SinglebandImageProcessor

SinglebandImageProcessor.Processable<T,S extends Image<T,S>,I extends Image<?,I>>

Constructor Summary

Constructors

Constructor and Description
SUSANEdgeDetector() Default constructor that instantiates a simple SUSAN edge detector with threshold 0.08 and global threshold weighting 9.
SUSANEdgeDetector(org.openimaj.image.processing.edges.SUSANEdgeDetector.SUSANDetector s, double threshold, double nmax)
SUSANEdgeDetector(org.openimaj.image.processing.edges.SUSANEdgeDetector.SUSANDetector s, double threshold, double nmax, double radius)

Method Summary

Modifier and Type	Method and Description
void	processImage(FImage image) Process an image.
static FImage	simpleSusan(FImage img, double thresh, double nmax) Performs the simple SUSAN edge detection.
static FImage	smoothCircularSusan(FImage img, double thresh, double nmax, double radius) Performs the simple SUSAN edge detection.
static FImage	smoothSusan(FImage img, double thresh, double nmax) Performs the simple SUSAN edge detection.

Methods inherited from class java.lang.Object

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

Constructor Detail

SUSANEdgeDetector

public SUSANEdgeDetector()

Default constructor that instantiates a simple SUSAN edge detector with threshold 0.08 and global threshold weighting 9.

SUSANEdgeDetector

public SUSANEdgeDetector(org.openimaj.image.processing.edges.SUSANEdgeDetector.SUSANDetector s,
                         double threshold,
                         double nmax)

Parameters:

s - The susan detector to use

threshold - The threshold to use

nmax - The global threshold weighting

SUSANEdgeDetector

public SUSANEdgeDetector(org.openimaj.image.processing.edges.SUSANEdgeDetector.SUSANDetector s,
                         double threshold,
                         double nmax,
                         double radius)

Parameters:

s - The susan detector to use

threshold - The threshold to use

nmax - The global threshold weighting

radius - The radius of the circular susan

Method Detail

processImage

public void processImage(FImage image)

Process an image. Implementing classes must alter the image passed in-place or assign the output to the input using Image.internalAssign(Image).

Specified by:

processImage in interface ImageProcessor<FImage>

Parameters:

image - The image to process in place.

See Also:

ImageProcessor.processImage(org.openimaj.image.Image)

simpleSusan

public static FImage simpleSusan(FImage img,
                                 double thresh,
                                 double nmax)

Performs the simple SUSAN edge detection.

Parameters:

img - The image to find edges in

thresh - The threshold

nmax - The global threshold weighting

Returns:

Edge image

smoothSusan

public static FImage smoothSusan(FImage img,
                                 double thresh,
                                 double nmax)

Performs the simple SUSAN edge detection.

Parameters:

img - The image to find edges in

thresh - The threshold

nmax - The global threshold weighting

Returns:

Edge image

smoothCircularSusan

public static FImage smoothCircularSusan(FImage img,
                                         double thresh,
                                         double nmax,
                                         double radius)

Performs the simple SUSAN edge detection.

Parameters:

img - The image to find edges in

thresh - The threshold

nmax - The global threshold weighting

radius - The radius of the circle (try 3.4)

Returns:

Edge image