SampleConsensusModelCone defines a model for 3D cone segmentation. More...

#include <pcl/sample_consensus/sac_model_cone.h>

Inheritance diagram for pcl::SampleConsensusModelCone< PointT, PointNT >:

Collaboration diagram for pcl::SampleConsensusModelCone< PointT, PointNT >:

Public Types
typedef SampleConsensusModel < PointT >::PointCloud	PointCloud

typedef SampleConsensusModel < PointT >::PointCloudPtr	PointCloudPtr

typedef SampleConsensusModel < PointT >::PointCloudConstPtr	PointCloudConstPtr

typedef boost::shared_ptr < SampleConsensusModelCone >	Ptr

typedef pcl::search::Search < PointT >::Ptr	SearchPtr

typedef boost::shared_ptr < const SampleConsensusModel >	ConstPtr

typedef pcl::PointCloud < PointNT >::ConstPtr	PointCloudNConstPtr

typedef pcl::PointCloud < PointNT >::Ptr	PointCloudNPtr

typedef boost::shared_ptr < const SampleConsensusModelFromNormals >	ConstPtr

Public Member Functions
	SampleConsensusModelCone (const PointCloudConstPtr &cloud)
	Constructor for base SampleConsensusModelCone. More...

	SampleConsensusModelCone (const PointCloudConstPtr &cloud, const std::vector< int > &indices)
	Constructor for base SampleConsensusModelCone. More...

	SampleConsensusModelCone (const SampleConsensusModelCone &source)
	Copy constructor. More...

SampleConsensusModelCone &	operator= (const SampleConsensusModelCone &source)
	Copy constructor. More...

void	setEpsAngle (double ea)
	Set the angle epsilon (delta) threshold. More...

double	getEpsAngle () const
	Get the angle epsilon (delta) threshold. More...

void	setAxis (const Eigen::Vector3f &ax)
	Set the axis along which we need to search for a cone direction. More...

Eigen::Vector3f	getAxis () const
	Get the axis along which we need to search for a cone direction. More...

void	setMinMaxOpeningAngle (const double &min_angle, const double &max_angle)
	Set the minimum and maximum allowable opening angle for a cone model given from a user. More...

void	getMinMaxOpeningAngle (double &min_angle, double &max_angle) const
	Get the opening angle which we need minumum to validate a cone model. More...

bool	computeModelCoefficients (const std::vector< int > &samples, Eigen::VectorXf &model_coefficients)
	Check whether the given index samples can form a valid cone model, compute the model coefficients from these samples and store them in model_coefficients. More...

void	getDistancesToModel (const Eigen::VectorXf &model_coefficients, std::vector< double > &distances)
	Compute all distances from the cloud data to a given cone model. More...

void	selectWithinDistance (const Eigen::VectorXf &model_coefficients, const double threshold, std::vector< int > &inliers)
	Select all the points which respect the given model coefficients as inliers. More...

virtual int	countWithinDistance (const Eigen::VectorXf &model_coefficients, const double threshold)
	Count all the points which respect the given model coefficients as inliers. More...

void	optimizeModelCoefficients (const std::vector< int > &inliers, const Eigen::VectorXf &model_coefficients, Eigen::VectorXf &optimized_coefficients)
	Recompute the cone coefficients using the given inlier set and return them to the user. More...

void	projectPoints (const std::vector< int > &inliers, const Eigen::VectorXf &model_coefficients, PointCloud &projected_points, bool copy_data_fields=true)
	Create a new point cloud with inliers projected onto the cone model. More...

bool	doSamplesVerifyModel (const std::set< int > &indices, const Eigen::VectorXf &model_coefficients, const double threshold)
	Verify whether a subset of indices verifies the given cone model coefficients. More...

pcl::SacModel	getModelType () const
	Return an unique id for this model (SACMODEL_CONE). More...

void	getSamples (int &iterations, std::vector< int > &samples)
	Get a set of random data samples and return them as point indices. More...

virtual void	setInputCloud (const PointCloudConstPtr &cloud)
	Provide a pointer to the input dataset. More...

PointCloudConstPtr	getInputCloud () const
	Get a pointer to the input point cloud dataset. More...

void	setIndices (const boost::shared_ptr< std::vector< int > > &indices)
	Provide a pointer to the vector of indices that represents the input data. More...

void	setIndices (const std::vector< int > &indices)
	Provide the vector of indices that represents the input data. More...

boost::shared_ptr< std::vector < int > >	getIndices () const
	Get a pointer to the vector of indices used. More...

unsigned int	getSampleSize () const
	Return the size of a sample from which a model is computed. More...

void	setRadiusLimits (const double &min_radius, const double &max_radius)
	Set the minimum and maximum allowable radius limits for the model (applicable to models that estimate a radius) More...

void	getRadiusLimits (double &min_radius, double &max_radius)
	Get the minimum and maximum allowable radius limits for the model as set by the user. More...

void	setSamplesMaxDist (const double &radius, SearchPtr search)
	Set the maximum distance allowed when drawing random samples. More...

void	getSamplesMaxDist (double &radius)
	Get maximum distance allowed when drawing random samples. More...

void	setNormalDistanceWeight (const double w)
	Set the normal angular distance weight. More...

double	getNormalDistanceWeight ()
	Get the normal angular distance weight. More...

void	setInputNormals (const PointCloudNConstPtr &normals)
	Provide a pointer to the input dataset that contains the point normals of the XYZ dataset. More...

PointCloudNConstPtr	getInputNormals ()
	Get a pointer to the normals of the input XYZ point cloud dataset. More...

Detailed Description

template<typename PointT, typename PointNT>
class pcl::SampleConsensusModelCone< PointT, PointNT >

SampleConsensusModelCone defines a model for 3D cone segmentation.

The model coefficients are defined as:

apex.x : the X coordinate of cone's apex
apex.y : the Y coordinate of cone's apex
apex.z : the Z coordinate of cone's apex
axis_direction.x : the X coordinate of the cone's axis direction
axis_direction.y : the Y coordinate of the cone's axis direction
axis_direction.z : the Z coordinate of the cone's axis direction
opening_angle : the cone's opening angle

Author: Stefan Schrandt

Definition at line 66 of file sac_model_cone.h.

Member Typedef Documentation

template<typename PointT>

typedef boost::shared_ptr<const SampleConsensusModel> pcl::SampleConsensusModel< PointT >::ConstPtr

inherited

Definition at line 74 of file sac_model.h.

template<typename PointT, typename PointNT>

typedef boost::shared_ptr<const SampleConsensusModelFromNormals> pcl::SampleConsensusModelFromNormals< PointT, PointNT >::ConstPtr

inherited

Definition at line 510 of file sac_model.h.

template<typename PointT, typename PointNT>

typedef SampleConsensusModel<PointT>::PointCloud pcl::SampleConsensusModelCone< PointT, PointNT >::PointCloud

Definition at line 76 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

typedef SampleConsensusModel<PointT>::PointCloudConstPtr pcl::SampleConsensusModelCone< PointT, PointNT >::PointCloudConstPtr

Definition at line 78 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

typedef pcl::PointCloud<PointNT>::ConstPtr pcl::SampleConsensusModelFromNormals< PointT, PointNT >::PointCloudNConstPtr

inherited

Definition at line 506 of file sac_model.h.

template<typename PointT, typename PointNT>

typedef pcl::PointCloud<PointNT>::Ptr pcl::SampleConsensusModelFromNormals< PointT, PointNT >::PointCloudNPtr

inherited

Definition at line 507 of file sac_model.h.

template<typename PointT, typename PointNT>

typedef SampleConsensusModel<PointT>::PointCloudPtr pcl::SampleConsensusModelCone< PointT, PointNT >::PointCloudPtr

Definition at line 77 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

typedef boost::shared_ptr<SampleConsensusModelCone> pcl::SampleConsensusModelCone< PointT, PointNT >::Ptr

Definition at line 80 of file sac_model_cone.h.

template<typename PointT>

typedef pcl::search::Search<PointT>::Ptr pcl::SampleConsensusModel< PointT >::SearchPtr

inherited

Definition at line 71 of file sac_model.h.

Constructor & Destructor Documentation

template<typename PointT, typename PointNT>

pcl::SampleConsensusModelCone< PointT, PointNT >::SampleConsensusModelCone ( const PointCloudConstPtr & cloud )

inline

Constructor for base SampleConsensusModelCone.

Parameters

[in] cloud the input point cloud dataset

Definition at line 85 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

pcl::SampleConsensusModelCone< PointT, PointNT >::SampleConsensusModelCone	(	const PointCloudConstPtr &	cloud,
		const std::vector< int > &	indices
	)

inline

Constructor for base SampleConsensusModelCone.

Parameters

[in]	cloud	the input point cloud dataset
[in]	indices	a vector of point indices to be used from cloud

Definition at line 95 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

pcl::SampleConsensusModelCone< PointT, PointNT >::SampleConsensusModelCone ( const SampleConsensusModelCone< PointT, PointNT > & source )

inline

Copy constructor.

Parameters

[in] source the model to copy into this

Definition at line 105 of file sac_model_cone.h.

Member Function Documentation

template<typename PointT , typename PointNT >

bool pcl::SampleConsensusModelCone< PointT, PointNT >::computeModelCoefficients	(	const std::vector< int > &	samples,
		Eigen::VectorXf &	model_coefficients
	)

virtual

Check whether the given index samples can form a valid cone model, compute the model coefficients from these samples and store them in model_coefficients.

The cone coefficients are: apex, axis_direction, opening_angle.

Parameters

[in]	samples	the point indices found as possible good candidates for creating a valid model
[out]	model_coefficients	the resultant model coefficients

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 54 of file sac_model_cone.hpp.

template<typename PointT , typename PointNT >

int pcl::SampleConsensusModelCone< PointT, PointNT >::countWithinDistance	(	const Eigen::VectorXf &	model_coefficients,
		const double	threshold
	)

virtual

Count all the points which respect the given model coefficients as inliers.

Parameters

[in]	model_coefficients	the coefficients of a model that we need to compute distances to
[in]	threshold	maximum admissible distance threshold for determining the inliers from the outliers

Returns: the resultant number of inliers

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 249 of file sac_model_cone.hpp.

template<typename PointT , typename PointNT >

bool pcl::SampleConsensusModelCone< PointT, PointNT >::doSamplesVerifyModel	(	const std::set< int > &	indices,
		const Eigen::VectorXf &	model_coefficients,
		const double	threshold
	)

virtual

Verify whether a subset of indices verifies the given cone model coefficients.

Parameters

[in]	indices	the data indices that need to be tested against the cone model
[in]	model_coefficients	the cone model coefficients
[in]	threshold	a maximum admissible distance threshold for determining the inliers from the outliers

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 432 of file sac_model_cone.hpp.

template<typename PointT, typename PointNT>

Eigen::Vector3f pcl::SampleConsensusModelCone< PointT, PointNT >::getAxis ( ) const

inline

Get the axis along which we need to search for a cone direction.

Definition at line 144 of file sac_model_cone.h.

template<typename PointT , typename PointNT >

void pcl::SampleConsensusModelCone< PointT, PointNT >::getDistancesToModel	(	const Eigen::VectorXf &	model_coefficients,
		std::vector< double > &	distances
	)

virtual

Compute all distances from the cloud data to a given cone model.

Parameters

[in]	model_coefficients	the coefficients of a cone model that we need to compute distances to
[out]	distances	the resultant estimated distances

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 136 of file sac_model_cone.hpp.

template<typename PointT, typename PointNT>

double pcl::SampleConsensusModelCone< PointT, PointNT >::getEpsAngle ( ) const

inline

Get the angle epsilon (delta) threshold.

Definition at line 134 of file sac_model_cone.h.

template<typename PointT>

boost::shared_ptr<std::vector<int> > pcl::SampleConsensusModel< PointT >::getIndices ( ) const

inlineinherited

Get a pointer to the vector of indices used.

Definition at line 327 of file sac_model.h.

template<typename PointT>

PointCloudConstPtr pcl::SampleConsensusModel< PointT >::getInputCloud ( ) const

inlineinherited

Get a pointer to the input point cloud dataset.

Definition at line 303 of file sac_model.h.

template<typename PointT, typename PointNT>

PointCloudNConstPtr pcl::SampleConsensusModelFromNormals< PointT, PointNT >::getInputNormals ( )

