|
Point Cloud Library (PCL)
1.6.0
|
|
Point Cloud Library (PCL)
1.6.0
|
PFHEstimation estimates the Point Feature Histogram (PFH) descriptor for a given point cloud dataset containing points and normals. More...
#include <pcl/features/pfh.h>
Public Types | |
| typedef Feature< PointInT, PointOutT >::PointCloudOut | PointCloudOut |
| typedef Feature< PointInT, PointOutT >::PointCloudIn | PointCloudIn |
| typedef pcl::PointCloud< PointNT > | PointCloudN |
| typedef PointCloudN::Ptr | PointCloudNPtr |
| typedef PointCloudN::ConstPtr | PointCloudNConstPtr |
| typedef boost::shared_ptr < FeatureFromNormals< PointInT, PointNT, PointOutT > > | Ptr |
| typedef boost::shared_ptr < const FeatureFromNormals < PointInT, PointNT, PointOutT > > | ConstPtr |
| typedef PCLBase< PointInT > | BaseClass |
| typedef pcl::search::Search < PointInT > | KdTree |
| typedef pcl::search::Search < PointInT >::Ptr | KdTreePtr |
| typedef boost::function< int(size_t, double, std::vector< int > &, std::vector< float > &)> | SearchMethod |
| typedef boost::function< int(const PointCloudIn &cloud, size_t index, double, std::vector < int > &, std::vector< float > &)> | SearchMethodSurface |
| typedef pcl::PointCloud< PointInT > | PointCloud |
| typedef PointCloud::Ptr | PointCloudPtr |
| typedef PointCloud::ConstPtr | PointCloudConstPtr |
| typedef PointIndices::Ptr | PointIndicesPtr |
| typedef PointIndices::ConstPtr | PointIndicesConstPtr |
Public Member Functions | |
| PFHEstimation () | |
| Empty constructor. | |
| void | setMaximumCacheSize (unsigned int cache_size) |
| Set the maximum internal cache size. | |
| unsigned int | getMaximumCacheSize () |
| Get the maximum internal cache size. | |
| void | setUseInternalCache (bool use_cache) |
| Set whether to use an internal cache mechanism for removing redundant calculations or not. | |
| bool | getUseInternalCache () |
| Get whether the internal cache is used or not for computing the PFH features. | |
| bool | computePairFeatures (const pcl::PointCloud< PointInT > &cloud, const pcl::PointCloud< PointNT > &normals, int p_idx, int q_idx, float &f1, float &f2, float &f3, float &f4) |
| Compute the 4-tuple representation containing the three angles and one distance between two points represented by Cartesian coordinates and normals. | |
| void | computePointPFHSignature (const pcl::PointCloud< PointInT > &cloud, const pcl::PointCloud< PointNT > &normals, const std::vector< int > &indices, int nr_split, Eigen::VectorXf &pfh_histogram) |
| Estimate the PFH (Point Feature Histograms) individual signatures of the three angular (f1, f2, f3) features for a given point based on its spatial neighborhood of 3D points with normals. | |
| void | setInputNormals (const PointCloudNConstPtr &normals) |
| Provide a pointer to the input dataset that contains the point normals of the XYZ dataset. | |
| PointCloudNConstPtr | getInputNormals () const |
| Get a pointer to the normals of the input XYZ point cloud dataset. | |
| void | setSearchSurface (const PointCloudInConstPtr &cloud) |
| Provide a pointer to a dataset to add additional information to estimate the features for every point in the input dataset. | |
| PointCloudInConstPtr | getSearchSurface () const |
| Get a pointer to the surface point cloud dataset. | |
| void | setSearchMethod (const KdTreePtr &tree) |
| Provide a pointer to the search object. | |
| KdTreePtr | getSearchMethod () const |
| Get a pointer to the search method used. | |
| double | getSearchParameter () const |
| Get the internal search parameter. | |
| void | setKSearch (int k) |
| Set the number of k nearest neighbors to use for the feature estimation. | |
| int | getKSearch () const |
| get the number of k nearest neighbors used for the feature estimation. | |
| void | setRadiusSearch (double radius) |
| Set the sphere radius that is to be used for determining the nearest neighbors used for the feature estimation. | |
| double | getRadiusSearch () const |
| Get the sphere radius used for determining the neighbors. | |
| void | compute (PointCloudOut &output) |
| Base method for feature estimation for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod () | |
| void | computeEigen (pcl::PointCloud< Eigen::MatrixXf > &output) |
| Base method for feature estimation for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod () | |
| virtual void | setInputCloud (const PointCloudConstPtr &cloud) |
| Provide a pointer to the input dataset. | |
| PointCloudConstPtr const | getInputCloud () |
| Get a pointer to the input point cloud dataset. | |
| void | setIndices (const IndicesPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. | |
| void | setIndices (const IndicesConstPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. | |
| void | setIndices (const PointIndicesConstPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. | |
| void | setIndices (size_t row_start, size_t col_start, size_t nb_rows, size_t nb_cols) |
| Set the indices for the points laying within an interest region of the point cloud. | |
| IndicesPtr const | getIndices () |
| Get a pointer to the vector of indices used. | |
| const PointInT & | operator[] (size_t pos) |
| Override PointCloud operator[] to shorten code. | |
PFHEstimation estimates the Point Feature Histogram (PFH) descriptor for a given point cloud dataset containing points and normals.
A commonly used type for PointOutT is pcl::PFHSignature125.
typedef PCLBase<PointInT> pcl::Feature< PointInT, PointOutT >::BaseClass [inherited] |
Reimplemented in pcl::RangeImageBorderExtractor, and pcl::NarfDescriptor.
typedef boost::shared_ptr< const FeatureFromNormals<PointInT, PointNT, PointOutT> > pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::ConstPtr [inherited] |
typedef pcl::search::Search<PointInT> pcl::Feature< PointInT, PointOutT >::KdTree [inherited] |
typedef pcl::search::Search<PointInT>::Ptr pcl::Feature< PointInT, PointOutT >::KdTreePtr [inherited] |
Reimplemented in pcl::CVFHEstimation< PointInT, PointNT, PointOutT >.
typedef pcl::PointCloud<PointInT > pcl::PCLBase< PointInT >::PointCloud [inherited] |
Definition at line 74 of file pcl_base.h.
typedef PointCloud::ConstPtr pcl::PCLBase< PointInT >::PointCloudConstPtr [inherited] |
Reimplemented in pcl::NormalEstimation< PointInT, PointOutT >, and pcl::NormalEstimation< PointInT, pcl::Normal >.
Definition at line 76 of file pcl_base.h.
| typedef Feature<PointInT, PointOutT>::PointCloudIn pcl::PFHEstimation< PointInT, PointNT, PointOutT >::PointCloudIn |
Reimplemented from pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >.
typedef pcl::PointCloud<PointNT> pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::PointCloudN [inherited] |
typedef PointCloudN::ConstPtr pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::PointCloudNConstPtr [inherited] |
typedef PointCloudN::Ptr pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::PointCloudNPtr [inherited] |
| typedef Feature<PointInT, PointOutT>::PointCloudOut pcl::PFHEstimation< PointInT, PointNT, PointOutT >::PointCloudOut |
Reimplemented from pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >.
typedef PointCloud::Ptr pcl::PCLBase< PointInT >::PointCloudPtr [inherited] |
Reimplemented in pcl::OrganizedFastMesh< PointInT >.
Definition at line 75 of file pcl_base.h.
typedef PointIndices::ConstPtr pcl::PCLBase< PointInT >::PointIndicesConstPtr [inherited] |
Definition at line 79 of file pcl_base.h.
typedef PointIndices::Ptr pcl::PCLBase< PointInT >::PointIndicesPtr [inherited] |
Definition at line 78 of file pcl_base.h.
typedef boost::shared_ptr< FeatureFromNormals<PointInT, PointNT, PointOutT> > pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::Ptr [inherited] |
typedef boost::function<int (size_t, double, std::vector<int> &, std::vector<float> &)> pcl::Feature< PointInT, PointOutT >::SearchMethod [inherited] |
typedef boost::function<int (const PointCloudIn &cloud, size_t index, double, std::vector<int> &, std::vector<float> &)> pcl::Feature< PointInT, PointOutT >::SearchMethodSurface [inherited] |
| pcl::PFHEstimation< PointInT, PointNT, PointOutT >::PFHEstimation | ( | ) | [inline] |
| void pcl::Feature< PointInT, PointOutT >::compute | ( | PointCloudOut & | output | ) | [inherited] |
Base method for feature estimation for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod ()
| [out] | output | the resultant point cloud model dataset containing the estimated features |
Reimplemented in pcl::CVFHEstimation< PointInT, PointNT, PointOutT >, pcl::VFHEstimation< PointInT, PointNT, PointOutT >, pcl::RangeImageBorderExtractor, pcl::ESFEstimation< PointInT, PointOutT >, and pcl::NarfDescriptor.
Definition at line 188 of file feature.hpp.
| void pcl::Feature< PointInT, PointOutT >::computeEigen | ( | pcl::PointCloud< Eigen::MatrixXf > & | output | ) | [inherited] |
Base method for feature estimation for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod ()
| [out] | output | the resultant point cloud model dataset containing the estimated features |
Reimplemented in pcl::SHOTColorEstimation< PointInT, PointNT, Eigen::MatrixXf, PointRFT >, and pcl::SHOTEstimation< PointInT, PointNT, Eigen::MatrixXf, PointRFT >.
Definition at line 224 of file feature.hpp.
| bool pcl::PFHEstimation< PointInT, PointNT, PointOutT >::computePairFeatures | ( | const pcl::PointCloud< PointInT > & | cloud, |
| const pcl::PointCloud< PointNT > & | normals, | ||
| int | p_idx, | ||
| int | q_idx, | ||
| float & | f1, | ||
| float & | f2, | ||
| float & | f3, | ||
| float & | f4 | ||
| ) |
Compute the 4-tuple representation containing the three angles and one distance between two points represented by Cartesian coordinates and normals.
| [in] | cloud | the dataset containing the XYZ Cartesian coordinates of the two points |
| [in] | normals | the dataset containing the surface normals (assuming normalized vectors) at each point in cloud |
| [in] | p_idx | the index of the first point (source) |
| [in] | q_idx | the index of the second point (target) |
| [out] | f1 | the first angular feature (angle between the projection of nq_idx and u) |
| [out] | f2 | the second angular feature (angle between nq_idx and v) |
| [out] | f3 | the third angular feature (angle between np_idx and |p_idx - q_idx|) |
| [out] | f4 | the distance feature (p_idx - q_idx) |
| void pcl::PFHEstimation< PointInT, PointNT, PointOutT >::computePointPFHSignature | ( | const pcl::PointCloud< PointInT > & | cloud, |
| const pcl::PointCloud< PointNT > & | normals, | ||
| const std::vector< int > & | indices, | ||
| int | nr_split, | ||
| Eigen::VectorXf & | pfh_histogram | ||
| ) |
Estimate the PFH (Point Feature Histograms) individual signatures of the three angular (f1, f2, f3) features for a given point based on its spatial neighborhood of 3D points with normals.
| [in] | cloud | the dataset containing the XYZ Cartesian coordinates of the two points |
| [in] | normals | the dataset containing the surface normals at each point in cloud |
| [in] | indices | the k-neighborhood point indices in the dataset |
| [in] | nr_split | the number of subdivisions for each angular feature interval |
| [out] | pfh_histogram | the resultant (combinatorial) PFH histogram representing the feature at the query point |
| IndicesPtr const pcl::PCLBase< PointInT >::getIndices | ( | ) | [inline, inherited] |
Get a pointer to the vector of indices used.
Definition at line 190 of file pcl_base.h.
| PointCloudConstPtr const pcl::PCLBase< PointInT >::getInputCloud | ( | ) | [inline, inherited] |
Get a pointer to the input point cloud dataset.
Definition at line 107 of file pcl_base.h.
| PointCloudNConstPtr pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::getInputNormals | ( | ) | const [inline, inherited] |
| int pcl::Feature< PointInT, PointOutT >::getKSearch | ( | ) | const [inline, inherited] |
| unsigned int pcl::PFHEstimation< PointInT, PointNT, PointOutT >::getMaximumCacheSize | ( | ) | [inline] |
| double pcl::Feature< PointInT, PointOutT >::getRadiusSearch | ( | ) | const [inline, inherited] |
| KdTreePtr pcl::Feature< PointInT, PointOutT >::getSearchMethod | ( | ) | const [inline, inherited] |
| double pcl::Feature< PointInT, PointOutT >::getSearchParameter | ( | ) | const [inline, inherited] |
| PointCloudInConstPtr pcl::Feature< PointInT, PointOutT >::getSearchSurface | ( | ) | const [inline, inherited] |
| bool pcl::PFHEstimation< PointInT, PointNT, PointOutT >::getUseInternalCache | ( | ) | [inline] |
| const PointInT & pcl::PCLBase< PointInT >::operator[] | ( | size_t | pos | ) | [inline, inherited] |
Override PointCloud operator[] to shorten code.
| pos | position in indices_ vector |
Definition at line 197 of file pcl_base.h.
| void pcl::PCLBase< PointInT >::setIndices | ( | const IndicesPtr & | indices | ) | [inline, inherited] |
Provide a pointer to the vector of indices that represents the input data.
| indices | a pointer to the vector of indices that represents the input data. |
Definition at line 113 of file pcl_base.h.
| void pcl::PCLBase< PointInT >::setIndices | ( | const IndicesConstPtr & | indices | ) | [inline, inherited] |
Provide a pointer to the vector of indices that represents the input data.
| indices | a pointer to the vector of indices that represents the input data. |
Definition at line 124 of file pcl_base.h.
| void pcl::PCLBase< PointInT >::setIndices | ( | const PointIndicesConstPtr & | indices | ) | [inline, inherited] |
Provide a pointer to the vector of indices that represents the input data.
| indices | a pointer to the vector of indices that represents the input data. |
Definition at line 135 of file pcl_base.h.
| void pcl::PCLBase< PointInT >::setIndices | ( | size_t | row_start, |
| size_t | col_start, | ||
| size_t | nb_rows, | ||
| size_t | nb_cols | ||
| ) | [inline, inherited] |
Set the indices for the points laying within an interest region of the point cloud.
| row_start | the offset on rows |
| col_start | the offset on columns |
| nb_rows | the number of rows to be considered row_start included |
| nb_cols | the number of columns to be considered col_start included |
Definition at line 151 of file pcl_base.h.
| virtual void pcl::PCLBase< PointInT >::setInputCloud | ( | const PointCloudConstPtr & | cloud | ) | [inline, virtual, inherited] |
Provide a pointer to the input dataset.
| cloud | the const boost shared pointer to a PointCloud message |
Definition at line 103 of file pcl_base.h.
| void pcl::FeatureFromNormals< PointInT, PointNT, PointOutT >::setInputNormals | ( | const PointCloudNConstPtr & | normals | ) | [inline, inherited] |
Provide a pointer to the input dataset that contains the point normals of the XYZ dataset.
In case of search surface is set to be different from the input cloud, normals should correspond to the search surface, not the input cloud!
| [in] | normals | the const boost shared pointer to a PointCloud of normals. By convention, L2 norm of each normal should be 1. |
| void pcl::Feature< PointInT, PointOutT >::setKSearch | ( | int | k | ) | [inline, inherited] |
Set the number of k nearest neighbors to use for the feature estimation.
| [in] | k | the number of k-nearest neighbors |
Reimplemented in pcl::RSDEstimation< PointInT, PointNT, PointOutT >.
| void pcl::PFHEstimation< PointInT, PointNT, PointOutT >::setMaximumCacheSize | ( | unsigned int | cache_size | ) | [inline] |
| void pcl::Feature< PointInT, PointOutT >::setRadiusSearch | ( | double | radius | ) | [inline, inherited] |
| void pcl::Feature< PointInT, PointOutT >::setSearchMethod | ( | const KdTreePtr & | tree | ) | [inline, inherited] |
| void pcl::Feature< PointInT, PointOutT >::setSearchSurface | ( | const PointCloudInConstPtr & | cloud | ) | [inline, inherited] |
Provide a pointer to a dataset to add additional information to estimate the features for every point in the input dataset.
This is optional, if this is not set, it will only use the data in the input cloud to estimate the features. This is useful when you only need to compute the features for a downsampled cloud.
| [in] | cloud | a pointer to a PointCloud message |
| void pcl::PFHEstimation< PointInT, PointNT, PointOutT >::setUseInternalCache | ( | bool | use_cache | ) | [inline] |
Set whether to use an internal cache mechanism for removing redundant calculations or not.
See setMaximumCacheSize for setting the maximum cache size
| [in] | use_cache | set to true to use the internal cache, false otherwise |
1.7.6.1
