Home > freetb4matlab > optimization > fzero.m

fzero

PURPOSE ^

% Find a zero point of a univariate function. @var{fun} should be a function

SYNOPSIS ^

function [x, fval, info, output] = fzero (fun, x0, options = struct )

DESCRIPTION ^

% -*- texinfo -*-
% @deftypefn {Function File} {[@var{x}, @var{fval}, @var{info}, @var{output}] =} fzero (@var{fun}, @var{x0}, @var{options})
% Find a zero point of a univariate function.  @var{fun} should be a function
% handle or name.  @var{x0} specifies a starting point.  @var{options} is a
% structure specifying additional options.  Currently, @code{fzero}
% recognizes these options: @code{'FunValCheck'}, @code{'OutputFcn'},
% @code{'TolX'}, @code{'MaxIter'}, @code{'MaxFunEvals'}. 
% For description of these options, see @ref{doc-optimset,,optimset}.
% 
% On exit, the function returns @var{x}, the approximate zero point
% and @var{fval}, the function value thereof.
% @var{info} is an exit flag that can have these values:
% @itemize
% @item 1
% The algorithm converged to a solution.
% @item 0
% Maximum number of iterations or function evaluations has been exhausted.
% @item -1
% The algorithm has been terminated from user output function.
% @item -2 
% A general unexpected error.
% @item -3
% A non-real value encountered.
% @item -4
% A NaN value encountered.
% @end itemize
% @seealso{optimset, fsolve} 
% @end deftypefn

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Fri 22-May-2009 15:13:00 by m2html © 2003