Module imagingbook.common
Package imagingbook.common.geometry.fitting.ellipse.algebraic

Interface EllipseFitAlgebraic

All Known Implementing Classes:
EllipseFit5Points, EllipseFitFitzgibbonNaive, EllipseFitFitzgibbonOriginal, EllipseFitFitzgibbonStable, EllipseFitTaubin1, EllipseFitTaubin2
public interface EllipseFitAlgebraic
Interface for algebraic ellipse fits.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static enum 
    EllipseFitAlgebraic.FitType
     

  • Method Summary

    Modifier and Type
    Method
    Description
    default RealMatrix
    getDataOffsetCorrectionMatrix(double xr, double yr)
    Returns a 6x6 matrix (U) to convert ellipse parameters qr = (ar,...,fr) calculated for data centered at (xr, yr) to ellipse parameters q = (a,...,f) for the original non-centered data: q = U * qr.
    default AlgebraicEllipse
    getEllipse()
    Returns a algebraic ellipse constructed from the estimated ellipse parameters.
    static EllipseFitAlgebraic
    getFit(EllipseFitAlgebraic.FitType type, Pnt2d[] points, Pnt2d xref)
     
    double[]
    getParameters()
    Returns a vector of algebraic ellipse parameters: (a,b,c,d,e,f), representing the ellipse by a x^2 + b x y + c y^2 + d x + e y + f = 0.
    default boolean
    isEllipse()
     
    static void
    main(String[] args)
     

  • Method Details

    • getFit

      static EllipseFitAlgebraic getFit(EllipseFitAlgebraic.FitType type, Pnt2d[] points, Pnt2d xref)

    • getParameters

      double[] getParameters()
      Returns a vector of algebraic ellipse parameters: (a,b,c,d,e,f), representing the ellipse by a x^2 + b x y + c y^2 + d x + e y + f = 0.
      Returns:
      the ellipse parameters

    • getEllipse

      default AlgebraicEllipse getEllipse()
      Returns a algebraic ellipse constructed from the estimated ellipse parameters.
      Returns:
      an AlgebraicEllipse instance

    • isEllipse

      default boolean isEllipse()

    • getDataOffsetCorrectionMatrix

      default RealMatrix getDataOffsetCorrectionMatrix(double xr, double yr)

      Returns a 6x6 matrix (U) to convert ellipse parameters qr = (ar,...,fr) calculated for data centered at (xr, yr) to ellipse parameters q = (a,...,f) for the original non-centered data: q = U * qr. See [1, Sec. 11.2.1] (e.g., Alg. 11.6) for additional information.

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

      Parameters:
      xr - data reference point (x)
      yr - data reference point (y)
      Returns:
      the offset correction matrix (U)

    • main

      static void main(String[] args)