DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface > Struct Template Reference

Aim: A functor Surfel -> Quantity that returns the mean of absolute curvatures at given surfel: (abs(k1)+abs(k2))/2. This class has meaning only in 3D. More...

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

Public Types
typedef TVCMOnDigitalSurface	VCMOnDigitalSurface
typedef VCMOnDigitalSurface::KSpace	KSpace
typedef VCMOnDigitalSurface::Surfel	Surfel
typedef VCMOnDigitalSurface::VectorN	RealVector
typedef RealVector::Component	Scalar
typedef Surfel	Argument
typedef Scalar	Quantity

Public Member Functions
	VCMMeanAbsoluteCurvatures3DFunctor (ConstAlias< VCMOnDigitalSurface > aVCMOnDigitalSurface=0)
void	attach (ConstAlias< VCMOnDigitalSurface > aVCMOnDigitalSurface)
Quantity	operator() (const Surfel &s) const

Private Attributes
CountedConstPtrOrConstPtr< VCMOnDigitalSurface >	myVCMOnDigitalSurface
	The shape of interest.

Detailed Description

template<typename TVCMOnDigitalSurface>
struct DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >

Aim: A functor Surfel -> Quantity that returns the mean of absolute curvatures at given surfel: (abs(k1)+abs(k2))/2. This class has meaning only in 3D.

Description of template class 'VCMMeanAbsoluteCurvatures3DFunctor'

Template Parameters

TVCMOnDigitalSurface

any concrete type of VoronoiCovarianceMeasureOnDigitalSurface

Definition at line 326 of file VCMGeometricFunctors.h.

Member Typedef Documentation

Argument

template<typename TVCMOnDigitalSurface >

typedef Surfel DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::Argument

Definition at line 332 of file VCMGeometricFunctors.h.

KSpace

template<typename TVCMOnDigitalSurface >

typedef VCMOnDigitalSurface::KSpace DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::KSpace

Definition at line 328 of file VCMGeometricFunctors.h.

Quantity

template<typename TVCMOnDigitalSurface >

typedef Scalar DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::Quantity

Definition at line 333 of file VCMGeometricFunctors.h.

RealVector

template<typename TVCMOnDigitalSurface >

typedef VCMOnDigitalSurface::VectorN DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::RealVector

Definition at line 330 of file VCMGeometricFunctors.h.

Scalar

template<typename TVCMOnDigitalSurface >

typedef RealVector::Component DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::Scalar

Definition at line 331 of file VCMGeometricFunctors.h.

Surfel

template<typename TVCMOnDigitalSurface >

typedef VCMOnDigitalSurface::Surfel DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::Surfel

Definition at line 329 of file VCMGeometricFunctors.h.

VCMOnDigitalSurface

template<typename TVCMOnDigitalSurface >

typedef TVCMOnDigitalSurface DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::VCMOnDigitalSurface

Definition at line 327 of file VCMGeometricFunctors.h.

Constructor & Destructor Documentation

VCMMeanAbsoluteCurvatures3DFunctor()

template<typename TVCMOnDigitalSurface >

DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::VCMMeanAbsoluteCurvatures3DFunctor ( ConstAlias< VCMOnDigitalSurface > aVCMOnDigitalSurface = 0 )

inline

Constructor. A VCM may also be attached at construction.

Parameters

aVCMOnDigitalSurface

the VCM on surface that stores all the information. The alias can be secured if some counted pointer is handed.

Definition at line 342 of file VCMGeometricFunctors.h.

        : myVCMOnDigitalSurface( aVCMOnDigitalSurface ) 
      {
        BOOST_STATIC_ASSERT(( KSpace::dimension == 3 ));
      }

References DGtal::KhalimskySpaceND< dim, TInteger >::dimension.

Member Function Documentation

attach()

template<typename TVCMOnDigitalSurface >

void DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::attach ( ConstAlias< VCMOnDigitalSurface > aVCMOnDigitalSurface )

inline

Attach a VCM on a digital surface.

Parameters

aVCMOnDigitalSurface

on surface that stores all the information. The alias can be secured if some counted pointer is handed.

Definition at line 355 of file VCMGeometricFunctors.h.

      {
        myVCMOnDigitalSurface = aVCMOnDigitalSurface;
      }

References DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::myVCMOnDigitalSurface.

operator()()

template<typename TVCMOnDigitalSurface >

Quantity DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::operator() ( const Surfel & s ) const

inline

Map operator Surfel -> Scalar giving the mean of absolute curvatures estimated by the VCM object. Complexity is \( O(log n) \), if n is the number of surfels of the surface.

Parameters

s	any surfel of the shape.

Returns

the normal at point p (as the normalized gradient).

Definition at line 367 of file VCMGeometricFunctors.h.

      {
        ASSERT( myVCMOnDigitalSurface != 0 );
        RealVector lambda;
        bool ok = myVCMOnDigitalSurface->getChiVCMEigenvalues( lambda, s );
        ASSERT( ok ); boost::ignore_unused_variable_warning( ok );
 
        // The last eigenvalue l2 is approximately the mixed "area" 2pi R^3 r^2 / 3
        // The greatest principal curvature is related to the second eigenvalue l1.
        // k1^2 = 4*l1 / (l2*r^2)
        Quantity k1 = 2.0 * sqrt( lambda[1] / lambda[2] ) / myVCMOnDigitalSurface->r();
 
       // The last eigenvalue l2 is approximately the mixed "area" 2pi R^3 r^2 / 3
        // The smallest principal curvature is related to the first eigenvalue l0.
        // k2^2 = 4*l0 / (l2*r^2)
        Quantity k2 = 2.0 * sqrt( lambda[0] / lambda[2] ) / myVCMOnDigitalSurface->r();
        return (k1+k2) * 0.5;
      }

References DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::myVCMOnDigitalSurface.

Field Documentation

myVCMOnDigitalSurface

template<typename TVCMOnDigitalSurface >

CountedConstPtrOrConstPtr<VCMOnDigitalSurface> DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::myVCMOnDigitalSurface

private

The shape of interest.

Definition at line 388 of file VCMGeometricFunctors.h.

Referenced by DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::attach(), and DGtal::functors::VCMMeanAbsoluteCurvatures3DFunctor< TVCMOnDigitalSurface >::operator()().

---

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

• VCMGeometricFunctors.h