algorithm, based on watershed, allowing to separate grey 3d shapes More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::watershedGreySeparation3dImg (const image::ImageConstPtr &pInIntImg3d, const ipsdk::imaproc::attr::eShapeGreyscaleType &inShapeGreyscaleType, const ipReal32 inDilateFactor, const ipsdk::imaproc::attr::eWatershedSeparationMode &inWatershedSeparationMode)
	wrapper function for algorithm, based on watershed, allowing to separate grey 3d shapes More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::watershedGreySeparation3dImg (const image::ImageConstPtr &pInIntImg3d, const ipsdk::imaproc::attr::eShapeGreyscaleType &inShapeGreyscaleType, const ipReal32 inDilateFactor, const ipsdk::imaproc::attr::eWatershedSeparationMode &inWatershedSeparationMode, const ipsdk::imaproc::attr::eWatershedProcessingMode &inOptWatershedProcMode)
	wrapper function for algorithm, based on watershed, allowing to separate grey 3d shapes More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::watershedGreySeparation3dImg (const image::ImageConstPtr &pInIntImg3d, const ipsdk::imaproc::attr::eShapeGreyscaleType &inShapeGreyscaleType, const ipReal32 inDilateFactor, const ipsdk::imaproc::attr::eWatershedSeparationMode &inWatershedSeparationMode, const ipsdk::imaproc::attr::eWatershedProcessingMode &inOptWatershedProcMode, const image::ImagePtr &pOutImg)
	wrapper function for algorithm, based on watershed, allowing to separate grey 3d shapes More...

Detailed Description

algorithm, based on watershed, allowing to separate grey 3d shapes

This algorithm, based on watershed algorithm, allows to separate shapes of an input 3d grey image. It is an equivalent of Watershed Binary Separation 3d applied on grey scale images case.

Given an input grey image InIntImg3d, algorithm process following steps :

Dilation of local extrema on input image (see Dilate Local Extrema 3d). This step can be customized using parameter InDilateFactor which allows to merge local extrema and parameter InShapeGreyscaleType which allows to search for light or dark shapes (see below).
Separation of shapes using watershed algorithm (see Seeded Watershed 3d). This step can be customized using parameters InOptWatershedProcMode and InOptNbMinDataByThread.

Parameter InShapeGreyscaleType allows to select for searched shapes type :

for light shapes this parameters should take ipsdk::imaproc::attr::eShapeGreyscaleType::eSGT_Light value
for dark shapes this parameters should take ipsdk::imaproc::attr::eShapeGreyscaleType::eSGT_Dark value

Global output of a algorithm can be customized using parameter InWatershedSeparationMode which can take following values :

ipsdk::imaproc::attr::eWatershedSeparationMode::eWSM_Split (in this case OutImg has same type as InIntImg). Used split value is equal to minimum or maximum supported value for image, depending on InShapeGreyscaleType value (minimal value for light shapes search and maximal value for dark shapes search).
ipsdk::imaproc::attr::eWatershedSeparationMode::eWSM_Lines (in this case OutImg is a binary image)
ipsdk::imaproc::attr::eWatershedSeparationMode::eWSM_Basins (in this case OutImg is a label image)

Futher illustrations for this algorithm can be found looking its 2d version : Watershed Grey Separation 2d.

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InIntImg3d	[Input] image 3d for processing operation (data contained in image buffer are integers)	X
ipsdk::imaproc::attr::InShapeGreyscaleType	[Input] shape greyscale type considered during processing	X
ipsdk::imaproc::attr::InDilateFactor	[Input] factor used for dilation	X
ipsdk::imaproc::attr::InWatershedSeparationMode	[Input] parameter allowing to define watershed separation mode	X
ipsdk::imaproc::attr::InOptWatershedProcMode	[Input Optional] Watershed processing mode	X
ipsdk::imaproc::attr::InOptNbMinDataByThread	[Input Optional] minimum number of data by thread	X
ipsdk::imaproc::attr::OutWk1Img	[Output] Temporary working image for algorithm	customOutput (_pOutWk1Img, outputWk1Watershed(_pInIntImg3d,_pInWatershedSeparationMode))
ipsdk::imaproc::attr::OutWk2Img	[Output] Temporary working image for algorithm	customOutput (_pOutWk2Img, outputWk2Watershed(_pInIntImg3d,_pInWatershedSeparationMode))
ipsdk::imaproc::attr::OutOptWk1Img	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutImg	[Output] image for processing operation	customOutput (_pOutImg, outputWatershed(_pInIntImg3d,_pInWatershedSeparationMode))

