Package net.sf.tweety.math.opt

Class RootFinder

java.lang.Object

net.sf.tweety.math.opt.RootFinder

Direct Known Subclasses:

NewtonRootFinder, OptimizationRootFinder

public abstract class RootFinder
extends Object

Classes which extend this class represent algorithms for finding zero points (roots) of functions.

Author:

Matthias Thimm

Field Summary

Fields

Modifier and Type	Field	Description
static double	PRECISION	The precision for finding roots.

Constructor Summary

Constructors

Constructor	Description
RootFinder(List<Term> functions, Map<Variable,Term> startingPoint)	Creates a new root finder for the given starting point and the given (multi-dimensional) function
RootFinder(Term function)	Creates a new root finder for the given function.
RootFinder(Term function, Map<Variable,Term> startingPoint)	Creates a new root finder for the given starting point and the given function

Method Summary

Modifier and Type	Method	Description
List<Term>	getFunctions()	Returns the function of this root finder.
Map<Variable,Term>	getStartingPoint()	Returns the starting point of this finder.
abstract Map<Variable,Term>	randomRoot()	Determines the values for the variables appearing in the function such the function evaluates to zero.
void	setStartingPoint(Map<Variable,Term> startingPoint)	sets the starting point of this root finder.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PRECISION

public static double PRECISION

The precision for finding roots.

Constructor Detail

RootFinder

public RootFinder(Term function)

Creates a new root finder for the given function.

Parameters:

function - a term

RootFinder

public RootFinder(Term function,
                  Map<Variable,Term> startingPoint)

Creates a new root finder for the given starting point and the given function

Parameters:

function - a function

startingPoint - the starting point

RootFinder

public RootFinder(List<Term> functions,
                  Map<Variable,Term> startingPoint)

Creates a new root finder for the given starting point and the given (multi-dimensional) function

Parameters:

functions - a list of functions

startingPoint - the starting point

Method Detail

setStartingPoint

public void setStartingPoint(Map<Variable,Term> startingPoint)

sets the starting point of this root finder.

Parameters:

startingPoint - the starting point

getStartingPoint

public Map<Variable,Term> getStartingPoint()

Returns the starting point of this finder.

Returns:

the starting point of this finder.

getFunctions

public List<Term> getFunctions()

Returns the function of this root finder.

Returns:

the function of this root finder.

randomRoot

public abstract Map<Variable,Term> randomRoot()
                                             throws GeneralMathException

Determines the values for the variables appearing in the function such the function evaluates to zero.

Returns:

a map from variables to terms such that "function" evaluates to zero.

Throws:

GeneralMathException - if something went wrong.