SampleConsensusModelCylinder defines a model for 3D cylinder segmentation. More...

#include <pcl/sample_consensus/sac_model_cylinder.h>

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

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

Public Types
typedef SampleConsensusModel < PointT >::PointCloud	PointCloud

typedef SampleConsensusModel < PointT >::PointCloudPtr	PointCloudPtr

typedef SampleConsensusModel < PointT >::PointCloudConstPtr	PointCloudConstPtr

typedef boost::shared_ptr < SampleConsensusModelCylinder >	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
	SampleConsensusModelCylinder (const PointCloudConstPtr &cloud)
	Constructor for base SampleConsensusModelCylinder. More...

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

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

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

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

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

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

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

bool	computeModelCoefficients (const std::vector< int > &samples, Eigen::VectorXf &model_coefficients)
	Check whether the given index samples can form a valid cylinder 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 cylinder 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 cylinder 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 cylinder 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 cylinder model coefficients. More...

pcl::SacModel	getModelType () const
	Return an unique id for this model (SACMODEL_CYLINDER). 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::SampleConsensusModelCylinder< PointT, PointNT >

SampleConsensusModelCylinder defines a model for 3D cylinder segmentation.

The model coefficients are defined as:

point_on_axis.x : the X coordinate of a point located on the cylinder axis
point_on_axis.y : the Y coordinate of a point located on the cylinder axis
point_on_axis.z : the Z coordinate of a point located on the cylinder axis
axis_direction.x : the X coordinate of the cylinder's axis direction
axis_direction.y : the Y coordinate of the cylinder's axis direction
axis_direction.z : the Z coordinate of the cylinder's axis direction
radius : the cylinder's radius

Author: Radu Bogdan Rusu

Definition at line 64 of file sac_model_cylinder.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::SampleConsensusModelCylinder< PointT, PointNT >::PointCloud

Definition at line 74 of file sac_model_cylinder.h.

template<typename PointT, typename PointNT>

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

Definition at line 76 of file sac_model_cylinder.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::SampleConsensusModelCylinder< PointT, PointNT >::PointCloudPtr

Definition at line 75 of file sac_model_cylinder.h.

template<typename PointT, typename PointNT>

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

Definition at line 78 of file sac_model_cylinder.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::SampleConsensusModelCylinder< PointT, PointNT >::SampleConsensusModelCylinder ( const PointCloudConstPtr & cloud)

inline

Constructor for base SampleConsensusModelCylinder.

Parameters

[in] cloud the input point cloud dataset

Definition at line 83 of file sac_model_cylinder.h.

template<typename PointT, typename PointNT>

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

inline

Constructor for base SampleConsensusModelCylinder.

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_cylinder.h.

template<typename PointT, typename PointNT>

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

inline

Copy constructor.

Parameters

[in] source the model to copy into this

Definition at line 106 of file sac_model_cylinder.h.

Member Function Documentation

template<typename PointT , typename PointNT >

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

virtual

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

The cylinder coefficients are: point_on_axis, axis_direction, cylinder_radius_R

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_cylinder.hpp.

template<typename PointT , typename PointNT >

int pcl::SampleConsensusModelCylinder< 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 212 of file sac_model_cylinder.hpp.

template<typename PointT , typename PointNT >

bool pcl::SampleConsensusModelCylinder< 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 cylinder model coefficients.

Parameters

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

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 377 of file sac_model_cylinder.hpp.

template<typename PointT, typename PointNT>

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

inline

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

Definition at line 146 of file sac_model_cylinder.h.

template<typename PointT , typename PointNT >

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

virtual

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

Parameters

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

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 121 of file sac_model_cylinder.hpp.

template<typename PointT, typename PointNT>

double pcl::SampleConsensusModelCylinder< PointT, PointNT >::getEpsAngle ( )

inline

Get the angle epsilon (delta) threshold.

Definition at line 136 of file sac_model_cylinder.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>

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

inlinevirtual

Return an unique id for this model (SACMODEL_CYLINDER).

Implements pcl::SampleConsensusModel< PointT >.

Definition at line 222 of file sac_model_cylinder.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>

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

inline

Copy constructor.

Parameters

[in] source the model to copy into this

Definition at line 119 of file sac_model_cylinder.h.

template<typename PointT , typename PointNT >

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

virtual

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

Note: : these are the coefficients of the cylinder 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 252 of file sac_model_cylinder.hpp.

template<typename PointT , typename PointNT >

void pcl::SampleConsensusModelCylinder< 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 cylinder model.

Parameters

[in]	inliers	the data inliers that we want to project on the cylinder model
[in]	model_coefficients	the coefficients of a cylinder 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 291 of file sac_model_cylinder.hpp.

template<typename PointT , typename PointNT >

void pcl::SampleConsensusModelCylinder< 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 cylinder 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 164 of file sac_model_cylinder.hpp.

template<typename PointT, typename PointNT>

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

inline

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

Parameters

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

Definition at line 142 of file sac_model_cylinder.h.

template<typename PointT, typename PointNT>

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

inline

Set the angle epsilon (delta) threshold.

Parameters

[in] ea the maximum allowed difference between the cyilinder axis and the given axis.

Definition at line 132 of file sac_model_cylinder.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::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_cylinder.h
/builddir/build/BUILD/PCL-1.6.0-Source/sample_consensus/include/pcl/sample_consensus/impl/sac_model_cylinder.hpp

Public Types

Public Member Functions

Detailed Description

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

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

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