Point Cloud Library (PCL)  1.14.1-dev
List of all members | Public Types | Public Member Functions | Protected Attributes
pcl::ProgressiveMorphologicalFilter< PointT > Class Template Reference

Implements the Progressive Morphological Filter for segmentation of ground points. More...

#include <pcl/segmentation/progressive_morphological_filter.h>

+ Inheritance diagram for pcl::ProgressiveMorphologicalFilter< PointT >:
+ Collaboration diagram for pcl::ProgressiveMorphologicalFilter< PointT >:

Public Types

using PointCloud = pcl::PointCloud< PointT >
 
- Public Types inherited from pcl::PCLBase< PointT >
using PointCloud = pcl::PointCloud< PointT >
 
using PointCloudPtr = typename PointCloud::Ptr
 
using PointCloudConstPtr = typename PointCloud::ConstPtr
 
using PointIndicesPtr = PointIndices::Ptr
 
using PointIndicesConstPtr = PointIndices::ConstPtr
 

Public Member Functions

 ProgressiveMorphologicalFilter ()
 Constructor that sets default values for member variables. More...
 
 ~ProgressiveMorphologicalFilter () override
 
int getMaxWindowSize () const
 Get the maximum window size to be used in filtering ground returns. More...
 
void setMaxWindowSize (int max_window_size)
 Set the maximum window size to be used in filtering ground returns. More...
 
float getSlope () const
 Get the slope value to be used in computing the height threshold. More...
 
void setSlope (float slope)
 Set the slope value to be used in computing the height threshold. More...
 
float getMaxDistance () const
 Get the maximum height above the parameterized ground surface to be considered a ground return. More...
 
void setMaxDistance (float max_distance)
 Set the maximum height above the parameterized ground surface to be considered a ground return. More...
 
float getInitialDistance () const
 Get the initial height above the parameterized ground surface to be considered a ground return. More...
 
void setInitialDistance (float initial_distance)
 Set the initial height above the parameterized ground surface to be considered a ground return. More...
 
float getCellSize () const
 Get the cell size. More...
 
void setCellSize (float cell_size)
 Set the cell size. More...
 
float getBase () const
 Get the base to be used in computing progressive window sizes. More...
 
void setBase (float base)
 Set the base to be used in computing progressive window sizes. More...
 
bool getExponential () const
 Get flag indicating whether or not to exponentially grow window sizes? More...
 
void setExponential (bool exponential)
 Set flag indicating whether or not to exponentially grow window sizes? More...
 
virtual void extract (Indices &ground)
 This method launches the segmentation algorithm and returns indices of points determined to be ground returns. More...
 
- Public Member Functions inherited from pcl::PCLBase< PointT >
 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 PointToperator[] (std::size_t pos) const
 Override PointCloud operator[] to shorten code. More...
 

Protected Attributes

int max_window_size_ {33}
 Maximum window size to be used in filtering ground returns. More...
 
float slope_ {0.7f}
 Slope value to be used in computing the height threshold. More...
 
float max_distance_ {10.0f}
 Maximum height above the parameterized ground surface to be considered a ground return. More...
 
float initial_distance_ {0.15f}
 Initial height above the parameterized ground surface to be considered a ground return. More...
 
float cell_size_ {1.0f}
 Cell size. More...
 
float base_ {2.0f}
 Base to be used in computing progressive window sizes. More...
 
bool exponential_ {true}
 Exponentially grow window sizes? More...
 
- Protected Attributes inherited from pcl::PCLBase< PointT >
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...
 

Additional Inherited Members

- Protected Member Functions inherited from pcl::PCLBase< PointT >
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...
 

Detailed Description

template<typename PointT>
class pcl::ProgressiveMorphologicalFilter< PointT >

Implements the Progressive Morphological Filter for segmentation of ground points.

Description can be found in the article "A Progressive Morphological Filter for Removing Nonground Measurements from Airborne LIDAR Data" by K. Zhang, S. Chen, D. Whitman, M. Shyu, J. Yan, and C. Zhang.

Definition at line 55 of file progressive_morphological_filter.h.

Member Typedef Documentation

◆ PointCloud

Definition at line 59 of file progressive_morphological_filter.h.

Constructor & Destructor Documentation

◆ ProgressiveMorphologicalFilter()

Constructor that sets default values for member variables.

◆ ~ProgressiveMorphologicalFilter()

template<typename PointT >
pcl::ProgressiveMorphologicalFilter< PointT >::~ProgressiveMorphologicalFilter ( )
overridedefault

Member Function Documentation

