algorithm allowing to extract local extremum 3d from an image More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::localMaxima3dImg (const image::ImageConstPtr &pInImg3d)
	wrapper function for algorithm allowing to extract local maxima 3d from an image More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::localMaxima3dImg (const image::ImageConstPtr &pInImg3d, const image::ImagePtr &pOutBinImg)
	wrapper function for algorithm allowing to extract local maxima 3d from an image More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::localMinima3dImg (const image::ImageConstPtr &pInImg3d)
	wrapper function for algorithm allowing to extract local minima 3d from an image More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::localMinima3dImg (const image::ImageConstPtr &pInImg3d, const image::ImagePtr &pOutBinImg)
	wrapper function for algorithm allowing to extract local minima 3d from an image More...

Detailed Description

algorithm allowing to extract local extremum 3d from an image

This algorithm allows, given an input image InImg3d and a searched extrema type defined by InLocalExtremumType parameter, to compute a binary ouput image OutBinImg where all set pixels are local extrema.

This means that if a pixel is set in output image, all neighbor value respect one of following condition :

neighbor value is lower in case of maxima search (or greater in case of minima search)
neighbor value is equal and neighbor is also a extrema (plateau case with neighbor pixel set in output image)

This is illustrated in case of a 1d signal :

An example of local maxima extraction is illustrated in 2d case : see Local Extrema 2d.

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg3d	[Input] 3d image for operation	X
ipsdk::imaproc::attr::InLocalExtremumType	[Input] local extremum type	X
ipsdk::imaproc::attr::OutBinImg	[Output] binary image for processing operation	duplicateInOut (_pOutBinImg, _pInImg3d, ipsdk::image::eImageBufferType::eIBT_Binary)

Global Rule description

Global rule description for algorithm :
ipsdk::imaproc::matchSize (_pInImg3d,_pOutBinImg) &&
ipsdk::imaproc::noInSitu (_pInImg3d,_pOutBinImg)

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # local maxima 3d computation
    outImg = advmorpho.localMaxima3dImg(inImg)

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

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

Code Example

        // opening of input image
        ImagePtr pInImg = loadTiffImageFile(inputImgPath);
    
        // mark local maxima in input image
        ImagePtr pOutMaxImg = localMaxima3dImg(pInImg);
        // mark local minima in input image
        ImagePtr pOutMinImg = localMinima3dImg(pInImg);

See also: LocalExtrema3dImgLvl1; LocalExtrema3dImgLvl2; LocalExtrema3dImgLvl3

Function Documentation

◆ localMaxima3dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::localMaxima3dImg ( const image::ImageConstPtr & pInImg3d )

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

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ localMinima3dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::localMinima3dImg ( const image::ImageConstPtr & pInImg3d )

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

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ localMaxima3dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::localMaxima3dImg	(	const image::ImageConstPtr &	pInImg3d,
		const image::ImagePtr &	pOutBinImg
	)

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

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ localMinima3dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::localMinima3dImg	(	const image::ImageConstPtr &	pInImg3d,
		const image::ImagePtr &	pOutBinImg
	)

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

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure