|
CGAL 5.0.1 - Classification
|
|
CGAL 5.0.1 - Classification
|
#include <CGAL/Classification/Point_set_feature_generator.h>
Generates a set of generic features for point set classification.
This class takes care of computing and storing all necessary data structures and of generating a set of generic features at multiple scales to increase the reliability of the classification.
| GeomTraits | model of CGAL Kernel. |
| PointRange | model of ConstRange. Its iterator type is RandomAccessIterator and its value type is the key type of PointMap. |
| PointMap | model of ReadablePropertyMap whose key type is the value type of the iterator of PointRange and value type is GeomTraits::Point_3. |
| ConcurrencyTag | enables sequential versus parallel computation of CGAL::Classification::Local_eigen_analysis objects. Possible values are Parallel_tag (default value is CGAL is linked with TBB) or Sequential_tag (default value otherwise). |
| DiagonalizeTraits | model of DiagonalizeTraits used for matrix diagonalization. It can be omitted: if Eigen 3 (or greater) is available and CGAL_EIGEN3_ENABLED is defined: in that case, an overload using Eigen_diagonalize_traits is provided. |
Public Types | |
| typedef GeomTraits::Iso_cuboid_3 | Iso_cuboid_3 |
| typedef Classification::Planimetric_grid< GeomTraits, PointRange, PointMap > | Planimetric_grid |
| typedef Classification::Point_set_neighborhood< GeomTraits, PointRange, PointMap > | Neighborhood |
| typedef Classification::Local_eigen_analysis | Local_eigen_analysis |
Constructor | |
| Point_set_feature_generator (const PointRange &input, PointMap point_map, std::size_t nb_scales, float voxel_size=-1.f) | |
| Initializes a feature generator from an input range. More... | |
Feature Generation | |
| void | generate_point_based_features (Feature_set &features) |
| Generate geometric features based on point position information. More... | |
| template<typename VectorMap > | |
| void | generate_normal_based_features (Feature_set &features, const VectorMap &normal_map) |
| Generate geometric features based on normal vector information. More... | |
| template<typename ColorMap > | |
| void | generate_color_based_features (Feature_set &features, const ColorMap &color_map) |
| Generate geometric features based on point color information. More... | |
| template<typename EchoMap > | |
| void | generate_echo_based_features (Feature_set &features, const EchoMap &echo_map) |
| Generate geometric features based on echo information. More... | |
Data Structures Access | |
| const Iso_cuboid_3 & | bbox () const |
| Returns the bounding box of the input point set. | |
| const Neighborhood & | neighborhood (std::size_t scale=0) const |
Returns the neighborhood structure at scale scale. | |
| const Planimetric_grid & | grid (std::size_t scale=0) const |
Returns the planimetric grid structure at scale scale. | |
| const Local_eigen_analysis & | eigen (std::size_t scale=0) const |
Returns the local eigen analysis structure at scale scale. | |
Parameters | |
| std::size_t | number_of_scales () const |
| Returns the number of scales that were computed. | |
| float | grid_resolution (std::size_t scale=0) const |
Returns the grid resolution at scale scale. More... | |
| float | radius_neighbors (std::size_t scale=0) const |
Returns the radius used for neighborhood queries at scale scale. More... | |
| float | radius_dtm (std::size_t scale=0) const |
Returns the radius used for digital terrain modeling at scale scale. More... | |
| CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::Point_set_feature_generator | ( | const PointRange & | input, |
| PointMap | point_map, | ||
| std::size_t | nb_scales, | ||
| float | voxel_size = -1.f |
||
| ) |
Initializes a feature generator from an input range.
If not provided by the user, The size of the smallest scale is automatically estimated using a method equivalent to CGAL::compute_average_spacing() using 6 neighbors. The data structures needed (Neighborhood, Planimetric_grid and Local_eigen_analysis) are computed at nb_scales recursively larger scales.
| input | point range. |
| point_map | property map to access the input points. |
| nb_scales | number of scales to compute. |
| voxel_size | smallest scale used as a voxel size for the planimetric grid (if the default value -1 is used, its value is automatically estimated). |
| void CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::generate_color_based_features | ( | Feature_set & | features, |
| const ColorMap & | color_map | ||
| ) |
Generate geometric features based on point color information.
Generates CGAL::Classification::Feature::Color_channel with channels HUE, SATURATION and VALUE.
| ColorMap | model of ReadablePropertyMap whose key type is the value type of the iterator of PointRange and value type is CGAL::Color. |
| features | the feature set where the features are instantiated. |
| color_map | property map to access the colors of the input points (if any). |
| void CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::generate_echo_based_features | ( | Feature_set & | features, |
| const EchoMap & | echo_map | ||
| ) |
Generate geometric features based on echo information.
At each scale, generates CGAL::Classification::Feature::Echo_scatter.
| EchoMap | model of ReadablePropertyMap whose key type is the value type of the iterator of PointRange and value type is std::size_t. |
| features | the feature set where the features are instantiated. |
| echo_map | property map to access the echo values of the input points (if any). |
| void CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::generate_normal_based_features | ( | Feature_set & | features, |
| const VectorMap & | normal_map | ||
| ) |
Generate geometric features based on normal vector information.
Generates the version of CGAL::Classification::Feature::Verticality based on normal vectors.
| VectorMap | model of ReadablePropertyMap whose key type is the value type of the iterator of PointRange and value type is GeomTraits::Vector_3. |
| features | the feature set where the features are instantiated. |
| normal_map | property map to access the normal vectors of the input points (if any). |
| void CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::generate_point_based_features | ( | Feature_set & | features | ) |
Generate geometric features based on point position information.
At each scale, the following features are generated:
CGAL::Classification::Feature::Eigenvalue with indices 0, 1 and 2CGAL::Classification::Feature::Distance_to_planeCGAL::Classification::Feature::ElevationCGAL::Classification::Feature::Height_aboveCGAL::Classification::Feature::Height_belowCGAL::Classification::Feature::Vertical_dispersionCGAL::Classification::Feature::Vertical_rangeCGAL::Classification::Feature::Verticality based on eigenvalues| features | the feature set where the features are instantiated. |
| float CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::grid_resolution | ( | std::size_t | scale = 0 | ) | const |
Returns the grid resolution at scale scale.
This resolution is the length and width of a cell of the Planimetric_grid defined at this scale.
| float CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::radius_dtm | ( | std::size_t | scale = 0 | ) | const |
Returns the radius used for digital terrain modeling at scale scale.
This radius represents the minimum size of a building at this scale.
| float CGAL::Classification::Point_set_feature_generator< GeomTraits, PointRange, PointMap, ConcurrencyTag, DiagonalizeTraits >::radius_neighbors | ( | std::size_t | scale = 0 | ) | const |
Returns the radius used for neighborhood queries at scale scale.
This radius is the smallest radius that is relevant from a geometric point of view at this scale (that is to say that encloses a few cells of Planimetric_grid).
1.8.13