Difference between revisions of "Modules:OtsuThreshold-Documentation-3.6"

From Slicer Wiki
Jump to: navigation, search
(Created page with 'Return to Slicer 3.6 Documentation Gallery of New Features __NOTOC__ ===Module Name=== Otsu Threshold {| |[[Image:O…')
 
Line 39: Line 39:
  
 
== Usage ==
 
== Usage ==
 
 
===Examples, Use Cases & Tutorials===
 
 
* Note use cases for which this module is especially appropriate, and/or link to examples.
 
* Link to examples of the module's use
 
* Link to any existing tutorials
 
 
===Quick Tour of Features and Use===
 
List all the panels in your interface, their features, what they mean, and how to use them. For instance:
 
 
* '''Input panel:'''
 
* '''Parameters panel:'''
 
* '''Output panel:'''
 
* '''Viewing panel:'''
 
 
== Development ==
 
 
===Dependencies===
 
 
Other modules or packages that are required for this module's use.
 
 
===Known bugs===
 
 
Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker.
 
 
 
===Usability issues===
 
 
Follow this [http://na-mic.org/Mantis/main_page.php link] to the Slicer3 bug tracker. Please select the '''usability issue category''' when browsing or contributing.
 
 
===Source code & documentation===
 
 
Source Code: [http://www.na-mic.org/ViewVC/index.cgi/trunk/Applications/CLI/OtsuThresholdImageFilter.cxx?view=annotate OtsuThreshold.cxx]
 
 
XML Description: [http://www.na-mic.org/ViewVC/index.cgi/trunk/Applications/CLI/OtsuThresholdImageFilter.cxx?view=co OtsuThreshold.xml]
 
 
Usage:
 
 
<pre>
 
<pre>
 
./OtsuThresholdImageFilter  [--processinformationaddress <std::string>]
 
./OtsuThresholdImageFilter  [--processinformationaddress <std::string>]
Line 123: Line 85:
 
   (required)  Output filtered
 
   (required)  Output filtered
 
</pre>
 
</pre>
 +
 +
===Source code & documentation===
 +
 +
Source Code: [http://www.na-mic.org/ViewVC/index.cgi/trunk/Applications/CLI/OtsuThresholdImageFilter.cxx?view=co OtsuThreshold.cxx]
 +
 +
XML Description: [http://www.na-mic.org/ViewVC/index.cgi/trunk/Applications/CLI/OtsuThresholdImageFilter.xml?view=co OtsuThreshold.xml]
  
 
== More Information ==  
 
== More Information ==  
  
===Acknowledgment===
+
===Acknowledgement===
 
This work is part of the National Alliance for Medical Image
 
This work is part of the National Alliance for Medical Image
 
Computing (NAMIC), funded by the National Institutes of Health
 
Computing (NAMIC), funded by the National Institutes of Health
Line 134: Line 102:
  
 
===References===
 
===References===
 +
 +
* http://en.wikipedia.org/wiki/Otsu%27s_method
 +
* http://www.labbookpages.co.uk/software/imgProc/otsuThreshold.html
 +
* N.Otsu, ‘‘A threshold selection method from gray level histograms,’’ IEEE Trans.Syst.ManCybern.SMC-9,62–66 1979.

Revision as of 17:14, 20 April 2010

Home < Modules:OtsuThreshold-Documentation-3.6

Return to Slicer 3.6 Documentation

Gallery of New Features

Module Name

Otsu Threshold

CT Grayscale Data
After OtsuThresholdFilter applied with default settings

General Information

Module Type & Category

Type: CLI

Category: Filtering

Authors, Collaborators & Contact

  • Author: Bill Lorensen
  • Contact: bill.lorensen at gmail.com

Module Description

This filter creates a binary thresholded image that separates an image into foreground and background components. The filter calculates the optimum threshold separating those two classes so that their combined spread (intra-class variance) is minimal (see http://en.wikipedia.org/wiki/Otsu%27s_method). Then the filter applies that threshold to the input image using the itkBinaryThresholdImageFilter. The numberOfHistogram bins can be set for the Otsu Calculator. The insideValue and outsideValue can be set for the BinaryThresholdImageFilter. The filter produces a labeled volume.

The original reference is: N.Otsu, ‘‘A threshold selection method from gray level histograms,’’ IEEE Trans.Syst.ManCybern.SMC-9,62–66 1979.

Usage

./OtsuThresholdImageFilter  [--processinformationaddress <std::string>]
                            [--xml] [--echo] [--numberOfBins <int>]
                            [--outsideValue <int>] [--insideValue <int>]
                            [--] [--version] [-h] <std::string>
                            <std::string>


Where: 

--processinformationaddress <std::string>
  Address of a structure to store process information (progress, abort,
  etc.). (default: 0)

--xml
  Produce xml description of command line arguments (default: 0)

--echo
  Echo the command line arguments (default: 0)

--numberOfBins <int>
  The number of bins in the histogram (default: 128)

--outsideValue <int>
  The value assigned to pixels that are outside the computed threshold
  (default: 255)

--insideValue <int>
  The value assigned to pixels that are inside the computed threshold
  (default: 0)

--,  --ignore_rest
  Ignores the rest of the labeled arguments following this flag.

--version
  Displays version information and exits.

-h,  --help
  Displays usage information and exits.

<std::string>
  (required)  Input volume to be filtered

<std::string>
  (required)  Output filtered

Source code & documentation

Source Code: OtsuThreshold.cxx

XML Description: OtsuThreshold.xml

More Information

Acknowledgement

This work is part of the National Alliance for Medical Image Computing (NAMIC), funded by the National Institutes of Health through the NIH Roadmap for Medical Research, Grant U54 EB005149. Information on the National Centers for Biomedical Computing can be obtained from National Centers for Biomedical Computing.

References