ISSKeypoint3D detects the Intrinsic Shape Signatures keypoints for a given point cloud. More...
#include <pcl/keypoints/iss_3d.h>
Public Types | |
using | Ptr = shared_ptr< ISSKeypoint3D< PointInT, PointOutT, NormalT > > |
using | ConstPtr = shared_ptr< const ISSKeypoint3D< PointInT, PointOutT, NormalT > > |
using | PointCloudIn = typename Keypoint< PointInT, PointOutT >::PointCloudIn |
using | PointCloudOut = typename Keypoint< PointInT, PointOutT >::PointCloudOut |
using | PointCloudN = pcl::PointCloud< NormalT > |
using | PointCloudNPtr = typename PointCloudN::Ptr |
using | PointCloudNConstPtr = typename PointCloudN::ConstPtr |
using | OctreeSearchIn = pcl::octree::OctreePointCloudSearch< PointInT > |
using | OctreeSearchInPtr = typename OctreeSearchIn::Ptr |
Public Types inherited from pcl::Keypoint< PointInT, PointOutT > | |
using | Ptr = shared_ptr< Keypoint< PointInT, PointOutT > > |
using | ConstPtr = shared_ptr< const Keypoint< PointInT, PointOutT > > |
using | BaseClass = PCLBase< PointInT > |
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(pcl::index_t, double, pcl::Indices &, std::vector< float > &)> |
using | SearchMethodSurface = std::function< int(const PointCloudIn &cloud, pcl::index_t index, double, pcl::Indices &, std::vector< float > &)> |
Public Member Functions | |
ISSKeypoint3D (double salient_radius=0.0001) | |
Constructor. More... |
|
~ISSKeypoint3D () | |
Destructor. More... |
|
void | setSalientRadius (double salient_radius) |
Set the radius of the spherical neighborhood used to compute the scatter matrix. More... |
|
void | setNonMaxRadius (double non_max_radius) |
Set the radius for the application of the non maxima supression algorithm. More... |
|
void | setNormalRadius (double normal_radius) |
Set the radius used for the estimation of the surface normals of the input cloud. More... |
|
void | setBorderRadius (double border_radius) |
Set the radius used for the estimation of the boundary points. More... |
|
void | setThreshold21 (double gamma_21) |
Set the upper bound on the ratio between the second and the first eigenvalue. More... |
|
void | setThreshold32 (double gamma_32) |
Set the upper bound on the ratio between the third and the second eigenvalue. More... |
|
void | setMinNeighbors (int min_neighbors) |
Set the minimum number of neighbors that has to be found while applying the non maxima suppression algorithm. More... |
|
void | setNormals (const PointCloudNConstPtr &normals) |
Set the normals if pre-calculated normals are available. More... |
|
void | setAngleThreshold (float angle) |
Set the decision boundary (angle threshold) that marks points as boundary or regular. More... |
|
void | setNumberOfThreads (unsigned int nr_threads=0) |
Initialize the scheduler and set the number of threads to use. More... |
|
Public Member Functions inherited from pcl::Keypoint< PointInT, PointOutT > | |
Keypoint () | |
Keypoint () | |
Empty constructor. More... |
|
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 | hessianBlob (PointInT &output, PointInT &input, const float start_scale, const float scaling_factor, const int num_scales) |
void | imageElementMultiply (PointInT &output, PointInT &input1, PointInT &input2) |
~Keypoint () | |
Empty destructor. More... |
|
virtual void | setSearchSurface (const PointCloudInConstPtr &cloud) |
Provide a pointer to the input dataset that we need to estimate features at every point for. More... |
|
PointCloudInConstPtr | getSearchSurface () |
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 () |
Get a pointer to the search method used. More... |
|
double | getSearchParameter () |
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 () |
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 key point detection. More... |
|
double | getRadiusSearch () |
Get the sphere radius used for determining the neighbors. More... |
|
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 () More... |
|
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. More... |
|
Protected Member Functions | |
bool * | getBoundaryPoints (PointCloudIn &input, double border_radius, float angle_threshold) |
Compute the boundary points for the given input cloud. More... |
|
void | getScatterMatrix (const int ¤t_index, Eigen::Matrix3d &cov_m) |
Compute the scatter matrix for a point index. More... |
|
bool | initCompute () override |
Perform the initial checks before computing the keypoints. More... |
|
void | detectKeypoints (PointCloudOut &output) override |
Detect the keypoints by performing the EVD of the scatter matrix. More... |
|
Protected Member Functions inherited from pcl::Keypoint< PointInT, PointOutT > | |
const std::string & | getClassName () const |
Get a string representation of the name of this class. More... |
|
virtual void | detectKeypoints (PointCloudOut &output)=0 |
Abstract key point detection method. More... |
|
Protected Attributes | |
double | salient_radius_ |
The radius of the spherical neighborhood used to compute the scatter matrix. More... |
|
double | non_max_radius_ |
The non maxima suppression radius. More... |
|
double | normal_radius_ |
The radius used to compute the normals of the input cloud. More... |
|
double | border_radius_ |
The radius used to compute the boundary points of the input cloud. More... |
|
double | gamma_21_ |
The upper bound on the ratio between the second and the first eigenvalue returned by the EVD. More... |
|
double | gamma_32_ |
The upper bound on the ratio between the third and the second eigenvalue returned by the EVD. More... |
|
double * | third_eigen_value_ |
Store the third eigen value associated to each point in the input cloud. More... |
|
bool * | edge_points_ |
Store the information about the boundary points of the input cloud. More... |
|
int | min_neighbors_ |
Minimum number of neighbors that has to be found while applying the non maxima suppression algorithm. More... |
|
PointCloudNConstPtr | normals_ |
The cloud of normals related to the input surface. More... |
|
float | angle_threshold_ |
The decision boundary (angle threshold) that marks points as boundary or regular. More... |
|
unsigned int | threads_ |
The number of threads that has to be used by the scheduler. More... |
|
Protected Attributes inherited from pcl::Keypoint< PointInT, PointOutT > | |
std::string | name_ |
The key point detection method's name. More... |
|
SearchMethod | search_method_ |
The search method template for indices. 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 (casted 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... |
|
pcl::PointIndicesPtr | keypoints_indices_ |
Indices of the keypoints in the input cloud. More... |
|
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 pcl::Keypoint< PointInT, PointOutT >::name_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::salient_radius_, pcl::Keypoint< PointInT, PointOutT >::search_radius_, pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNumberOfThreads(), and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::threads_.
| inline |
Destructor.
Definition at line 132 of file iss_3d.h.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::edge_points_, and pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::third_eigen_value_.
| overrideprotected |
Detect the keypoints by performing the EVD of the scatter matrix.
[out] | output | the resultant cloud of keypoints |
Definition at line 307 of file iss_3d.hpp.
References pcl::isFinite().
| 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::BoundaryEstimation< PointInT, PointNT, PointOutT >::isBoundaryPoint(), pcl::isFinite(), and pcl::PCLBase< PointInT >::setInputCloud().
| 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.
| overrideprotectedvirtual |
Perform the initial checks before computing the keypoints.
Reimplemented from pcl::Keypoint< PointInT, PointOutT >.
Definition at line 215 of file iss_3d.hpp.
References pcl::Feature< PointInT, PointOutT >::compute(), pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setInputCloud(), pcl::NormalEstimation< PointInT, PointOutT >::setInputCloud(), pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setNormalEstimationMethod(), pcl::IntegralImageNormalEstimation< PointInT, PointOutT >::setNormalSmoothingSize(), and pcl::Feature< PointInT, PointOutT >::setRadiusSearch().
| inline |
Set the decision boundary (angle threshold) that marks points as boundary or regular.
(default )
[in] | angle | the angle threshold |
Definition at line 193 of file iss_3d.h.
References pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::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.
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.
void pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setNonMaxRadius | ( | double | non_max_radius | ) |
Set the radius for the application of the non maxima supression algorithm.
[in] | non_max_radius | the non maxima suppression radius |
Definition at line 57 of file iss_3d.hpp.
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.
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.
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.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::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.
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.
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.
| protected |
The decision boundary (angle threshold) that marks points as boundary or regular.
(default )
Definition at line 266 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::setAngleThreshold().
| protected |
| protected |
Store the information about the boundary points of the input cloud.
Definition at line 257 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::~ISSKeypoint3D().
| protected |
| protected |
| protected |
| protected |
| protected |
| protected |
| protected |
The radius of the spherical neighborhood used to compute the scatter matrix.
Definition at line 236 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::ISSKeypoint3D().
| protected |
Store the third eigen value associated to each point in the input cloud.
Definition at line 254 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::~ISSKeypoint3D().
| protected |
The number of threads that has to be used by the scheduler.
Definition at line 269 of file iss_3d.h.
Referenced by pcl::ISSKeypoint3D< PointInT, PointOutT, NormalT >::ISSKeypoint3D().
© 2009–2012, Willow Garage, Inc.
© 2012–, Open Perception, Inc.
Licensed under the BSD License.
https://pointclouds.org/documentation/classpcl_1_1_i_s_s_keypoint3_d.html