new_muller
- sherpa.utils.new_muller(fcn, xa, xb, fa=None, fb=None, args=(), maxfev=32, tol=1e-06)[source] [edit on github]
Alternative implementation of Mueller’s method for root finding
- Parameters:
- fcn
callable() The function with a root. The function signature is
fcn(x, *args).- xa, xb: float
Muller’s method requires three initial values.
- fa, fb: float or None
Function values at
xaandxb. These parameters are optional and can be passed to save time in cases wherefcn(xa, *args)is already known and function evaluation takes a long time. IfNone, they will be calculated.- args
tuple Additional parameters that will be passed through to
fcn.- maxfev
int Maximal number of function evaluations
- tol
float The root finding algorithm stops if the function value a value x with
abs(fcn(x)) < tolis found.
- fcn
- Returns:
- out
list The output has the form of a list:
[[x, fcn(x)], [x1, fcn(x1)], [x2, fcn(x2)], nfev]wherexis the location of the root, andx1andx2are the previous steps. The function value for those steps is returned as well.nfevis the total number of function evaluations. If any of those values is not available,Nonewill be returned instead.
- out