Aim: An estimator on digital surfaces that returns the reference local geometric quantity. This is used for comparing estimators. More...

#include <DGtal/geometry/surfaces/estimation/TrueDigitalSurfaceLocalEstimator.h>

Public Types
typedef TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >	Self

typedef TKSpace	KSpace

typedef TShape	Shape

typedef TGeometricFunctor	GeometricFunctor

typedef KSpace::Space	Space

typedef KSpace::SCell	SCell

typedef KSpace::Surfel	Surfel

typedef Space::RealPoint	RealPoint

typedef RealPoint::Coordinate	Scalar

typedef GeometricFunctor::Quantity	Quantity

typedef CanonicSCellEmbedder< KSpace >	SCellEmbedder

Public Member Functions
	BOOST_CONCEPT_ASSERT ((concepts::CUnaryFunctor< GeometricFunctor, RealPoint, Quantity >))

	~TrueDigitalSurfaceLocalEstimator ()

	TrueDigitalSurfaceLocalEstimator ()

	TrueDigitalSurfaceLocalEstimator (const Self &other)

Self &	operator= (const Self &other)

Scalar	h () const

void	attach (ConstAlias< Shape > aShape)

void	setParams (ConstAlias< KSpace > ks, Clone< GeometricFunctor > fct, const int maxIter=20, const Scalar accuracy=0.0001, const Scalar gamma=0.5)

template<typename SurfelConstIterator >
void	init (const Scalar _h, SurfelConstIterator itb, SurfelConstIterator ite)

template<typename SurfelConstIterator >
Quantity	eval (SurfelConstIterator it) const

template<typename OutputIterator , typename SurfelConstIterator >
OutputIterator	eval (SurfelConstIterator itb, SurfelConstIterator ite, OutputIterator result) const

RealPoint	embed (Surfel surfel) const

void	selfDisplay (std::ostream &out) const

bool	isValid () const

Protected Attributes
CountedConstPtrOrConstPtr< KSpace >	myKSpace
	The cellular space. More...

CowPtr< GeometricFunctor >	myFct
	The functor RealPoint -> Quantity returning some geometric quantity. More...

SCellEmbedder	myEmbedder
	The surfel embedder. /!\ For now, it is multiplied by myH. More...

CountedConstPtrOrConstPtr< Shape >	myShape
	The shape of interest. More...

Scalar	myH
	The gridstep. More...

bool	myNearest
	Tells if we look for nearest point. More...

int	myMaxIter
	fixes the maximum number of steps (0: takes the point as is). More...

Scalar	myAccuracy
	distance criterion to stop the descent (proximity of implicit function). More...

Scalar	myGamma
	coefficient associated with the gradient (size of each step). More...

Private Member Functions
	BOOST_CONCEPT_ASSERT ((concepts::CCellularGridSpaceND< TKSpace >))

Detailed Description

template<typename TKSpace, typename TShape, typename TGeometricFunctor>
class DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >

Aim: An estimator on digital surfaces that returns the reference local geometric quantity. This is used for comparing estimators.

Description of template class 'TrueDigitalSurfaceLocalEstimator'

Note that you must call methods setParams, attach, then init before calling eval method(s).

It is a model of CDigitalSurfaceLocalEstimator.

Template Parameters

TKSpace	the type of cellular grid space, a model of CCellularGridSpaceND.
TShape	the type of the shape where geometric estimation are made. It must have methods gradient, meanCurvature, etc depending on the chosen functor.
TGeometricFunctor	the type of the function RealPoint -> Quantity, generally one of ShapeGeometricFunctors::ShapePositionFunctor, ShapeGeometricFunctors::ShapeNormalVectorFunctor, ShapeGeometricFunctors::ShapeMeanCurvatureFunctor, ShapeGeometricFunctors::ShapeGaussianCurvatureFunctor, ShapeGeometricFunctors::ShapeFirstPrincipalCurvatureFunctor, ShapeGeometricFunctors::ShapeSecondPrincipalCurvatureFunctor, ShapeGeometricFunctors::ShapeCurvatureTensorFunctor.

