Point Cloud Library (PCL)  1.8.1-dev
List of all members | Public Types | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes
pcl::registration::CorrespondenceRejectorDistance Class Reference

CorrespondenceRejectorDistance implements a simple correspondence rejection method based on thresholding the distances between the correspondences. More...

#include <pcl/registration/correspondence_rejection_distance.h>

+ Inheritance diagram for pcl::registration::CorrespondenceRejectorDistance:

Public Types

typedef boost::shared_ptr
< CorrespondenceRejectorDistance
Ptr
 
typedef boost::shared_ptr
< const
CorrespondenceRejectorDistance
ConstPtr
 
- Public Types inherited from pcl::registration::CorrespondenceRejector
typedef boost::shared_ptr
< CorrespondenceRejector
Ptr
 
typedef boost::shared_ptr
< const CorrespondenceRejector
ConstPtr
 

Public Member Functions

 CorrespondenceRejectorDistance ()
 Empty constructor. More...
 
virtual ~CorrespondenceRejectorDistance ()
 Empty destructor. More...
 
void getRemainingCorrespondences (const pcl::Correspondences &original_correspondences, pcl::Correspondences &remaining_correspondences)
 Get a list of valid correspondences after rejection from the original set of correspondences. More...
 
virtual void setMaximumDistance (float distance)
 Set the maximum distance used for thresholding in correspondence rejection. More...
 
float getMaximumDistance ()
 Get the maximum distance used for thresholding in correspondence rejection. More...
 
template<typename PointT >
void setInputCloud (const typename pcl::PointCloud< PointT >::ConstPtr &cloud)
 Provide a source point cloud dataset (must contain XYZ data!), used to compute the correspondence distance. More...
 
template<typename PointT >
void setInputSource (const typename pcl::PointCloud< PointT >::ConstPtr &cloud)
 Provide a source point cloud dataset (must contain XYZ data!), used to compute the correspondence distance. More...
 
template<typename PointT >
void setInputTarget (const typename pcl::PointCloud< PointT >::ConstPtr &target)
 Provide a target point cloud dataset (must contain XYZ data!), used to compute the correspondence distance. More...
 
bool requiresSourcePoints () const
 See if this rejector requires source points. More...
 
void setSourcePoints (pcl::PCLPointCloud2::ConstPtr cloud2)
 Blob method for setting the source cloud. More...
 
bool requiresTargetPoints () const
 See if this rejector requires a target cloud. More...
 
void setTargetPoints (pcl::PCLPointCloud2::ConstPtr cloud2)
 Method for setting the target cloud. More...
 
template<typename PointT >
void setSearchMethodTarget (const boost::shared_ptr< pcl::search::KdTree< PointT > > &tree, bool force_no_recompute=false)
 Provide a pointer to the search object used to find correspondences in the target cloud. 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, std::vector< int > &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 Types

typedef boost::shared_ptr
< DataContainerInterface
DataContainerPtr
 

Protected Member Functions

void applyRejection (pcl::Correspondences &correspondences)
 Apply the rejection algorithm. More...
 

Protected Attributes

float max_distance_
 The maximum distance threshold between two correspondent points in source <-> target. More...
 
DataContainerPtr data_container_
 A pointer to the DataContainer object containing the input and target point clouds. 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...
 

Detailed Description

CorrespondenceRejectorDistance implements a simple correspondence rejection method based on thresholding the distances between the correspondences.

Note
If setInputCloud and setInputTarget are given, then the distances between correspondences will be estimated using the given XYZ data, and not read from the set of input correspondences.
Author
Dirk Holz, Radu B. Rusu

Definition at line 61 of file correspondence_rejection_distance.h.

Member Typedef Documentation

Definition at line 69 of file correspondence_rejection_distance.h.

Definition at line 199 of file correspondence_rejection_distance.h.

Definition at line 68 of file correspondence_rejection_distance.h.

Constructor & Destructor Documentation

pcl::registration::CorrespondenceRejectorDistance::CorrespondenceRejectorDistance ( )
inline

Empty constructor.

Definition at line 72 of file correspondence_rejection_distance.h.

virtual pcl::registration::CorrespondenceRejectorDistance::~CorrespondenceRejectorDistance ( )
inlinevirtual

Empty destructor.

Definition at line 79 of file correspondence_rejection_distance.h.

Member Function Documentation

void pcl::registration::CorrespondenceRejectorDistance::applyRejection ( pcl::Correspondences correspondences)
inlineprotectedvirtual

Apply the rejection algorithm.

Parameters
[out]correspondencesthe set of resultant correspondences.

Implements pcl::registration::CorrespondenceRejector.

Definition at line 189 of file correspondence_rejection_distance.h.

