Aim: Model of the concept StarShaped represents any ellipse in the plane. More...

#include <DGtal/shapes/parametric/Ellipse2D.h>

Inheritance diagram for DGtal::Ellipse2D< TSpace >:

Public Types
typedef TSpace	Space
typedef Space::RealPoint	RealPoint
typedef Space::RealVector	RealVector
Public Types inherited from DGtal::StarShaped2D< TSpace >
typedef TSpace	Space
typedef Space::RealPoint	RealPoint

Public Member Functions
	Ellipse2D ()=delete
	Ellipse2D (const double x0, const double y0, const double a0, const double a1, const double theta)
	Ellipse2D (const RealPoint &aPoint, const double a0, const double a1, const double theta)
	Ellipse2D (const Ellipse2D &other)
Ellipse2D &	operator= (const Ellipse2D &other)=delete
	~Ellipse2D ()=default
RealPoint	getLowerBound () const
RealPoint	getUpperBound () const
RealPoint	center () const
void	moveTo (const RealPoint &newCenter)
double	parameter (const RealPoint &p) const
RealPoint	x (const double t) const
RealVector	xp (const double t) const
RealVector	xpp (const double t) const
void	selfDisplay (std::ostream &out) const
bool	isValid () const
Public Member Functions inherited from DGtal::StarShaped2D< TSpace >
	StarShaped2D ()=default
	StarShaped2D (const StarShaped2D &other)=delete
StarShaped2D &	operator= (const StarShaped2D &other)=delete
virtual	~StarShaped2D ()=default
virtual RealPoint	interiorPoint () const
Orientation	orientation (const RealPoint &p) const
RealPoint	tangent (const double t) const
RealPoint	normal (const double t) const
double	curvature (const double t) const
double	arclength (const double t1, double t2, const unsigned int nb) const
RealPoint	findIntersection (const RealPoint &inner, const RealPoint &outer, const double epsilon) const
RealPoint	closestPointWithWitnesses (const RealPoint &p, const RealPoint &left, const RealPoint &right, const int step) const
void	selfDisplay (std::ostream &out) const
bool	isValid () const

Private Member Functions
template<typename T>
bool	isAlmostEqual (T x, T y) const

Private Attributes
RealPoint	myCenter
double	myAxis1
double	myAxis2
double	myTheta

Detailed Description

template<typename TSpace>
class DGtal::Ellipse2D< TSpace >

Aim: Model of the concept StarShaped represents any ellipse in the plane.

Description of template class 'Ellipse2D'

NB: A backport from ImaGene.

Examples: geometry/curves/estimation/exampleCurvature.cpp.

Definition at line 64 of file Ellipse2D.h.

Member Typedef Documentation

◆ RealPoint

template<typename TSpace>

typedef Space::RealPoint DGtal::Ellipse2D< TSpace >::RealPoint

Definition at line 70 of file Ellipse2D.h.

◆ RealVector

template<typename TSpace>

typedef Space::RealVector DGtal::Ellipse2D< TSpace >::RealVector

Definition at line 71 of file Ellipse2D.h.

◆ Space

template<typename TSpace>

typedef TSpace DGtal::Ellipse2D< TSpace >::Space

Definition at line 69 of file Ellipse2D.h.

Constructor & Destructor Documentation

◆ Ellipse2D() [1/4]

template<typename TSpace>

DGtal::Ellipse2D< TSpace >::Ellipse2D ( )

delete

Constructor. Forbidden by default.

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

◆ Ellipse2D() [2/4]

template<typename TSpace>

DGtal::Ellipse2D< TSpace >::Ellipse2D	(	const double	x0,
		const double	y0,
		const double	a0,
		const double	a1,
		const double	theta )

Constructor.

Parameters

x0	the x-coordinate of the circle center.
y0	the y-coordinate of the circle center.
a0	the half big axis of the ellipse.
a1	the half small axis of the ellipse.
theta	the orientation of the ellipse.

◆ Ellipse2D() [3/4]

template<typename TSpace>

DGtal::Ellipse2D< TSpace >::Ellipse2D	(	const RealPoint &	aPoint,
		const double	a0,
		const double	a1,
		const double	theta )

Constructor.

Parameters

aPoint	the circle center.
a0	the half big axis of the ellipse.
a1	the half small axis of the ellipse.
theta	the orientation of the ellipse.

References aPoint.

◆ Ellipse2D() [4/4]

template<typename TSpace>

DGtal::Ellipse2D< TSpace >::Ellipse2D ( const Ellipse2D< TSpace > & other )

Copy constructor.

Parameters

other the object to clone.

References Ellipse2D().

◆ ~Ellipse2D()

template<typename TSpace>

DGtal::Ellipse2D< TSpace >::~Ellipse2D ( )

default

Destructor.

Member Function Documentation

◆ center()

template<typename TSpace>

RealPoint DGtal::Ellipse2D< TSpace >::center ( ) const

inlinevirtual

Returns: the center of the star-shaped object.

Implements DGtal::StarShaped2D< TSpace >.

Definition at line 143 of file Ellipse2D.h.

    {
      return myCenter;
    }

References myCenter.

◆ getLowerBound()

template<typename TSpace>

RealPoint DGtal::Ellipse2D< TSpace >::getLowerBound ( ) const

inlinevirtual

Returns: the lower bound of the shape bounding box.

Implements DGtal::StarShaped2D< TSpace >.

Definition at line 126 of file Ellipse2D.h.

    {
      return myCenter - myAxis1;
    }

References myAxis1, and myCenter.

◆ getUpperBound()

template<typename TSpace>

RealPoint DGtal::Ellipse2D< TSpace >::getUpperBound ( ) const

inlinevirtual

Returns: the upper bound of the shape bounding box.

Implements DGtal::StarShaped2D< TSpace >.

Definition at line 135 of file Ellipse2D.h.

    {
      return myCenter + myAxis1;
    }

References myAxis1, and myCenter.

◆ isAlmostEqual()

template<typename TSpace>

template<typename T>

bool DGtal::Ellipse2D< TSpace >::isAlmostEqual	(	T	x,
		T	y ) const

inlineprivate

Equality test using relative tolerance.

Definition at line 238 of file Ellipse2D.h.

    {
      return std::abs(x - y) <= std::numeric_limits<T>::epsilon();
    }

References x().

◆ isValid()

template<typename TSpace>

bool DGtal::Ellipse2D< TSpace >::isValid ( ) const

Checks the validity/consistency of the object.

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

◆ moveTo()

template<typename TSpace>

void DGtal::Ellipse2D< TSpace >::moveTo ( const RealPoint & newCenter )

inlinevirtual

Modify the shape center

Parameters

newCenter the new center position

Implements DGtal::StarShaped2D< TSpace >.

Definition at line 153 of file Ellipse2D.h.

    {
      myCenter = newCenter;
    }

References myCenter.

◆ operator=()

template<typename TSpace>

Ellipse2D & DGtal::Ellipse2D< TSpace >::operator= ( const Ellipse2D< TSpace > & other )

delete

Assignment.

Parameters

other the object to copy.

Returns: a reference on 'this'. Forbidden by default.

References Ellipse2D().

◆ parameter()

template<typename TSpace>

double DGtal::Ellipse2D< TSpace >::parameter ( const RealPoint & p ) const

virtual

Parameters

p	any point in the plane.

Returns: the angle parameter between 0 and 2*Pi corresponding to this point for the shape.

Implements DGtal::StarShaped2D< TSpace >.

◆ selfDisplay()

template<typename TSpace>

void DGtal::Ellipse2D< TSpace >::selfDisplay ( std::ostream & out ) const

Writes/Displays the object on an output stream.

Parameters

out	the output stream where the object is written.

◆ x()

template<typename TSpace>

RealPoint DGtal::Ellipse2D< TSpace >::x ( const double t ) const

virtual

Parameters

t	any angle between 0 and 2*Pi.

Returns: the vector (x(t),y(t)) which is the position on the shape boundary.

Implements DGtal::StarShaped2D< TSpace >.

Referenced by isAlmostEqual().

◆ xp()

template<typename TSpace>

RealVector DGtal::Ellipse2D< TSpace >::xp ( const double t ) const

virtual

Parameters

t	any angle between 0 and 2*Pi.

Returns: the vector (x'(t),y'(t)) which is the tangent to the shape boundary.

Implements DGtal::StarShaped2D< TSpace >.

◆ xpp()

template<typename TSpace>

RealVector DGtal::Ellipse2D< TSpace >::xpp ( const double t ) const

virtual

Parameters

t	any angle between 0 and 2*Pi.

Returns: the vector (x''(t),y''(t)).

Implements DGtal::StarShaped2D< TSpace >.

Field Documentation

◆ myAxis1

template<typename TSpace>

double DGtal::Ellipse2D< TSpace >::myAxis1

private

First axis.

Definition at line 202 of file Ellipse2D.h.

Referenced by getLowerBound(), and getUpperBound().

◆ myAxis2

template<typename TSpace>

double DGtal::Ellipse2D< TSpace >::myAxis2

private

Second axis.

Definition at line 208 of file Ellipse2D.h.

◆ myCenter

template<typename TSpace>

RealPoint DGtal::Ellipse2D< TSpace >::myCenter

private

Center of the circle.

Definition at line 197 of file Ellipse2D.h.

Referenced by center(), getLowerBound(), getUpperBound(), and moveTo().

◆ myTheta

template<typename TSpace>

double DGtal::Ellipse2D< TSpace >::myTheta

private

Orientation (radian).

Definition at line 213 of file Ellipse2D.h.

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

Ellipse2D.h

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Typedef Documentation

◆ RealPoint

◆ RealVector

◆ Space

Constructor & Destructor Documentation

◆ Ellipse2D() [1/4]

◆ Ellipse2D() [2/4]

◆ Ellipse2D() [3/4]

◆ Ellipse2D() [4/4]

◆ ~Ellipse2D()

Member Function Documentation

◆ center()

◆ getLowerBound()

◆ getUpperBound()

◆ isAlmostEqual()

◆ isValid()

◆ moveTo()

◆ operator=()

◆ parameter()

◆ selfDisplay()

◆ x()

◆ xp()

◆ xpp()

Field Documentation

◆ myAxis1

◆ myAxis2

◆ myCenter

◆ myTheta