inlineinherited

Get a pointer to the normals of the input XYZ point cloud dataset.

Definition at line 546 of file sac_model.h.

template<typename PointT, typename PointNT>

void pcl::SampleConsensusModelCone< PointT, PointNT >::getMinMaxOpeningAngle	(	double &	min_angle,
		double &	max_angle
	)		const

inline

Get the opening angle which we need minumum to validate a cone model.

Parameters

[out]	min_angle	the minimum allwoable opening angle of a cone model
[out]	max_angle	the maximum allwoable opening angle of a cone model

Definition at line 163 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

pcl::SacModel pcl::SampleConsensusModelCone< PointT, PointNT >::getModelType ( ) const

inlinevirtual

Return an unique id for this model (SACMODEL_CONE).

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 244 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

double pcl::SampleConsensusModelFromNormals< PointT, PointNT >::getNormalDistanceWeight ( )

inlineinherited

Get the normal angular distance weight.

Definition at line 531 of file sac_model.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::getRadiusLimits	(	double &	min_radius,
		double &	max_radius
	)

inlineinherited

Get the minimum and maximum allowable radius limits for the model as set by the user.

Parameters

[out]	min_radius	the resultant minimum radius model
[out]	max_radius	the resultant maximum radius model

Definition at line 363 of file sac_model.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::getSamples	(	int &	iterations,
		std::vector< int > &	samples
	)

inlineinherited

Get a set of random data samples and return them as point indices.

Pure virtual.

Parameters

[out]	iterations	the internal number of iterations used by SAC methods
[out]	samples	the resultant model samples

Definition at line 163 of file sac_model.h.

template<typename PointT>

unsigned int pcl::SampleConsensusModel< PointT >::getSampleSize ( ) const

inlineinherited

Return the size of a sample from which a model is computed.

Definition at line 335 of file sac_model.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::getSamplesMaxDist ( double & radius )

inlineinherited

Get maximum distance allowed when drawing random samples.

Parameters

[out] radius the maximum distance (L2 norm)

Definition at line 384 of file sac_model.h.

template<typename PointT, typename PointNT>

SampleConsensusModelCone& pcl::SampleConsensusModelCone< PointT, PointNT >::operator= ( const SampleConsensusModelCone< PointT, PointNT > & source )

inline

Copy constructor.

Parameters

[in] source the model to copy into this

Definition at line 115 of file sac_model_cone.h.

template<typename PointT , typename PointNT >

void pcl::SampleConsensusModelCone< PointT, PointNT >::optimizeModelCoefficients	(	const std::vector< int > &	inliers,
		const Eigen::VectorXf &	model_coefficients,
		Eigen::VectorXf &	optimized_coefficients
	)

virtual

Recompute the cone coefficients using the given inlier set and return them to the user.

Note: : these are the coefficients of the cone model after refinement (eg. after SVD)

Parameters

[in]	inliers	the data inliers found as supporting the model
[in]	model_coefficients	the initial guess for the optimization
[out]	optimized_coefficients	the resultant recomputed coefficients after non-linear optimization

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 303 of file sac_model_cone.hpp.

template<typename PointT , typename PointNT >

void pcl::SampleConsensusModelCone< PointT, PointNT >::projectPoints	(	const std::vector< int > &	inliers,
		const Eigen::VectorXf &	model_coefficients,
		PointCloud &	projected_points,
		bool	copy_data_fields = `true`
	)

virtual

Create a new point cloud with inliers projected onto the cone model.

Parameters

[in]	inliers	the data inliers that we want to project on the cone model
[in]	model_coefficients	the coefficients of a cone model
[out]	projected_points	the resultant projected points
[in]	copy_data_fields	set to true if we need to copy the other data fields

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 336 of file sac_model_cone.hpp.

template<typename PointT , typename PointNT >

void pcl::SampleConsensusModelCone< PointT, PointNT >::selectWithinDistance	(	const Eigen::VectorXf &	model_coefficients,
		const double	threshold,
		std::vector< int > &	inliers
	)

virtual

Select all the points which respect the given model coefficients as inliers.

Parameters