float pcl::registration::CorrespondenceRejectorDistance::getMaximumDistance ( )
inline

Get the maximum distance used for thresholding in correspondence rejection.

Definition at line 99 of file correspondence_rejection_distance.h.

void pcl::registration::CorrespondenceRejectorDistance::getRemainingCorrespondences ( const pcl::Correspondences original_correspondences,
pcl::Correspondences remaining_correspondences 
)
virtual

Get a list of valid correspondences after rejection from the original set of correspondences.

Parameters
[in]original_correspondencesthe set of initial correspondences given
[out]remaining_correspondencesthe resultant filtered set of remaining correspondences

Implements pcl::registration::CorrespondenceRejector.

bool pcl::registration::CorrespondenceRejectorDistance::requiresSourcePoints ( ) const
inlinevirtual

See if this rejector requires source points.

Reimplemented from pcl::registration::CorrespondenceRejector.

Definition at line 141 of file correspondence_rejection_distance.h.

bool pcl::registration::CorrespondenceRejectorDistance::requiresTargetPoints ( ) const
inlinevirtual

See if this rejector requires a target cloud.

Reimplemented from pcl::registration::CorrespondenceRejector.

Definition at line 155 of file correspondence_rejection_distance.h.

template<typename PointT >
void pcl::registration::CorrespondenceRejectorDistance::setInputCloud ( const typename pcl::PointCloud< PointT >::ConstPtr cloud)
inline

Provide a source point cloud dataset (must contain XYZ data!), used to compute the correspondence distance.

Parameters
[in]clouda cloud containing XYZ data

Definition at line 106 of file correspondence_rejection_distance.h.

template<typename PointT >
void pcl::registration::CorrespondenceRejectorDistance::setInputSource ( const typename pcl::PointCloud< PointT >::ConstPtr cloud)
inline

Provide a source point cloud dataset (must contain XYZ data!), used to compute the correspondence distance.

Parameters
[in]clouda cloud containing XYZ data

Definition at line 119 of file correspondence_rejection_distance.h.

template<typename PointT >
void pcl::registration::CorrespondenceRejectorDistance::setInputTarget ( const typename pcl::PointCloud< PointT >::ConstPtr target)
inline

Provide a target point cloud dataset (must contain XYZ data!), used to compute the correspondence distance.

Parameters
[in]targeta cloud containing XYZ data

Definition at line 131 of file correspondence_rejection_distance.h.

virtual void pcl::registration::CorrespondenceRejectorDistance::setMaximumDistance ( float  distance)
inlinevirtual

Set the maximum distance used for thresholding in correspondence rejection.

Parameters
[in]distanceDistance to be used as maximum distance between correspondences. Correspondences with larger distances are rejected.
Note
Internally, the distance will be stored squared.

Definition at line 95 of file correspondence_rejection_distance.h.

template<typename PointT >
void pcl::registration::CorrespondenceRejectorDistance::setSearchMethodTarget ( const boost::shared_ptr< pcl::search::KdTree< PointT > > &  tree,
bool  force_no_recompute = false 
)
inline

Provide a pointer to the search object used to find correspondences in the target cloud.

Parameters
[in]treea pointer to the spatial search object.
[in]force_no_recomputeIf set to true, this tree will NEVER be recomputed, regardless of calls to setInputTarget. Only use if you are confident that the tree will be set correctly.

Definition at line 175 of file correspondence_rejection_distance.h.

void pcl::registration::CorrespondenceRejectorDistance::setSourcePoints ( pcl::PCLPointCloud2::ConstPtr  cloud2)
inlinevirtual

Blob method for setting the source cloud.

Reimplemented from pcl::registration::CorrespondenceRejector.

Definition at line 146 of file correspondence_rejection_distance.h.

References pcl::fromPCLPointCloud2().

void pcl::registration::CorrespondenceRejectorDistance::setTargetPoints ( pcl::PCLPointCloud2::ConstPtr  cloud2)
inlinevirtual

Method for setting the target cloud.

Reimplemented from pcl::registration::CorrespondenceRejector.

Definition at line 160 of file correspondence_rejection_distance.h.

References pcl::fromPCLPointCloud2().

Member Data Documentation

DataContainerPtr pcl::registration::CorrespondenceRejectorDistance::data_container_
protected

A pointer to the DataContainer object containing the input and target point clouds.

Definition at line 202 of file correspondence_rejection_distance.h.

float pcl::registration::CorrespondenceRejectorDistance::max_distance_
protected

The maximum distance threshold between two correspondent points in source <-> target.

If the distance is larger than this threshold, the points will not be ignored in the alignment process.

Definition at line 197 of file correspondence_rejection_distance.h.


The documentation for this class was generated from the following file: