|
Point Cloud Library (PCL)
1.6.0
|
FPFHEstimationOMP estimates the Fast Point Feature Histogram (FPFH) descriptor for a given point cloud dataset containing points and normals, in parallel, using the OpenMP standard. More...
#include <pcl/features/fpfh_omp.h>


Public Types | |
| typedef Feature< PointInT, PointOutT >::PointCloudOut | PointCloudOut |
| 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 | |
| FPFHEstimationOMP () | |
| Empty constructor. | |
| FPFHEstimationOMP (unsigned int nr_threads) | |
| Initialize the scheduler and set the number of threads to use. | |
| void | setNumberOfThreads (unsigned int nr_threads) |
| Initialize the scheduler and set the number of threads to use. | |
| 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 | computePointSPFHSignature (const pcl::PointCloud< PointInT > &cloud, const pcl::PointCloud< PointNT > &normals, int p_idx, int row, const std::vector< int > &indices, Eigen::MatrixXf &hist_f1, Eigen::MatrixXf &hist_f2, Eigen::MatrixXf &hist_f3) |
| Estimate the SPFH (Simple 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 | weightPointSPFHSignature (const Eigen::MatrixXf &hist_f1, const Eigen::MatrixXf &hist_f2, const Eigen::MatrixXf &hist_f3, const std::vector< int > &indices, const std::vector< float > &dists, Eigen::VectorXf &fpfh_histogram) |
| Weight the SPFH (Simple Point Feature Histograms) individual histograms to create the final FPFH (Fast Point Feature Histogram) for a given point based on its 3D spatial neighborhood. | |
| void | setNrSubdivisions (int nr_bins_f1, int nr_bins_f2, int nr_bins_f3) |
| Set the number of subdivisions for each angular feature interval. | |
| void | getNrSubdivisions (int &nr_bins_f1, int &nr_bins_f2, int &nr_bins_f3) |
| Get the number of subdivisions for each angular feature interval. | |
| 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. | |
Public Attributes | |
| int | nr_bins_f1_ |
| The number of subdivisions for each angular feature interval. | |
| int | nr_bins_f2_ |
| int | nr_bins_f3_ |
FPFHEstimationOMP estimates the Fast Point Feature Histogram (FPFH) descriptor for a given point cloud dataset containing points and normals, in parallel, using the OpenMP standard.
Definition at line 72 of file fpfh_omp.h.
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 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::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::PointCloudOut |
Reimplemented from pcl::FPFHEstimation< PointInT, PointNT, PointOutT >.
Definition at line 88 of file fpfh_omp.h.
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::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::FPFHEstimationOMP | ( | ) | [inline] |
Empty constructor.
Definition at line 91 of file fpfh_omp.h.
| pcl::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::FPFHEstimationOMP | ( | unsigned int | nr_threads | ) | [inline] |
Initialize the scheduler and set the number of threads to use.
| [in] | nr_threads | the number of hardware threads to use (-1 sets the value back to automatic) |
Definition at line 99 of file fpfh_omp.h.
| 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::FPFHEstimation< 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 | ||
| ) | [inherited] |
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::FPFHEstimation< PointInT, PointNT, PointOutT >::computePointSPFHSignature | ( | const pcl::PointCloud< PointInT > & | cloud, |
| const pcl::PointCloud< PointNT > & | normals, | ||
| int | p_idx, | ||
| int | row, | ||
| const std::vector< int > & | indices, | ||
| Eigen::MatrixXf & | hist_f1, | ||
| Eigen::MatrixXf & | hist_f2, | ||
| Eigen::MatrixXf & | hist_f3 | ||
| ) | [inherited] |
Estimate the SPFH (Simple 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] | p_idx | the index of the query point (source) |
| [in] | row | the index row in feature histogramms |
| [in] | indices | the k-neighborhood point indices in the dataset |
| [out] | hist_f1 | the resultant SPFH histogram for feature f1 |
| [out] | hist_f2 | the resultant SPFH histogram for feature f2 |
| [out] | hist_f3 | the resultant SPFH histogram for feature f3 |
| 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] |
| void pcl::FPFHEstimation< PointInT, PointNT, PointOutT >::getNrSubdivisions | ( | int & | nr_bins_f1, |
| int & | nr_bins_f2, | ||
| int & | nr_bins_f3 | ||
| ) | [inline, inherited] |
Get the number of subdivisions for each angular feature interval.
| [out] | nr_bins_f1 | number of subdivisions for the first angular feature |
| [out] | nr_bins_f2 | number of subdivisions for the second angular feature |
| [out] | nr_bins_f3 | number of subdivisions for the third angular feature |
| 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] |
| 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::FPFHEstimation< PointInT, PointNT, PointOutT >::setNrSubdivisions | ( | int | nr_bins_f1, |
| int | nr_bins_f2, | ||
| int | nr_bins_f3 | ||
| ) | [inline, inherited] |
Set the number of subdivisions for each angular feature interval.
| [in] | nr_bins_f1 | number of subdivisions for the first angular feature |
| [in] | nr_bins_f2 | number of subdivisions for the second angular feature |
| [in] | nr_bins_f3 | number of subdivisions for the third angular feature |
| void pcl::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::setNumberOfThreads | ( | unsigned int | nr_threads | ) | [inline] |
Initialize the scheduler and set the number of threads to use.
| [in] | nr_threads | the number of hardware threads to use (-1 sets the value back to automatic) |
Definition at line 108 of file fpfh_omp.h.
| 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::FPFHEstimation< PointInT, PointNT, PointOutT >::weightPointSPFHSignature | ( | const Eigen::MatrixXf & | hist_f1, |
| const Eigen::MatrixXf & | hist_f2, | ||
| const Eigen::MatrixXf & | hist_f3, | ||
| const std::vector< int > & | indices, | ||
| const std::vector< float > & | dists, | ||
| Eigen::VectorXf & | fpfh_histogram | ||
| ) | [inherited] |
Weight the SPFH (Simple Point Feature Histograms) individual histograms to create the final FPFH (Fast Point Feature Histogram) for a given point based on its 3D spatial neighborhood.
| [in] | hist_f1 | the histogram feature vector of f1 values over the given patch |
| [in] | hist_f2 | the histogram feature vector of f2 values over the given patch |
| [in] | hist_f3 | the histogram feature vector of f3 values over the given patch |
| [in] | indices | the point indices of p_idx's k-neighborhood in the point cloud |
| [in] | dists | the distances from p_idx to all its k-neighbors |
| [out] | fpfh_histogram | the resultant FPFH histogram representing the feature at the query point |
| int pcl::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::nr_bins_f1_ |
The number of subdivisions for each angular feature interval.
Reimplemented from pcl::FPFHEstimation< PointInT, PointNT, PointOutT >.
Definition at line 126 of file fpfh_omp.h.
| int pcl::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::nr_bins_f2_ |
Reimplemented from pcl::FPFHEstimation< PointInT, PointNT, PointOutT >.
Definition at line 126 of file fpfh_omp.h.
| int pcl::FPFHEstimationOMP< PointInT, PointNT, PointOutT >::nr_bins_f3_ |
Reimplemented from pcl::FPFHEstimation< PointInT, PointNT, PointOutT >.
Definition at line 126 of file fpfh_omp.h.
1.7.6.1