de.unihalle.informatik.MiToBo.math.fitting

Class FitQuadraticCurveToPointSet

java.lang.Object

de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.MiToBo.core.operator.MTBOperator

de.unihalle.informatik.MiToBo.math.fitting.FitQuadraticCurveToPointSet

All Implemented Interfaces:

de.unihalle.informatik.Alida.datatypes.ALDConfigurationValidator, de.unihalle.informatik.Alida.operator.events.ALDOperatorExecutionProgressEventListener, EventListener

@ALDAOperator(genericExecutionMode=NONE,
              level=STANDARD)
public class FitQuadraticCurveToPointSet
extends MTBOperator

Operator that fits a quadratic curve or conic to a given set of 2D points.

A general quadratic curve is defined by the following implicit equation:

\begin{equation*} a \cdot x^2 + 2 b \cdot x \cdot y + c \cdot y^2 + 2 d \cdot x + 2 e \cdot y + f = 0 \end{equation*}

This operator estimates the parameters of a conic in a least square sense from a given set of 2D points. The point set is required to contain at least 5 points which is the minimal number of points necessary to uniquely estimate the parameters.

The result is given by an object of type MTBQuadraticCurve2D which can be asked for the concrete type of the estimated conic, e.g., if it is an ellipse, hyperbola or parabola.

Author:

Birgit Moeller

See Also:

MTBQuadraticCurve2D, Ellipses on WolframMathWorld, Efficient Java Matrix Library

Nested Class Summary

Nested classes/interfaces inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

de.unihalle.informatik.Alida.operator.ALDOperator.HidingMode, de.unihalle.informatik.Alida.operator.ALDOperator.HistoryConstructionMode

Field Summary

Fields

Modifier and Type	Field and Description
private MTBQuadraticCurve2D	curve Estimated curve.
private Vector<Point2D.Double>	points Input set of points.

Fields inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

completeDAG, name, operatorExecutionEventlistenerList, portHashAccess, verbose, versionProvider

Constructor Summary

Constructors

Constructor and Description
FitQuadraticCurveToPointSet() Default constructor.

Method Summary

Modifier and Type	Method and Description
MTBQuadraticCurve2D	getEstimatedCurve() Get estimated curve.
protected void	operate()
void	setPointSet(Vector<Point2D.Double> p) Set input set of 2D points.
void	validateCustom()

Methods inherited from class de.unihalle.informatik.MiToBo.core.operator.MTBOperator

readResolve

Methods inherited from class de.unihalle.informatik.Alida.operator.ALDOperator

addOperatorExecutionProgressEventListener, addParameter, addParameter, addParameterUnconditioned, fieldContained, fireOperatorExecutionProgressEvent, getALDPortHashAccessKey, getConstructionMode, getDocumentation, getHidingMode, getInactiveParameterNames, getInInoutNames, getInInoutNames, getInNames, getInOutNames, getMissingRequiredInputs, getName, getNumParameters, getOutInoutNames, getOutNames, getParameter, getParameterDescriptor, getParameterDescriptorUnconditioned, getParameterNames, getParameterUnconditioned, getSupplementalNames, getVerbose, getVersion, handleOperatorExecutionProgressEvent, hasInOutParameters, hasParameter, isAnnotatedParameter, isConfigured, print, print, print, printInterface, printInterface, readHistory, reinitializeParameterDescriptors, removeOperatorExecutionProgressEventListener, removeParameter, runOp, runOp, runOp, setConstructionMode, setConstructionMode, setConstructionMode, setHidingMode, setName, setParameter, setParameterUnconditioned, setVerbose, toStringVerbose, unconfiguredItems, validate, validateGeneric, writeHistory, writeHistory, writeHistory

Methods inherited from class java.lang.Object

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

Field Detail

points

@Parameter(label="Point Set",
           required=true,
           dataIOOrder=0,
           direction=IN,
           description="Point Set.")
private Vector<Point2D.Double> points

Input set of points.

curve

@Parameter(label="Curve",
           dataIOOrder=1,
           direction=OUT,
           description="Estimated curve.")
private MTBQuadraticCurve2D curve

Estimated curve.

Constructor Detail

FitQuadraticCurveToPointSet

public FitQuadraticCurveToPointSet()
                            throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Default constructor.

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException - Thrown in case of operate failure.

Method Detail

validateCustom

public void validateCustom()
                    throws de.unihalle.informatik.Alida.exceptions.ALDOperatorException

Overrides:

validateCustom in class de.unihalle.informatik.Alida.operator.ALDOperator

Throws:

de.unihalle.informatik.Alida.exceptions.ALDOperatorException

operate

protected void operate()

Specified by:

operate in class de.unihalle.informatik.Alida.operator.ALDOperator

setPointSet

public void setPointSet(Vector<Point2D.Double> p)

Set input set of 2D points.

Parameters:

p - Set of points to process.

getEstimatedCurve

public MTBQuadraticCurve2D getEstimatedCurve()

Get estimated curve.

Returns:

Estimated curve.