pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT > Class Template Reference

PrincipalCurvaturesEstimation estimates the directions (eigenvectors) and magnitudes (eigenvalues) of principal surface curvatures for a given point cloud dataset containing points and normals. More...

#include <principal_curvatures.h>

Inheritance diagram for pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >:
Inheritance graph
[legend]

List of all members.

Public Types

typedef pcl::PointCloud< PointInT > PointCloudIn
typedef Feature< PointInT,
PointOutT >::PointCloudOut 
PointCloudOut

Public Member Functions

void computePointPrincipalCurvatures (const pcl::PointCloud< PointNT > &normals, int p_idx, const std::vector< int > &indices, float &pcx, float &pcy, float &pcz, float &pc1, float &pc2)
 Perform Principal Components Analysis (PCA) on the point normals of a surface patch in the tangent plane of the given point normal, and return the principal curvature (eigenvector of the max eigenvalue), along with both the max (pc1) and min (pc2) eigenvalues.
 PrincipalCurvaturesEstimation ()
 Empty constructor.

Protected Member Functions

void computeFeature (PointCloudOut &output)
 Estimate the principal curvature (eigenvector of the max eigenvalue), along with both the max (pc1) and min (pc2) eigenvalues for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod ().

Private Attributes

EIGEN_ALIGN16 Eigen::Matrix3f covariance_matrix_
 Placeholder for the 3x3 covariance matrix at each surface patch.
Eigen::Vector3f demean_
 Temporary point placeholder.
Eigen::Vector3f eigenvalues_
 eigenvalues placeholder for a covariance matrix.
EIGEN_ALIGN16 Eigen::Matrix3f eigenvectors_
 SSE aligned eigenvectors placeholder for a covariance matrix.
std::vector< Eigen::Vector3f > projected_normals_
 A pointer to the input dataset that contains the point normals of the XYZ dataset.
Eigen::Vector3f xyz_centroid_
 SSE aligned placeholder for the XYZ centroid of a surface patch.

Detailed Description

template<typename PointInT, typename PointNT, typename PointOutT>
class pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >

PrincipalCurvaturesEstimation estimates the directions (eigenvectors) and magnitudes (eigenvalues) of principal surface curvatures for a given point cloud dataset containing points and normals.

Note:
The code is stateful as we do not expect this class to be multicore parallelized. Please look at NormalEstimationOpenMP and NormalEstimationTBB for examples on how to extend this to parallel implementations.
Author:
Radu Bogdan Rusu, Jared Glover

Definition at line 56 of file principal_curvatures.h.


Member Typedef Documentation

template<typename PointInT, typename PointNT, typename PointOutT>
typedef pcl::PointCloud<PointInT> pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::PointCloudIn
template<typename PointInT, typename PointNT, typename PointOutT>
typedef Feature<PointInT, PointOutT>::PointCloudOut pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::PointCloudOut

Constructor & Destructor Documentation

template<typename PointInT, typename PointNT, typename PointOutT>
pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::PrincipalCurvaturesEstimation (  )  [inline]

Empty constructor.

Definition at line 71 of file principal_curvatures.h.


Member Function Documentation

template<typename PointInT , typename PointNT , typename PointOutT >
void pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::computeFeature ( PointCloudOut output  )  [inline, protected, virtual]

Estimate the principal curvature (eigenvector of the max eigenvalue), along with both the max (pc1) and min (pc2) eigenvalues for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod ().

Parameters:
output the resultant point cloud model dataset that contains the principal curvature estimates

Implements pcl::Feature< PointInT, PointOutT >.

Definition at line 112 of file principal_curvatures.hpp.

template<typename PointInT , typename PointNT , typename PointOutT >
void pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::computePointPrincipalCurvatures ( const pcl::PointCloud< PointNT > &  normals,
int  p_idx,
const std::vector< int > &  indices,
float &  pcx,
float &  pcy,
float &  pcz,
float &  pc1,
float &  pc2 
) [inline]

Perform Principal Components Analysis (PCA) on the point normals of a surface patch in the tangent plane of the given point normal, and return the principal curvature (eigenvector of the max eigenvalue), along with both the max (pc1) and min (pc2) eigenvalues.

Parameters:
normals the point cloud normals
p_idx the query point at which the least-squares plane was estimated
indices the point cloud indices that need to be used
pcx the principal curvature X direction
pcy the principal curvature Y direction
pcz the principal curvature Z direction
pc1 the max eigenvalue of curvature
pc2 the min eigenvalue of curvature

Definition at line 45 of file principal_curvatures.hpp.


Member Data Documentation

template<typename PointInT, typename PointNT, typename PointOutT>
EIGEN_ALIGN16 Eigen::Matrix3f pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::covariance_matrix_ [private]

Placeholder for the 3x3 covariance matrix at each surface patch.

Definition at line 110 of file principal_curvatures.h.

template<typename PointInT, typename PointNT, typename PointOutT>
Eigen::Vector3f pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::demean_ [private]

Temporary point placeholder.

Definition at line 107 of file principal_curvatures.h.

template<typename PointInT, typename PointNT, typename PointOutT>
Eigen::Vector3f pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::eigenvalues_ [private]

eigenvalues placeholder for a covariance matrix.

Definition at line 115 of file principal_curvatures.h.

template<typename PointInT, typename PointNT, typename PointOutT>
EIGEN_ALIGN16 Eigen::Matrix3f pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::eigenvectors_ [private]

SSE aligned eigenvectors placeholder for a covariance matrix.

Definition at line 113 of file principal_curvatures.h.

template<typename PointInT, typename PointNT, typename PointOutT>
std::vector<Eigen::Vector3f> pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::projected_normals_ [private]

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

Definition at line 101 of file principal_curvatures.h.

template<typename PointInT, typename PointNT, typename PointOutT>
Eigen::Vector3f pcl::PrincipalCurvaturesEstimation< PointInT, PointNT, PointOutT >::xyz_centroid_ [private]

SSE aligned placeholder for the XYZ centroid of a surface patch.

Definition at line 104 of file principal_curvatures.h.


The documentation for this class was generated from the following files:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines


pcl
Author(s): See http://pcl.ros.org/authors for the complete list of authors.
autogenerated on Fri Jan 11 09:57:20 2013