Aim: Represent a way to probe the R-neighborhood, with the R1 optimization, see [106] for details. More...

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

Inheritance diagram for DGtal::PlaneProbingR1Neighborhood< TPredicate >:

Public Types
using	Predicate = TPredicate
using	Point = typename TPredicate::Point
using	Triangle = typename PlaneProbingRNeighborhood<TPredicate>::Triangle
using	PointOnProbingRay = typename PlaneProbingRNeighborhood<TPredicate>::PointOnProbingRay
using	Integer = typename Point::Coordinate
using	HexagonState = typename PlaneProbingRNeighborhood<TPredicate>::HexagonState
using	Index = typename PlaneProbingRNeighborhood<TPredicate>::Index
Public Types inherited from DGtal::PlaneProbingRNeighborhood< TPredicate >
using	Predicate = TPredicate
using	Point = typename TPredicate::Point
using	Triangle = typename PlaneProbingNeighborhood<TPredicate>::Triangle
using	Integer = typename PlaneProbingNeighborhood<TPredicate>::Integer
using	PointOnProbingRay = typename PlaneProbingNeighborhood<TPredicate>::PointOnProbingRay
using	HexagonState = typename PlaneProbingNeighborhood<TPredicate>::HexagonState
Public Types inherited from DGtal::PlaneProbingNeighborhood< TPredicate >
enum class	HexagonState { Empty , NonConvex , NonPlanar , Planar }
using	Predicate = TPredicate
using	Point = typename Predicate::Point
using	Vector = Point
using	Integer = typename Point::Coordinate
using	Triangle = std::array<Vector, 3>
using	Index = std::size_t
using	PointOnProbingRay = detail::PointOnProbingRay<Integer,Index>

Public Member Functions
	PlaneProbingR1Neighborhood ()=delete
	PlaneProbingR1Neighborhood (Predicate const &aPredicate, Point const &aQ, Triangle const &aM)
	~PlaneProbingR1Neighborhood ()
	PlaneProbingR1Neighborhood (const PlaneProbingR1Neighborhood &other)=delete
	PlaneProbingR1Neighborhood (PlaneProbingR1Neighborhood &&other)=delete
PlaneProbingR1Neighborhood &	operator= (const PlaneProbingR1Neighborhood &other)=delete
PlaneProbingR1Neighborhood &	operator= (PlaneProbingR1Neighborhood &&other)=delete
virtual HexagonState	hexagonState () override
void	selfDisplay (std::ostream &out) const
bool	isValid () const
Public Member Functions inherited from DGtal::PlaneProbingRNeighborhood< TPredicate >
	PlaneProbingRNeighborhood ()=delete
	PlaneProbingRNeighborhood (Predicate const &aPredicate, Point const &aQ, Triangle const &aM)
	~PlaneProbingRNeighborhood ()
	PlaneProbingRNeighborhood (const PlaneProbingRNeighborhood &other)=delete
	PlaneProbingRNeighborhood (PlaneProbingRNeighborhood &&other)=delete
PlaneProbingRNeighborhood &	operator= (const PlaneProbingRNeighborhood &other)=delete
PlaneProbingRNeighborhood &	operator= (PlaneProbingRNeighborhood &&other)=delete
void	selfDisplay (std::ostream &out) const
bool	isValid () const
Public Member Functions inherited from DGtal::PlaneProbingNeighborhood< TPredicate >
	PlaneProbingNeighborhood ()=delete
	PlaneProbingNeighborhood (Predicate const &aPredicate, Point const &aQ, Triangle const &aM)
virtual	~PlaneProbingNeighborhood ()
	PlaneProbingNeighborhood (const PlaneProbingNeighborhood &other)=delete
	PlaneProbingNeighborhood (PlaneProbingNeighborhood &&other)=delete
PlaneProbingNeighborhood &	operator= (const PlaneProbingNeighborhood &other)=delete
PlaneProbingNeighborhood &	operator= (PlaneProbingNeighborhood &&other)=delete
void	setNeighbors (std::vector< PointOnProbingRay > const &aNeighbors)
virtual UpdateOperation	closestCandidate ()
UpdateOperation	getOperation (PointOnProbingRay const &aClosest) const
HexagonState	classify (std::array< bool, 6 > const &aState) const
void	selfDisplay (std::ostream &out) const
bool	isValid () const

Private Member Functions
	BOOST_CONCEPT_ASSERT ((concepts::CPointPredicate< TPredicate >))
int	getNeighborhoodCode () const
std::pair< PointOnProbingRay, PointOnProbingRay >	candidateRay (Index const &index) const
std::vector< PointOnProbingRay >	intersectSphereRay (PointOnProbingRay const &aPoint, PointOnProbingRay const &aRay) const
bool	isValidIntersectSphereRay (PointOnProbingRay const &aPoint, PointOnProbingRay const &aRay, std::vector< PointOnProbingRay > const &aLst) const
PointOnProbingRay	closestPointOnRayConstant (PointOnProbingRay const &aRay) const
PointOnProbingRay	closestPointOnRayLinear (PointOnProbingRay const &aRay) const
PointOnProbingRay	closestRayPoint (std::pair< PointOnProbingRay, PointOnProbingRay > const &aRayPoint) const

Private Attributes
std::array< bool, 6 >	myState

Additional Inherited Members
Protected Member Functions inherited from DGtal::PlaneProbingRNeighborhood< TPredicate >
template<typename TPointAdapter>
TPointAdapter	closestPointOnRayLogWithPredicate (TPointAdapter const &aRay) const
template<typename TPointAdapter>
TPointAdapter	closestPointOnRayLinearWithPredicate (TPointAdapter const &aRay) const
Protected Member Functions inherited from DGtal::PlaneProbingNeighborhood< TPredicate >
template<class TPointAdapter>
TPointAdapter	closestPointInList (std::vector< TPointAdapter > const &aPoints) const
bool	isNeighbor (PointOnProbingRay const &aRay) const
bool	isSmallest (Point const &aX, Point const &aY) const
template<class TPointAdapter>
Point	relativePoint (TPointAdapter const &aPoint) const
template<class TPointAdapter>
Point	absolutePoint (TPointAdapter const &aPoint) const
Protected Attributes inherited from DGtal::PlaneProbingNeighborhood< TPredicate >
Predicate const &	myPredicate
Point const &	myQ
Triangle const &	myM
std::vector< PointOnProbingRay >	myCandidates
std::vector< PointOnProbingRay >	myNeighbors
Static Protected Attributes inherited from DGtal::PlaneProbingNeighborhood< TPredicate >
static const PointOnProbingRay	myNeighborhood [6]

Detailed Description

template<typename TPredicate>
class DGtal::PlaneProbingR1Neighborhood< TPredicate >

Aim: Represent a way to probe the R-neighborhood, with the R1 optimization, see [106] for details.

Description of template class 'PlaneProbingR1Neighborhood'

Template Parameters

TPredicate the probing predicate, a model of concepts::CPointPredicate.

Definition at line 63 of file PlaneProbingR1Neighborhood.h.

Member Typedef Documentation

◆ HexagonState

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::HexagonState = typename PlaneProbingRNeighborhood<TPredicate>::HexagonState

Definition at line 74 of file PlaneProbingR1Neighborhood.h.

◆ Index

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::Index = typename PlaneProbingRNeighborhood<TPredicate>::Index

Definition at line 76 of file PlaneProbingR1Neighborhood.h.

◆ Integer

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::Integer = typename Point::Coordinate

Definition at line 73 of file PlaneProbingR1Neighborhood.h.

◆ Point

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::Point = typename TPredicate::Point

Definition at line 70 of file PlaneProbingR1Neighborhood.h.

◆ PointOnProbingRay

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::PointOnProbingRay = typename PlaneProbingRNeighborhood<TPredicate>::PointOnProbingRay

Definition at line 72 of file PlaneProbingR1Neighborhood.h.

◆ Predicate

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::Predicate = TPredicate

