ISSKeypoint3D detects the Intrinsic Shape Signatures keypoints for a given point cloud. More...
#include <pcl/keypoints/iss_3d.h>


Public Types | |
| typedef boost::shared_ptr < ISSKeypoint3D< PointInT, PointOutT, NormalT > > | Ptr |
| typedef boost::shared_ptr < const ISSKeypoint3D < PointInT, PointOutT, NormalT > > | ConstPtr |
| typedef Keypoint< PointInT, PointOutT >::PointCloudIn | PointCloudIn |
| typedef Keypoint< PointInT, PointOutT >::PointCloudOut | PointCloudOut |
| typedef pcl::PointCloud< NormalT > | PointCloudN |
| typedef PointCloudN::Ptr | PointCloudNPtr |
| typedef PointCloudN::ConstPtr | PointCloudNConstPtr |
| typedef pcl::octree::OctreePointCloudSearch < PointInT > | OctreeSearchIn |
| typedef OctreeSearchIn::Ptr | OctreeSearchInPtr |
Public Member Functions | |
| ISSKeypoint3D (double salient_radius=0.0001) | |
| Constructor. | |
| 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 supression 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. | |
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 () |
| Perform the initial checks before computing the keypoints. | |
| void | detectKeypoints (PointCloudOut &output) |
| Detect the keypoints by performing the EVD of the scatter matrix. | |
Protected Attributes | |
| double | salient_radius_ |
| The radius of the spherical neighborhood used to compute the scatter matrix. | |
| double | non_max_radius_ |
| The non maxima suppression radius. | |
| double | normal_radius_ |
| The radius used to compute the normals of the input cloud. | |
| double | border_radius_ |
| The radius used to compute the boundary points of the input cloud. | |
| double | gamma_21_ |
| The upper bound on the ratio between the second and the first eigenvalue returned by the EVD. | |
| double | gamma_32_ |
| The upper bound on the ratio between the third and the second eigenvalue returned by the EVD. | |
| double * | third_eigen_value_ |
| Store the third eigen value associated to each point in the input cloud. | |
| bool * | edge_points_ |
| Store the information about the boundary points of the input cloud. | |
| int | min_neighbors_ |
| 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_ |
| The number of threads that has to be used by the scheduler. | |
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:
pcl::PointCloud<pcl::PointXYZRGBA>::Ptr model (new pcl::PointCloud<pcl::PointXYZRGBA> ());; pcl::PointCloud<pcl::PointXYZRGBA>::Ptr model_keypoints (new pcl::PointCloud<pcl::PointXYZRGBA> ()); pcl::search::KdTree<pcl::PointXYZRGBA>::Ptr tree (new pcl::search::KdTree<pcl::PointXYZRGBA> ()); // Fill in the model cloud double model_resolution; // Compute model_resolution pcl::ISSKeypoint3D<pcl::PointXYZRGBA, pcl::PointXYZRGBA> iss_detector; iss_detector.setSearchMethod (tree); iss_detector.setSalientRadius (6 * model_resolution); iss_detector.setNonMaxRadius (4 * model_resolution); iss_detector.setThreshold21 (0.975); iss_detector.setThreshold32 (0.975); iss_detector.setMinNeighbors (5); iss_detector.setNumberOfThreads (4); iss_detector.setInputCloud (model); iss_detector.compute (*model_keypoints);
Definition at line 85 of file iss_3d.h.
| typedef boost::shared_ptr<const ISSKeypoint3D<PointInT, PointOutT, NormalT> > pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::ConstPtr |
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
| typedef pcl::octree::OctreePointCloudSearch<PointInT> pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::OctreeSearchIn |
| typedef OctreeSearchIn::Ptr pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::OctreeSearchInPtr |
| typedef Keypoint<PointInT, PointOutT>::PointCloudIn pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudIn |
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
| typedef pcl::PointCloud<NormalT> pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudN |
| typedef PointCloudN::ConstPtr pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudNConstPtr |
| typedef PointCloudN::Ptr pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudNPtr |
| typedef Keypoint<PointInT, PointOutT>::PointCloudOut pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::PointCloudOut |
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
| typedef boost::shared_ptr<ISSKeypoint3D<PointInT, PointOutT, NormalT> > pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::Ptr |
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
| pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::ISSKeypoint3D | ( | double | salient_radius = 0.0001 |
) | [inline] |
Constructor.
| [in] | salient_radius | the radius of the spherical neighborhood used to compute the scatter matrix. |
Definition at line 111 of file iss_3d.h.
References pcl::Keypoint< PointInT, PointOutT >::name_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::salient_radius_, and pcl::Keypoint< PointInT, PointOutT >::search_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints | ( | PointCloudOut & | output | ) | [inline, protected, virtual] |
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 293 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::angle_threshold_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::border_radius_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::edge_points_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_21_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_32_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getBoundaryPoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getScatterMatrix(), pcl::PointCloud< PointT >::header, pcl::PointCloud< PointT >::height, pcl::PCLBase< PointInT >::input_, pcl::isFinite(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::min_neighbors_, pcl::Keypoint< PointInT, PointOutT >::name_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::non_max_radius_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normals_, pcl::PointCloud< PointT >::points, pcl::Keypoint< PointInT, PointOutT >::searchForNeighbors(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::third_eigen_value_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::threads_, and pcl::PointCloud< PointT >::width.
| bool * pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getBoundaryPoints | ( | PointCloudIn & | input, | |
| double | border_radius, | |||
| float | angle_threshold | |||
| ) | [inline, 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] | the | decision boundary that marks the points as boundary |
Definition at line 105 of file iss_3d.hpp.
References pcl::BoundaryEstimation< PointInT, PointNT, PointOutT >::getCoordinateSystemOnPlane(), pcl::PCLBase< PointInT >::input_, pcl::BoundaryEstimation< PointInT, PointNT, PointOutT >::isBoundaryPoint(), pcl::isFinite(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::min_neighbors_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normals_, pcl::PointCloud< PointT >::points, pcl::Keypoint< PointInT, PointOutT >::searchForNeighbors(), pcl::PCLBase< PointInT >::setInputCloud(), and pcl::PointCloud< PointT >::size().
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints().
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getScatterMatrix | ( | const int & | current_index, | |
| Eigen::Matrix3d & | cov_m | |||
| ) | [inline, protected] |
Compute the scatter matrix for a point index.
| [in] | index | the index of the point |
| [out] | cov_m | the point scatter matrix |
Definition at line 149 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::min_neighbors_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::salient_radius_, and pcl::Keypoint< PointInT, PointOutT >::searchForNeighbors().
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints().
| bool pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute | ( | ) | [inline, protected, virtual] |
Perform the initial checks before computing the keypoints.
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
Definition at line 199 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::border_radius_, pcl::Feature< PointInT, PointOutT >::compute(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::edge_points_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_21_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_32_, pcl::PCLBase< PointInT >::input_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::min_neighbors_, pcl::Keypoint< PointInT, PointOutT >::name_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::non_max_radius_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normal_radius_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normals_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::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::Keypoint< PointInT, PointOutT >::surface_, and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::third_eigen_value_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setAngleThreshold | ( | float | angle | ) | [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 pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::angle_threshold_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setBorderRadius | ( | double | border_radius | ) | [inline] |
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 70 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::border_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setMinNeighbors | ( | int | min_neighbors | ) | [inline] |
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 91 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::min_neighbors_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNonMaxRadius | ( | double | non_max_radius | ) | [inline] |
Set the radius for the application of the non maxima supression algorithm.
| [in] | non_max_radius | the non maxima suppression radius |
Definition at line 56 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::non_max_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNormalRadius | ( | double | normal_radius | ) | [inline] |
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] | normals_radius | the radius used to estimate surface normals |
Definition at line 63 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normal_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNormals | ( | const PointCloudNConstPtr & | normals | ) | [inline] |
Set the normals if pre-calculated normals are available.
| [in] | normals | the given cloud of normals |
Definition at line 98 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normals_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNumberOfThreads | ( | unsigned int | nr_threads = 0 |
) | [inline] |
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 193 of file iss_3d.h.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::threads_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setSalientRadius | ( | double | salient_radius | ) | [inline] |
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 49 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::salient_radius_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setThreshold21 | ( | double | gamma_21 | ) | [inline] |
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 77 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_21_.
| void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setThreshold32 | ( | double | gamma_32 | ) | [inline] |
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 84 of file iss_3d.hpp.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_32_.
float pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::angle_threshold_ [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 pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setAngleThreshold().
double pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::border_radius_ [protected] |
The radius used to compute the boundary points of the input cloud.
Definition at line 236 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setBorderRadius().
bool* pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::edge_points_ [protected] |
Store the information about the boundary points of the input cloud.
Definition at line 248 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute().
double pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_21_ [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 pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setThreshold21().
double pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::gamma_32_ [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 pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setThreshold32().
int pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::min_neighbors_ [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 pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getBoundaryPoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getScatterMatrix(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setMinNeighbors().
double pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::non_max_radius_ [protected] |
The non maxima suppression radius.
Definition at line 230 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNonMaxRadius().
double pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normal_radius_ [protected] |
The radius used to compute the normals of the input cloud.
Definition at line 233 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNormalRadius().
PointCloudNConstPtr pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::normals_ [protected] |
The cloud of normals related to the input surface.
Definition at line 254 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getBoundaryPoints(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNormals().
double pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::salient_radius_ [protected] |
The radius of the spherical neighborhood used to compute the scatter matrix.
Definition at line 227 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::getScatterMatrix(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute(), pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::ISSKeypoint3D(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setSalientRadius().
double* pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::third_eigen_value_ [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 pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::initCompute().
unsigned int pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::threads_ [protected] |
The number of threads that has to be used by the scheduler.
Definition at line 260 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::detectKeypoints(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNumberOfThreads().