CorrespondenceRejectorPoly implements a correspondence rejection method that exploits low-level and pose-invariant geometric constraints between two point sets by forming virtual polygons of a user-specifiable cardinality on each model using the input correspondences. More...
#include <pcl/registration/correspondence_rejection_poly.h>
Public Types | |
using | Ptr = shared_ptr< CorrespondenceRejectorPoly< SourceT, TargetT > > |
using | ConstPtr = shared_ptr< const CorrespondenceRejectorPoly< SourceT, TargetT > > |
using | PointCloudSource = pcl::PointCloud< SourceT > |
using | PointCloudSourcePtr = typename PointCloudSource::Ptr |
using | PointCloudSourceConstPtr = typename PointCloudSource::ConstPtr |
using | PointCloudTarget = pcl::PointCloud< TargetT > |
using | PointCloudTargetPtr = typename PointCloudTarget::Ptr |
using | PointCloudTargetConstPtr = typename PointCloudTarget::ConstPtr |
Public Types inherited from pcl::registration::CorrespondenceRejector | |
using | Ptr = shared_ptr< CorrespondenceRejector > |
using | ConstPtr = shared_ptr< const CorrespondenceRejector > |
Public Member Functions | |
CorrespondenceRejectorPoly () | |
Empty constructor. More... |
|
void | getRemainingCorrespondences (const pcl::Correspondences &original_correspondences, pcl::Correspondences &remaining_correspondences) override |
Get a list of valid correspondences after rejection from the original set of correspondences. More... |
|
void | setInputSource (const PointCloudSourceConstPtr &cloud) |
Provide a source point cloud dataset (must contain XYZ data!), used to compute the correspondence distance. More... |
|
void | setInputTarget (const PointCloudTargetConstPtr &target) |
Provide a target point cloud dataset (must contain XYZ data!), used to compute the correspondence distance. More... |
|
bool | requiresSourcePoints () const override |
See if this rejector requires source points. More... |
|
void | setSourcePoints (pcl::PCLPointCloud2::ConstPtr cloud2) override |
Blob method for setting the source cloud. More... |
|
bool | requiresTargetPoints () const override |
See if this rejector requires a target cloud. More... |
|
void | setTargetPoints (pcl::PCLPointCloud2::ConstPtr cloud2) override |
Method for setting the target cloud. More... |
|
void | setCardinality (int cardinality) |
Set the polygon cardinality. More... |
|
int | getCardinality () |
Get the polygon cardinality. More... |
|
void | setSimilarityThreshold (float similarity_threshold) |
Set the similarity threshold in [0,1[ between edge lengths, where 1 is a perfect match. More... |
|
float | getSimilarityThreshold () |
Get the similarity threshold between edge lengths. More... |
|
void | setIterations (int iterations) |
Set the number of iterations. More... |
|
int | getIterations () |
Get the number of iterations. More... |
|
bool | thresholdPolygon (const pcl::Correspondences &corr, const std::vector< int > &idx) |
Polygonal rejection of a single polygon, indexed by a subset of correspondences. More... |
|
bool | thresholdPolygon (const pcl::Indices &source_indices, const pcl::Indices &target_indices) |
Polygonal rejection of a single polygon, indexed by two point index vectors. More... |
|
Public Member Functions inherited from pcl::registration::CorrespondenceRejector | |
CorrespondenceRejector () | |
Empty constructor. More... |
|
virtual | ~CorrespondenceRejector () |
Empty destructor. More... |
|
virtual void | setInputCorrespondences (const CorrespondencesConstPtr &correspondences) |
Provide a pointer to the vector of the input correspondences. More... |
|
CorrespondencesConstPtr | getInputCorrespondences () |
Get a pointer to the vector of the input correspondences. More... |
|
void | getCorrespondences (pcl::Correspondences &correspondences) |
Run correspondence rejection. More... |
|
void | getRejectedQueryIndices (const pcl::Correspondences &correspondences, pcl::Indices &indices) |
Determine the indices of query points of correspondences that have been rejected, i.e., the difference between the input correspondences (set via setInputCorrespondences) and the given correspondence vector. More... |
|
const std::string & | getClassName () const |
Get a string representation of the name of this class. More... |
|
virtual bool | requiresSourceNormals () const |
See if this rejector requires source normals. More... |
|
virtual void | setSourceNormals (pcl::PCLPointCloud2::ConstPtr) |
Abstract method for setting the source normals. More... |
|
virtual bool | requiresTargetNormals () const |
See if this rejector requires target normals. More... |
|
virtual void | setTargetNormals (pcl::PCLPointCloud2::ConstPtr) |
Abstract method for setting the target normals. More... |
|
Protected Member Functions | |
void | applyRejection (pcl::Correspondences &correspondences) override |
Apply the rejection algorithm. More... |
|
std::vector< int > | getUniqueRandomIndices (int n, int k) |
Get k unique random indices in range {0,...,n-1} (sampling without replacement) More... |
|
float | computeSquaredDistance (const SourceT &p1, const TargetT &p2) |
Squared Euclidean distance between two points using the members x, y and z. More... |
|
bool | thresholdEdgeLength (int index_query_1, int index_query_2, int index_match_1, int index_match_2, float simsq) |
Edge length similarity thresholding. More... |
|
std::vector< int > | computeHistogram (const std::vector< float > &data, float lower, float upper, int bins) |
Compute a linear histogram. More... |
|
int | findThresholdOtsu (const std::vector< int > &histogram) |
Find the optimal value for binary histogram thresholding using Otsu's method. More... |
|
Protected Attributes | |
PointCloudSourceConstPtr | input_ |
The input point cloud dataset. More... |
|
PointCloudTargetConstPtr | target_ |
The input point cloud dataset target. More... |
|
int | iterations_ |
Number of iterations to run. More... |
|
int | cardinality_ |
The polygon cardinality used during rejection. More... |
|
float | similarity_threshold_ |
Lower edge length threshold in [0,1] used for verifying polygon similarities, where 1 is a perfect match. More... |
|
float | similarity_threshold_squared_ |
Squared value if similarity_threshold_, only for internal use. More... |
|
Protected Attributes inherited from pcl::registration::CorrespondenceRejector | |
std::string | rejection_name_ |
The name of the rejection method. More... |
|
CorrespondencesConstPtr | input_correspondences_ |
The input correspondences. More... |
|
CorrespondenceRejectorPoly implements a correspondence rejection method that exploits low-level and pose-invariant geometric constraints between two point sets by forming virtual polygons of a user-specifiable cardinality on each model using the input correspondences.
These polygons are then checked in a pose-invariant manner (i.e. the side lengths must be approximately equal), and rejection is performed by thresholding these edge lengths.
If you use this in academic work, please cite:
A. G. Buch, D. Kraft, J.-K. Kämäräinen, H. G. Petersen and N. Krüger. Pose Estimation using Local Structure-Specific Shape and Appearance Context. International Conference on Robotics and Automation (ICRA), 2013.
Definition at line 63 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::ConstPtr = shared_ptr<const CorrespondenceRejectorPoly<SourceT, TargetT> > |
Definition at line 70 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::PointCloudSource = pcl::PointCloud<SourceT> |
Definition at line 72 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::PointCloudSourceConstPtr = typename PointCloudSource::ConstPtr |
Definition at line 74 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::PointCloudSourcePtr = typename PointCloudSource::Ptr |
Definition at line 73 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::PointCloudTarget = pcl::PointCloud<TargetT> |
Definition at line 76 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::PointCloudTargetConstPtr = typename PointCloudTarget::ConstPtr |
Definition at line 78 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::PointCloudTargetPtr = typename PointCloudTarget::Ptr |
Definition at line 77 of file correspondence_rejection_poly.h.
using pcl::registration::CorrespondenceRejectorPoly< SourceT, TargetT >::Ptr = shared_ptr<CorrespondenceRejectorPoly<SourceT, TargetT> > |
Definition at line 69 of file correspondence_rejection_poly.h.
| inline |
Empty constructor.
Definition at line 81 of file correspondence_rejection_poly.h.
| inlineoverrideprotectedvirtual |
Apply the rejection algorithm.
[out] | correspondences | the set of resultant correspondences. |
Implements pcl::registration::CorrespondenceRejector.
Definition at line 263 of file correspondence_rejection_poly.h.
| protected |
Compute a linear histogram.
This function is equivalent to the MATLAB function histc, with the edges set as follows: lower:(upper-lower)/bins:upper
data | input samples |
lower | lower bound of input samples |
upper | upper bound of input samples |
bins | number of bins in output |
Definition at line 158 of file correspondence_rejection_poly.hpp.
| inlineprotected |
Squared Euclidean distance between two points using the members x, y and z.
p1 | first point |
p2 | second point |
Definition at line 304 of file correspondence_rejection_poly.h.
| protected |
Find the optimal value for binary histogram thresholding using Otsu's method.
histogram | input histogram |
Definition at line 177 of file correspondence_rejection_poly.hpp.
| inline |
Get the polygon cardinality.
Definition at line 162 of file correspondence_rejection_poly.h.
| inline |
Get the number of iterations.
Definition at line 200 of file correspondence_rejection_poly.h.
| overridevirtual |
Get a list of valid correspondences after rejection from the original set of correspondences.
[in] | original_correspondences | the set of initial correspondences given |
[out] | remaining_correspondences | the resultant filtered set of remaining correspondences |
Implements pcl::registration::CorrespondenceRejector.
Definition at line 48 of file correspondence_rejection_poly.hpp.
| inline |
Get the similarity threshold between edge lengths.
Definition at line 182 of file correspondence_rejection_poly.h.
| inlineprotected |
Get k unique random indices in range {0,...,n-1} (sampling without replacement)
n | upper index range, exclusive |
k | number of unique indices to sample |
Definition at line 274 of file correspondence_rejection_poly.h.
| inlineoverridevirtual |
See if this rejector requires source points.
Reimplemented from pcl::registration::CorrespondenceRejector.
Definition at line 119 of file correspondence_rejection_poly.h.
| inlineoverridevirtual |
See if this rejector requires a target cloud.
Reimplemented from pcl::registration::CorrespondenceRejector.
Definition at line 135 of file correspondence_rejection_poly.h.
| inline |
Set the polygon cardinality.
cardinality | polygon cardinality |
Definition at line 153 of file correspondence_rejection_poly.h.
| inline |
Provide a source point cloud dataset (must contain XYZ data!), used to compute the correspondence distance.
[in] | cloud | a cloud containing XYZ data |
Definition at line 103 of file correspondence_rejection_poly.h.
| inline |
Provide a target point cloud dataset (must contain XYZ data!), used to compute the correspondence distance.
[in] | target | a cloud containing XYZ data |
Definition at line 112 of file correspondence_rejection_poly.h.
| inline |
Set the number of iterations.
iterations | number of iterations |
Definition at line 191 of file correspondence_rejection_poly.h.
| inline |
Set the similarity threshold in [0,1[ between edge lengths, where 1 is a perfect match.
similarity_threshold | similarity threshold |
Definition at line 172 of file correspondence_rejection_poly.h.
| inlineoverridevirtual |
Blob method for setting the source cloud.
Reimplemented from pcl::registration::CorrespondenceRejector.
Definition at line 126 of file correspondence_rejection_poly.h.
References pcl::fromPCLPointCloud2().
| inlineoverridevirtual |
Method for setting the target cloud.
Reimplemented from pcl::registration::CorrespondenceRejector.
Definition at line 142 of file correspondence_rejection_poly.h.
References pcl::fromPCLPointCloud2().
| inlineprotected |
Edge length similarity thresholding.
index_query_1 | index of first source vertex |
index_query_2 | index of second source vertex |
index_match_1 | index of first target vertex |
index_match_2 | index of second target vertex |
simsq | squared similarity threshold in [0,1] |
Definition at line 322 of file correspondence_rejection_poly.h.
| inline |
Polygonal rejection of a single polygon, indexed by a subset of correspondences.
corr | all correspondences into input_ and target_ |
idx | sampled indices into correspondences, must have a size equal to cardinality_ |
Definition at line 212 of file correspondence_rejection_poly.h.
| inline |
Polygonal rejection of a single polygon, indexed by two point index vectors.
source_indices | indices of polygon points in input_, must have a size equal to cardinality_ |
target_indices | corresponding indices of polygon points in target_, must have a size equal to cardinality_ |
Definition at line 243 of file correspondence_rejection_poly.h.
| protected |
The polygon cardinality used during rejection.
Definition at line 367 of file correspondence_rejection_poly.h.
| protected |
The input point cloud dataset.
Definition at line 358 of file correspondence_rejection_poly.h.
| protected |
Number of iterations to run.
Definition at line 364 of file correspondence_rejection_poly.h.
| protected |
Lower edge length threshold in [0,1] used for verifying polygon similarities, where 1 is a perfect match.
Definition at line 371 of file correspondence_rejection_poly.h.
| protected |
Squared value if similarity_threshold_, only for internal use.
Definition at line 374 of file correspondence_rejection_poly.h.
| protected |
The input point cloud dataset target.
Definition at line 361 of file correspondence_rejection_poly.h.
© 2009–2012, Willow Garage, Inc.
© 2012–, Open Perception, Inc.
Licensed under the BSD License.
https://pointclouds.org/documentation/classpcl_1_1registration_1_1_correspondence_rejector_poly.html