Package org.apache.commons.math.estimation

Class AbstractEstimator

  • All Implemented Interfaces:
    Estimator
    Direct Known Subclasses:
    GaussNewtonEstimator, LevenbergMarquardtEstimator
    @Deprecated
public abstract class AbstractEstimator
extends java.lang.Object
implements Estimator
    Deprecated.
    as of 2.0, everything in package org.apache.commons.math.estimation has been deprecated and replaced by package org.apache.commons.math.optimization.general
    Base class for implementing estimators.

    This base class handles the boilerplates methods associated to thresholds settings, jacobian and error estimation.

    Since:
    1.2

    • Field Detail

      • DEFAULT_MAX_COST_EVALUATIONS

        public static final int DEFAULT_MAX_COST_EVALUATIONS
        Deprecated.
        Default maximal number of cost evaluations allowed.
        See Also:
        Constant Field Values

    • Method Detail

      • getCostEvaluations

        public final int getCostEvaluations()
        Deprecated.
        Get the number of cost evaluations.
        Returns:
        number of cost evaluations

      • getJacobianEvaluations

        public final int getJacobianEvaluations()
        Deprecated.
        Get the number of jacobian evaluations.
        Returns:
        number of jacobian evaluations

      • getRMS

        public double getRMS​(EstimationProblem problem)
        Deprecated.
        Get the Root Mean Square value. Get the Root Mean Square value, i.e. the root of the arithmetic mean of the square of all weighted residuals. This is related to the criterion that is minimized by the estimator as follows: if c if the criterion, and n is the number of measurements, then the RMS is sqrt (c/n).
        Specified by:
        getRMS in interface Estimator
        Parameters:
        problem - estimation problem
        Returns:
        RMS value
        See Also:
        Estimator.guessParametersErrors(EstimationProblem)

      • getChiSquare

        public double getChiSquare​(EstimationProblem problem)
        Deprecated.
        Get the Chi-Square value.
        Parameters:
        problem - estimation problem
        Returns:
        chi-square value

      • getCovariances

        public double[][] getCovariances​(EstimationProblem problem)
                          throws EstimationException
        Deprecated.
        Get the covariance matrix of unbound estimated parameters.
        Specified by:
        getCovariances in interface Estimator
        Parameters:
        problem - estimation problem
        Returns:
        covariance matrix
        Throws:
        EstimationException - if the covariance matrix cannot be computed (singular problem)

      • guessParametersErrors

        public double[] guessParametersErrors​(EstimationProblem problem)
                               throws EstimationException
        Deprecated.
        Guess the errors in unbound estimated parameters.

        Guessing is covariance-based, it only gives rough order of magnitude.

        Specified by:
        guessParametersErrors in interface Estimator
        Parameters:
        problem - estimation problem
        Returns:
        errors in estimated parameters
        Throws:
        EstimationException - if the covariances matrix cannot be computed or the number of degrees of freedom is not positive (number of measurements lesser or equal to number of parameters)
        See Also:
        Estimator.getRMS(EstimationProblem)

      • estimate

        public abstract void estimate​(EstimationProblem problem)
                       throws EstimationException
        Deprecated.
        Solve an estimation problem.

        The method should set the parameters of the problem to several trial values until it reaches convergence. If this method returns normally (i.e. without throwing an exception), then the best estimate of the parameters can be retrieved from the problem itself, through the EstimationProblem.getAllParameters method.

        Specified by:
        estimate in interface Estimator
        Parameters:
        problem - estimation problem to solve
        Throws:
        EstimationException - if the problem cannot be solved