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. More...

#include <math_NewtonFunctionRoot.hxx>

Public Member Functions
	math_NewtonFunctionRoot (math_FunctionWithDerivative &F, const double Guess, const double EpsX, const double EpsF, const int 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 double Guess, const double EpsX, const double EpsF, const double A, const double B, const int 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 double A, const double B, const double EpsX, const double EpsF, const int NbIterations=100)
	is used in a sub-class to initialize correctly all the fields of this class.
void	Perform (math_FunctionWithDerivative &F, const double Guess)
	is used internally by the constructors.
bool	IsDone () const
	Returns true if the computations are successful, otherwise returns false.
double	Root () const
	Returns the value of the root of function <F>. Exception NotDone is raised if the root was not found.
double	Derivative () const
	returns the value of the derivative at the root. Exception NotDone is raised if the root was not found.
double	Value () const
	returns the value of the function at the root. Exception NotDone is raised if the root was not found.
int	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.

Detailed Description

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.

Constructor & Destructor Documentation

math_NewtonFunctionRoot() [1/3]

math_NewtonFunctionRoot::math_NewtonFunctionRoot	(	math_FunctionWithDerivative &	F,
		const double	Guess,
		const double	EpsX,
		const double	EpsF,
		const int	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() [2/3]

math_NewtonFunctionRoot::math_NewtonFunctionRoot	(	math_FunctionWithDerivative &	F,
		const double	Guess,
		const double	EpsX,
		const double	EpsF,
		const double	A,
		const double	B,
		const int	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() [3/3]

math_NewtonFunctionRoot::math_NewtonFunctionRoot	(	const double	A,
		const double	B,
		const double	EpsX,
		const double	EpsF,
		const int	NbIterations = 100 )

is used in a sub-class to initialize correctly all the fields of this class.

Member Function Documentation

Derivative()

double math_NewtonFunctionRoot::Derivative

(

)

const

returns the value of the derivative at the root. Exception NotDone is raised if the root was not found.

Dump()

void math_NewtonFunctionRoot::Dump

(

Standard_OStream &

o

)

const

Prints information on the current state of the object.

IsDone()

bool math_NewtonFunctionRoot::IsDone

(

)

const

Returns true if the computations are successful, otherwise returns false.

NbIterations()

int math_NewtonFunctionRoot::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.

Perform()

void math_NewtonFunctionRoot::Perform	(	math_FunctionWithDerivative &	F,
		const double	Guess )

is used internally by the constructors.

Root()

double math_NewtonFunctionRoot::Root

(

)

const

Returns the value of the root of function <F>. Exception NotDone is raised if the root was not found.

Value()

double math_NewtonFunctionRoot::Value

(

)

const

returns the value of the function at the root. Exception NotDone is raised if the root was not found.

---

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

• math_NewtonFunctionRoot.hxx