Compute the Kittler threshold of an input image, and binarize the image using this threshold. More...

IPSDKIPLBINARIZATION_API KittlerResult	ipsdk::imaproc::bin::kittlerThresholdImg (const ipsdk::image::ImageConstPtr &pInImg)
	wrapper function for binarization on one image using Kittler's method. In this version of the function, the histogram of the image is automatically computed, with a bin width of 1.0 More...

IPSDKIPLBINARIZATION_API ipReal64	ipsdk::imaproc::bin::kittlerThresholdImg (const ipsdk::image::ImageConstPtr &pInImg, const ipsdk::image::ImagePtr &pOutBinImg)
	wrapper function for binarization on one image using Kittler's method. In this version of the function, the histogram of the image is automatically computed, with a bin width of 1.0 More...

IPSDKIPLBINARIZATION_API KittlerResult	ipsdk::imaproc::bin::kittlerThresholdImg (const ipsdk::image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::HistogramDataPtr &pHistogram)
	wrapper function for binarization on one image using Kittler's method. histogram used to compute the Kittler's threshold is provided as argument of the function More...

IPSDKIPLBINARIZATION_API ipReal64	ipsdk::imaproc::bin::kittlerThresholdImg (const ipsdk::image::ImageConstPtr &pInImg, const ipsdk::imaproc::attr::HistogramDataPtr &pHistogram, const ipsdk::image::ImagePtr &pOutBinImg)
	wrapper function for binarization on one image using Kittler's method. histogram used to compute the Kittler's threshold is provided as argument of the function More...

Detailed Description

Compute the Kittler threshold of an input image, and binarize the image using this threshold.

Kittler's method is used to automatically perform the binarization of an input image [1]. It assumes that the image is bi-modal (pixel intensities can be distinguished in 2 classes: background pixels and foreground pixels and that each mode can be approximated by a Gaussian. It then calculates the optimal threshold $t$ that separates these 2 classes, by minimizing the error :

$\begin{eqnarray*} E & = & 1 + 2*(P_1(t)*\log(\sigma_1(t)) + P_2(t)*\log(\sigma_2(t)))\\ & & \quad - 2*(P_1(t)*\log(P_1(t)) + P2(t)*\log(P_2(t))) \end{eqnarray*}$

See also: Kittler Threshold computation for more details about this error function.

On output, binarized image values are given by:

$OutBinImg[i] = \begin{cases} 1, & \text{if } InImg[i] \geq KittlerThreshold \\ 0, & \text{otherwise} \end{cases}$

with $KittlerThreshold$ the threshold computed from Kittler's method.

Input and output images must have same size and buffer type.

Here is an example of automatic Kittler image thresholding applied to a 8-bits grey level image (on ouput, computed threshold equals 65) :

[1] Kittler, J. & Illingworth, J. Minimum error thresholding Pattern Recognition, 1986, 19, 41 - 47

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::OutThreshold	[Output] threshold value for image binarization	X
ipsdk::imaproc::attr::OutBinImg	[Output] binary image for processing operation	ipsdk::imaproc::duplicateInOut (_pOutBinImg, _pInImg, image::eImageBufferType::eIBT_Binary)

Global Rule description

Global rule description for algorithm :
ipsdk::imaproc::matchSize (_pInImg,_pOutBinImg)

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
    outImg,  kittlerThresholdValue = bin.kittlerThresholdImg(inImg)

Example of C++ code :

Example informations

Associated library

IPSDKIPLBinarization

Header file

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

Code Example

        // open input image
        ImageGeometryPtr pInputImageGeometry = geometry2d(inType, sizeX, sizeY);
        ImagePtr pInImg = loadRawImageFile(inPath, *pInputImageGeometry);
        // Sample with a generated output image
        // ------------------------------------
        // compute thresholded output image
        KittlerResult kittlerResult = kittlerThresholdImg(pInImg);
        // Sample with a provided output image
        // -----------------------------------
        // create output image
        ImageGeometryPtr pOutputImageGeometry = geometry2d(eImageBufferType::eIBT_Binary, sizeX, sizeY);
        boost::shared_ptr<MemoryImage> pOutImg(boost::make_shared<MemoryImage>());
        pOutImg->init(*pOutputImageGeometry);
        // compute thresholded output image
        ipReal64 fOutThreshold = kittlerThresholdImg(pInImg, pOutImg);

See also: KittlerThresholdImgLvl1

Function Documentation

◆ kittlerThresholdImg() [1/4]

IPSDKIPLBINARIZATION_API KittlerResult ipsdk::imaproc::bin::kittlerThresholdImg ( const ipsdk::image::ImageConstPtr & pInImg )

wrapper function for binarization on one image using Kittler's method. In this version of the function, the histogram of the image is automatically computed, with a bin width of 1.0

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ kittlerThresholdImg() [2/4]

IPSDKIPLBINARIZATION_API KittlerResult ipsdk::imaproc::bin::kittlerThresholdImg	(	const ipsdk::image::ImageConstPtr &	pInImg,
		const ipsdk::imaproc::attr::HistogramDataPtr &	pHistogram
	)

wrapper function for binarization on one image using Kittler's method. histogram used to compute the Kittler's threshold is provided as argument of the function

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ kittlerThresholdImg() [3/4]

IPSDKIPLBINARIZATION_API ipReal64 ipsdk::imaproc::bin::kittlerThresholdImg	(	const ipsdk::image::ImageConstPtr &	pInImg,
		const ipsdk::image::ImagePtr &	pOutBinImg
	)

wrapper function for binarization on one image using Kittler's method. In this version of the function, the histogram of the image is automatically computed, with a bin width of 1.0

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ kittlerThresholdImg() [4/4]

IPSDKIPLBINARIZATION_API ipReal64 ipsdk::imaproc::bin::kittlerThresholdImg	(	const ipsdk::image::ImageConstPtr &	pInImg,
		const ipsdk::imaproc::attr::HistogramDataPtr &	pHistogram,
		const ipsdk::image::ImagePtr &	pOutBinImg
	)

wrapper function for binarization on one image using Kittler's method. histogram used to compute the Kittler's threshold is provided as argument of the function

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure