Creates a label image from 3D spheres detected with te 3D Hough detection algorithm. More...

IPSDKIPLFEATUREDETECTION_API ipsdk::image::ImagePtr	ipsdk::imaproc::fd::houghSpheres3dLabelImg (const ipsdk::imaproc::attr::HoughSpheres3dPptiesConstPtr &pSpheresPpties, const ipsdk::image::ImageConstPtr &pInImg)
	wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm More...

IPSDKIPLFEATUREDETECTION_API void	ipsdk::imaproc::fd::houghSpheres3dLabelImg (const ipsdk::imaproc::attr::HoughSpheres3dPptiesConstPtr &pSpheresPpties, const ipsdk::image::ImageConstPtr &pInImg, const image::ImagePtr &pOutImg)
	wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm More...

IPSDKIPLFEATUREDETECTION_API ipsdk::image::ImagePtr	ipsdk::imaproc::fd::houghSpheres3dLabelImg (const ipsdk::imaproc::attr::PlanIndexedHoughSpheres3dPptiesConstPtr &pPISpheresPpties, const ipsdk::image::ImageConstPtr &pInImg)
	wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm More...

IPSDKIPLFEATUREDETECTION_API void	ipsdk::imaproc::fd::houghSpheres3dLabelImg (const ipsdk::imaproc::attr::PlanIndexedHoughSpheres3dPptiesConstPtr &pPISpheresPpties, const ipsdk::image::ImageConstPtr &pInImg, const image::ImagePtr &pOutImg)
	wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm More...

Detailed Description

Creates a label image from 3D spheres detected with te 3D Hough detection algorithm.

This algorithms creates a label image representing the spheres detected by the result of Hough spheres detection. In the case of automatically allocated output image, IPSDK needs to know the size of the ouput image and the image used to calculate the spheres properties in Hough spheres detection must also be specified.

If two spheres intersect each other, the label calculated accoring to the interface between the two spheres.

The output image voxels intensities are SphereIndex + 1 for voxels inside the sphere and 0 otherwise, where SphereIndex is the sphere index in the result of Hough spheres detection.

Here is a slice of an image and the result of the algorithm application :

Attributes description

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InPIHoughSpheres3dPpties	[Input] plan indexed collection of properties of circles detected by Hough algorithm	X
ipsdk::imaproc::attr::InImg	[Input] image for processing operation	X
ipsdk::imaproc::attr::OutLabelImg	[Output] label image for processing operation	customOutput (_pOutLabelImg, outputHoughSpheres3dLabelImg(_pInImg,_pInPIHoughSpheres3dPpties))

Global Rule description

Global rule description for algorithm :
ipsdk::imaproc::matchSize (_pInImg,_pOutLabelImg) &&
ipsdk::imaproc::matchImagePlans (_pInPIHoughSpheres3dPpties,_pInImg,eImagePlansMatchPolicy::eIPMP_CT)

Example of Python code :

Example imports

import PyIPSDK

import PyIPSDK.IPSDKIPLFeatureDetection as fd

Code Example

    # opening of input image
    inImg = PyIPSDK.loadTiffImageFile(inputImgPath)
    
    # radius range detection definition
    radiusRange = PyIPSDK.createHoughCirclesRadiusRange(8,  12)
    
    # hough circle detection computation
    outSpheres = fd.houghSpheres3d(inImg, radiusRange)
    
    # compute the label image
    outImg = fd.houghSpheres3dLabelImg(outSpheres, inImg)

Example of C++ code :

Example informations

Associated library

IPSDKIPLFeatureDetection

Header file

#include <IPSDKIPL/IPSDKIPLFeatureDetection/Processor/HoughSpheres3dLabelImg/HoughSpheres3dLabelImg.h>

Code Example

        // Load the input image
        ImagePtr pInImg = loadTiffImageFile(inputPath);
        // Detect the spheres
        HoughCirclesRadiusRangePtr pHoughRange = createHoughCirclesRadiusRange(8, 12);
        HoughSpheres3dPptiesPtr pSpheres = houghSpheres3d(pInImg, pHoughRange);
        ImagePtr pOutImg = houghSpheres3dLabelImg(pSpheres, pInImg);

See also: HoughSpheres3dLabelImgLvl1; HoughSpheres3dLabelImgLvl2; HoughSpheres3dLabelImgLvl3

Function Documentation

◆ houghSpheres3dLabelImg() [1/4]

IPSDKIPLFEATUREDETECTION_API ipsdk::image::ImagePtr ipsdk::imaproc::fd::houghSpheres3dLabelImg	(	const ipsdk::imaproc::attr::HoughSpheres3dPptiesConstPtr &	pSpheresPpties,
		const ipsdk::image::ImageConstPtr &	pInImg
	)

wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ houghSpheres3dLabelImg() [2/4]

IPSDKIPLFEATUREDETECTION_API void ipsdk::imaproc::fd::houghSpheres3dLabelImg	(	const ipsdk::imaproc::attr::HoughSpheres3dPptiesConstPtr &	pSpheresPpties,
		const ipsdk::image::ImageConstPtr &	pInImg,
		const image::ImagePtr &	pOutImg
	)

wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ houghSpheres3dLabelImg() [3/4]

IPSDKIPLFEATUREDETECTION_API ipsdk::image::ImagePtr ipsdk::imaproc::fd::houghSpheres3dLabelImg	(	const ipsdk::imaproc::attr::PlanIndexedHoughSpheres3dPptiesConstPtr &	pPISpheresPpties,
		const ipsdk::image::ImageConstPtr &	pInImg
	)

wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure

◆ houghSpheres3dLabelImg() [4/4]

IPSDKIPLFEATUREDETECTION_API void ipsdk::imaproc::fd::houghSpheres3dLabelImg	(	const ipsdk::imaproc::attr::PlanIndexedHoughSpheres3dPptiesConstPtr &	pPISpheresPpties,
		const ipsdk::image::ImageConstPtr &	pInImg,
		const image::ImagePtr &	pOutImg
	)

wrapper function for Creates a mask image from 3D spheres detected with te 3D Hough detection algorithm

Exceptions

ipsdk::processor::IPSDKBaseProcessingException on failure