Package com.irurueta.geometry.estimators

Class MSACConicRobustEstimator

java.lang.Object
com.irurueta.geometry.estimators.ConicRobustEstimator
com.irurueta.geometry.estimators.MSACConicRobustEstimator
public class MSACConicRobustEstimator extends ConicRobustEstimator
Finds the best conic for provided collection of 2D points using MSAC algorithm.

  • Field Details

    • DEFAULT_THRESHOLD

      public static final double DEFAULT_THRESHOLD
      Constant defining default threshold to determine whether points are inliers or not. Threshold is defined by the equation abs(trans(x) * C * x) < t, where trans is the transposition, x i a point and C is a conic and t is a threshold. This equation determines the points x belonging to the locus of a conic C up to a certain threshold.
      See Also:

    • MIN_THRESHOLD

      public static final double MIN_THRESHOLD
      Minimum value that can be set as threshold. Threshold must be strictly greater than 0.0.
      See Also:

    • threshold

      private double threshold
      Threshold to determine whether points are inliers or not when testing possible estimation solutions. The threshold refers to the amount of error (i.e. distance) a possible solution has on a matched pair of points.

  • Constructor Details

    • MSACConicRobustEstimator

      public MSACConicRobustEstimator()
      Constructor.

    • MSACConicRobustEstimator

      public MSACConicRobustEstimator(List<Point2D> points)
      Constructor with points.
      Parameters:
      points - 2D points to estimate a conic.
      Throws:
      IllegalArgumentException - if provided list of points don't have a size greater or equal than MINIMUM_SIZE.

    • MSACConicRobustEstimator

      public MSACConicRobustEstimator(ConicRobustEstimatorListener listener)
      Constructor.
      Parameters:
      listener - listener to be notified of events such as when estimation starts, ends or its progress significantly changes.

    • MSACConicRobustEstimator

      public MSACConicRobustEstimator(ConicRobustEstimatorListener listener, List<Point2D> points)
      Constructor.
      Parameters:
      listener - listener to be notified of events such as when estimation starts, ends or its progress significantly changes.
      points - 2D points to estimate a conic.
      Throws:
      IllegalArgumentException - if provided list of points don't have a size greater or equal than MINIMUM_SIZE.

  • Method Details

    • getThreshold

      public double getThreshold()
      Returns threshold to determine whether points are inliers or not when testing possible estimation solutions. The threshold refers to the amount of error a possible solution has on a given point.
      Returns:
      threshold to determine whether points are inliers or not when testing possible estimation solutions.

    • setThreshold

      public void setThreshold(double threshold) throws LockedException
      Sets threshold to determine whether points are inliers or not when testing possible estimation solutions. The threshold refers to the amount of error a possible solution has on a given point.
      Parameters:
      threshold - threshold to be set.
      Throws:
      IllegalArgumentException - if provided value is equal or less than zero.
      LockedException - if robust estimator is locked because an estimation is already in progress.

    • estimate

      public Conic estimate() throws LockedException, NotReadyException, com.irurueta.numerical.robust.RobustEstimatorException
      Estimates a conic using a robust estimator and the best set of 2D points that fit into the locus of the estimated conic found using the robust estimator.
      Specified by:
      estimate in class ConicRobustEstimator
      Returns:
      a conic.
      Throws:
      LockedException - if robust estimator is locked because an estimation is already in progress.
      NotReadyException - if provided input data is not enough to start the estimation.
      com.irurueta.numerical.robust.RobustEstimatorException - if estimation fails for any reason (i.e. numerical instability, no solution available, etc).

    • getMethod

      public com.irurueta.numerical.robust.RobustEstimatorMethod getMethod()
      Returns method being used for robust estimation.
      Specified by:
      getMethod in class ConicRobustEstimator
      Returns:
      method being used for robust estimation.