typedef ImplicitPolynomial3Shape<Z3i::Space> ImplicitShape;
typedef ShapeGeometricFunctors::ShapeNormalVectorFunctor<ImplicitShape> NormalFunctor;
typedef TrueDigitalSurfaceLocalEstimator<Z3i::KSpace, ImplicitShape, NormalFunctor> TrueNormalEstimator;
TrueNormalEstimator true_estimator;
true_estimator.setParams( K, NormalFunctor() ); // K is some KSpace
true_estimator.attach( shape );                 // shape is some ImplicitShape
true_estimator.init( 1.0, surface.begin(), surface.end() ); // surface is a digital surface.

Todo:

add precise concept CShape

for now we use a CanonicSCellEmbedder times the gridstep to embed surfels.

Definition at line 97 of file TrueDigitalSurfaceLocalEstimator.h.

Member Typedef Documentation

◆ GeometricFunctor

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef TGeometricFunctor DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::GeometricFunctor

Definition at line 105 of file TrueDigitalSurfaceLocalEstimator.h.

◆ KSpace

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef TKSpace DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::KSpace

Definition at line 103 of file TrueDigitalSurfaceLocalEstimator.h.

◆ Quantity

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef GeometricFunctor::Quantity DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::Quantity

Definition at line 111 of file TrueDigitalSurfaceLocalEstimator.h.

◆ RealPoint

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef Space::RealPoint DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::RealPoint

Definition at line 109 of file TrueDigitalSurfaceLocalEstimator.h.

◆ Scalar

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef RealPoint::Coordinate DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::Scalar

Definition at line 110 of file TrueDigitalSurfaceLocalEstimator.h.

◆ SCell

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef KSpace::SCell DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::SCell

Definition at line 107 of file TrueDigitalSurfaceLocalEstimator.h.

◆ SCellEmbedder

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef CanonicSCellEmbedder<KSpace> DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::SCellEmbedder

Definition at line 112 of file TrueDigitalSurfaceLocalEstimator.h.

◆ Self

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef TrueDigitalSurfaceLocalEstimator<TKSpace,TShape,TGeometricFunctor> DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::Self

Definition at line 102 of file TrueDigitalSurfaceLocalEstimator.h.

◆ Shape

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef TShape DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::Shape

Definition at line 104 of file TrueDigitalSurfaceLocalEstimator.h.

◆ Space

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef KSpace::Space DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::Space

Definition at line 106 of file TrueDigitalSurfaceLocalEstimator.h.

◆ Surfel

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

typedef KSpace::Surfel DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::Surfel

Definition at line 108 of file TrueDigitalSurfaceLocalEstimator.h.

Constructor & Destructor Documentation

◆ ~TrueDigitalSurfaceLocalEstimator()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::~TrueDigitalSurfaceLocalEstimator ( )

Destructor.

◆ TrueDigitalSurfaceLocalEstimator() [1/2]

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::TrueDigitalSurfaceLocalEstimator ( )

Default constructor. The estimator is not valid.

◆ TrueDigitalSurfaceLocalEstimator() [2/2]

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::TrueDigitalSurfaceLocalEstimator ( const Self & other )

Copy constructor.

Parameters

other the object to clone.

Member Function Documentation

◆ attach()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

void DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::attach ( ConstAlias< Shape > aShape )

Attach a shape.

Parameters

aShape the shape of interest. The alias can be secured if a some counted pointer is handed.

Referenced by DGtal::ShortcutsGeometry< TKSpace >::getFirstPrincipalCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getFirstPrincipalDirections(), DGtal::ShortcutsGeometry< TKSpace >::getGaussianCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getMeanCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getNormalVectors(), DGtal::ShortcutsGeometry< TKSpace >::getPositions(), DGtal::ShortcutsGeometry< TKSpace >::getPrincipalCurvaturesAndDirections(), DGtal::ShortcutsGeometry< TKSpace >::getSecondPrincipalCurvatures(), and DGtal::ShortcutsGeometry< TKSpace >::getSecondPrincipalDirections().

◆ BOOST_CONCEPT_ASSERT() [1/2]

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::BOOST_CONCEPT_ASSERT ( (concepts::CCellularGridSpaceND< TKSpace >) )

private

◆ BOOST_CONCEPT_ASSERT() [2/2]

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::BOOST_CONCEPT_ASSERT ( (concepts::CUnaryFunctor< GeometricFunctor, RealPoint, Quantity >) )

◆ embed()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

RealPoint DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::embed ( Surfel surfel ) const

Parameters

surfel any surfel.

Returns: the associated point on the shape (the one that is closest to its centroid).

◆ eval() [1/2]

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

template<typename SurfelConstIterator >

Quantity DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::eval ( SurfelConstIterator it ) const

Returns: the estimated quantity at *it

Parameters

[in] it the surfel iterator at which we evaluate the quantity.

Referenced by DGtal::ShortcutsGeometry< TKSpace >::getFirstPrincipalCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getFirstPrincipalDirections(), DGtal::ShortcutsGeometry< TKSpace >::getGaussianCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getMeanCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getNormalVectors(), DGtal::ShortcutsGeometry< TKSpace >::getPositions(), DGtal::ShortcutsGeometry< TKSpace >::getPrincipalCurvaturesAndDirections(), DGtal::ShortcutsGeometry< TKSpace >::getSecondPrincipalCurvatures(), and DGtal::ShortcutsGeometry< TKSpace >::getSecondPrincipalDirections().

◆ eval() [2/2]

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

template<typename OutputIterator , typename SurfelConstIterator >

OutputIterator DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::eval	(	SurfelConstIterator	itb,
		SurfelConstIterator	ite,
		OutputIterator	result
	)		const

Returns: the estimated quantity in the range [itb,ite)

Parameters

[in]	itb	starting surfel iterator.
[in]	ite	end surfel iterator.
[in]	result	resulting output iterator

◆ h()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

Scalar DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::h ( ) const

Returns: the grid step.

◆ init()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

template<typename SurfelConstIterator >

void DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::init	(	const Scalar	_h,
		SurfelConstIterator	itb,
		SurfelConstIterator	ite
	)

Model of CDigitalSurfaceLocalEstimator. Initialisation.

Template Parameters

SurfelConstIterator any model of forward readable iterator on Surfel.

Parameters

[in]	_h	grid size (must be >0).
[in]	ite	iterator on the first surfel of the surface.
[in]	itb	iterator after the last surfel of the surface.

Referenced by DGtal::ShortcutsGeometry< TKSpace >::getFirstPrincipalCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getFirstPrincipalDirections(), DGtal::ShortcutsGeometry< TKSpace >::getGaussianCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getMeanCurvatures(), DGtal::ShortcutsGeometry< TKSpace >::getNormalVectors(), DGtal::ShortcutsGeometry< TKSpace >::getPositions(), DGtal::ShortcutsGeometry< TKSpace >::getPrincipalCurvaturesAndDirections(), DGtal::ShortcutsGeometry< TKSpace >::getSecondPrincipalCurvatures(), and DGtal::ShortcutsGeometry< TKSpace >::getSecondPrincipalDirections().

◆ isValid()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

bool DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::isValid ( ) const

Checks the validity/consistency of the object.

Returns: 'true' if the object is valid, 'false' otherwise.

◆ operator=()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

Self & DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::operator= ( const Self & other )

Assignment.

Parameters

other the object to copy.

Returns: a reference on 'this'.

◆ selfDisplay()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

void DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::selfDisplay ( std::ostream & out ) const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

◆ setParams()

template<typename TKSpace , typename TShape , typename TGeometricFunctor >

void DGtal::TrueDigitalSurfaceLocalEstimator< TKSpace, TShape, TGeometricFunctor >::setParams	(	ConstAlias< KSpace >	ks,
		Clone< GeometricFunctor >	fct,
		const int	maxIter = `20`,
		const Scalar	accuracy = `0.0001`,
		const Scalar	gamma = `0.5`
	)

Set specific parameters. They specify the space, the estimated quantity and how the nearest point on the surface is approached.

Parameters

ks	the cellular grid space. The alias can be secured if a some counted pointer is handed.
fct	the functor RealPoint -> Quantity returning some geometric quantity.
maxIter	fixes the maximum number of steps (0: takes the point as is).
accuracy	distance criterion to stop the descent (proximity of implicit function).
gamma	coefficient associated with the gradient (size of each step).