|
Point Cloud Library (PCL) 1.15.1
|
ISSKeypoint3D detects the Intrinsic Shape Signatures keypoints for a given point cloud. More...
#include <pcl/keypoints/iss_3d.h>
Public Member Functions | |
| ISSKeypoint3D (double salient_radius=0.0001) | |
| Constructor. | |
| ~ISSKeypoint3D () override | |
| Destructor. | |
| void | setSalientRadius (double salient_radius) |
| Set the radius of the spherical neighborhood used to compute the scatter matrix. | |
| void | setNonMaxRadius (double non_max_radius) |
| Set the radius for the application of the non maxima suppression algorithm. | |
| void | setNormalRadius (double normal_radius) |
| Set the radius used for the estimation of the surface normals of the input cloud. | |
| void | setBorderRadius (double border_radius) |
| Set the radius used for the estimation of the boundary points. | |
| void | setThreshold21 (double gamma_21) |
| Set the upper bound on the ratio between the second and the first eigenvalue. | |
| void | setThreshold32 (double gamma_32) |
| Set the upper bound on the ratio between the third and the second eigenvalue. | |
| void | setMinNeighbors (int min_neighbors) |
| Set the minimum number of neighbors that has to be found while applying the non maxima suppression algorithm. | |
| void | setNormals (const PointCloudNConstPtr &normals) |
| Set the normals if pre-calculated normals are available. | |
| void | setAngleThreshold (float angle) |
| Set the decision boundary (angle threshold) that marks points as boundary or regular. | |
| void | setNumberOfThreads (unsigned int nr_threads=0) |
| Initialize the scheduler and set the number of threads to use. | |
| Public Member Functions inherited from pcl::Keypoint< PointInT, PointOutT > | |
| Keypoint ()=default | |
| void | harrisCorner (PointInT &output, PointInT &input, const float sigma_d, const float sigma_i, const float alpha, const float thresh) |
| void | hessianBlob (PointInT &output, PointInT &input, const float sigma, bool SCALE) |
| void | imageElementMultiply (PointInT &output, PointInT &input1, PointInT &input2) |
| ~Keypoint () override=default | |
| Empty destructor. | |
| virtual void | setSearchSurface (const PointCloudInConstPtr &cloud) |
| Provide a pointer to the input dataset that we need to estimate features at every point for. | |
| PointCloudInConstPtr | getSearchSurface () |
| Get a pointer to the surface point cloud dataset. | |
| void | setSearchMethod (const KdTreePtr &tree) |
| Provide a pointer to the search object. | |
| KdTreePtr | getSearchMethod () |
| Get a pointer to the search method used. | |
| double | getSearchParameter () |
| Get the internal search parameter. | |
| void | setKSearch (int k) |
| Set the number of k nearest neighbors to use for the feature estimation. | |
| int | getKSearch () |
| 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 key point detection. | |
| double | getRadiusSearch () |
| Get the sphere radius used for determining the neighbors. | |
| pcl::PointIndicesConstPtr | getKeypointsIndices () |
| void | compute (PointCloudOut &output) |
| Base method for key point detection for all points given in <setInputCloud (), setIndices ()> using the surface in setSearchSurface () and the spatial locator in setSearchMethod (). | |
| int | searchForNeighbors (pcl::index_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. | |
| Public Member Functions inherited from pcl::PCLBase< PointInT > | |
| PCLBase () | |
| Empty constructor. | |
| PCLBase (const PCLBase &base) | |
| Copy constructor. | |
| virtual | ~PCLBase ()=default |
| Destructor. | |
| virtual void | setInputCloud (const PointCloudConstPtr &cloud) |
| Provide a pointer to the input dataset. | |
| PointCloudConstPtr const | getInputCloud () const |
| Get a pointer to the input point cloud dataset. | |
| virtual void | setIndices (const IndicesPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. | |
| virtual void | setIndices (const IndicesConstPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. | |
| virtual void | setIndices (const PointIndicesConstPtr &indices) |
| Provide a pointer to the vector of indices that represents the input data. | |
| 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. | |
| IndicesPtr | getIndices () |
| Get a pointer to the vector of indices used. | |
| IndicesConstPtr const | getIndices () const |
| Get a pointer to the vector of indices used. | |
| const PointInT & | operator[] (std::size_t pos) const |
| Override PointCloud operator[] to shorten code. | |
Protected Member Functions | |
| bool * | getBoundaryPoints (PointCloudIn &input, double border_radius, float angle_threshold) |
| Compute the boundary points for the given input cloud. | |
| void | getScatterMatrix (const int ¤t_index, Eigen::Matrix3d &cov_m) |
| Compute the scatter matrix for a point index. | |
| bool | initCompute () override |
| Perform the initial checks before computing the keypoints. | |
| void | detectKeypoints (PointCloudOut &output) override |
| Detect the keypoints by performing the EVD of the scatter matrix. | |
| Protected Member Functions inherited from pcl::Keypoint< PointInT, PointOutT > | |
| const std::string & | getClassName () const |
| Get a string representation of the name of this class. | |
| Protected Member Functions inherited from pcl::PCLBase< PointInT > | |
| bool | initCompute () |
| This method should get called before starting the actual computation. | |
| bool | deinitCompute () |
| This method should get called after finishing the actual computation. | |
Protected Attributes | |
| double | salient_radius_ |
| The radius of the spherical neighborhood used to compute the scatter matrix. | |
| double | non_max_radius_ {0.0} |
| The non maxima suppression radius. | |
| double | normal_radius_ {0.0} |
| The radius used to compute the normals of the input cloud. | |
| double | border_radius_ {0.0} |
| The radius used to compute the boundary points of the input cloud. | |
| double | gamma_21_ {0.975} |
| The upper bound on the ratio between the second and the first eigenvalue returned by the EVD. | |
| double | gamma_32_ {0.975} |
| The upper bound on the ratio between the third and the second eigenvalue returned by the EVD. | |
| double * | third_eigen_value_ {nullptr} |
| Store the third eigen value associated to each point in the input cloud. | |
| bool * | edge_points_ {nullptr} |
| Store the information about the boundary points of the input cloud. | |
| int | min_neighbors_ {5} |
| Minimum number of neighbors that has to be found while applying the non maxima suppression algorithm. | |
| PointCloudNConstPtr | normals_ |
| The cloud of normals related to the input surface. | |
| float | angle_threshold_ |
| The decision boundary (angle threshold) that marks points as boundary or regular. | |
| unsigned int | threads_ {0} |
| The number of threads that has to be used by the scheduler. | |
| Protected Attributes inherited from pcl::Keypoint< PointInT, PointOutT > | |
| std::string | name_ |
| The key point detection method's name. | |
| SearchMethod | search_method_ |
| The search method template for indices. | |
| SearchMethodSurface | search_method_surface_ |
| The search method template for points. | |
| PointCloudInConstPtr | surface_ |
| An input point cloud describing the surface that is to be used for nearest neighbors estimation. | |
| KdTreePtr | tree_ |
| A pointer to the spatial search object. | |
| double | search_parameter_ |
| The actual search parameter (casted from either search_radius_ or k_). | |
| double | search_radius_ |
| The nearest neighbors search radius for each point. | |
| int | k_ |
| The number of K nearest neighbors to use for each point. | |
| pcl::PointIndicesPtr | keypoints_indices_ |
| Indices of the keypoints in the input cloud. | |
| Protected Attributes inherited from pcl::PCLBase< PointInT > | |
| PointCloudConstPtr | input_ |
| The input point cloud dataset. | |
| IndicesPtr | indices_ |
| A pointer to the vector of point indices to use. | |
| bool | use_indices_ |
| Set to true if point indices are used. | |
| bool | fake_indices_ |
| If no set of indices are given, we construct a set of fake indices that mimic the input PointCloud. | |
ISSKeypoint3D detects the Intrinsic Shape Signatures keypoints for a given point cloud.
This class is based on a particular implementation made by Federico Tombari and Samuele Salti and it has been explicitly adapted to PCL.
For more information about the original ISS detector, see:
Code example:
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::ConstPtr = shared_ptr<const ISSKeypoint3D<PointInT, PointOutT, NormalT> > |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::OctreeSearchIn = pcl::octree::OctreePointCloudSearch<PointInT> |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::OctreeSearchInPtr = typename OctreeSearchIn::Ptr |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudIn = typename Keypoint<PointInT, PointOutT>::PointCloudIn |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudN = pcl::PointCloud<NormalT> |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudNConstPtr = typename PointCloudN::ConstPtr |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudNPtr = typename PointCloudN::Ptr |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudOut = typename Keypoint<PointInT, PointOutT>::PointCloudOut |
| using pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::Ptr = shared_ptr<ISSKeypoint3D<PointInT, PointOutT, NormalT> > |
|
inline |
Constructor.
| [in] | salient_radius | the radius of the spherical neighborhood used to compute the scatter matrix. |
Definition at line 112 of file iss_3d.h.
References angle_threshold_, M_PI, pcl::Keypoint< PointInT, PointOutT >::name_, normals_, salient_radius_, pcl::Keypoint< PointInT, PointOutT >::search_radius_, setNumberOfThreads(), and threads_.
|
inlineoverride |
Destructor.
Definition at line 123 of file iss_3d.h.
References edge_points_, and third_eigen_value_.
|
overrideprotectedvirtual |
Detect the keypoints by performing the EVD of the scatter matrix.
| [out] | output | the resultant cloud of keypoints |
Implements pcl::Keypoint< PointInT, PointOutT >.
Definition at line 303 of file iss_3d.hpp.
References angle_threshold_, border_radius_, edge_points_, gamma_21_, gamma_32_, getBoundaryPoints(), getScatterMatrix(), pcl::PCLBase< PointInT >::input_, pcl::isFinite(), pcl::Keypoint< PointInT, PointOutT >::keypoints_indices_, min_neighbors_, pcl::Keypoint< PointInT, PointOutT >::name_, non_max_radius_, normals_, pcl::Keypoint< PointInT, PointOutT >::searchForNeighbors(), third_eigen_value_, and threads_.
|
protected |
Compute the boundary points for the given input cloud.
| [in] | input | the input cloud |
| [in] | border_radius | the radius used to compute the boundary points |
| [in] | angle_threshold | the decision boundary that marks the points as boundary |
Definition at line 120 of file iss_3d.hpp.
References pcl::BoundaryEstimation< PointInT, PointNT, PointOutT >::getCoordinateSystemOnPlane(), pcl::PCLBase< PointInT >::input_, pcl::BoundaryEstimation< PointInT, PointNT, PointOutT >::isBoundaryPoint(), pcl::isFinite(), min_neighbors_, normals_, pcl::Keypoint< PointInT, PointOutT >::searchForNeighbors(), and pcl::PCLBase< PointT >::setInputCloud().
Referenced by detectKeypoints().
|
protected |
Compute the scatter matrix for a point index.
| [in] | current_index | the index of the point |
| [out] | cov_m | the point scatter matrix |
Definition at line 165 of file iss_3d.hpp.
References min_neighbors_, salient_radius_, and pcl::Keypoint< PointInT, PointOutT >::searchForNeighbors().
Referenced by detectKeypoints().
|
overrideprotectedvirtual |
Perform the initial checks before computing the keypoints.
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
Definition at line 212 of file iss_3d.hpp.
References border_radius_, pcl::Feature< PointInT, PointOutT >::compute(), edge_points_, gamma_21_, gamma_32_, pcl::Keypoint< ImageType >::initCompute(), pcl::PCLBase< PointInT >::input_, min_neighbors_, pcl::Keypoint< PointInT, PointOutT >::name_, non_max_radius_, normal_radius_, normals_, salient_radius_, pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setInputCloud(), pcl::NormalEstimation< PointInT, PointOutT >::setInputCloud(), pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setNormalEstimationMethod(), pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setNormalSmoothingSize(), pcl::Feature< PointInT, PointOutT >::setRadiusSearch(), pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::SIMPLE_3D_GRADIENT, pcl::Keypoint< PointInT, PointOutT >::surface_, and third_eigen_value_.
|
inline |
Set the decision boundary (angle threshold) that marks points as boundary or regular.
(default 
| [in] | angle | the angle threshold |
Definition at line 184 of file iss_3d.h.
References angle_threshold_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setBorderRadius | ( | double | border_radius | ) |
Set the radius used for the estimation of the boundary points.
If the radius is too large, the temporal performances of the detector may degrade significantly.
| [in] | border_radius | the radius used to compute the boundary points |
Definition at line 71 of file iss_3d.hpp.
References border_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setMinNeighbors | ( | int | min_neighbors | ) |
Set the minimum number of neighbors that has to be found while applying the non maxima suppression algorithm.
| [in] | min_neighbors | the minimum number of neighbors required |
Definition at line 92 of file iss_3d.hpp.
References min_neighbors_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNonMaxRadius | ( | double | non_max_radius | ) |
Set the radius for the application of the non maxima suppression algorithm.
| [in] | non_max_radius | the non maxima suppression radius |
Definition at line 57 of file iss_3d.hpp.
References non_max_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNormalRadius | ( | double | normal_radius | ) |
Set the radius used for the estimation of the surface normals of the input cloud.
If the radius is too large, the temporal performances of the detector may degrade significantly.
| [in] | normal_radius | the radius used to estimate surface normals |
Definition at line 64 of file iss_3d.hpp.
References normal_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNormals | ( | const PointCloudNConstPtr & | normals | ) |
Set the normals if pre-calculated normals are available.
| [in] | normals | the given cloud of normals |
Definition at line 99 of file iss_3d.hpp.
References normals_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNumberOfThreads | ( | unsigned int | nr_threads = 0 | ) |
Initialize the scheduler and set the number of threads to use.
| [in] | nr_threads | the number of hardware threads to use (0 sets the value back to automatic) |
Definition at line 106 of file iss_3d.hpp.
References threads_.
Referenced by ISSKeypoint3D().
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setSalientRadius | ( | double | salient_radius | ) |
Set the radius of the spherical neighborhood used to compute the scatter matrix.
| [in] | salient_radius | the radius of the spherical neighborhood |
Definition at line 50 of file iss_3d.hpp.
References salient_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setThreshold21 | ( | double | gamma_21 | ) |
Set the upper bound on the ratio between the second and the first eigenvalue.
| [in] | gamma_21 | the upper bound on the ratio between the second and the first eigenvalue |
Definition at line 78 of file iss_3d.hpp.
References gamma_21_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setThreshold32 | ( | double | gamma_32 | ) |
Set the upper bound on the ratio between the third and the second eigenvalue.
| [in] | gamma_32 | the upper bound on the ratio between the third and the second eigenvalue |
Definition at line 85 of file iss_3d.hpp.
References gamma_32_.
|
protected |
The decision boundary (angle threshold) that marks points as boundary or regular.
(default 
Definition at line 257 of file iss_3d.h.
Referenced by detectKeypoints(), ISSKeypoint3D(), and setAngleThreshold().
|
protected |
The radius used to compute the boundary points of the input cloud.
Definition at line 236 of file iss_3d.h.
Referenced by detectKeypoints(), initCompute(), and setBorderRadius().
|
protected |
Store the information about the boundary points of the input cloud.
Definition at line 248 of file iss_3d.h.
Referenced by detectKeypoints(), initCompute(), and ~ISSKeypoint3D().
|
protected |
The upper bound on the ratio between the second and the first eigenvalue returned by the EVD.
Definition at line 239 of file iss_3d.h.
Referenced by detectKeypoints(), initCompute(), and setThreshold21().
|
protected |
The upper bound on the ratio between the third and the second eigenvalue returned by the EVD.
Definition at line 242 of file iss_3d.h.
Referenced by detectKeypoints(), initCompute(), and setThreshold32().
|
protected |
Minimum number of neighbors that has to be found while applying the non maxima suppression algorithm.
Definition at line 251 of file iss_3d.h.
Referenced by detectKeypoints(), getBoundaryPoints(), getScatterMatrix(), initCompute(), and setMinNeighbors().
|
protected |
The non maxima suppression radius.
Definition at line 230 of file iss_3d.h.
Referenced by detectKeypoints(), initCompute(), and setNonMaxRadius().
|
protected |
The radius used to compute the normals of the input cloud.
Definition at line 233 of file iss_3d.h.
Referenced by initCompute(), and setNormalRadius().
|
protected |
The cloud of normals related to the input surface.
Definition at line 254 of file iss_3d.h.
Referenced by detectKeypoints(), getBoundaryPoints(), initCompute(), ISSKeypoint3D(), and setNormals().
|
protected |
The radius of the spherical neighborhood used to compute the scatter matrix.
Definition at line 227 of file iss_3d.h.
Referenced by getScatterMatrix(), initCompute(), ISSKeypoint3D(), and setSalientRadius().
|
protected |
Store the third eigen value associated to each point in the input cloud.
Definition at line 245 of file iss_3d.h.
Referenced by detectKeypoints(), initCompute(), and ~ISSKeypoint3D().
|
protected |
The number of threads that has to be used by the scheduler.
Definition at line 260 of file iss_3d.h.
Referenced by detectKeypoints(), ISSKeypoint3D(), and setNumberOfThreads().