Mercurial > hg > octave-lyh
changeset 12521:02e48856e486
Add fminbnd, fminunc functions to documentation.
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Fri, 18 Mar 2011 21:25:08 -0700 |
parents | ad05e1547398 |
children | 33bbae85769a |
files | doc/ChangeLog doc/interpreter/nonlin.txi doc/interpreter/octave.texi |
diffstat | 3 files changed, 45 insertions(+), 3 deletions(-) [+] |
line wrap: on
line diff
--- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2010-03-18 Rik <octave@nomad.inbox5.com> + + * interpreter/nonlin.txi, interpreter/octave.texi: Add fminbnd, + fminunc functions to documentation. + 2010-03-18 Rik <octave@nomad.inbox5.com> * interpreter/arith.txi, interpreter/linalg.txi: Add function chop
--- a/doc/interpreter/nonlin.txi +++ b/doc/interpreter/nonlin.txi @@ -21,6 +21,14 @@ @cindex nonlinear equations @cindex equations, nonlinear +@menu +* Solvers:: +* Minimizers:: +@end menu + +@node Solvers +@section Solvers + Octave can solve sets of nonlinear equations of the form @tex $$ @@ -36,14 +44,14 @@ @end ifnottex @noindent -using the function @code{fsolve}, which is based on the @sc{Minpack} +using the function @code{fsolve}, which is based on the @sc{minpack} subroutine @code{hybrd}. This is an iterative technique so a starting -point will have to be provided. This also has the consequence that +point must be provided. This also has the consequence that convergence is not guaranteed even if a solution exists. @DOCSTRING(fsolve) -Here is a complete example. To solve the set of equations +The following is a complete example. To solve the set of equations @tex $$ \eqalign{-2x^2 + 3xy + 4\sin(y) - 6 &= 0\cr @@ -164,3 +172,27 @@ which gives the same solution as before. @DOCSTRING(fzero) + +@node Minimizers +@section Minimizers +@cindex local minimum +@cindex finding minimums + +Often it is useful to find the minimum value of a function rather than just +the zeroes where it crosses the x-axis. @code{fminbnd} is designed for the +simpler, but very common, case of a univariate function where the interval +to search is bounded. For unbounded minimization of a function with +potentially many variables use @code{fminunc}. @xref{Optimization}, for +minimzation with the presence of constraint functions. Note that searches +can be made for maxima by simply inverting the objective function +@tex +($F_{max} = -F_{min}$). +@end tex +@ifnottex +(@code{Fto_max = -Fto_min}). +@end ifnottex + +@DOCSTRING(fminbnd) + +@DOCSTRING(fminunc) +
--- a/doc/interpreter/octave.texi +++ b/doc/interpreter/octave.texi @@ -600,6 +600,11 @@ * Functions of a Matrix:: * Specialized Solvers:: +Nonlinear Equations + +* Solvers:: +* Minimizers:: + Diagonal and Permutation Matrices * Basic Usage:: Creation and Manipulation of Diagonal and Permutation Matrices