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	Fri Mar 18 18:51:45 2011 -0700
+++ b/doc/ChangeLog	Fri Mar 18 21:25:08 2011 -0700
@@ -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	Fri Mar 18 18:51:45 2011 -0700
+++ b/doc/interpreter/nonlin.txi	Fri Mar 18 21:25:08 2011 -0700
@@ -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	Fri Mar 18 18:51:45 2011 -0700
+++ b/doc/interpreter/octave.texi	Fri Mar 18 21:25:08 2011 -0700
@@ -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