propagation of maxima in a 3d image More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::maxPropagation3dImg (const image::ImageConstPtr &pInImg3d)
	wrapper function for propagation of maxima in a 3d image More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::maxPropagation3dImg (const image::ImageConstPtr &pInImg3d, const eNeighborhood3dType &inOptNeighborhood3d, const ipsdk::imaproc::attr::eProcessingOptimizationPolicy &inOptOptimizationPolicy, const image::ImagePtr &pOutImg)
	wrapper function for propagation of maxima in a 3d image More...

Detailed Description

propagation of maxima in a 3d image

Maxima propagation algorithm allows to propagate maximum grayscale values inside particules separated by zero grayscale pixel values with respect to a given neighborhood 3d policy (see 3d neighborhood models).

Two versions of this algorithm are implemented which can be selected using attribute InOptOptimizationPolicy which associated to enumerate ipsdk::imaproc::attr::eProcessingOptimizationPolicy :

a 'fast' version using a binary and a label intermediate image (which can optionally be provided via OutOptWk1BinImg and OutOptWk1LabelImg attributes)
a low memory consumption iterative algorithm which propagate maxima until convergence.

An example of propagation of maxima operation is illustrated in 2d case : see Max Propagation 2d.

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg3d	[Input] 3d image for operation	X
ipsdk::imaproc::attr::InOptNeighborhood3d	[Input optional] neighborhood 3d type for operation	X
ipsdk::imaproc::attr::InOptOptimizationPolicy	[Input Optional] processing optimization policy for algorithm	X
ipsdk::imaproc::attr::OutOptWk1BinImg	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutOptWk1LabelImg	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutImg	[Output] image for processing operation	ipsdk::imaproc::duplicateInOut (_pOutImg, _pInImg3d)

Global Rule description

Global rule description for algorithm :
((ipsdk::imaproc::matchSizeAndType (_pInImg3d,_pOutImg)) &&
(ipsdk::processor::ifIsSet (
   _pOutOptWk1BinImg, (
    ipsdk::imaproc::matchSize (_pInImg3d,_pOutOptWk1BinImg)))) &&
(ipsdk::processor::ifIsSet (
   _pOutOptWk1LabelImg, (
    ipsdk::imaproc::matchSize (_pInImg3d,_pOutOptWk1LabelImg)))))

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

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

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

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

Code Example

        // opening input image
        ImagePtr pInImg3d = loadTiffImageFile(inputImgPath);
        // compute maximum propagation on input image
        ImagePtr pOutImg = maxPropagation3dImg(pInImg3d);

See also: MaxPropagation3dImgLvl1

Function Documentation

◆ maxPropagation3dImg() [1/2]

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

wrapper function for propagation of maxima in a 3d image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ maxPropagation3dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::maxPropagation3dImg	(	const image::ImageConstPtr &	pInImg3d,
		const eNeighborhood3dType &	inOptNeighborhood3d,
		const ipsdk::imaproc::attr::eProcessingOptimizationPolicy &	inOptOptimizationPolicy,
		const image::ImagePtr &	pOutImg
	)

wrapper function for propagation of maxima in a 3d image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure