Isodata Threshold computation

computation of iso data threshold on one image More...

Functions
IPSDKIPLBINARIZATION_API ipReal64	ipsdk::imaproc::bin::isoDataThreshold (const ipsdk::image::ImageConstPtr &pInImg)
	wrapper function for computation of iso data threshold on one image. In this version of the function, the histogram of the image is automatically computed, with a bin width of 1.0 More...

Detailed Description

computation of iso data threshold on one image

Isodata-based method, also known as Ridler-Calvard method [1] [2], is used to automatically perform the binarization of an input image. It assumes that the image is bi-modal (pixel intensities can be distinguished in 2 classes: background pixels and foreground pixels) and calculate the optimal threshold that separates these 2 classes. This algorithm was proposed by Ridler-Calvard in 1978 , and defines the threshold as the equidistant value between the average intensities of both classes:

Where is the mean intensity of the background pixels and is the mean intensity of the foreground pixels.

An admissible threshold is close to the bin , used to define the background and foreground classes:

Where is the histogram value for the bin and is the width of this bin.

If thresholds are found, the algorithm retains the minimum and maximum thresholds respecting the previous assertion and returns the mean value between their average.

On the contrary, if no threshold has been found, the algorithm returns NumericLimits<ipsdk::ipReal64>::max().

References

[1] "Picture Thresholding Using an Iterative Selection Method", T. W. Ridler and S. Calvard, IEEE Transactions on Systems, Man, and Cybernetics, pages 630-632, August 1978

[2] "Survey over image thresholding techniques and quantitative performance evaluation", M. Sezgin and B. Sankur, Journal of Electronic Imaging, pages 146-168, January 2004

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InOutOptHistogram	[InOut Optional] histogram properties	X
ipsdk::imaproc::attr::InOptWeight	[Input Optional] Weighting coefficient	X
ipsdk::imaproc::attr::OutThreshold	[Output] threshold value for image binarization	X

Global Rule description

Global rule description for algorithm :
ipsdk::processor::none ()

Example of Python code :

Example imports

import PyIPSDK
import PyIPSDK.IPSDKIPLBinarization as bin

Code Example

    # opening of input images
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)    
    
    # otsu threshold computation
    isoDataThresholdValue = bin.isoDataThreshold(inImg)

Example of C++ code :

Example informations

Associated library

IPSDKIPLBinarization

Header file

#include <IPSDKIPL/IPSDKIPLBinarization/Processor/IsoDataThreshold/IsoDataThreshold.h>

Code Example

        // open input image
        ImageGeometryPtr pInputImageGeometry = geometry2d(inType, sizeX, sizeY);
        ImagePtr pInImg = loadRawImageFile(inPath, *pInputImageGeometry);

        // Sample calculating automatically the histogram
        // ----------------------------------------------

        // compute otsu threshold associated to input image
        ipReal64 isodataThresholdValue = isoDataThreshold(pInImg);

        // Sample with the histogram as input parameter
        // ----------------------------------------------

        // Set the histogram parameters
        const ipReal64 min = 50.;
        const ipReal64 max = 250.;
        const ipReal64 fBinWidth = 2.;
        HistoMsrParamsPtr pHistoPrms = createHistoMsrParamsWithBinWidth(min, max, fBinWidth);

        // Compute the histogram
        HistogramDataPtr pHistogramData = histogramMsr(pInImg, pHistoPrms);

        // compute otsu threshold associated to input image
        ipReal64 isodataThresholdValue_manualHisto = isoDataThreshold(pInImg, pHistogramData);

See also

IsoDataThresholdLvl1

Function Documentation

isoDataThreshold()

IPSDKIPLBINARIZATION_API ipReal64 ipsdk::imaproc::bin::isoDataThreshold

(

const ipsdk::image::ImageConstPtr &

pInImg

)

wrapper function for computation of iso data threshold on one image. In this version of the function, the histogram of the image is automatically computed, with a bin width of 1.0

Note

the binarized image is not computed

Exceptions

ipsdk::processor::IPSDKBaseProcessingException

on failure