Module imagingbook.common

Package imagingbook.common.geometry.ellipse

Class AlgebraicEllipse

java.lang.Object

imagingbook.common.geometry.ellipse.AlgebraicEllipse

public class AlgebraicEllipse
extends Object

Represents an algebraic ellipse with the implicit equation A x^2 + B x y + C y^2 + D x + E y + F = 0. Parameters A, ..., F are normalized such that B^2 - 4 A C = -1. Instances are immutable. See Secs. 11.2.1 and F.3.1 for details.

[1] W. Burger, M.J. Burge, Digital Image Processing – An Algorithmic Introduction, 3rd ed, Springer (2022).

Version:

2022/11/17

Constructor Summary

Constructors

Constructor	Description
AlgebraicEllipse(double[] p)	Constructor.
AlgebraicEllipse(double A, double B, double C, double D, double E, double F)	Constructor.
AlgebraicEllipse(GeometricEllipse ge)	Constructor.

Method Summary

Modifier and Type	Method	Description
AlgebraicEllipse	duplicate()
boolean	equals(AlgebraicEllipse other, double tolerance)
boolean	equals(Object other)
double	getAlgebraicDistance(Pnt2d p)
double	getGoncharovaDistance(Pnt2d p)
double[]	getParameters()	Return a vector of parameters for this ellipse.
double	getSampsonDistance(Pnt2d p)
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

AlgebraicEllipse

public AlgebraicEllipse(double A,
 double B,
 double C,
 double D,
 double E,
 double F)

Constructor. Creates a AlgebraicEllipse instance by normalizing the supplied parameters [A,...,F] such that d = B^2 - 4 A C = -1. Throws an exception if d is non-negative.

Parameters:

A - ellipse parameter A

B - ellipse parameter B

C - ellipse parameter C

D - ellipse parameter D

E - ellipse parameter E

F - ellipse parameter F

AlgebraicEllipse

public AlgebraicEllipse(double[] p)

Constructor. Creates a AlgebraicEllipse instance from the specified parameter vector [A,...,F].

Parameters:

p - algebraic ellipse parameters

AlgebraicEllipse

public AlgebraicEllipse(GeometricEllipse ge)

Constructor. Creates a AlgebraicEllipse instance from a GeometricEllipse.

Parameters:

ge - a GeometricEllipse

Method Details

getParameters

public double[] getParameters()

Return a vector of parameters for this ellipse. The length of the vector and the meaning of the parameters depends on the concrete ellipse type.

Returns:

a vector of parameters [A, B, C, D, E, F]

getAlgebraicDistance

public double getAlgebraicDistance(Pnt2d p)

getSampsonDistance

public double getSampsonDistance(Pnt2d p)

getGoncharovaDistance

public double getGoncharovaDistance(Pnt2d p)

equals

public boolean equals(Object other)

Overrides:

equals in class Object

equals

public boolean equals(AlgebraicEllipse other,
 double tolerance)

duplicate

public AlgebraicEllipse duplicate()

toString

public String toString()

Overrides:

toString in class Object