noether::RansacCylinderProjectionMeshModifier Class Reference

MeshModifier that fits a specifiable number of cylinders to the input mesh and projects the inlier vertices onto the fitted cylinder models. More...

Detailed Description

This modifier uses RANSAC to sequentially fit cylinder models to the input mesh. When a valid cylinder model is identified, the inlier vertices are removed from the input mesh into a new submesh and then projected onto the fitted cylinder model. New cylinder models are then fitted to the remainder of vertices in the input mesh until either 1) the maximum number of cylinder models have been fitted 2) too few inliers remain in the input mesh, or 3) no more valid cylinders can be fit to the input mesh.

#include <ransac_cylinder_fit_modifier.h>

Inheritance diagram for noether::RansacCylinderProjectionMeshModifier:

Public Member Functions
	RansacCylinderProjectionMeshModifier (float min_radius, float max_radius, float distance_threshold, const Eigen::Vector3f &axis=Eigen::Vector3f::UnitZ(), float axis_threshold=10.0 *M_PI/180.0, float normal_distance_weight=0.1, unsigned min_vertices=1, int max_cylinders=-1, unsigned max_iterations=100)
	Constructor.
Public Member Functions inherited from noether::RansacPrimitiveFitMeshModifier
	RansacPrimitiveFitMeshModifier (float distance_threshold, unsigned min_vertices=1, int max_primitives=-1, unsigned max_iterations=100)
	Constructor.
std::vector< pcl::PolygonMesh >	modify (const pcl::PolygonMesh &mesh) const override

Protected Member Functions
std::shared_ptr< pcl::SampleConsensusModel< pcl::PointXYZ > >	createModel (const pcl::PolygonMesh &mesh) const override
	Creates a sample consensus model for the primitive.
pcl::PolygonMesh	createSubMesh (const pcl::PolygonMesh &mesh, std::shared_ptr< const pcl::RandomSampleConsensus< pcl::PointXYZ > > ransac) const override
	Creates a sub-mesh from the results of the model primitive fitting.

Protected Attributes
float	min_radius_
float	max_radius_
Eigen::Vector3f	axis_
float	axis_threshold_
float	normal_distance_weight_
Protected Attributes inherited from noether::RansacPrimitiveFitMeshModifier
float	distance_threshold_
unsigned	min_vertices_
int	max_primitives_
unsigned	max_iterations_

Additional Inherited Members
Public Types inherited from noether::MeshModifier
using	Ptr = std::unique_ptr< MeshModifier >
using	ConstPtr = std::unique_ptr< const MeshModifier >

Constructor & Destructor Documentation

RansacCylinderProjectionMeshModifier()

noether::RansacCylinderProjectionMeshModifier::RansacCylinderProjectionMeshModifier	(	float	min_radius,
		float	max_radius,
		float	distance_threshold,
		const Eigen::Vector3f &	axis = Eigen::Vector3f::UnitZ(),
		float	axis_threshold = 10.0 * M_PI / 180.0,
		float	normal_distance_weight = 0.1,
		unsigned	min_vertices = 1,
		int	max_cylinders = -1,
		unsigned	max_iterations = 100
	)

Parameters

min_radius	Minimum required cylinder radius (m)
max_radius	Maximum required cylinder radius (m)
distance_threshold	Maximum distance (m) a point can be from a model of a cylinder to be considered an inlier
axis	Predicted cylinder axis
axis_threshold	Maximum angle (radians) by which the axis of a detected cylinder can differ from the axis of the defined model cylinder
normal_distance_weight	Distance weighting amount given to normals (vs point positions) when comparing to the cylinder model (value from [0, 1])
min_vertices	Minimum number of vertices that a cluster (identfied as a cylinder) must have
max_cylinders	Maximum number of cylinders to detect
max_iterations	Maximum number of RANSAC iterations to perform

Member Function Documentation

createModel()

std::shared_ptr< pcl::SampleConsensusModel< pcl::PointXYZ > > noether::RansacCylinderProjectionMeshModifier::createModel ( const pcl::PolygonMesh &  mesh ) const

overrideprotectedvirtual

Implements noether::RansacPrimitiveFitMeshModifier.

createSubMesh()

pcl::PolygonMesh noether::RansacCylinderProjectionMeshModifier::createSubMesh ( const pcl::PolygonMesh &  mesh, std::shared_ptr< const pcl::RandomSampleConsensus< pcl::PointXYZ > >  ransac  ) const

overrideprotectedvirtual

Parameters

mesh	Full input mesh
ransac	RANSAC model after successful completion of the model primitive fit

Returns

Implements noether::RansacPrimitiveFitMeshModifier.