TopHat binary threshold on one 2d image. More...

IPSDKIPLBINARIZATION_API image::ImagePtr	ipsdk::imaproc::bin::darkTopHat2dImg (const image::ImageConstPtr &pInImg, const StructuringElementXYInfoConstPtr &pInSEXY, const ipReal64 inTopHatThreshold)
	wrapper function for dark TopHat binary threshold on one 2d image More...

IPSDKIPLBINARIZATION_API image::ImagePtr	ipsdk::imaproc::bin::darkTopHat2dImg (const image::ImageConstPtr &pInImg, const StructuringElementXYInfoConstPtr &pInSEXY, const ipReal64 inTopHatThreshold, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy)
	wrapper function for dark TopHat binary threshold on one 2d image More...

IPSDKIPLBINARIZATION_API void	ipsdk::imaproc::bin::darkTopHat2dImg (const image::ImageConstPtr &pInImg, const StructuringElementXYInfoConstPtr &pInSEXY, const ipReal64 inTopHatThreshold, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy, const image::ImagePtr &pOutBinImg)
	wrapper function for dark TopHat binary threshold on one 2d image More...

IPSDKIPLBINARIZATION_API image::ImagePtr	ipsdk::imaproc::bin::lightTopHat2dImg (const image::ImageConstPtr &pInImg, const StructuringElementXYInfoConstPtr &pInSEXY, const ipReal64 inTopHatThreshold)
	wrapper function for light TopHat binary threshold on one 2d image More...

IPSDKIPLBINARIZATION_API image::ImagePtr	ipsdk::imaproc::bin::lightTopHat2dImg (const image::ImageConstPtr &pInImg, const StructuringElementXYInfoConstPtr &pInSEXY, const ipReal64 inTopHatThreshold, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy)
	wrapper function for light TopHat binary threshold on one 2d image More...

IPSDKIPLBINARIZATION_API void	ipsdk::imaproc::bin::lightTopHat2dImg (const image::ImageConstPtr &pInImg, const StructuringElementXYInfoConstPtr &pInSEXY, const ipReal64 inTopHatThreshold, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy, const image::ImagePtr &pOutBinImg)
	wrapper function for light TopHat binary threshold on one 2d image More...

Detailed Description

TopHat binary threshold on one 2d image.

Top-Hat transform is an operation which allows to extract small details from an image. This transformation is in this case associated to a thresholding operation to obtain a binary image. This algorithm can be customized to search for dark (black, which is the default) or light (white) small particules.

Top-Hat transformation, given a structuring element $ InSEXY $ , is associated to following formula :

Dark (black) top hat transform :
$T^D(InImg)_{InSEXY} = InImg \odot InSEXY - InImg$
Dark Top-Hat algorithm used a top-hat transform followed by a binarization step which can be illustrated as follow :
Light (white) top hat transform :
$T^L(InImg)_{InSEXY} = InImg - InImg \circledcirc InSEXY$
White Top-Hat algorithm used a top-hat transform followed by a binarization step which can be illustrated as follow :

Where $\odot$ and $\circledcirc$ are respectively a closing and an opening operation (see Opening 2d and Closing 2d).

Note: Behavior of this algorithm is specialized using specific morphological structuring elements (see 2d structuring elements for more informations about these shapes).
Please refer to Usage for examples of usage of different types of specific structuring elements during morphological operations.

Here is an example of a top-hat transform 2d operation applied to a gray scale input image with a circular structuring element with radius 20 :

See also: http://en.wikipedia.org/wiki/Top-hat_transform

Note

This algorithm is associated with three temporary working images ipsdk::imaproc::attr::OutOptWk1Img, ipsdk::imaproc::attr::OutOptWk2Img and ipsdk::imaproc::attr::OutWk1Img.

ipsdk::imaproc::attr::OutOptWk1Img will only be used if InOptBorderExtensionPolicy is set to ipsdk::imaproc::attr::eBorderExtensionPolicy::eBEP_Enable. This working temporary image can be provided by user or will be automatically allocated when requested.
The second one (ipsdk::imaproc::attr::OutOptWk2Img) is only used in special processing cases defined via ipsdk::imaproc::morpho::eSEProcessingCase enumerate. Such situation can be tested using ipsdk::imaproc::morpho::getSEProcessingCase function and associated image buffer type can be retrieved using ipsdk::imaproc::morpho::getSEWkImageBufferType. This working temporary image can be provided by user or will be automatically allocated when requested.
The third one (ipsdk::imaproc::attr::OutWk1Img) is systematically needed for internal processing. This working temporary image can be provided by user or will be automatically allocated.

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InSEXY	[Input] structuring element xy for processing operation	X
ipsdk::imaproc::attr::InShapeGreyscaleType	[Input] shape greyscale type considered during processing	X
ipsdk::imaproc::attr::InTopHatThreshold	[Input] threshold value used for top hat binarization	X
ipsdk::imaproc::attr::InOptBorderExtensionPolicy	[Input Optional] flag indicating border extension policy for processing	X
ipsdk::imaproc::attr::OutOptWk1Img	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutOptWk2Img	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutWk1Img	[Output] Temporary working image for algorithm	ipsdk::imaproc::duplicateInOut (_pOutWk1Img, _pInImg)
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)) &&
(ipsdk::imaproc::matchSizeAndType (_pInImg,_pOutWk1Img)) &&
(ipsdk::imaproc::noInSitu (_pInImg,_pOutWk1Img)) &&
(ipsdk::processor::ifIsSet (_pOutOptWk1Img,
   ipsdk::imaproc::customImageProperty (_pOutOptWk1Img,
    morpho::matchBorderExtension1 (_pInImg,_pInSEXY,_pInOptBorderExtensionPolicy)))) &&
(ipsdk::processor::ifIsSet (_pOutOptWk2Img,
   ipsdk::imaproc::customImageProperty (_pOutOptWk2Img,
    morpho::matchBorderExtension2 (_pInImg,_pInSEXY,_pInOptBorderExtensionPolicy)))))

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLBinarization as bin

Code Example

    # opening of input images
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # creation of used structuring element
    structuringElement = PyIPSDK.circularSEXYInfo(15);
    
    # dark top hat 2d image computation
    outImg = bin.darkTopHat2dImg(inImg,  structuringElement,  20)

Example of C++ code :

Example informations

Associated library

IPSDKIPLBinarization

Header file

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

Code Example

    // create a 6x2 rectangular structuring element
    StructuringElementXYInfoConstPtr pInSEXY = rectangularSEXYInfo(6, 2);
    // opening input image
    ImagePtr pInImg = loadTiffImageFile(inputImgPath);
    // compute dark tophat on input image
    ImagePtr pOutImgDark = darkTopHat2dImg(pInImg, pInSEXY, 30);

See also: TopHat2dImgLvl1

Function Documentation