Global Rule description

Global rule description for algorithm :
(ipsdk::imaproc::matchSize (_pInIntImg3d,_pOutImg) &&
ipsdk::imaproc::customImageProperty (_pOutImg,
  allowedBufferType (_pInWatershedSeparationMode,_pInIntImg3d)) &&
ipsdk::imaproc::matchSize (_pInIntImg3d,_pOutWk1Img) &&
ipsdk::imaproc::customImageProperty (_pOutWk1Img,
  allowedWk1BufferType (_pInWatershedSeparationMode)) &&
ipsdk::imaproc::matchSize (_pInIntImg3d,_pOutWk2Img) &&
ipsdk::imaproc::customImageProperty (_pOutWk2Img,
  allowedWk2BufferType (_pInWatershedSeparationMode,_pInIntImg3d)) &&
ipsdk::processor::ifIsSet (_pOutOptWk1Img,
  ipsdk::imaproc::matchSize (_pInIntImg3d,_pOutOptWk1Img)))

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

    # opening of input images
    inGreyImg3d = PyIPSDK.loadTiffImageFile(inputGreyImgPath,
                                            PyIPSDK.eTiffDirectoryMode.eTDM_Volume)
    
    # process watershed binary separation (split mode)
    outImg = advmorpho.watershedGreySeparation3dImg(inGreyImg3d, PyIPSDK.eShapeGreyscaleType.eSGT_Light, 50,
                                                    PyIPSDK.eWatershedSeparationMode.eWSM_Split, PyIPSDK.eWPM_Repeatable)

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

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

Code Example

    // opening of input grey image
    ImagePtr pInGreyImg3d = loadTiffImageFile(utImagesCommonPath / "blobs3d_483x348x31_UInt8.tif",
                                              eTiffDirectoryMode::eTDM_Volume);
    // process grey separation (split mode)
    ImagePtr pOutImg = watershedGreySeparation3dImg(pInGreyImg3d, eShapeGreyscaleType::eSGT_Light, 50, eWatershedSeparationMode::eWSM_Split);

See also: WatershedGreySeparation3dImgLvl1

Function Documentation

◆ watershedGreySeparation3dImg() [1/3]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::watershedGreySeparation3dImg	(	const image::ImageConstPtr &	pInIntImg3d,
		const ipsdk::imaproc::attr::eShapeGreyscaleType &	inShapeGreyscaleType,
		const ipReal32	inDilateFactor,
		const ipsdk::imaproc::attr::eWatershedSeparationMode &	inWatershedSeparationMode
	)

wrapper function for algorithm, based on watershed, allowing to separate grey 3d shapes

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ watershedGreySeparation3dImg() [2/3]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::watershedGreySeparation3dImg	(	const image::ImageConstPtr &	pInIntImg3d,
		const ipsdk::imaproc::attr::eShapeGreyscaleType &	inShapeGreyscaleType,
		const ipReal32	inDilateFactor,
		const ipsdk::imaproc::attr::eWatershedSeparationMode &	inWatershedSeparationMode,
		const ipsdk::imaproc::attr::eWatershedProcessingMode &	inOptWatershedProcMode
	)

wrapper function for algorithm, based on watershed, allowing to separate grey 3d shapes

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ watershedGreySeparation3dImg() [3/3]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::watershedGreySeparation3dImg	(	const image::ImageConstPtr &	pInIntImg3d,
		const ipsdk::imaproc::attr::eShapeGreyscaleType &	inShapeGreyscaleType,
		const ipReal32	inDilateFactor,
		const ipsdk::imaproc::attr::eWatershedSeparationMode &	inWatershedSeparationMode,
		const ipsdk::imaproc::attr::eWatershedProcessingMode &	inOptWatershedProcMode,
		const image::ImagePtr &	pOutImg
	)

wrapper function for algorithm, based on watershed, allowing to separate grey 3d shapes

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure