bar.plugin

Class ShenCastan

java.lang.Object

bar.plugin.ShenCastan

All Implemented Interfaces:

DialogListener, ExtendedPlugInFilter, PlugInFilter

public class ShenCastan
extends Object
implements ExtendedPlugInFilter, DialogListener

Performs gradient computation using the method proposed by Shen and Castan, an alternative to Canny-Deriche filtering. For a full description, see the original manuscript: Shen and Castan, CVGIP, 1992, 54 (2) 112-133. DOI: 10.1016/1049-9652(92)90060-B

 2014.06-2015.07, Tiago Ferreira
      - Extended API
      - Works with 16-bit and 32-bit images and stacks (multithreaded)
      - If present, only area ROI is processed
      - Added "preview" mode and undo support
      - Licensed under GPL (see ../../../../../LICENSE.txt)
 2004.07, Maxime Pinchon
      - Algorithm implementation[1]. This initial version no longer works with IJ
 
 [1] http://imagej.nih.gov/ij/plugins/inserm514/Documentation/Shen_Castan_514/Shen_Castan_514.html
 

Field Summary

Fields inherited from interface ij.plugin.filter.ExtendedPlugInFilter

KEEP_PREVIEW

Fields inherited from interface ij.plugin.filter.PlugInFilter

CONVERT_TO_FLOAT, DOES_16, DOES_32, DOES_8C, DOES_8G, DOES_ALL, DOES_RGB, DOES_STACKS, DONE, FINAL_PROCESSING, KEEP_THRESHOLD, NO_CHANGES, NO_IMAGE_REQUIRED, NO_UNDO, PARALLELIZE_IMAGES, PARALLELIZE_STACKS, ROI_REQUIRED, SNAPSHOT, STACK_REQUIRED, SUPPORTS_MASKING

Constructor Summary

Constructors

Constructor and Description
ShenCastan()

Method Summary

Modifier and Type	Method and Description
boolean	dialogItemChanged(GenericDialog gd, AWTEvent e) Reads dialog parameters (during preview and upon dismissal of dialog prompt).
void	findEdges(ImageProcessor ip, double f) Method implementing Shen-Castan edge detection.
double[]	getX() Returns the horizontal component of the computed gradient.
double[]	getY() Returns the vertical component of the computed gradient.
static void	main(String[] args) Calls fiji.Debug.runFilter() so that the plugin can be debugged from an IDE
void	run(ImageProcessor ip)
void	setNPasses(int nPasses)
int	setup(String arg, ImagePlus imp) Returns the flags declaring the type of supported images.
int	showDialog(ImagePlus imp, String command, PlugInFilterRunner pfr) Displays the dialog prompt.

Methods inherited from class java.lang.Object

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

Constructor Detail

ShenCastan

public ShenCastan()

Method Detail

main

public static void main(String[] args)

Calls fiji.Debug.runFilter() so that the plugin can be debugged from an IDE

setup

public int setup(String arg,
                 ImagePlus imp)

Returns the flags declaring the type of supported images.

Specified by:

setup in interface PlugInFilter

showDialog

public int showDialog(ImagePlus imp,
                      String command,
                      PlugInFilterRunner pfr)

Displays the dialog prompt.

Specified by:

showDialog in interface ExtendedPlugInFilter

dialogItemChanged

public boolean dialogItemChanged(GenericDialog gd,
                                 AWTEvent e)

Reads dialog parameters (during preview and upon dismissal of dialog prompt).

Specified by:

dialogItemChanged in interface DialogListener

Returns:

true, if user specified valid input values

setNPasses

public void setNPasses(int nPasses)

Specified by:

setNPasses in interface ExtendedPlugInFilter

run

public void run(ImageProcessor ip)

Specified by:

run in interface PlugInFilter

findEdges

public void findEdges(ImageProcessor ip,
                      double f)

Method implementing Shen-Castan edge detection.

Parameters:

ip - the ImageProcessor to be filtered (8/16/32-bit grayscale image)

f - the smoothing factor alpha, i.e., the Shen-Castan coefficient. Can vary between 0d (high smoothing, suitable for noisy images) and 1d (no smoothing, suitable for non-noisy images). Note that no validation is performed to assess if 0d > alpha < 1d .

getX

public double[] getX()

Returns the horizontal component of the computed gradient. Must be called after calling findEdges(ImageProcessor, double).

Returns:

the horizontal component of the Shen-Castan gradient

getY

public double[] getY()

Returns the vertical component of the computed gradient. Must be called after calling findEdges(ImageProcessor, double).

Returns:

the vertical component of the Shen-Castan gradient