[in]	model_coefficients	the coefficients of a cone model that we need to compute distances to
[in]	threshold	a maximum admissible distance threshold for determining the inliers from the outliers
[out]	inliers	the resultant model inliers

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 188 of file sac_model_cone.hpp.

template<typename PointT, typename PointNT>

void pcl::SampleConsensusModelCone< PointT, PointNT >::setAxis ( const Eigen::Vector3f & ax )

inline

Set the axis along which we need to search for a cone direction.

Parameters

[in] ax the axis along which we need to search for a cone direction

Definition at line 140 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

void pcl::SampleConsensusModelCone< PointT, PointNT >::setEpsAngle ( double ea )

inline

Set the angle epsilon (delta) threshold.

Parameters

[in] ea the maximum allowed difference between the cone's axis and the given axis.

Definition at line 130 of file sac_model_cone.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::setIndices ( const boost::shared_ptr< std::vector< int > > & indices )

inlineinherited

Provide a pointer to the vector of indices that represents the input data.

Parameters

[in] indices a pointer to the vector of indices that represents the input data.

Definition at line 309 of file sac_model.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::setIndices ( const std::vector< int > & indices )

inlineinherited

Provide the vector of indices that represents the input data.

Parameters

[out] indices the vector of indices that represents the input data.

Definition at line 319 of file sac_model.h.

template<typename PointT>

virtual void pcl::SampleConsensusModel< PointT >::setInputCloud ( const PointCloudConstPtr & cloud )

inlinevirtualinherited

Provide a pointer to the input dataset.

Parameters

[in] cloud the const boost shared pointer to a PointCloud message

Reimplemented in pcl::SampleConsensusModelRegistration< PointT >.

Definition at line 286 of file sac_model.h.

template<typename PointT, typename PointNT>

void pcl::SampleConsensusModelFromNormals< PointT, PointNT >::setInputNormals ( const PointCloudNConstPtr & normals )

inlineinherited

Provide a pointer to the input dataset that contains the point normals of the XYZ dataset.

Parameters

[in] normals the const boost shared pointer to a PointCloud message

Definition at line 539 of file sac_model.h.

template<typename PointT, typename PointNT>

void pcl::SampleConsensusModelCone< PointT, PointNT >::setMinMaxOpeningAngle	(	const double &	min_angle,
		const double &	max_angle
	)

inline

Set the minimum and maximum allowable opening angle for a cone model given from a user.

Parameters

[in]	min_angle	the minimum allwoable opening angle of a cone model
[in]	max_angle	the maximum allwoable opening angle of a cone model

Definition at line 152 of file sac_model_cone.h.

template<typename PointT, typename PointNT>

void pcl::SampleConsensusModelFromNormals< PointT, PointNT >::setNormalDistanceWeight ( const double w )

inlineinherited

Set the normal angular distance weight.

Parameters

[in] w the relative weight (between 0 and 1) to give to the angular distance (0 to pi/2) between point normals and the plane normal. (The Euclidean distance will have weight 1-w.)

Definition at line 524 of file sac_model.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::setRadiusLimits	(	const double &	min_radius,
		const double &	max_radius
	)

inlineinherited

Set the minimum and maximum allowable radius limits for the model (applicable to models that estimate a radius)

Parameters

[in]	min_radius	the minimum radius model
[in]	max_radius	the maximum radius model

Definition at line 350 of file sac_model.h.

template<typename PointT>

void pcl::SampleConsensusModel< PointT >::setSamplesMaxDist	(	const double &	radius,
		SearchPtr	search
	)

inlineinherited

Set the maximum distance allowed when drawing random samples.

Parameters

[in] radius the maximum distance (L2 norm)

Definition at line 373 of file sac_model.h.

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

/builddir/build/BUILD/PCL-1.6.0-Source/sample_consensus/include/pcl/sample_consensus/sac_model_cone.h
/builddir/build/BUILD/PCL-1.6.0-Source/sample_consensus/include/pcl/sample_consensus/impl/sac_model_cone.hpp

Public Types

Public Member Functions

Detailed Description

template<typename PointT, typename PointNT> class pcl::SampleConsensusModelCone< PointT, PointNT >

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

template<typename PointT, typename PointNT>
class pcl::SampleConsensusModelCone< PointT, PointNT >