org.opensourcephysics.numerics.rk.irk
Interface AlgebraicEquationSimpleSolver

All Known Subinterfaces:
AlgebraicEquationSolver
All Known Implementing Classes:
IRKSimplifiedNewton, IRKSimplifiedNewtonStep

public interface AlgebraicEquationSimpleSolver

AlgebraicEquationSimpleSolver defines a core of algebraic equation system solver supporting runtime modification of equation. In other words it defines a core of root finder software but equation's right hand function is a multivariable vector function with same dimention that and argument.

Author:
Andrei Goussev

Method Summary
 double resolve()
          Adjust the current approximation as close to the root of right hand function of the algebraic equation system as implemented algorithm can.
 void restart(boolean bestConvergenceRequired)
          Performs preparation in case if algebraic equation was updated.
 void updateInitialValue()
          Informs the algebraic equation solver that current approximation was changed by user.
 

Method Detail

resolve

double resolve()
Adjust the current approximation as close to the root of right hand function of the algebraic equation system as implemented algorithm can. After invoking this method current approximation becomes a quite exact.

Returns:
the convergence rate

restart

void restart(boolean bestConvergenceRequired)
Performs preparation in case if algebraic equation was updated.

Parameters:
bestConvergenceRequired - the requirement to achive best convergence rate. Computation resources can be saved due to some data will stays from previous equation, if paramether set to false

updateInitialValue

void updateInitialValue()
Informs the algebraic equation solver that current approximation was changed by user. It is necessary when new initial values is assigned.