Dilate Local Extrema 2d

algorithm allowing to extract dilated local extrema 2d from an image More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::dilateLocalMaxima2dImg (const image::ImageConstPtr &pInImg, const ipReal32 inDilateFactor)
	wrapper function for algorithm allowing to extract dilated local maxima 2d from an image More...
IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::dilateLocalMaxima2dImg (const image::ImageConstPtr &pInImg, const ipReal32 inDilateFactor, const image::ImagePtr &pOutBinImg)
	wrapper function for algorithm allowing to extract dilated local maxima 2d from an image More...
IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::dilateLocalMinima2dImg (const image::ImageConstPtr &pInImg, const ipReal32 inDilateFactor)
	wrapper function for algorithm allowing to extract dilated local minima 2d from an image More...
IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::dilateLocalMinima2dImg (const image::ImageConstPtr &pInImg, const ipReal32 inDilateFactor, const image::ImagePtr &pOutBinImg)
	wrapper function for algorithm allowing to extract dilated local minima 2d from an image More...

Detailed Description

algorithm allowing to extract dilated local extrema 2d from an image

This algorithm allows, given an input image InImg, a dilation factor InDilateFactor and a searched extrema type defined by InLocalExtremumType parameter, to compute a binary ouput image OutBinImg where all set pixels are part of a dilated local extrema.

Note

This algorithm is an extension of Local Extrema 2d algorithm allowing to dilate (and in some case merge) local extrema. Using this algorithm with a value of InDilateFactor set to 0 is equivalent of using Local Extrema 2d algorithm.

Dilation factor InDilateFactor is a grey scale factor (not a geometric factor) since local extrema are dilated with a distance based on grey scale difference.

Output image is computed has follow (local maxima case) :

where pixel with index is :

• connected to pixel with index in output image
• greater than or equal to all other values (local maxima) in the connected component associated to the pixel with index .

This is illustrated in case of a 1d signal :

Here is an example of a dilated local maxima extraction applied to an unsigned char input image with dilation factor equal to 0 :

Here is an example of a dilated local maxima extraction applied to an unsigned char input image with dilation factor equal to 5 (note merged maxima) :

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InDilateFactor	[Input] factor used for dilation	X
ipsdk::imaproc::attr::InLocalExtremumType	[Input] local extremum type	X
ipsdk::imaproc::attr::OutOptWk1Img	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutBinImg	[Output] binary image for processing operation	duplicateInOut (_pOutBinImg, _pInImg, ipsdk::image::eImageBufferType::eIBT_Binary)

Global Rule description

Global rule description for algorithm :
(ipsdk::imaproc::matchSize (_pInImg,_pOutBinImg) && 
 ipsdk::processor::ifIsSet (_pOutOptWk1Img,
  ipsdk::imaproc::matchSizeAndType (_pInImg,_pOutOptWk1Img)))

Example of Python code :

Example imports

import PyIPSDK
import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # dilate local maxima 2d computation
    outImg = advmorpho.dilateLocalMaxima2dImg(inImg, 5)

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

#include <IPSDKIPL/IPSDKIPLAdvancedMorphology/Processor/DilateLocalExtrema2dImg/DilateLocalExtrema2dImg.h>

Code Example

    // opening of input image
    ImagePtr pInImg = loadTiffImageFile(inputImgPath);
    
    // mark local maxima in input image
    ImagePtr pOutMaxImg = dilateLocalMaxima2dImg(pInImg, 5);

    // mark local minima in input image
    ImagePtr pOutMinImg = dilateLocalMinima2dImg(pInImg, 5);

See also

DilateLocalExtrema2dImgLvl1

Function Documentation

dilateLocalMaxima2dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::dilateLocalMaxima2dImg	(	const image::ImageConstPtr &	pInImg,
		const ipReal32	inDilateFactor
	)

wrapper function for algorithm allowing to extract dilated local maxima 2d from an image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException

on failure

dilateLocalMinima2dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::dilateLocalMinima2dImg	(	const image::ImageConstPtr &	pInImg,
		const ipReal32	inDilateFactor
	)

wrapper function for algorithm allowing to extract dilated local minima 2d from an image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException

on failure

dilateLocalMaxima2dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::dilateLocalMaxima2dImg	(	const image::ImageConstPtr &	pInImg,
		const ipReal32	inDilateFactor,
		const image::ImagePtr &	pOutBinImg
	)

wrapper function for algorithm allowing to extract dilated local maxima 2d from an image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException

on failure

dilateLocalMinima2dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::dilateLocalMinima2dImg	(	const image::ImageConstPtr &	pInImg,
		const ipReal32	inDilateFactor,
		const image::ImagePtr &	pOutBinImg
	)

wrapper function for algorithm allowing to extract dilated local minima 2d from an image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException

on failure