removal of connected components in contact with image borders in binary 3d images More...

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::advmorpho::removeBorder3dImg (const image::ImageConstPtr &pInBinLabImg3d)
	wrapper function for removal of connected components in contact with image borders in binary or label 3d images More...

IPSDKIPLADVANCEDMORPHOLOGY_API void	ipsdk::imaproc::advmorpho::removeBorder3dImg (const image::ImageConstPtr &pInBinLabImg3d, const eNeighborhood3dType &inOptNeighborhood3d, const ipsdk::imaproc::attr::eProcessingOptimizationPolicy &inOptOptimizationPolicy, const image::ImagePtr &pOutImg)
	wrapper function for removal of connected components in contact with image borders in binary or label 3d images More...

Detailed Description

removal of connected components in contact with image borders in binary 3d images

This algorithm allows to remove connected components in contact with at least an image border in an input binary image InBinLabImg3d with respect to a given neighborhood 3d policy (see 3d neighborhood models).

Two versions of binary 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 reconstructed elements until convergence. These parameters are ignored in case of input label image.

An example of border removal is illustrated in 2d case : see Remove Border 2d.

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::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, _pInBinLabImg3d)

Global Rule description

Global rule description for algorithm :
((ipsdk::imaproc::matchSizeAndType (_pInBinLabImg3d,_pOutImg)) &&
(ipsdk::processor::ifIsSet (
   _pOutOptWk1BinImg, (
    ipsdk::imaproc::matchSize (_pInBinLabImg3d,_pOutOptWk1BinImg)))) &&
(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)
    
    # compute border removal on input image
    outImg = advmorpho.removeBorder3dImg(inBinImg)

Example of C++ code :

Example informations

Associated library

IPSDKIPLAdvancedMorphology

Header file

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

Code Example

    // opening input image
    ImagePtr pInBinImg = loadTiffImageFile(inputImgPath);
    // compute border removal on input image
    ImagePtr pOutImg = removeBorder3dImg(pInBinImg);

See also: RemoveBorder3dImgLvl1

Function Documentation

◆ removeBorder3dImg() [1/2]

IPSDKIPLADVANCEDMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::advmorpho::removeBorder3dImg ( const image::ImageConstPtr & pInBinLabImg3d )

wrapper function for removal of connected components in contact with image borders in binary or label 3d images

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ removeBorder3dImg() [2/2]

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

wrapper function for removal of connected components in contact with image borders in binary or label 3d images

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure