Level 1 algorithm: detects circles in image using Hough algorithm. More...

#include <HoughCircles2dLvl1.h>

Inheritance diagram for ipsdk::imaproc::fd::HoughCircles2dLvl1:

Public Member Functions
	~HoughCircles2dLvl1 ()
	destructor

const std::string &	getObjectName () const
	method allowing to retrieve object name

const std::string &	getToolTip () const
	method allowing to retrieve object tooltip

const boost::filesystem::path	getHeaderPath () const
	retrieve relative header path associated to processor

const std::string	getLibraryName () const
	retrieve library name associated processor

template<typename TAttribute >
TAttribute::StorageType	getStorage ()
	retrieve storage associated to a given attribute More...

Attribute accessors
Setters and Getters for attributes
template<>
const ipsdk::imaproc::attr::InOptGreyImg2d &	get () const
	Getter for attribute InOptGreyImg2d.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptGreyImg2d::StorageType &value)
	Setter for attribute InOptGreyImg2d.

template<>
const ipsdk::imaproc::attr::InOptGxGreyImg2d &	get () const
	Getter for attribute InOptGxGreyImg2d.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptGxGreyImg2d::StorageType &value)
	Setter for attribute InOptGxGreyImg2d.

template<>
const ipsdk::imaproc::attr::InOptGyGreyImg2d &	get () const
	Getter for attribute InOptGyGreyImg2d.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptGyGreyImg2d::StorageType &value)
	Setter for attribute InOptGyGreyImg2d.

template<>
const ipsdk::imaproc::attr::InOptHoughCircles2dAlgoMethod &	get () const
	Getter for attribute InOptHoughCircles2dAlgoMethod.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptHoughCircles2dAlgoMethod::StorageType &value)
	Setter for attribute InOptHoughCircles2dAlgoMethod.

template<>
const ipsdk::imaproc::attr::InOptCircleIntensityType &	get () const
	Getter for attribute InOptCircleIntensityType.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptCircleIntensityType::StorageType &value)
	Setter for attribute InOptCircleIntensityType.

template<>
const ipsdk::imaproc::attr::InOptMaxAngleWithGradDir &	get () const
	Getter for attribute InOptMaxAngleWithGradDir.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptMaxAngleWithGradDir::StorageType &value)
	Setter for attribute InOptMaxAngleWithGradDir.

template<>
const ipsdk::imaproc::attr::InOptNbMaxPtsPerCircle &	get () const
	Getter for attribute InOptNbMaxPtsPerCircle.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptNbMaxPtsPerCircle::StorageType &value)
	Setter for attribute InOptNbMaxPtsPerCircle.

template<>
const ipsdk::imaproc::attr::InOptHoughCirclesRadiusRange &	get () const
	Getter for attribute InOptHoughCirclesRadiusRange.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptHoughCirclesRadiusRange::StorageType &value)
	Setter for attribute InOptHoughCirclesRadiusRange.

template<>
const ipsdk::imaproc::attr::InOptAccumIntensityThreshold &	get () const
	Getter for attribute InOptAccumIntensityThreshold.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptAccumIntensityThreshold::StorageType &value)
	Setter for attribute InOptAccumIntensityThreshold.

template<>
const ipsdk::imaproc::attr::InOptRemoveTooCloseCirclesParams &	get () const
	Getter for attribute InOptRemoveTooCloseCirclesParams.

template<>
void	set (const typename ipsdk::imaproc::attr::InOptRemoveTooCloseCirclesParams::StorageType &value)
	Setter for attribute InOptRemoveTooCloseCirclesParams.

template<>
const ipsdk::imaproc::attr::OutOptRealImg1 &	get () const
	Getter for attribute OutOptRealImg1.

template<>
void	set (const typename ipsdk::imaproc::attr::OutOptRealImg1::StorageType &value)
	Setter for attribute OutOptRealImg1.

template<>
const ipsdk::imaproc::attr::OutOptRealImg2 &	get () const
	Getter for attribute OutOptRealImg2.

template<>
void	set (const typename ipsdk::imaproc::attr::OutOptRealImg2::StorageType &value)
	Setter for attribute OutOptRealImg2.

template<>
const ipsdk::imaproc::attr::OutOptGxGreyImg2d &	get () const
	Getter for attribute OutOptGxGreyImg2d.

template<>
void	set (const typename ipsdk::imaproc::attr::OutOptGxGreyImg2d::StorageType &value)
	Setter for attribute OutOptGxGreyImg2d.

template<>
const ipsdk::imaproc::attr::OutOptGyGreyImg2d &	get () const
	Getter for attribute OutOptGyGreyImg2d.

template<>
void	set (const typename ipsdk::imaproc::attr::OutOptGyGreyImg2d::StorageType &value)
	Setter for attribute OutOptGyGreyImg2d.

template<>
const ipsdk::imaproc::attr::OutPIHoughCircles2dPpties &	get () const
	Getter for attribute OutPIHoughCircles2dPpties.

template<>
void	set (const typename ipsdk::imaproc::attr::OutPIHoughCircles2dPpties::StorageType &value)
	Setter for attribute OutPIHoughCircles2dPpties.

Public Member Functions inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
virtual eProcessorType	getProcessorType () const =0

BoolResult	init (const eProcessorRulePolicy rulePolicy=eProcessorRulePolicy::ePRP_DisableSubRules)

const eProcessorRulePolicy &	getProcessorRulePolicy () const

std::string	getFullInfoStr () const

const BaseRule &	getGlobalRule () const

const ProcessorDispatchPolicy &	getDispatchPolicy () const

void	restrictDispatchPolicy (const ProcessorDispatchPolicy &policy)

bool	isProgressAvailable () const

ipsdk::processor::eProcessorProgressAvailability	getProgressAvailability () const

ipsdk::ipUInt64	getTotalNbIterations () const

bool	existsHeaderKey (const std::string &key) const

bool	existsHeaderKey (const std::string &key) const

ItemNames	getHeaderKeys () const

ItemNames	getHeaderKeys () const

const BaseDataItem &	getHeaderItem (const std::string &key) const

BaseDataItem &	getHeaderItem (const std::string &key)

const BaseDataItem &	getHeaderItem (const std::string &key) const

BaseDataItem &	getHeaderItem (const std::string &key)

void	addHeaderItem (const std::string &key, const DataItemPtr &pItem)

void	addHeaderItem (const std::string &key, const DataItemPtr &pItem)

void	removeHeaderItem (const std::string &key)

void	removeHeaderItem (const std::string &key)

void	clearHeader ()

void	clearHeader ()

ipUInt32	getNbAttributes () const

ipUInt32	getNbAttributes () const

const BaseAttribute &	getAttribute (ipUInt32 index) const

BaseAttribute &	getAttribute (ipUInt32 index)

const BaseAttribute &	getAttribute (const std::string &attributeName) const

BaseAttribute &	getAttribute (const std::string &attributeName)

const BaseAttribute &	getAttribute (ipUInt32 index) const

BaseAttribute &	getAttribute (ipUInt32 index)

const BaseAttribute &	getAttribute (const std::string &attributeName) const

BaseAttribute &	getAttribute (const std::string &attributeName)

bool	existsAttribute (const std::string &attributeName) const

bool	existsAttribute (const std::string &attributeName) const

StringVector	getAttributeNameColl () const

StringVector	getAttributeNameColl () const

bool	hasOutputInitializer (const std::string &attributeName) const

bool	hasOutputInitializer (const std::string &attributeName) const

const BaseOutputInitializer &	getOutputInitializer (const std::string &attributeName) const

const BaseOutputInitializer &	getOutputInitializer (const std::string &attributeName) const

Static Public Member Functions
static boost::shared_ptr< HoughCircles2dLvl1 >	createProcessor ()
	processor creation function

static const std::string &	getObjectNameStr ()
	method allowing to retrieve object name

static const std::string &	getToolTipStr ()
	method allowing to retrieve object tooltip

static const boost::filesystem::path	getHeaderPathStr ()
	retrieve relative header path associated to processor

static const std::string	getLibraryNameStr ()
	retrieve library name associated processor

Protected Member Functions
	HoughCircles2dLvl1 ()
	constructor

ipsdk::processor::RetrievalResult	retrieveFirstProvider (const ipsdk::core::BasePriority &priority, ipsdk::core::ActionProviderPtr &pProvider)
	method allowing to retrieve first provider associated to asynchronous processing in derived class More...

ipsdk::processor::RetrievalResult	retrieveSecondProvider (const ipsdk::core::BasePriority &priority, ipsdk::core::ActionProviderPtr &pProvider)
	method allowing to retrieve second provider associated to asynchronous processing in derived class More...

processor::RetrievalResult	provideProcessor (const boost::shared_ptr< core::BaseAction > &pProcessor, const core::BasePriority &priority, core::ActionProviderPtr &pProvider)

processor::RetrievalResult	gaussianGradient (const core::BasePriority &priority, core::ActionProviderPtr &pProvider)

Protected Member Functions inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
virtual BoolResult	initDerived (AttributeColl &attributeColl, OutputInitializerColl &outputInitializerColl, ProcessorDispatchPolicy &dispatchPolicy, RulePtr &pGlobalRule, const eProcessorRulePolicy &rulePolicy)=0

Protected Attributes
ipsdk::image::ImageConstPtr	_pGxImgConst
	Gradient images used for the process.

ipsdk::image::ImageConstPtr	_pGyImgConst

Attribute members
boost::shared_ptr< ipsdk::imaproc::attr::InOptGreyImg2d >	_pInOptGreyImg2d

boost::shared_ptr< ipsdk::imaproc::attr::InOptGxGreyImg2d >	_pInOptGxGreyImg2d

boost::shared_ptr< ipsdk::imaproc::attr::InOptGyGreyImg2d >	_pInOptGyGreyImg2d

boost::shared_ptr< ipsdk::imaproc::attr::InOptHoughCircles2dAlgoMethod >	_pInOptHoughCircles2dAlgoMethod

boost::shared_ptr< ipsdk::imaproc::attr::InOptCircleIntensityType >	_pInOptCircleIntensityType

boost::shared_ptr< ipsdk::imaproc::attr::InOptMaxAngleWithGradDir >	_pInOptMaxAngleWithGradDir

boost::shared_ptr< ipsdk::imaproc::attr::InOptNbMaxPtsPerCircle >	_pInOptNbMaxPtsPerCircle

boost::shared_ptr< ipsdk::imaproc::attr::InOptHoughCirclesRadiusRange >	_pInOptHoughCirclesRadiusRange

boost::shared_ptr< ipsdk::imaproc::attr::InOptAccumIntensityThreshold >	_pInOptAccumIntensityThreshold

boost::shared_ptr< ipsdk::imaproc::attr::InOptRemoveTooCloseCirclesParams >	_pInOptRemoveTooCloseCirclesParams

boost::shared_ptr< ipsdk::imaproc::attr::OutOptRealImg1 >	_pOutOptRealImg1

boost::shared_ptr< ipsdk::imaproc::attr::OutOptRealImg2 >	_pOutOptRealImg2

boost::shared_ptr< ipsdk::imaproc::attr::OutOptGxGreyImg2d >	_pOutOptGxGreyImg2d

boost::shared_ptr< ipsdk::imaproc::attr::OutOptGyGreyImg2d >	_pOutOptGyGreyImg2d

boost::shared_ptr< ipsdk::imaproc::attr::OutPIHoughCircles2dPpties >	_pOutPIHoughCircles2dPpties

Protected Attributes inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
eProcessorProgressAvailability	_processorProgressAvailability

ipUInt32	_nbIter

Additional Inherited Members
Protected Types inherited from ipsdk::processor::BaseProcessor< ipsdk::core::BaseAsync2Action >
typedef std::vector< AttributePtr >	AttributeColl

typedef std::map< std::string, OutputInitializerPtr >	OutputInitializerColl

Detailed Description

Level 1 algorithm: detects circles in image using Hough algorithm.

See Hough circles detection for a complete algorithm description.

Author: H. Delestre

Date: 2015/06/09

Copyright: 2015 Reactiv'IP, all right reserved.

Algorithm associated library :

IPSDKIPLFeatureDetection

Attribute description for algorithm :

Name	ToolTip	Default Initializer
ipsdk::imaproc::attr::InOptGreyImg2d	[Input Optional] grey-levels 2d image	X
ipsdk::imaproc::attr::InOptGxGreyImg2d	[Input Optional] grey-levels 2d image of gradient computed along x-axis	X
ipsdk::imaproc::attr::InOptGyGreyImg2d	[Input Optional] grey-levels 2d image of gradient computed along y-axis	X
ipsdk::imaproc::attr::InOptHoughCircles2dAlgoMethod	[Input Optional] Hough circles 2d detector method	X
ipsdk::imaproc::attr::InOptCircleIntensityType	[Input Optional] circle intensity type for detection algorithms	X
ipsdk::imaproc::attr::InOptMaxAngleWithGradDir	[Input Optional] maximum angle with gradient direction, in radians	X
ipsdk::imaproc::attr::InOptNbMaxPtsPerCircle	[Input Optional] maximum number of points per circle	X
ipsdk::imaproc::attr::InOptHoughCirclesRadiusRange	[Input Optional] range of radius of circles to detect using Hough circles algorithm	X
ipsdk::imaproc::attr::InOptAccumIntensityThreshold	[Input Optional] threshold on accumulation intensities for local maxima extraction	X
ipsdk::imaproc::attr::InOptRemoveTooCloseCirclesParams	[Input Optional] parameters of "removing too close circles" phasis in Hough circles detection	X
ipsdk::imaproc::attr::OutOptRealImg1	[Output Optional] image for processing operation (data contained in image buffer are reals)	X
ipsdk::imaproc::attr::OutOptRealImg2	[Output Optional] image for processing operation (data contained in image buffer are reals)	X
ipsdk::imaproc::attr::OutOptGxGreyImg2d	[Output Optional] grey-levels 2d image of gradient computed along x-axis	X
ipsdk::imaproc::attr::OutOptGyGreyImg2d	[Output Optional] grey-levels 2d image of gradient computed along y-axis	X
ipsdk::imaproc::attr::OutPIHoughCircles2dPpties	[Output] plan indexed collection of properties of circles detected by Hough algorithm	ipsdk::processor::allocate (_pOutPIHoughCircles2dPpties)

Global attributes rule :

Global rule on attributes is given by
(ipsdk::processor::If (
  ipsdk::processor::isSet (_pInOptGreyImg2d),
  ipsdk::processor::Not (
   ipsdk::processor::isSet (_pInOptGxGreyImg2d)) &&
  ipsdk::processor::Not (
   ipsdk::processor::isSet (_pInOptGyGreyImg2d)) && ipsdk::imaproc::matchSize<ipsdk::imaproc::attr::HoughCirclesRadiusRange::MaxRadius>(ipsdk::imaproc::eMatchImageSizeType::eMIST_2d,ipsdk::imaproc::eMatchImageSizeScale::eMISS_HalfSize,_pInOptGreyImg2d,_pInOptHoughCirclesRadiusRange) &&
  ipsdk::processor::If (
   ipsdk::processor::isSet (_pOutOptGxGreyImg2d),
   ipsdk::imaproc::matchSize (_pInOptGreyImg2d,_pOutOptGxGreyImg2d)) &&
  ipsdk::processor::If (
   ipsdk::processor::isSet (_pOutOptGyGreyImg2d),
   ipsdk::imaproc::matchSize (_pInOptGreyImg2d,_pOutOptGyGreyImg2d)) &&
  ipsdk::processor::ifIsSet (_pOutOptRealImg1,
   ipsdk::imaproc::matchSize (_pInOptGreyImg2d,_pOutOptRealImg1)) &&
  ipsdk::processor::ifIsSet (_pOutOptRealImg2,
   ipsdk::imaproc::matchSize (_pInOptGreyImg2d,_pOutOptRealImg2)),
  ipsdk::processor::isSet (_pInOptGxGreyImg2d) &&
  ipsdk::processor::isSet (_pInOptGyGreyImg2d) &&
  ipsdk::imaproc::matchSizeAndType (_pInOptGxGreyImg2d,_pInOptGyGreyImg2d) && ipsdk::imaproc::matchSize<ipsdk::imaproc::attr::HoughCirclesRadiusRange::MaxRadius>(ipsdk::imaproc::eMatchImageSizeType::eMIST_2d,ipsdk::imaproc::eMatchImageSizeScale::eMISS_HalfSize,_pInOptGxGreyImg2d,_pInOptHoughCirclesRadiusRange) &&
  ipsdk::processor::ifIsSet (_pOutOptRealImg1,
   ipsdk::imaproc::matchSize (_pInOptGxGreyImg2d,_pOutOptRealImg1)) &&
  ipsdk::processor::ifIsSet (_pOutOptRealImg2,
   ipsdk::imaproc::matchSize (_pInOptGxGreyImg2d,_pOutOptRealImg2))))

Member Function Documentation

◆ getStorage()

template<typename TAttribute >

TAttribute::StorageType ipsdk::imaproc::fd::HoughCircles2dLvl1::getStorage ( )

retrieve storage associated to a given attribute

Note: This method is only available for Output and In/Out attributes

Exceptions

ipsdk::processor::IPSDKBaseProcessingException if isInit() == false

◆ retrieveFirstProvider()

ipsdk::processor::RetrievalResult ipsdk::imaproc::fd::HoughCircles2dLvl1::retrieveFirstProvider	(	const ipsdk::core::BasePriority &	priority,
		ipsdk::core::ActionProviderPtr &	pProvider
	)

protected

method allowing to retrieve first provider associated to asynchronous processing in derived class

Returns: provider retrieval result.

Note: On success provider pointer must not be null nor uninitialized

◆ retrieveSecondProvider()

ipsdk::processor::RetrievalResult ipsdk::imaproc::fd::HoughCircles2dLvl1::retrieveSecondProvider	(	const ipsdk::core::BasePriority &	priority,
		ipsdk::core::ActionProviderPtr &	pProvider
	)

protected

method allowing to retrieve second provider associated to asynchronous processing in derived class

Returns: provider retrieval result.

Note: On success provider pointer must not be null nor uninitialized

The documentation for this class was generated from the following file:

/media/reactivipdev/Nightly/IPSDK_Patch/IPSDK_4_1/IPSDK_Nightly/include/public/IPSDKIPL/IPSDKIPLFeatureDetection/Processor/HoughCircles2d/HoughCircles2dLvl1.h

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Additional Inherited Members