Definition at line 69 of file PlaneProbingR1Neighborhood.h.

◆ Triangle

template<typename TPredicate>

using DGtal::PlaneProbingR1Neighborhood< TPredicate >::Triangle = typename PlaneProbingRNeighborhood<TPredicate>::Triangle

Definition at line 71 of file PlaneProbingR1Neighborhood.h.

Constructor & Destructor Documentation

◆ PlaneProbingR1Neighborhood() [1/4]

template<typename TPredicate>

DGtal::PlaneProbingR1Neighborhood< TPredicate >::PlaneProbingR1Neighborhood ( )

delete

Default constructor.

Referenced by operator=(), operator=(), PlaneProbingR1Neighborhood(), and PlaneProbingR1Neighborhood().

◆ PlaneProbingR1Neighborhood() [2/4]

template<typename TPredicate>

DGtal::PlaneProbingR1Neighborhood< TPredicate >::PlaneProbingR1Neighborhood	(	Predicate const &	aPredicate,
		Point const &	aQ,
		Triangle const &	aM )

Constructor.

Parameters

aPredicate	a probing predicate.
aQ	the fixed point 'q'.
aM	a frame composed of the three vectors.

◆ ~PlaneProbingR1Neighborhood()

template<typename TPredicate>

DGtal::PlaneProbingR1Neighborhood< TPredicate >::~PlaneProbingR1Neighborhood ( )

Destructor.

◆ PlaneProbingR1Neighborhood() [3/4]

template<typename TPredicate>

DGtal::PlaneProbingR1Neighborhood< TPredicate >::PlaneProbingR1Neighborhood ( const PlaneProbingR1Neighborhood< TPredicate > & other )

delete

Copy constructor.

Parameters

other the object to clone.

References PlaneProbingR1Neighborhood().

◆ PlaneProbingR1Neighborhood() [4/4]

template<typename TPredicate>

DGtal::PlaneProbingR1Neighborhood< TPredicate >::PlaneProbingR1Neighborhood ( PlaneProbingR1Neighborhood< TPredicate > && other )

delete

Move constructor.

Parameters

other the object to move.

References PlaneProbingR1Neighborhood().

Member Function Documentation

◆ BOOST_CONCEPT_ASSERT()

template<typename TPredicate>

DGtal::PlaneProbingR1Neighborhood< TPredicate >::BOOST_CONCEPT_ASSERT ( (concepts::CPointPredicate< TPredicate >) )

private

◆ candidateRay()

template<typename TPredicate>

std::pair< PointOnProbingRay, PointOnProbingRay > DGtal::PlaneProbingR1Neighborhood< TPredicate >::candidateRay ( Index const & index ) const

private

Parameters

index an integer between 0 and 2.

Returns: a pair of a point on a ray and a ray.

References index().

◆ closestPointOnRayConstant()

template<typename TPredicate>

PointOnProbingRay DGtal::PlaneProbingR1Neighborhood< TPredicate >::closestPointOnRayConstant ( PointOnProbingRay const & aRay ) const

private

Parameters

aRay a ray.

Returns: the closest point on a ray using [106] Algorithm 4.

◆ closestPointOnRayLinear()

template<typename TPredicate>

PointOnProbingRay DGtal::PlaneProbingR1Neighborhood< TPredicate >::closestPointOnRayLinear ( PointOnProbingRay const & aRay ) const

private

Parameters

aRay a ray.

Returns: the closest point on the ray using a linear search.

◆ closestRayPoint()

template<typename TPredicate>

PointOnProbingRay DGtal::PlaneProbingR1Neighborhood< TPredicate >::closestRayPoint ( std::pair< PointOnProbingRay, PointOnProbingRay > const & aRayPoint ) const

private

Parameters

aRayPoint a pair describing a ray and a point on a ray.

Returns: the closest point among the points of a ray and a point on another ray.

◆ getNeighborhoodCode()

template<typename TPredicate>

int DGtal::PlaneProbingR1Neighborhood< TPredicate >::getNeighborhoodCode ( ) const

private

Returns: an integer coding the current configuration of the H-neighborhood.

◆ hexagonState()

template<typename TPredicate>

virtual HexagonState DGtal::PlaneProbingR1Neighborhood< TPredicate >::hexagonState ( )

overridevirtual

Computes the current state of the neighborhood. This is the function that is overloaded for the different probing modes.

Returns: the hexagon state, see HexagonState.

Reimplemented from DGtal::PlaneProbingRNeighborhood< TPredicate >.

◆ intersectSphereRay()

template<typename TPredicate>

std::vector< PointOnProbingRay > DGtal::PlaneProbingR1Neighborhood< TPredicate >::intersectSphereRay	(	PointOnProbingRay const &	aPoint,
		PointOnProbingRay const &	aRay ) const

private

Parameters

aPoint	a point on a ray.
aRay	a ray.

Returns: extremal points of aRay included in the sphere passing through aPoint and the current triangle.

References aPoint.

◆ isValid()

template<typename TPredicate>

bool DGtal::PlaneProbingR1Neighborhood< TPredicate >::isValid ( ) const

Checks the validity/consistency of the object.

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

◆ isValidIntersectSphereRay()

template<typename TPredicate>

bool DGtal::PlaneProbingR1Neighborhood< TPredicate >::isValidIntersectSphereRay	(	PointOnProbingRay const &	aPoint,
		PointOnProbingRay const &	aRay,
		std::vector< PointOnProbingRay > const &	aLst ) const

private

Sanity check for point returned by intersectSphereRay.

Parameters

aPoint	a point on a ray.
aRay	a ray.
aLst	a list of points on a ray.

Returns: 'true' if the points of aLst are indeed in the sphere passing through aPoint and the current triangle, 'false' otherwise.

References aPoint.

◆ operator=() [1/2]

template<typename TPredicate>

PlaneProbingR1Neighborhood & DGtal::PlaneProbingR1Neighborhood< TPredicate >::operator= ( const PlaneProbingR1Neighborhood< TPredicate > & other )

delete

Copy assignment operator.

Parameters

other the object to copy.

Returns: a reference on 'this'.

References PlaneProbingR1Neighborhood().

◆ operator=() [2/2]

template<typename TPredicate>

PlaneProbingR1Neighborhood & DGtal::PlaneProbingR1Neighborhood< TPredicate >::operator= ( PlaneProbingR1Neighborhood< TPredicate > && other )

delete

Move assignment operator.

Parameters

other the object to move.

Returns: a reference on 'this'.

References PlaneProbingR1Neighborhood().

◆ selfDisplay()

template<typename TPredicate>

void DGtal::PlaneProbingR1Neighborhood< TPredicate >::selfDisplay ( std::ostream & out ) const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

Field Documentation

◆ myState

template<typename TPredicate>

std::array<bool, 6> DGtal::PlaneProbingR1Neighborhood< TPredicate >::myState

mutableprivate

The current state of the H-neighborhood.

Definition at line 149 of file PlaneProbingR1Neighborhood.h.

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

PlaneProbingR1Neighborhood.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ HexagonState

◆ Index

◆ Integer

◆ Point

◆ PointOnProbingRay

◆ Predicate

◆ Triangle

Constructor & Destructor Documentation

◆ PlaneProbingR1Neighborhood() [1/4]

◆ PlaneProbingR1Neighborhood() [2/4]

◆ ~PlaneProbingR1Neighborhood()

◆ PlaneProbingR1Neighborhood() [3/4]

◆ PlaneProbingR1Neighborhood() [4/4]

Member Function Documentation

◆ BOOST_CONCEPT_ASSERT()

◆ candidateRay()

◆ closestPointOnRayConstant()

◆ closestPointOnRayLinear()

◆ closestRayPoint()

◆ getNeighborhoodCode()

◆ hexagonState()

◆ intersectSphereRay()

◆ isValid()

◆ isValidIntersectSphereRay()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ selfDisplay()

Field Documentation

◆ myState