Open CASCADE Technology  6.5.4
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Defines
Public Member Functions
math_NewtonFunctionRoot Class Reference

This class implements the calculation of a root of a function of
a single variable starting from an initial near guess using the
Newton algorithm. Knowledge of the derivative is required.

#include <math_NewtonFunctionRoot.hxx>

Public Member Functions

DEFINE_STANDARD_ALLOC math_NewtonFunctionRoot (math_FunctionWithDerivative &F, const Standard_Real Guess, const Standard_Real EpsX, const Standard_Real EpsF, const Standard_Integer NbIterations=100)
 The Newton method is done to find the root of the function F
from the initial guess Guess.
The tolerance required on the root is given by Tolerance.
The solution is found when :
abs(Xi - Xi-1) <= EpsX and abs(F(Xi))<= EpsF
The maximum number of iterations allowed is given by NbIterations.

 math_NewtonFunctionRoot (math_FunctionWithDerivative &F, const Standard_Real Guess, const Standard_Real EpsX, const Standard_Real EpsF, const Standard_Real A, const Standard_Real B, const Standard_Integer NbIterations=100)
 The Newton method is done to find the root of the function F
from the initial guess Guess.
The solution must be inside the interval [A, B].
The tolerance required on the root is given by Tolerance.
The solution is found when :
abs(Xi - Xi-1) <= EpsX and abs(F(Xi))<= EpsF
The maximum number of iterations allowed is given by NbIterations.

 math_NewtonFunctionRoot (const Standard_Real A, const Standard_Real B, const Standard_Real EpsX, const Standard_Real EpsF, const Standard_Integer NbIterations=100)
 is used in a sub-class to initialize correctly all the fields
of this class.

void Perform (math_FunctionWithDerivative &F, const Standard_Real Guess)
 is used internally by the constructors.

Standard_Boolean IsDone () const
 Returns true if the computations are successful, otherwise returns false.

Standard_Real Root () const
 Returns the value of the root of function <F>.
Exception NotDone is raised if the root was not found.

Standard_Real Derivative () const
 returns the value of the derivative at the root.
Exception NotDone is raised if the root was not found.

Standard_Real Value () const
 returns the value of the function at the root.
Exception NotDone is raised if the root was not found.

Standard_Integer NbIterations () const
 Returns the number of iterations really done on the
computation of the Root.
Exception NotDone is raised if the root was not found.

void Dump (Standard_OStream &o) const
 Prints information on the current state of the object.


Constructor & Destructor Documentation


Member Function Documentation


The documentation for this class was generated from the following file: