Aim: Estimates normal vector using CGAL linear least squares plane fitting. More...

#include <DGtal/geometry/surfaces/estimation/estimationFunctors/LinearLeastSquareFittingNormalVectorEstimator.h>

Public Types
typedef TSurfel	Surfel
typedef TEmbedder	SCellEmbedder
typedef SCellEmbedder::RealPoint	RealPoint
typedef RealPoint	Quantity
typedef CGAL::Cartesian< double >	CGALKernel
typedef CGALKernel::Point_3	CGALPoint
typedef CGALKernel::Plane_3	CGALPlane
typedef CGALKernel::Vector_3	CGALVector

Public Member Functions
	LinearLeastSquareFittingNormalVectorEstimator (ConstAlias< SCellEmbedder > anEmbedder, const double h)
void	pushSurfel (const Surfel &aSurf, const double aDistance)
Quantity	eval ()
void	reset ()

Private Attributes
const SCellEmbedder *	myEmbedder
	Alias of the geometrical embedder.
std::vector< CGALPoint >	myPoints
	Array of CGAL points.
double	myH
	Grid Step.

Detailed Description

template<typename TSurfel, typename TEmbedder>
class DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >

Aim: Estimates normal vector using CGAL linear least squares plane fitting.

Description of template class 'LinearLeastSquareFittingNormalVectorEstimator'

model of concepts::CLocalEstimatorFromSurfelFunctor

Template Parameters

TSurfel	type of surfels
TEmbedder	type of functors which embed surfel to R^3

Definition at line 79 of file LinearLeastSquareFittingNormalVectorEstimator.h.

Member Typedef Documentation

◆ CGALKernel

template<typename TSurfel, typename TEmbedder>

typedef CGAL::Cartesian<double> DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::CGALKernel

Definition at line 88 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ CGALPlane

template<typename TSurfel, typename TEmbedder>

typedef CGALKernel::Plane_3 DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::CGALPlane

Definition at line 90 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ CGALPoint

template<typename TSurfel, typename TEmbedder>

typedef CGALKernel::Point_3 DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::CGALPoint

Definition at line 89 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ CGALVector

template<typename TSurfel, typename TEmbedder>

typedef CGALKernel::Vector_3 DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::CGALVector

Definition at line 91 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ Quantity

template<typename TSurfel, typename TEmbedder>

typedef RealPoint DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::Quantity

Definition at line 86 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ RealPoint

template<typename TSurfel, typename TEmbedder>

typedef SCellEmbedder::RealPoint DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::RealPoint

Definition at line 85 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ SCellEmbedder

template<typename TSurfel, typename TEmbedder>

typedef TEmbedder DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::SCellEmbedder

Definition at line 84 of file LinearLeastSquareFittingNormalVectorEstimator.h.

◆ Surfel

template<typename TSurfel, typename TEmbedder>

typedef TSurfel DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::Surfel

Definition at line 83 of file LinearLeastSquareFittingNormalVectorEstimator.h.

Constructor & Destructor Documentation

◆ LinearLeastSquareFittingNormalVectorEstimator()

template<typename TSurfel, typename TEmbedder>

DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::LinearLeastSquareFittingNormalVectorEstimator	(	ConstAlias< SCellEmbedder >	anEmbedder,
		const double	h )

inline

Constructor.

Parameters

anEmbedder	embedder to map surfel to R^n.
h	gridstep.

Definition at line 99 of file LinearLeastSquareFittingNormalVectorEstimator.h.

                                                                                                       :
      myEmbedder(&anEmbedder), myH(h)
    {
    }

References myEmbedder, and myH.

Member Function Documentation

◆ eval()

template<typename TSurfel, typename TEmbedder>

Quantity DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::eval ( )

inline

Evaluate the normal vector from linear least squares fitting.

Returns: the mean curvature

Definition at line 124 of file LinearLeastSquareFittingNormalVectorEstimator.h.

    {
      CGALPlane plane;
      CGAL::linear_least_squares_fitting_3(myPoints.begin(),myPoints.end(), plane, CGAL::Dimension_tag<0>());
      CGALVector v = plane.orthogonal_vector();
      RealPoint vv(v.x(),v.y(),v.z());
      return vv.getNormalized();
    }

References myPoints.

◆ pushSurfel()

template<typename TSurfel, typename TEmbedder>

void DGtal::functors::LinearLeastSquareFittingNormalVectorEstimator< TSurfel, TEmbedder >::pushSurfel	(	const Surfel &	aSurf,
		const double	aDistance )

inline

Add the geometrical embedding of a surfel to the point list

Parameters

aSurf	a surfel to add
aDistance	distance to the origin surfel

Definition at line 110 of file LinearLeastSquareFittingNormalVectorEstimator.h.

    {
      BOOST_VERIFY(aDistance == aDistance);
      RealPoint p = myEmbedder->operator()(aSurf);
      CGALPoint pp(p[0],p[1],p[2]);
      myPoints.push_back(pp);
    }