|
Point Cloud Library (PCL)
1.15.1-dev
|
Surface normal estimation on organized data using integral images. More...
#include <pcl/features/integral_image_normal.h>
Inheritance diagram for pcl::IntegralImageNormalEstimation< PointInT, PointOutT >:
Collaboration diagram for pcl::IntegralImageNormalEstimation< PointInT, PointOutT >:Public Types | |
| enum | BorderPolicy { BORDER_POLICY_IGNORE , BORDER_POLICY_MIRROR } |
| Different types of border handling. More... | |
| enum | NormalEstimationMethod { COVARIANCE_MATRIX , AVERAGE_3D_GRADIENT , AVERAGE_DEPTH_CHANGE , SIMPLE_3D_GRADIENT } |
| Different normal estimation methods. More... | |
| using | Ptr = shared_ptr< IntegralImageNormalEstimation< PointInT, PointOutT > > |
| using | ConstPtr = shared_ptr< const IntegralImageNormalEstimation< PointInT, PointOutT > > |
| using | PointCloudIn = typename Feature< PointInT, PointOutT >::PointCloudIn |
| using | PointCloudOut = typename Feature< PointInT, PointOutT >::PointCloudOut |
Public Types inherited from pcl::Feature< PointInT, PointOutT > | |
| using | BaseClass = PCLBase< PointInT > |
| using | Ptr = shared_ptr< Feature< PointInT, PointOutT > > |
| using | ConstPtr = shared_ptr< const Feature< PointInT, PointOutT > > |
| using | KdTree = pcl::search::Search< PointInT > |
| using | KdTreePtr = typename KdTree::Ptr |
| using | PointCloudIn = pcl::PointCloud< PointInT > |
| using | PointCloudInPtr = typename PointCloudIn::Ptr |
| using | PointCloudInConstPtr = typename PointCloudIn::ConstPtr |
| using | PointCloudOut = pcl::PointCloud< PointOutT > |
| using | SearchMethod = std::function< int(std::size_t, double, pcl::Indices &, std::vector< float > &)> |
| using | SearchMethodSurface = std::function< int(const PointCloudIn &cloud, std::size_t index, double, pcl::Indices &, std::vector< float > &)> |
Public Types inherited from pcl::PCLBase< PointInT > | |
| using | PointCloud = pcl::PointCloud< PointInT > |
| using | PointCloudPtr = typename PointCloud::Ptr |
| using | PointCloudConstPtr = typename PointCloud::ConstPtr |
| using | PointIndicesPtr = PointIndices::Ptr |
| using | PointIndicesConstPtr = PointIndices::ConstPtr |
Public Member Functions | |
| IntegralImageNormalEstimation () | |
| Constructor. More... | |
| ~IntegralImageNormalEstimation () override | |
| Destructor. More... | |
| void | setRectSize (const int width, const int height) |
| Set the regions size which is considered for normal estimation. More... | |
| void | setBorderPolicy (const BorderPolicy border_policy) |
| Sets the policy for handling borders. More... | |
| void | computePointNormal (const int pos_x, const int pos_y, const unsigned point_index, PointOutT &normal) |
| Computes the normal at the specified position. More... | |
| void | computePointNormalMirror (const int pos_x, const int pos_y, const unsigned point_index, PointOutT &normal) |
| Computes the normal at the specified position with mirroring for border handling. More... | |
| void | setMaxDepthChangeFactor (float max_depth_change_factor) |
| The depth change threshold for computing object borders. More... | |
| void | setNormalSmoothingSize (float normal_smoothing_size) |
| Set the normal smoothing size. More... | |
| void | setNormalEstimationMethod (NormalEstimationMethod normal_estimation_method) |
| Set the normal estimation method. More... | |
| void | setDepthDependentSmoothing (bool use_depth_dependent_smoothing) |
| Set whether to use depth depending smoothing or not. More... | |
| void | setInputCloud (const typename PointCloudIn::ConstPtr &cloud) override |
| Provide a pointer to the input dataset (overwrites the PCLBase::setInputCloud method) More... | |
| float * | getDistanceMap () |
| Returns a pointer to the distance map which was computed internally. More... | |
| void | setViewPoint (float vpx, float vpy, float vpz) |
| Set the viewpoint. More... | |
| void | getViewPoint (float &vpx, float &vpy, float &vpz) |
| Get the viewpoint. More... | |
| void | useSensorOriginAsViewPoint () |
| sets whether the sensor origin or a user given viewpoint should be used. More... | |
Public Member Functions inherited from pcl::Feature< PointInT, PointOutT > | |
| Feature () | |
| Empty constructor. More... | |
| 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. More... | |
| PointCloudInConstPtr | getSearchSurface () const |
| Get a pointer to the surface point cloud dataset. More... | |
| void | setSearchMethod (const KdTreePtr &tree) |
| Provide a pointer to the search object. More... | |
| KdTreePtr | getSearchMethod () const |
| Get a pointer to the search method used. More... | |
| double | getSearchParameter () const |
| Get the internal search parameter. More... | |
| void | setKSearch (int k) |
| Set the number of k nearest neighbors to use for the feature estimation. More... | |
| int | getKSearch () const |
| get the number of k nearest neighbors used for the feature estimation. More... | |
| void | setRadiusSearch (double radius) |
| Set the sphere radius that is to be used for determining the nearest neighbors used for the feature estimation. More... | |
| double | getRadiusSearch () const |
| Get the sphere radius used for determining the neighbors. More... | |
| 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 () More... | |
Public Member Functions inherited from pcl::PCLBase< PointInT > | |
| PCLBase () | |
| Empty constructor. More... | |
| PCLBase (const PCLBase &base) | |
| Copy constructor. More... | |
| virtual | ~PCLBase ()=default |
| Destructor. More... | |
| virtual void | setInputCloud (const PointCloudConstPtr &cloud) |
| Provide a pointer to the input dataset. More... | |
| PointCloudConstPtr const | getInputCloud () const |
| Get a pointer to the input point cloud dataset. More... | |
| virtual void | setIndices (const IndicesPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. More... | |
| virtual void | setIndices (const IndicesConstPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. More... | |
| virtual void | setIndices (const PointIndicesConstPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. More... | |
| virtual void | setIndices (std::size_t row_start, std::size_t col_start, std::size_t nb_rows, std::size_t nb_cols) |
| Set the indices for the points laying within an interest region of the point cloud. More... | |
| IndicesPtr | getIndices () |
| Get a pointer to the vector of indices used. More... | |
| IndicesConstPtr const | getIndices () const |
| Get a pointer to the vector of indices used. More... | |
| const PointInT & | operator[] (std::size_t pos) const |
| Override PointCloud operator[] to shorten code. More... | |
Protected Member Functions | |
| void | computeFeature (PointCloudOut &output) override |
| Computes the normal for the complete cloud or only indices_ if provided. More... | |
| void | computeFeatureFull (const float *distance_map, const float &bad_point, PointCloudOut &output) |
| Computes the normal for the complete cloud. More... | |
| void | computeFeaturePart (const float *distance_map, const float &bad_point, PointCloudOut &output) |
| Computes the normal for part of the cloud specified by indices_. More... | |
| void | initData () |
| Initialize the data structures, based on the normal estimation method chosen. More... | |
Protected Member Functions inherited from pcl::Feature< PointInT, PointOutT > | |
| const std::string & | getClassName () const |
| Get a string representation of the name of this class. More... | |
| virtual bool | deinitCompute () |
| This method should get called after ending the actual computation. More... | |
| int | searchForNeighbors (std::size_t index, double parameter, pcl::Indices &indices, std::vector< float > &distances) const |
| Search for k-nearest neighbors using the spatial locator from setSearchmethod, and the given surface from setSearchSurface. More... | |
| int | searchForNeighbors (const PointCloudIn &cloud, std::size_t index, double parameter, pcl::Indices &indices, std::vector< float > &distances) const |
| Search for k-nearest neighbors using the spatial locator from setSearchmethod, and the given surface from setSearchSurface. More... | |
Protected Member Functions inherited from pcl::PCLBase< PointInT > | |
| bool | initCompute () |
| This method should get called before starting the actual computation. More... | |
| bool | deinitCompute () |
| This method should get called after finishing the actual computation. More... | |
Additional Inherited Members | |
Protected Attributes inherited from pcl::Feature< PointInT, PointOutT > | |
| std::string | feature_name_ |
| The feature name. More... | |
| SearchMethodSurface | search_method_surface_ |
| The search method template for points. More... | |
| PointCloudInConstPtr | surface_ |
| An input point cloud describing the surface that is to be used for nearest neighbors estimation. More... | |
| KdTreePtr | tree_ |
| A pointer to the spatial search object. More... | |
| double | search_parameter_ |
| The actual search parameter (from either search_radius_ or k_). More... | |
| double | search_radius_ |
| The nearest neighbors search radius for each point. More... | |
| int | k_ |
| The number of K nearest neighbors to use for each point. More... | |
| bool | fake_surface_ |
| If no surface is given, we use the input PointCloud as the surface. More... | |
Protected Attributes inherited from pcl::PCLBase< PointInT > | |
| PointCloudConstPtr | input_ |
| The input point cloud dataset. More... | |
| IndicesPtr | indices_ |
| A pointer to the vector of point indices to use. More... | |
| bool | use_indices_ |
| Set to true if point indices are used. More... | |
| bool | fake_indices_ |
| If no set of indices are given, we construct a set of fake indices that mimic the input PointCloud. More... | |
Surface normal estimation on organized data using integral images.
For detailed information about this method see: S. Holzer and R. B. Rusu and M. Dixon and S. Gedikli and N. Navab, Adaptive Neighborhood Selection for Real-Time Surface Normal Estimation from Organized Point Cloud Data Using Integral Images, IROS 2012. D. Holz, S. Holzer, R. B. Rusu, and S. Behnke (2011, July). Real-Time Plane Segmentation using RGB-D Cameras. In Proceedings of the 15th RoboCup International Symposium, Istanbul, Turkey. http://www.ais.uni-bonn.de/~holz/papers/holz_2011_robocup.pdf
Definition at line 65 of file integral_image_normal.h.
| using pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::ConstPtr = shared_ptr<const IntegralImageNormalEstimation<PointInT, PointOutT> > |
Definition at line 75 of file integral_image_normal.h.
| using pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::PointCloudIn = typename Feature<PointInT, PointOutT>::PointCloudIn |
Definition at line 103 of file integral_image_normal.h.
| using pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::PointCloudOut = typename Feature<PointInT, PointOutT>::PointCloudOut |
Definition at line 104 of file integral_image_normal.h.
| using pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::Ptr = shared_ptr<IntegralImageNormalEstimation<PointInT, PointOutT> > |
Definition at line 74 of file integral_image_normal.h.
| enum pcl::IntegralImageNormalEstimation::BorderPolicy |
Different types of border handling.
| Enumerator | |
|---|---|
| BORDER_POLICY_IGNORE | |
| BORDER_POLICY_MIRROR | |
Definition at line 78 of file integral_image_normal.h.
| enum pcl::IntegralImageNormalEstimation::NormalEstimationMethod |
Different normal estimation methods.
| Enumerator | |
|---|---|
| COVARIANCE_MATRIX | |
| AVERAGE_3D_GRADIENT | |
| AVERAGE_DEPTH_CHANGE | |
| SIMPLE_3D_GRADIENT | |
Definition at line 95 of file integral_image_normal.h.
|
inline |
Constructor.
Definition at line 107 of file integral_image_normal.h.
References pcl::Feature< PointInT, PointOutT >::feature_name_, pcl::Feature< PointInT, PointOutT >::k_, and pcl::Feature< PointInT, PointOutT >::tree_.
|
override |
Destructor.
Definition at line 46 of file integral_image_normal.hpp.
|
overrideprotectedvirtual |
Computes the normal for the complete cloud or only indices_ if provided.
| [out] | output | the resultant normals |
Implements pcl::Feature< PointInT, PointOutT >.
Definition at line 729 of file integral_image_normal.hpp.
References pcl::PointCloud< PointT >::sensor_orientation_, and pcl::PointCloud< PointT >::sensor_origin_.
|
protected |
Computes the normal for the complete cloud.
| [in] | distance_map | distance map |
| [in] | bad_point | constant given to invalid normal components |
| [out] | output | the resultant normals |
Definition at line 836 of file integral_image_normal.hpp.
References pcl::computePointNormal(), pcl::PointCloud< PointT >::is_dense, and pcl::PointCloud< PointT >::width.
|
protected |
Computes the normal for part of the cloud specified by indices_.
| [in] | distance_map | distance map |
| [in] | bad_point | constant given to invalid normal components |
| [out] | output | the resultant normals |
Definition at line 1025 of file integral_image_normal.hpp.
References pcl::computePointNormal(), pcl::PointCloud< PointT >::is_dense, and pcl::PointCloud< PointT >::width.
| void pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::computePointNormal | ( | const int | pos_x, |
| const int | pos_y, | ||
| const unsigned | point_index, | ||
| PointOutT & | normal | ||
| ) |
Computes the normal at the specified position.
| [in] | pos_x | x position (pixel) |
| [in] | pos_y | y position (pixel) |
| [in] | point_index | the position index of the point |
| [out] | normal | the output estimated normal |
Definition at line 206 of file integral_image_normal.hpp.
References pcl::eigen33(), pcl::flipNormalTowardsViewpoint(), pcl::IntegralImage2D< DataType, Dimension >::getFirstOrderSum(), and pcl::IntegralImage2D< DataType, Dimension >::getSecondOrderSum().
| void pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::computePointNormalMirror | ( | const int | pos_x, |
| const int | pos_y, | ||
| const unsigned | point_index, | ||
| PointOutT & | normal | ||
| ) |
Computes the normal at the specified position with mirroring for border handling.
| [in] | pos_x | x position (pixel) |
| [in] | pos_y | y position (pixel) |
| [in] | point_index | the position index of the point |
| [out] | normal | the output estimated normal |
Definition at line 461 of file integral_image_normal.hpp.
References pcl::eigen33(), pcl::flipNormalTowardsViewpoint(), and pcl::IntegralImage2D< DataType, Dimension >::getFirstOrderSumSE().
|
inline |
Returns a pointer to the distance map which was computed internally.
Definition at line 240 of file integral_image_normal.h.
|
inline |
Get the viewpoint.
| [out] | vpx | x-coordinate of the view point |
| [out] | vpy | y-coordinate of the view point |
| [out] | vpz | z-coordinate of the view point |
Definition at line 268 of file integral_image_normal.h.
|
protected |
Initialize the data structures, based on the normal estimation method chosen.
Definition at line 56 of file integral_image_normal.hpp.
Referenced by pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setInputCloud().
|
inline |
Sets the policy for handling borders.
| [in] | border_policy | the border policy. |
Definition at line 135 of file integral_image_normal.h.
|
inline |
Set whether to use depth depending smoothing or not.
| [in] | use_depth_dependent_smoothing | decides whether the smoothing is depth dependent |
Definition at line 206 of file integral_image_normal.h.
|
inlineoverride |
Provide a pointer to the input dataset (overwrites the PCLBase::setInputCloud method)
| [in] | cloud | the const boost shared pointer to a PointCloud message |
Definition at line 215 of file integral_image_normal.h.
References pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::initData(), and pcl::PCLBase< PointInT >::input_.
Referenced by pcl::HarrisKeypoint6D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::HarrisKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::SUSANKeypoint< PointInT, PointOutT, NormalT, IntensityT >::initCompute(), and pcl::TrajkovicKeypoint3D< PointInT, PointOutT, NormalT >::initCompute().
|
inline |
The depth change threshold for computing object borders.
| [in] | max_depth_change_factor | the depth change threshold for computing object borders based on depth changes |
Definition at line 163 of file integral_image_normal.h.
|
inline |
Set the normal estimation method.
The current implemented algorithms are:
| [in] | normal_estimation_method | the method used for normal estimation |
Definition at line 197 of file integral_image_normal.h.
Referenced by pcl::HarrisKeypoint6D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::HarrisKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::SUSANKeypoint< PointInT, PointOutT, NormalT, IntensityT >::initCompute(), and pcl::TrajkovicKeypoint3D< PointInT, PointOutT, NormalT >::initCompute().
|
inline |
Set the normal smoothing size.
| [in] | normal_smoothing_size | factor which influences the size of the area used to smooth normals (depth dependent if useDepthDependentSmoothing is true) |
Definition at line 173 of file integral_image_normal.h.
References pcl::Feature< PointInT, PointOutT >::feature_name_.
Referenced by pcl::HarrisKeypoint6D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::HarrisKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::SUSANKeypoint< PointInT, PointOutT, NormalT, IntensityT >::initCompute(), and pcl::TrajkovicKeypoint3D< PointInT, PointOutT, NormalT >::initCompute().
| void pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setRectSize | ( | const int | width, |
| const int | height | ||
| ) |
Set the regions size which is considered for normal estimation.
| [in] | width | the width of the search rectangle |
| [in] | height | the height of the search rectangle |
Definition at line 93 of file integral_image_normal.hpp.
|
inline |
Set the viewpoint.
| vpx | the X coordinate of the viewpoint |
| vpy | the Y coordinate of the viewpoint |
| vpz | the Z coordinate of the viewpoint |
Definition at line 251 of file integral_image_normal.h.
|
inline |
sets whether the sensor origin or a user given viewpoint should be used.
After this method, the normal estimation method uses the sensor origin of the input cloud. to use a user defined view point, use the method setViewPoint
Definition at line 280 of file integral_image_normal.h.
References pcl::PCLBase< PointInT >::input_.