Point Cloud Library (PCL)
1.14.1-dev
|
UniqueShapeContext implements the Unique Shape Context Descriptor described here: More...
#include <pcl/features/usc.h>
Public Member Functions | |
UniqueShapeContext () | |
Constructor. More... | |
~UniqueShapeContext () override=default | |
std::size_t | getAzimuthBins () const |
std::size_t | getElevationBins () const |
std::size_t | getRadiusBins () const |
void | setMinimalRadius (double radius) |
The minimal radius value for the search sphere (rmin) in the original paper. More... | |
double | getMinimalRadius () const |
void | setPointDensityRadius (double radius) |
This radius is used to compute local point density density = number of points within this radius. More... | |
double | getPointDensityRadius () const |
void | setLocalRadius (double radius) |
Set the local RF radius value. More... | |
double | getLocalRadius () const |
Public Member Functions inherited from pcl::Feature< PointInT, pcl::UniqueShapeContext1960 > | |
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... | |
Public Member Functions inherited from pcl::FeatureWithLocalReferenceFrames< PointInT, pcl::ReferenceFrame > | |
FeatureWithLocalReferenceFrames () | |
Empty constructor. More... | |
virtual | ~FeatureWithLocalReferenceFrames ()=default |
Default virtual destructor. More... | |
void | setInputReferenceFrames (const PointCloudLRFConstPtr &frames) |
Provide a pointer to the input dataset that contains the local reference frames of the XYZ dataset. More... | |
PointCloudLRFConstPtr | getInputReferenceFrames () const |
Get a pointer to the local reference frames. More... | |
Protected Member Functions | |
void | computePointDescriptor (std::size_t index, std::vector< float > &desc) |
Compute 3D shape context feature descriptor. More... | |
bool | initCompute () override |
Initialize computation by allocating all the intervals and the volume lookup table. More... | |
void | computeFeature (PointCloudOut &output) override |
The actual feature computation. More... | |
Protected Member Functions inherited from pcl::Feature< PointInT, pcl::UniqueShapeContext1960 > | |
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... | |
Protected Member Functions inherited from pcl::FeatureWithLocalReferenceFrames< PointInT, pcl::ReferenceFrame > | |
virtual bool | initLocalReferenceFrames (const std::size_t &indices_size, const LRFEstimationPtr &lrf_estimation=LRFEstimationPtr()) |
Protected Attributes | |
std::vector< float > | radii_interval_ |
values of the radii interval. More... | |
std::vector< float > | theta_divisions_ |
Theta divisions interval. More... | |
std::vector< float > | phi_divisions_ |
Phi divisions interval. More... | |
std::vector< float > | volume_lut_ |
Volumes look up table. More... | |
std::size_t | azimuth_bins_ {14} |
Bins along the azimuth dimension. More... | |
std::size_t | elevation_bins_ {14} |
Bins along the elevation dimension. More... | |
std::size_t | radius_bins_ {10} |
Bins along the radius dimension. More... | |
double | min_radius_ {0.1} |
Minimal radius value. More... | |
double | point_density_radius_ {0.1} |
Point density radius. More... | |
std::size_t | descriptor_length_ {} |
Descriptor length. More... | |
double | local_radius_ {2.0} |
Radius to compute local RF. More... | |
Protected Attributes inherited from pcl::Feature< PointInT, pcl::UniqueShapeContext1960 > | |
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... | |
Protected Attributes inherited from pcl::FeatureWithLocalReferenceFrames< PointInT, pcl::ReferenceFrame > | |
PointCloudLRFConstPtr | frames_ |
A boost shared pointer to the local reference frames. More... | |
bool | frames_never_defined_ |
The user has never set the frames. More... | |
Additional Inherited Members | |
Protected Types inherited from pcl::FeatureWithLocalReferenceFrames< PointInT, pcl::ReferenceFrame > | |
using | LRFEstimationPtr = typename Feature< PointInT, pcl::ReferenceFrame >::Ptr |
Check if frames_ has been correctly initialized and compute it if needed. More... | |
UniqueShapeContext implements the Unique Shape Context Descriptor described here:
The suggested PointOutT is pcl::UniqueShapeContext1960
using pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::ConstPtr = shared_ptr<const UniqueShapeContext<PointInT, PointOutT, PointRFT> > |
using pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::PointCloudIn = typename Feature<PointInT, PointOutT>::PointCloudIn |
using pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::PointCloudOut = typename Feature<PointInT, PointOutT>::PointCloudOut |
using pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::Ptr = shared_ptr<UniqueShapeContext<PointInT, PointOutT, PointRFT> > |
|
inline |
Constructor.
Definition at line 85 of file usc.h.
References pcl::Feature< PointInT, pcl::UniqueShapeContext1960 >::feature_name_, and pcl::Feature< PointInT, pcl::UniqueShapeContext1960 >::search_radius_.
|
overridedefault |
|
overrideprotected |
The actual feature computation.
[out] | output | the resultant features |
Definition at line 226 of file usc.hpp.
References pcl::isFinite().
|
protected |
Compute 3D shape context feature descriptor.
[in] | index | point index in input_ |
[out] | desc | descriptor to compute |
Compute the angle between the neighbour and the z axis (normal) in the interval [0, 180]
Compute the Bin(j, k, l) coordinates of current neighbour
Bin (j, k, l)
Local point density = number of points in a sphere of radius "point_density_radius_" around the current neighbour
point_density is always bigger than 0 because FindPointsWithinRadius returns at least the point itself
Accumulate w into correspondent Bin(j,k,l)
Definition at line 146 of file usc.hpp.
References pcl::geometry::distance(), pcl::utils::equal(), pcl::geometry::project(), and pcl::rad2deg().
|
inline |
Definition at line 96 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::azimuth_bins_.
|
inline |
Definition at line 100 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::elevation_bins_.
|
inline |
Definition at line 135 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::local_radius_.
|
inline |
Definition at line 114 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::min_radius_.
|
inline |
Definition at line 125 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::point_density_radius_.
|
inline |
Definition at line 104 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::radius_bins_.
|
overrideprotectedvirtual |
Initialize computation by allocating all the intervals and the volume lookup table.
Reimplemented from pcl::Feature< PointInT, pcl::UniqueShapeContext1960 >.
Definition at line 54 of file usc.hpp.
References pcl::deg2rad(), pcl::PCLBase< PointT >::setIndices(), pcl::PCLBase< PointT >::setInputCloud(), pcl::Feature< PointInT, PointOutT >::setRadiusSearch(), and pcl::Feature< PointInT, PointOutT >::setSearchSurface().
|
inline |
Set the local RF radius value.
[in] | radius | the desired local RF radius |
Definition at line 131 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::local_radius_.
|
inline |
The minimal radius value for the search sphere (rmin) in the original paper.
[in] | radius | the desired minimal radius |
Definition at line 110 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::min_radius_.
|
inline |
This radius is used to compute local point density density = number of points within this radius.
[in] | radius | Value of the point density search radius |
Definition at line 121 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::point_density_radius_.
|
protected |
Bins along the azimuth dimension.
Definition at line 168 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getAzimuthBins().
|
protected |
|
protected |
Bins along the elevation dimension.
Definition at line 171 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getElevationBins().
|
protected |
Radius to compute local RF.
Definition at line 186 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getLocalRadius(), and pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::setLocalRadius().
|
protected |
Minimal radius value.
Definition at line 177 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getMinimalRadius(), and pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::setMinimalRadius().
|
protected |
|
protected |
Point density radius.
Definition at line 180 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getPointDensityRadius(), and pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::setPointDensityRadius().
|
protected |
|
protected |
Bins along the radius dimension.
Definition at line 174 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getRadiusBins().
|
protected |
|
protected |