TransformationEstimationSymmetricPointToPlaneLLS implements a Linear Least Squares (LLS) approximation for minimizing the symmetric point-to-plane distance between two clouds of corresponding points with normals. More...

#include <transformation_estimation_symmetric_point_to_plane_lls.h>

Inheritance diagram for pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >:

Public Types
using	Ptr = boost::shared_ptr< TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar > >

using	ConstPtr = boost::shared_ptr< const TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar > >

using	Matrix4 = typename TransformationEstimation< PointSource, PointTarget, Scalar >::Matrix4

using	Vector6 = Eigen::Matrix< Scalar, 6, 1 >

Public Member Functions
	TransformationEstimationSymmetricPointToPlaneLLS2 ()

	~TransformationEstimationSymmetricPointToPlaneLLS2 ()

void	estimateRigidTransformation (const pcl::PointCloud< PointSource > &cloud_src, const pcl::PointCloud< PointTarget > &cloud_tgt, Matrix4 &transformation_matrix) const override
	Estimate a rigid rotation transformation between a source and a target point cloud using SVD. More...

void	estimateRigidTransformation (const pcl::PointCloud< PointSource > &cloud_src, const std::vector< int > &indices_src, const pcl::PointCloud< PointTarget > &cloud_tgt, Matrix4 &transformation_matrix) const override
	Estimate a rigid rotation transformation between a source and a target point cloud using SVD. More...

void	estimateRigidTransformation (const pcl::PointCloud< PointSource > &cloud_src, const std::vector< int > &indices_src, const pcl::PointCloud< PointTarget > &cloud_tgt, const std::vector< int > &indices_tgt, Matrix4 &transformation_matrix) const override
	Estimate a rigid rotation transformation between a source and a target point cloud using SVD. More...

void	estimateRigidTransformation (const pcl::PointCloud< PointSource > &cloud_src, const pcl::PointCloud< PointTarget > &cloud_tgt, const pcl::Correspondences &correspondences, Matrix4 &transformation_matrix) const override
	Estimate a rigid rotation transformation between a source and a target point cloud using SVD. More...

void	setEnforceSameDirectionNormals (bool enforce_same_direction_normals)
	Set whether or not to negate source or target normals on a per-point basis such that they point in the same direction. More...

bool	getEnforceSameDirectionNormals ()
	Obtain whether source or target normals are negated on a per-point basis such that they point in the same direction or not. More...

Protected Member Functions
void	estimateRigidTransformation (ConstCloudIterator< PointSource > &source_it, ConstCloudIterator< PointTarget > &target_it, Matrix4 &transformation_matrix) const
	Estimate a rigid rotation transformation between a source and a target. More...

void	constructTransformationMatrix (const Vector6 &parameters, Matrix4 &transformation_matrix) const
	Construct a 4 by 4 transformation matrix from the provided rotation and translation. More...

Protected Attributes
bool	enforce_same_direction_normals_
	Whether or not to negate source and/or target normals such that they point in the same direction. More...

Detailed Description

template<typename PointSource, typename PointTarget, typename Scalar = float>
class pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >

TransformationEstimationSymmetricPointToPlaneLLS implements a Linear Least Squares (LLS) approximation for minimizing the symmetric point-to-plane distance between two clouds of corresponding points with normals.

For additional details, see "Linear Least-Squares Optimization for Point-to-Plane ICP Surface Registration", Kok-Lim Low, 2004 "A Symmetric Objective Function for ICP", Szymon Rusinkiewicz, 2019

Note: The class is templated on the source and target point types as well as on the output scalar of the transformation matrix (i.e., float or double). Default: float.

Author: Matthew Cong

Member Typedef Documentation

◆ ConstPtr

template<typename PointSource , typename PointTarget , typename Scalar = float>

using pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::ConstPtr = boost::shared_ptr<const TransformationEstimationSymmetricPointToPlaneLLS2<PointSource, PointTarget, Scalar> >

◆ Matrix4

template<typename PointSource , typename PointTarget , typename Scalar = float>

using pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::Matrix4 = typename TransformationEstimation<PointSource, PointTarget, Scalar>::Matrix4

◆ Ptr

template<typename PointSource , typename PointTarget , typename Scalar = float>

using pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::Ptr = boost::shared_ptr<TransformationEstimationSymmetricPointToPlaneLLS2<PointSource, PointTarget, Scalar> >

◆ Vector6

template<typename PointSource , typename PointTarget , typename Scalar = float>

using pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::Vector6 = Eigen::Matrix<Scalar, 6, 1>

Constructor & Destructor Documentation

◆ TransformationEstimationSymmetricPointToPlaneLLS2()

template<typename PointSource , typename PointTarget , typename Scalar = float>

pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::TransformationEstimationSymmetricPointToPlaneLLS2 ( )

inline

◆ ~TransformationEstimationSymmetricPointToPlaneLLS2()

template<typename PointSource , typename PointTarget , typename Scalar = float>

pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::~TransformationEstimationSymmetricPointToPlaneLLS2 ( )

inline

Member Function Documentation

◆ constructTransformationMatrix()

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::constructTransformationMatrix	(	const Vector6 &	parameters,
		Matrix4 &	transformation_matrix
	)		const

inlineprotected

Construct a 4 by 4 transformation matrix from the provided rotation and translation.

Parameters

[in]	parameters	(alpha, beta, gamma, tx, ty, tz) specifying rotation about the x, y, and z-axis and translation along the the x, y, and z-axis respectively
[out]	transformation_matrix	the resultant transformation matrix

◆ estimateRigidTransformation() [1/5]

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::estimateRigidTransformation	(	const pcl::PointCloud< PointSource > &	cloud_src,
		const pcl::PointCloud< PointTarget > &	cloud_tgt,
		const pcl::Correspondences &	correspondences,
		Matrix4 &	transformation_matrix
	)		const

inlineoverride

Estimate a rigid rotation transformation between a source and a target point cloud using SVD.

Parameters

[in]	cloud_src	the source point cloud dataset
[in]	cloud_tgt	the target point cloud dataset
[in]	correspondences	the vector of correspondences between source and target point cloud
[out]	transformation_matrix	the resultant transformation matrix

◆ estimateRigidTransformation() [2/5]

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::estimateRigidTransformation	(	const pcl::PointCloud< PointSource > &	cloud_src,
		const pcl::PointCloud< PointTarget > &	cloud_tgt,
		Matrix4 &	transformation_matrix
	)		const

inlineoverride

Estimate a rigid rotation transformation between a source and a target point cloud using SVD.

Parameters

[in]	cloud_src	the source point cloud dataset
[in]	cloud_tgt	the target point cloud dataset
[out]	transformation_matrix	the resultant transformation matrix

◆ estimateRigidTransformation() [3/5]

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::estimateRigidTransformation	(	const pcl::PointCloud< PointSource > &	cloud_src,
		const std::vector< int > &	indices_src,
		const pcl::PointCloud< PointTarget > &	cloud_tgt,
		const std::vector< int > &	indices_tgt,
		Matrix4 &	transformation_matrix
	)		const

inlineoverride

Estimate a rigid rotation transformation between a source and a target point cloud using SVD.

Parameters

[in]	cloud_src	the source point cloud dataset
[in]	indices_src	the vector of indices describing the points of interest in cloud_src
[in]	cloud_tgt	the target point cloud dataset
[in]	indices_tgt	the vector of indices describing the correspondences of the interest points from indices_src@param transformation_matrix the resultant transformation matrix

◆ estimateRigidTransformation() [4/5]

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::estimateRigidTransformation	(	const pcl::PointCloud< PointSource > &	cloud_src,
		const std::vector< int > &	indices_src,
		const pcl::PointCloud< PointTarget > &	cloud_tgt,
		Matrix4 &	transformation_matrix
	)		const

inlineoverride

Estimate a rigid rotation transformation between a source and a target point cloud using SVD.

Parameters

[in]	cloud_src	the source point cloud dataset
[in]	indices_src	the vector of indices describing the points of interest in cloud_src
[in]	cloud_tgt	the target point cloud dataset
[out]	transformation_matrix	the resultant transformation matrix

◆ estimateRigidTransformation() [5/5]

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::estimateRigidTransformation	(	ConstCloudIterator< PointSource > &	source_it,
		ConstCloudIterator< PointTarget > &	target_it,
		Matrix4 &	transformation_matrix
	)		const

inlineprotected

Estimate a rigid rotation transformation between a source and a target.

Parameters

[in]	source_it	an iterator over the source point cloud dataset
[in]	target_it	an iterator over the target point cloud dataset
[out]	transformation_matrix	the resultant transformation matrix

◆ getEnforceSameDirectionNormals()

template<typename PointSource , typename PointTarget , typename Scalar >

bool pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::getEnforceSameDirectionNormals

inline

Obtain whether source or target normals are negated on a per-point basis such that they point in the same direction or not.

◆ setEnforceSameDirectionNormals()

template<typename PointSource , typename PointTarget , typename Scalar >

void pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::setEnforceSameDirectionNormals ( bool enforce_same_direction_normals )

inline

Set whether or not to negate source or target normals on a per-point basis such that they point in the same direction.

Parameters

[in] enforce_same_direction_normals whether to negate source or target normals on a per-point basis such that they point in the same direction.

Member Data Documentation

◆ enforce_same_direction_normals_

template<typename PointSource , typename PointTarget , typename Scalar = float>

bool pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >::enforce_same_direction_normals_

protected

Whether or not to negate source and/or target normals such that they point in the same direction.

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

localization/point_cloud_common/include/point_cloud_common/transformation_estimation_symmetric_point_to_plane_lls.h
localization/point_cloud_common/include/point_cloud_common/transformation_estimation_symmetric_point_to_plane_lls_impl.h

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

template<typename PointSource, typename PointTarget, typename Scalar = float> class pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >

Member Typedef Documentation

◆ ConstPtr

◆ Matrix4

◆ Ptr

◆ Vector6

Constructor & Destructor Documentation

◆ TransformationEstimationSymmetricPointToPlaneLLS2()

◆ ~TransformationEstimationSymmetricPointToPlaneLLS2()

Member Function Documentation

◆ constructTransformationMatrix()

◆ estimateRigidTransformation() [1/5]

◆ estimateRigidTransformation() [2/5]

◆ estimateRigidTransformation() [3/5]

◆ estimateRigidTransformation() [4/5]

◆ estimateRigidTransformation() [5/5]

◆ getEnforceSameDirectionNormals()

◆ setEnforceSameDirectionNormals()

Member Data Documentation

◆ enforce_same_direction_normals_

template<typename PointSource, typename PointTarget, typename Scalar = float>
class pcl::registration::TransformationEstimationSymmetricPointToPlaneLLS2< PointSource, PointTarget, Scalar >