Union of opening calculated for several linear structuring element orientations. More...

IPSDKIPLBASICMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const ipsdk::ipUInt32 nbAngles)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API image::ImagePtr	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const ipsdk::ipUInt32 nbAngles, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API void	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const image::ImagePtr &pOutImg)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API void	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const ipsdk::ipUInt32 nbAngles, const image::ImagePtr &pOutImg)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API void	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy, const image::ImagePtr &pOutImg)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

IPSDKIPLBASICMORPHOLOGY_API void	ipsdk::imaproc::morpho::unionLinearOpening2dImg (const image::ImageConstPtr &pInImg, const ipsdk::ipReal64 radius, const ipsdk::ipUInt32 nbAngles, const attr::eBorderExtensionPolicy &inOptBorderExtensionPolicy, const image::ImagePtr &pOutImg)
	wrapper function for Union of opening calculated for several linear structuring element orientations More...

Detailed Description

Union of opening calculated for several linear structuring element orientations.

The 2d union linear opening algorithm computes openings in several directions with linear structuring elements and combines them to keep the maximum pixel intensity. This algorithm is usefull to fill circular light holes inside dark objects while preserving thin light structures.

Just like Opening 2d, the algorithm can handle holes to avoid contact with the image border. See the Opening 2d description for more details.

By default, the algorithm uses 4 different angles : $ 0 $ , $\pi / 4$ , $\pi / 2$ and $3 \pi / 4$ . To have a good compromise between detection accuracy and calculation time, it is advised to use $4 \times InRadius$ angles for small structuring elements ( $ InRadius < 5 $ ).

A particularly relevant application example is presented in the Union linear closing 2d description.

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::InRadius	[Input] Radius	X
ipsdk::imaproc::attr::InOptNbAngles2d	[Input Optional] Number of angles for directional smoothing	X
ipsdk::imaproc::attr::InOptBorderExtensionPolicy	[Input Optional] flag indicating border extension policy for processing	X
ipsdk::imaproc::attr::OutOptWk1Img	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutOptWk2Img	[Output Optional] Temporary working image for algorithm	X
ipsdk::imaproc::attr::OutWk1Img	[Output] Temporary working image for algorithm	customOutput (_pOutWk1Img, outputUnionLinear2d(_pInImg,_pInOptBorderExtensionPolicy,_pInRadius))
ipsdk::imaproc::attr::OutWk2Img	[Output] Temporary working image for algorithm	customOutput (_pOutWk2Img, outputUnionLinear2d(_pInImg,_pInOptBorderExtensionPolicy,_pInRadius))
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::imaproc::customImageProperty (_pOutWk1Img,
  matchBorderExtension1 (_pInImg,_pInRadius,eSEXYSubType::eSEXY_Linear,_pInOptBorderExtensionPolicy))) &&
(ipsdk::imaproc::customImageProperty (_pOutWk2Img,
  matchBorderExtension1 (_pInImg,_pInRadius,eSEXYSubType::eSEXY_Linear,_pInOptBorderExtensionPolicy))) &&
(ipsdk::processor::ifIsSet (_pOutOptWk1Img,
  ipsdk::imaproc::customImageProperty (_pOutOptWk1Img,
   matchBorderExtension1 (_pInImg,_pInRadius,eSEXYSubType::eSEXY_Linear,_pInOptBorderExtensionPolicy)))) &&
(ipsdk::processor::ifIsSet (_pOutOptWk2Img,
  ipsdk::imaproc::customImageProperty (_pOutOptWk2Img,
   matchBorderExtension1 (_pInImg,_pInRadius,eSEXYSubType::eSEXY_Linear,_pInOptBorderExtensionPolicy))))

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLBasicMorphology as morpho

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # Structuring element radius
    radius = 4
    
    # opening 2d image computation
    outImg = morpho.unionLinearOpening2dImg(inImg, radius)

Example of C++ code :

Example informations

Associated library

IPSDKIPLBasicMorphology

Header file

#include <IPSDKIPL/IPSDKIPLBasicMorphology/Processor/UnionLinearOpening2dImg/UnionLinearOpening2dImg.h>

Code Example

    // opening input image
    ImagePtr pInImg = loadTiffImageFile(inputImgPath);
    // Input structuring element radius
    const ipReal64 radius = 4.;
    // compute union linear opening on the input image
    ImagePtr pOutImg = unionLinearOpening2dImg(pInImg, radius);

See also: UnionLinearOpening2dImgLvl1

Function Documentation

◆ unionLinearOpening2dImg() [1/8]

IPSDKIPLBASICMORPHOLOGY_API image::ImagePtr ipsdk::imaproc::morpho::unionLinearOpening2dImg	(	const image::ImageConstPtr &	pInImg,
		const ipsdk::ipReal64	radius
	)

wrapper function for Union of opening calculated for several linear structuring element orientations

Exceptions