UniqueShapeContext implements the Unique Shape Context Descriptor described here: More...
#include <pcl/features/usc.h>
Public Member Functions | |
UniqueShapeContext () | |
Constructor. More... |
|
~UniqueShapeContext () | |
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... |
|
virtual | ~Feature () |
Empty destructor. 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... |
|
const PointCloudConstPtr | 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... |
|
const IndicesConstPtr | 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 () |
Empty 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_ |
Bins along the azimuth dimension. More... |
|
std::size_t | elevation_bins_ |
Bins along the elevation dimension. More... |
|
std::size_t | radius_bins_ |
Bins along the radius dimension. More... |
|
double | min_radius_ |
Minimal radius value. More... |
|
double | point_density_radius_ |
Point density radius. More... |
|
std::size_t | descriptor_length_ |
Descriptor length. More... |
|
double | local_radius_ |
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_.
| inline |
| 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 98 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::azimuth_bins_.
| inline |
Definition at line 102 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::elevation_bins_.
| inline |
Definition at line 137 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::local_radius_.
| inline |
Definition at line 116 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::min_radius_.
| inline |
Definition at line 127 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::point_density_radius_.
| inline |
Definition at line 106 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< PointInT >::setIndices(), pcl::PCLBase< PointInT >::setInputCloud(), pcl::Feature< PointInT, ReferenceFrame >::setRadiusSearch(), and pcl::Feature< PointInT, ReferenceFrame >::setSearchSurface().
| inline |
Set the local RF radius value.
[in] | radius | the desired local RF radius |
Definition at line 133 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 112 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 123 of file usc.h.
References pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::point_density_radius_.
| protected |
Bins along the azimuth dimension.
Definition at line 170 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getAzimuthBins().
| protected |
| protected |
Bins along the elevation dimension.
Definition at line 173 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getElevationBins().
| protected |
Radius to compute local RF.
Definition at line 188 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 179 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 182 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 176 of file usc.h.
Referenced by pcl::UniqueShapeContext< PointInT, PointOutT, PointRFT >::getRadiusBins().
| protected |
| protected |
© 2009–2012, Willow Garage, Inc.
© 2012–, Open Perception, Inc.
Licensed under the BSD License.
https://pointclouds.org/documentation/classpcl_1_1_unique_shape_context.html