◆ extract()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::extract ( Indices ground)
virtual

This method launches the segmentation algorithm and returns indices of points determined to be ground returns.

Parameters
[out]groundindices of points determined to be ground returns.

Definition at line 59 of file progressive_morphological_filter.hpp.

References pcl::MORPH_OPEN.

◆ getBase()

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::getBase ( ) const
inline

Get the base to be used in computing progressive window sizes.

Definition at line 116 of file progressive_morphological_filter.h.

◆ getCellSize()

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::getCellSize ( ) const
inline

Get the cell size.

Definition at line 108 of file progressive_morphological_filter.h.

◆ getExponential()

template<typename PointT >
bool pcl::ProgressiveMorphologicalFilter< PointT >::getExponential ( ) const
inline

Get flag indicating whether or not to exponentially grow window sizes?

Definition at line 124 of file progressive_morphological_filter.h.

◆ getInitialDistance()

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::getInitialDistance ( ) const
inline

Get the initial height above the parameterized ground surface to be considered a ground return.

Definition at line 100 of file progressive_morphological_filter.h.

◆ getMaxDistance()

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::getMaxDistance ( ) const
inline

Get the maximum height above the parameterized ground surface to be considered a ground return.

Definition at line 92 of file progressive_morphological_filter.h.

◆ getMaxWindowSize()

template<typename PointT >
int pcl::ProgressiveMorphologicalFilter< PointT >::getMaxWindowSize ( ) const
inline

Get the maximum window size to be used in filtering ground returns.

Definition at line 76 of file progressive_morphological_filter.h.

◆ getSlope()

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::getSlope ( ) const
inline

Get the slope value to be used in computing the height threshold.

Definition at line 84 of file progressive_morphological_filter.h.

◆ setBase()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setBase ( float  base)
inline

Set the base to be used in computing progressive window sizes.

Definition at line 120 of file progressive_morphological_filter.h.

◆ setCellSize()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setCellSize ( float  cell_size)
inline

Set the cell size.

Definition at line 112 of file progressive_morphological_filter.h.

◆ setExponential()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setExponential ( bool  exponential)
inline

Set flag indicating whether or not to exponentially grow window sizes?

Definition at line 128 of file progressive_morphological_filter.h.

◆ setInitialDistance()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setInitialDistance ( float  initial_distance)
inline

Set the initial height above the parameterized ground surface to be considered a ground return.

Definition at line 104 of file progressive_morphological_filter.h.

◆ setMaxDistance()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setMaxDistance ( float  max_distance)
inline

Set the maximum height above the parameterized ground surface to be considered a ground return.

Definition at line 96 of file progressive_morphological_filter.h.

◆ setMaxWindowSize()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setMaxWindowSize ( int  max_window_size)
inline

Set the maximum window size to be used in filtering ground returns.

Definition at line 80 of file progressive_morphological_filter.h.

◆ setSlope()

template<typename PointT >
void pcl::ProgressiveMorphologicalFilter< PointT >::setSlope ( float  slope)
inline

Set the slope value to be used in computing the height threshold.

Definition at line 88 of file progressive_morphological_filter.h.

Member Data Documentation

◆ base_

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::base_ {2.0f}
protected

Base to be used in computing progressive window sizes.

Definition at line 155 of file progressive_morphological_filter.h.

◆ cell_size_

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::cell_size_ {1.0f}
protected

Cell size.

Definition at line 152 of file progressive_morphological_filter.h.

◆ exponential_

template<typename PointT >
bool pcl::ProgressiveMorphologicalFilter< PointT >::exponential_ {true}
protected

Exponentially grow window sizes?

Definition at line 158 of file progressive_morphological_filter.h.

◆ initial_distance_

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::initial_distance_ {0.15f}
protected

Initial height above the parameterized ground surface to be considered a ground return.

Definition at line 149 of file progressive_morphological_filter.h.

◆ max_distance_

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::max_distance_ {10.0f}
protected

Maximum height above the parameterized ground surface to be considered a ground return.

Definition at line 146 of file progressive_morphological_filter.h.

◆ max_window_size_

template<typename PointT >
int pcl::ProgressiveMorphologicalFilter< PointT >::max_window_size_ {33}
protected

Maximum window size to be used in filtering ground returns.

Definition at line 140 of file progressive_morphological_filter.h.

◆ slope_

template<typename PointT >
float pcl::ProgressiveMorphologicalFilter< PointT >::slope_ {0.7f}
protected

Slope value to be used in computing the height threshold.

Definition at line 143 of file progressive_morphological_filter.h.


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