image = minPropagation3dImg (inImg3d)

Detailed Description

propagation of minima in a 3d image

Minima propagation algorithm allows to propagate minimum 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 minima until convergence.

An example of propagation of minima operation is illustrated in 2d case : see Min Propagation 2d.

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

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

Example of C++ code :

Example informations

Header file

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

Code Example

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