keep only the big connected components in binary or label 3d image More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::keepBigShape3dImg (const image::ImageConstPtr &pInBinLabImg3d, const ipUInt32 inNbFeatures)
	wrapper function for keep only the big connected components in binary or label 3d image More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::keepBigShape3dImg (const image::ImageConstPtr &pInBinLabImg3d, const ipUInt32 inNbFeatures, const image::ImagePtr &pOutImg)
	wrapper function for keep only the big connected components in binary or label 3d image More...

Detailed Description

keep only the big connected components in binary or label 3d image

This algorithm allows to remove the smallest connected components into a binary or label 3d input image, keeping only the inNbFeatures biggest features.

The output result image OutImg has same type as input image InBinLabImg3d. This means that an input binary image will produce an output binary image and that an input label image will produce an output label image. Note that in label case, input labels index are reordered to fill index list holes created by shape filtering . Moreover, the biggest the feature will be assigned to the lowest label and the smallest selected feature will be assigned to the highest label.

Here is an example of small connected component removal on an image 3d :

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InBinLabImg3d	[Input] binary or label 3d image for processing operation	X
ipsdk::imaproc::attr::InNbFeatures	[Input] target number of features to be detected by algorithm	X
ipsdk::imaproc::attr::OutOptWk1LabelImg	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutImg	[Output] image for processing operation	duplicateInOut (_pOutImg, _pInBinLabImg3d)

Global Rule description

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

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLAdvancedMorphology as advmorpho

Code Example

    # opening of input image
    inBinImg = PyIPSDK.loadTiffImageFile(inputImgPath, PyIPSDK.eTiffDirectoryMode.eTDM_Volume)
    
    # compute the selection on a binary image
    # note: algorithm can also be used with input label image
    outBinImg = advmorpho.keepBigShape3dImg(inBinImg, 3)

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

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

Code Example

    // opening input image
    ImagePtr pInBinImg = loadTiffImageFile(inputImgPath);
    // compute the selection on a binary image
    // note: algorithm can also be used with input label image
    ImagePtr pOutImg = keepBigShape3dImg(pInBinImg, 3);

See also: KeepBigShape3dImgLvl1; KeepBigShape3dImgLvl2

Function Documentation

◆ keepBigShape3dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::keepBigShape3dImg	(	const image::ImageConstPtr &	pInBinLabImg3d,
		const ipUInt32	inNbFeatures
	)

wrapper function for keep only the big connected components in binary or label 3d image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ keepBigShape3dImg() [2/2]

IPSDKIPLADVANCEDMORPHOLOGY_API void ipsdk::imaproc::advmorpho::keepBigShape3dImg	(	const image::ImageConstPtr &	pInBinLabImg3d,
		const ipUInt32	inNbFeatures,
		const image::ImagePtr &	pOutImg
	)

wrapper function for keep only the big connected components in binary or label 3d image

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure