propagation of minima in a 2d image More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::minPropagation2dImg (const image::ImageConstPtr &pInImg)
	wrapper function for propagation of minima in a 2d image More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::minPropagation2dImg (const image::ImageConstPtr &pInImg, const eNeighborhood2dType &inOptNeighborhood2d, const ipsdk::imaproc::attr::eProcessingOptimizationPolicy &inOptOptimizationPolicy, const image::ImagePtr &pOutImg)
	wrapper function for propagation of minima in a 2d image More...

Detailed Description

propagation of minima in a 2d image

Minima propagation algorithm allows to propagate minimum grayscale values inside particules separated by zero grayscale pixel values with respect to a given neighborhood 2d policy (see 2d 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 minima until convergence.

The following figure illustrate algorithm effect on synthetic data :

Here is an example of minima propagation applied to a grayscale input image (with 8 connexity neighborhood type) :

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InOptNeighborhood2d	[Input optional] neighborhood 2d 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, _pInImg)

Global Rule description

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

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # minima 2d propagation computation
    outImg = advmorpho.minPropagation2dImg(inImg)

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

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

Code Example

        // opening input image
        ImagePtr pInImg = loadTiffImageFile(inputImgPath);
        // compute minimum propagation on input image
        ImagePtr pOutImg = minPropagation2dImg(pInImg);

See also: MinPropagation2dImgLvl1

Function Documentation

◆ minPropagation2dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::minPropagation2dImg ( const image::ImageConstPtr & pInImg )

wrapper function for propagation of minima in a 2d image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ minPropagation2dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::minPropagation2dImg	(	const image::ImageConstPtr &	pInImg,
		const eNeighborhood2dType &	inOptNeighborhood2d,
		const ipsdk::imaproc::attr::eProcessingOptimizationPolicy &	inOptOptimizationPolicy,
		const image::ImagePtr &	pOutImg
	)

wrapper function for propagation of minima in a 2d image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure