Data structure for circle in two dimensions. More...

#include <JCircle2D.hh>

Inheritance diagram for JGEOMETRY2D::JCircle2D:

Public Member Functions
	JCircle2D ()
	Default constructor. More...

	JCircle2D (const JVector2D &point, const double r)
	Constructor. More...

	JCircle2D (const JVector2D &p0, const JVector2D &p1)
	Constructor. More...

	JCircle2D (const JVector2D &p0, const JVector2D &p1, const JVector2D &p2)
	Constructor. More...

template<class T >
	JCircle2D (T __begin, T __end)
	Constructor. More...

double	getRadius () const
	Get radius. More...

void	set (const JVector2D &p0, const JVector2D &p1)
	Set circle. More...

void	set (const JVector2D &p0, const JVector2D &p1, const JVector2D &p2)
	Set circle. More...

template<class T >
void	set (T __begin, T __end)
	Set circle. More...

bool	is_inside (const JVector2D &pos) const
	Check whether given point is inside circle. More...

const JPosition2D &	getPosition () const
	Get position. More...

JPosition2D &	getPosition ()
	Get position. More...

void	setPosition (const JVector2D &pos)
	Set position. More...

	operator JAngle2D () const
	Type conversion operator. More...

	operator JVersor2D () const
	Type conversion operator. More...

JPosition2D &	rotate (const JRotation2D &R)
	Rotate. More...

JPosition2D &	rotate_back (const JRotation2D &R)
	Rotate back. More...

double	getDot (const JAngle2D &angle) const
	Get dot product. More...

double	getDot (const JVersor2D &versor) const
	Get dot product. More...

double	getDot (const JVector2D &point) const
	Get dot product. More...

double	getPerpDot (const JAngle2D &angle) const
	Get perpendicular dot product. More...

double	getPerpDot (const JVersor2D &dir) const
	Get perpendicular dot product. More...

double	getPerpDot (const JVector2D &point) const
	Get perpendicular dot product. More...

double	getX () const
	Get x position. More...

double	getY () const
	Get y position. More...

JVector2D &	negate ()
	Negate vector. More...

JVector2D &	add (const JVector2D &vector)
	Add vector. More...

JVector2D &	sub (const JVector2D &vector)
	Subtract vector. More...

JVector2D &	mul (const double factor)
	Scale vector. More...

JVector2D &	mul (const JNullType &object)
	Multiply with object. More...

JVector2D &	div (const double factor)
	Scale vector. More...

JVector2D &	transform (const JMatrix2D &T)
	Transform. More...

bool	equals (const JVector2D &vector, const double precision=std::numeric_limits< double >::min()) const
	Check equality. More...

double	getLengthSquared () const
	Get length squared. More...

double	getLength () const
	Get length. More...

double	getDistanceSquared (const JVector2D &point) const
	Get squared of distance to point. More...

double	getDistance (const JVector2D &point) const
	Get distance to point. More...

Protected Attributes
double	__r

double	__x

double	__y

Private Member Functions
template<class T >
void	configure (T __begin, T __end, const JVector2D &p0)
	Determine smallest enclosing circle. More...

template<class T >
void	configure (T __begin, T __end, const JVector2D &p0, const JVector2D &p1)
	Determine smallest enclosing circle. More...

Friends
std::istream &	operator>> (std::istream &in, JCircle2D &circle)
	Read circle from input stream. More...

std::ostream &	operator<< (std::ostream &out, const JCircle2D &circle)
	Write circle to output stream. More...

JReader &	operator>> (JReader &in, JCircle2D &circle)
	Read circle from input. More...

JWriter &	operator<< (JWriter &out, const JCircle2D &circle)
	Write circle to output. More...

Detailed Description

Data structure for circle in two dimensions.

Definition at line 29 of file JCircle2D.hh.

Constructor & Destructor Documentation

JGEOMETRY2D::JCircle2D::JCircle2D ( )

inline

Default constructor.

Definition at line 36 of file JCircle2D.hh.

                 :
       JPosition2D(),
       __r(0.0)
     {}

JGEOMETRY2D::JCircle2D::JCircle2D	(	const JVector2D &	point,
		const double	r
	)

inline

Constructor.

Parameters

point	point
r	radius

Definition at line 48 of file JCircle2D.hh.

                                   :
       JPosition2D(point),
       __r(r)
     {}

JGEOMETRY2D::JCircle2D::JCircle2D	(	const JVector2D &	p0,
		const JVector2D &	p1
	)

inline

Constructor.

Determines circle through two points.

Parameters

p0	first point
p1	second point

Definition at line 62 of file JCircle2D.hh.

                                    :
       JPosition2D(),
       __r(0.0)
     {
       set(p0, p1);
     }

JGEOMETRY2D::JCircle2D::JCircle2D	(	const JVector2D &	p0,
		const JVector2D &	p1,
		const JVector2D &	p2
	)

inline

Constructor.

Determines circle through three points.

Parameters

p0	first point
p1	second point
p2	third point

Definition at line 79 of file JCircle2D.hh.

                                    :
       JPosition2D(),
       __r(0.0)
     {
       set(p0, p1, p2);
     }

template<class T >

JGEOMETRY2D::JCircle2D::JCircle2D	(	T	__begin,
		T	__end
	)

inline

Constructor.

Determines smallest enclosing circle around set of points. The type of data should have the following member methods:

    double getX();   // x coordinate
    double getY();   // y coordinate

Reference: Computational Geometry Algorithms and Applications Authors: de Berg, M., Cheong, O., van Kreveld, M., Overmars, M.

Parameters

__begin	begin of data
__end	end of data

Definition at line 107 of file JCircle2D.hh.

                        :
       JPosition2D(),
       __r(0.0)
     {
       set(__begin, __end);
     }

Member Function Documentation

double JGEOMETRY2D::JCircle2D::getRadius ( ) const

inline

Get radius.

Returns: radius

Definition at line 121 of file JCircle2D.hh.

     { 
       return __r;
     }

void JGEOMETRY2D::JCircle2D::set	(	const JVector2D &	p0,
		const JVector2D &	p1
	)

inline

Set circle.

Determines circle through two points.

Parameters

p0	first point
p1	second point

Definition at line 134 of file JCircle2D.hh.

     {
       __x = 0.5 * (p0.getX() + p1.getX());
       __y = 0.5 * (p0.getY() + p1.getY());      
       __r = this->getDistance(p0);
     }

void JGEOMETRY2D::JCircle2D::set	(	const JVector2D &	p0,
		const JVector2D &	p1,
		const JVector2D &	p2
	)

inline

Set circle.

Determines circle through three points.

Parameters

p0	first point
p1	second point
p2	third point

Definition at line 151 of file JCircle2D.hh.

     {
       const double x0 = p2.getX() - p1.getX();
       const double x1 = p0.getX() - p2.getX();
       const double x2 = p1.getX() - p0.getX();
 
       const double y0 = p1.getY() - p2.getY();
       const double y1 = p2.getY() - p0.getY();
       const double y2 = p0.getY() - p1.getY();
 
       const double D  = 2.0 * (p0.getX()*y0 + p1.getX()*y1 + p2.getX()*y2);
 
       if (D != 0.0) {
 
         const double a = p0.getLengthSquared();
         const double b = p1.getLengthSquared();
         const double c = p2.getLengthSquared();
 
         __x = (a*y0 + b*y1 + c*y2) / D;
         __y = (a*x0 + b*x1 + c*x2) / D;
         __r = this->getDistance(p0);
 
       } else {
 
         set(p0, p1);
 
         const JCircle2D c1(p1, p2);
         const JCircle2D c2(p0, p2);
 
         if (c1.getRadius() > this->getRadius()) { *this = c1; }
         if (c2.getRadius() > this->getRadius()) { *this = c2; }
       }
     }

template<class T >

void JGEOMETRY2D::JCircle2D::set	(	T	__begin,
		T	__end
	)

inline

Set circle.

Determines smallest enclosing circle around set of points.

    double getX();   // x coordinate
    double getY();   // y coordinate

Parameters

__begin	begin of data
__end	end of data

Definition at line 200 of file JCircle2D.hh.

     {
       if        (std::distance(__begin,__end) == 1) {
 
         __x = __begin->getX();
         __y = __begin->getY();
         __r = 0.0;
 
       } else if (std::distance(__begin,__end) >  1) {
 
         T j = __begin;
         
         const JVector2D p0(j->getX(), j->getY());
 
         ++j;
 
         const JVector2D p1(j->getX(), j->getY());
 
         set(p0, p1);
 
         while (++j != __end) {
 
           const JVector2D p2(j->getX(), j->getY());
 
           if (this->getDistance(p2) > this->getRadius()) {
             configure(__begin, j, p2);
           }
         }
       }
     }

bool JGEOMETRY2D::JCircle2D::is_inside ( const JVector2D & pos ) const

inline

Check whether given point is inside circle.

Parameters

pos position

Returns: true if inside; else false

Definition at line 239 of file JCircle2D.hh.

     {
       return (this->getDistance(pos) <= this->getRadius());
     }

template<class T >

void JGEOMETRY2D::JCircle2D::configure	(	T	__begin,
		T	__end,
		const JVector2D &	p0
	)

inlineprivate

Determine smallest enclosing circle.

Parameters

__begin	begin of data
__end	end of data
p0	point on circle

Definition at line 323 of file JCircle2D.hh.

     {
       this->set(JVector2D(__begin->getX(), __begin->getY()), p0);
       
       for (T i = __begin; ++i != __end; ) {
 
         const JVector2D p1(i->getX(), i->getY());
 
         if (this->getDistance(p1) > this->getRadius()) {
           configure(__begin, i, p0, p1);
         }
       }
     }

template<class T >

void JGEOMETRY2D::JCircle2D::configure	(	T	__begin,
		T	__end,
		const JVector2D &	p0,
		const JVector2D &	p1
	)

inlineprivate

Determine smallest enclosing circle.

Parameters

__begin	begin of data
__end	end of data
p0	point on circle
p1	point on circle

Definition at line 349 of file JCircle2D.hh.

     {
       this->set(p0, p1);
 
       for (T i = __begin; i != __end; ++i) {
 
         const JVector2D p2(i->getX(), i->getY());
 
         if (this->getDistance(p2) > this->getRadius()) {
 
           const JCircle2D c1(p0, p1, p2);
 
           if (c1.getRadius() > this->getRadius()) { *this = c1; }
         }
       }
     }

const JPosition2D& JGEOMETRY2D::JPosition2D::getPosition ( ) const

inlineinherited

Get position.

Returns: position

Definition at line 97 of file JPosition2D.hh.

     {
       return static_cast<const JPosition2D&>(*this);
     }

JPosition2D& JGEOMETRY2D::JPosition2D::getPosition ( )

inlineinherited

Get position.

Returns: position

Definition at line 108 of file JPosition2D.hh.

     {
       return static_cast<JPosition2D&>(*this);
     }

void JGEOMETRY2D::JPosition2D::setPosition ( const JVector2D & pos )

inlineinherited

Set position.

Parameters

pos position

Definition at line 119 of file JPosition2D.hh.

     {
       static_cast<JVector2D&>(*this) = pos;
     }

JGEOMETRY2D::JPosition2D::operator JAngle2D ( ) const

inlineinherited

Type conversion operator.

Returns: angle

Definition at line 130 of file JPosition2D.hh.

     {
       return JAngle2D(getX(), getY());
     }

JGEOMETRY2D::JPosition2D::operator JVersor2D ( ) const

inlineinherited

Type conversion operator.

Returns: direction

Definition at line 141 of file JPosition2D.hh.

     {
       return JVersor2D(getX(), getY());
     }

JPosition2D& JGEOMETRY2D::JPosition2D::rotate ( const JRotation2D & R )

inlineinherited

Rotate.

Parameters

R	rotation matrix

Returns: this position

Definition at line 153 of file JPosition2D.hh.

     {
       R.rotate(__x, __y);
 
       return *this;
     }

JPosition2D& JGEOMETRY2D::JPosition2D::rotate_back ( const JRotation2D & R )

inlineinherited

Rotate back.

Parameters

R	rotation matrix

Returns: this position

Definition at line 167 of file JPosition2D.hh.

     {
       R.rotate_back(__x, __y);
 
       return *this;
     }

double JGEOMETRY2D::JPosition2D::getDot ( const JAngle2D & angle ) const

inlineinherited

Get dot product.

Parameters

angle angle

Returns: dot product

Definition at line 181 of file JPosition2D.hh.

     {
       return
         getX() * angle.getDX() +
         getY() * angle.getDY();
     }

double JGEOMETRY2D::JPosition2D::getDot ( const JVersor2D & versor ) const

inlineinherited

Get dot product.

Parameters

versor versor

Returns: dot product

Definition at line 195 of file JPosition2D.hh.

     {
       return
         getX() * versor.getDX() +
         getY() * versor.getDY();
     }

double JGEOMETRY2D::JVector2D::getDot ( const JVector2D & point ) const

inlineinherited

Get dot product.

Parameters

point vector

Returns: dot product

Definition at line 234 of file JVector2D.hh.

     {
       return
         getX() * point.getX() + 
         getY() * point.getY();
     }

double JGEOMETRY2D::JPosition2D::getPerpDot ( const JAngle2D & angle ) const

inlineinherited

Get perpendicular dot product.

Parameters

angle angle

Returns: perpendicular dot product

Definition at line 209 of file JPosition2D.hh.

     {
       return
         getX() * angle.getDY() -
         getY() * angle.getDX();
     }

double JGEOMETRY2D::JPosition2D::getPerpDot ( const JVersor2D & dir ) const

inlineinherited

Get perpendicular dot product.

Parameters

dir direction

Returns: perpendicular dot product

Definition at line 223 of file JPosition2D.hh.

     {
       return
         getX() * dir.getDY() -
         getY() * dir.getDX();
     }

double JGEOMETRY2D::JVector2D::getPerpDot ( const JVector2D & point ) const

inlineinherited

Get perpendicular dot product.

Parameters

point vector

Returns: perpendicular dot product

Definition at line 248 of file JVector2D.hh.

     {
       return
         getX() * point.getY() - 
         getY() * point.getX();
     }

double JGEOMETRY2D::JVector2D::getX ( ) const

inlineinherited

Get x position.

Returns: x position

Definition at line 62 of file JVector2D.hh.

     { 
       return __x;
     }

double JGEOMETRY2D::JVector2D::getY ( ) const

inlineinherited

Get y position.

Returns: y position

Definition at line 73 of file JVector2D.hh.

     { 
       return __y;
     }

JVector2D& JGEOMETRY2D::JVector2D::negate ( )

inlineinherited

Negate vector.

Returns: this vector

Definition at line 84 of file JVector2D.hh.

     {
       __x = -__x;
       __y = -__y;
 
       return *this;
     }

JVector2D& JGEOMETRY2D::JVector2D::add ( const JVector2D & vector )

inlineinherited

Add vector.

Parameters

vector vector

Returns: this vector

Definition at line 99 of file JVector2D.hh.

     {
       __x += vector.getX();
       __y += vector.getY();
 
       return *this;
     }

JVector2D& JGEOMETRY2D::JVector2D::sub ( const JVector2D & vector )

inlineinherited

Subtract vector.

Parameters

vector vector

Returns: this vector

Definition at line 114 of file JVector2D.hh.

     {
       __x -= vector.getX();
       __y -= vector.getY();
 
       return *this;
     }

JVector2D& JGEOMETRY2D::JVector2D::mul ( const double factor )

inlineinherited

Scale vector.

Parameters

factor multiplication factor

Returns: this vector

Definition at line 129 of file JVector2D.hh.

     {
       __x *= factor;
       __y *= factor;
 
       return *this;
     }

JVector2D & JMATH::JMath< JVector2D , JNullType >::mul ( const JNullType & object )

inlineinherited

Multiply with object.

Parameters

object object

Returns: result object

Definition at line 273 of file JMath.hh.

     {
       return static_cast<JFirst_t&>(*this) = JCalculator<JFirst_t>::calculator.mul(static_cast<const JFirst_t&>(*this), object);
     }

JVector2D& JGEOMETRY2D::JVector2D::div ( const double factor )

inlineinherited

Scale vector.

Parameters

factor division factor

Returns: this vector

Definition at line 144 of file JVector2D.hh.

     {
       __x /= factor;
       __y /= factor;
 
       return *this;
     }

JVector2D& JGEOMETRY2D::JVector2D::transform ( const JMatrix2D & T )

inlineinherited

Transform.

Parameters

T matrix

Returns: this vector

Definition at line 159 of file JVector2D.hh.

     {
       T.transform(__x, __y);
 
       return *this;
     }

bool JGEOMETRY2D::JVector2D::equals	(	const JVector2D &	vector,
		const double	precision = `std::numeric_limits<double>::min()`
	)		const

inlineinherited

Check equality.

Parameters

vector	vector
precision	precision

Returns: true if vectors are equal; else false

Definition at line 174 of file JVector2D.hh.

     {
       return (fabs(getX() - vector.getX()) <= precision &&
               fabs(getY() - vector.getY()) <= precision);
     }

double JGEOMETRY2D::JVector2D::getLengthSquared ( ) const

inlineinherited

Get length squared.

Returns: square of length

Definition at line 187 of file JVector2D.hh.

     { 
       return getX()*getX() + getY()*getY();
     }

double JGEOMETRY2D::JVector2D::getLength ( ) const

inlineinherited

Get length.

Returns: length

Definition at line 198 of file JVector2D.hh.

     { 
       return sqrt(getLengthSquared());
     }

double JGEOMETRY2D::JVector2D::getDistanceSquared ( const JVector2D & point ) const

inlineinherited

Get squared of distance to point.

Parameters

point point

Returns: square of distance

Definition at line 210 of file JVector2D.hh.

     {
       return JVector2D(point).sub(*this).getLengthSquared();
     }

double JGEOMETRY2D::JVector2D::getDistance ( const JVector2D & point ) const

inlineinherited

Get distance to point.

Parameters

point point

Returns: distance

Definition at line 222 of file JVector2D.hh.

     {
       return sqrt(getDistanceSquared(point));
     }

Friends And Related Function Documentation

std::istream& operator>>	(	std::istream &	in,
		JCircle2D &	circle
	)

friend

Read circle from input stream.

Parameters

in	input stream
circle	circle

Returns: input stream

Definition at line 252 of file JCircle2D.hh.

     {
       in >> static_cast<JPosition2D&>(circle);
       in >> circle.__r;
 
       return in;
     }

std::ostream& operator<<	(	std::ostream &	out,
		const JCircle2D &	circle
	)

friend

Write circle to output stream.

Parameters

out	output stream
circle	circle

Returns: output stream

Definition at line 268 of file JCircle2D.hh.

     {
       out << static_cast<const JPosition2D&>(circle);
       out << ' ';
       out << circle.__r;
 
       return out;
     }

JReader& operator>>	(	JReader &	in,
		JCircle2D &	circle
	)

friend

Read circle from input.

Parameters

in	reader
circle	circle

Returns: reader

Definition at line 285 of file JCircle2D.hh.

     {
       in >> static_cast<JPosition2D&>(circle);
       in >> circle.__r;
 
       return in;
     }

JWriter& operator<<	(	JWriter &	out,
		const JCircle2D &	circle
	)

friend

Write circle to output.

Parameters

out	writer
circle	circle

Returns: writer

Definition at line 301 of file JCircle2D.hh.

     {
       out << static_cast<const JPosition2D&>(circle);
       out << circle.__r;
 
       return out;
     }

Member Data Documentation

double JGEOMETRY2D::JCircle2D::__r

protected

Definition at line 311 of file JCircle2D.hh.

double JGEOMETRY2D::JVector2D::__x

protectedinherited

Definition at line 256 of file JVector2D.hh.

double JGEOMETRY2D::JVector2D::__y

protectedinherited

Definition at line 257 of file JVector2D.hh.

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

JCircle2D.hh

Public Member Functions

Protected Attributes

Private Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation