1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
<html lang="en">
<head>
<title>Multimin Iteration - GNU Scientific Library -- Reference Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Scientific Library -- Reference Manual">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Multidimensional-Minimization.html" title="Multidimensional Minimization">
<link rel="prev" href="Providing-a-function-to-minimize.html" title="Providing a function to minimize">
<link rel="next" href="Multimin-Stopping-Criteria.html" title="Multimin Stopping Criteria">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011 The GSL Team.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``GNU General Public License'' and ``Free Software
Needs Free Documentation'', the Front-Cover text being ``A GNU Manual'',
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled ``GNU Free Documentation
License''.
(a) The Back-Cover Text is: ``You have the freedom to copy and modify this
GNU Manual.''-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Multimin-Iteration"></a>
<p>
Next: <a rel="next" accesskey="n" href="Multimin-Stopping-Criteria.html">Multimin Stopping Criteria</a>,
Previous: <a rel="previous" accesskey="p" href="Providing-a-function-to-minimize.html">Providing a function to minimize</a>,
Up: <a rel="up" accesskey="u" href="Multidimensional-Minimization.html">Multidimensional Minimization</a>
<hr>
</div>
<h3 class="section">36.5 Iteration</h3>
<p>The following function drives the iteration of each algorithm. The
function performs one iteration to update the state of the minimizer.
The same function works for all minimizers so that different methods can
be substituted at runtime without modifications to the code.
<div class="defun">
— Function: int <b>gsl_multimin_fdfminimizer_iterate</b> (<var>gsl_multimin_fdfminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffdfminimizer_005fiterate-2529"></a></var><br>
— Function: int <b>gsl_multimin_fminimizer_iterate</b> (<var>gsl_multimin_fminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffminimizer_005fiterate-2530"></a></var><br>
<blockquote><p>These functions perform a single iteration of the minimizer <var>s</var>.
If the iteration encounters an unexpected problem then an error code
will be returned. The error code <code>GSL_ENOPROG</code> signifies that
the minimizer is unable to improve on its current estimate, either due
to numerical difficulty or because a genuine local minimum has been
reached.
</p></blockquote></div>
<p class="noindent">The minimizer maintains a current best estimate of the minimum at all
times. This information can be accessed with the following auxiliary
functions,
<div class="defun">
— Function: gsl_vector * <b>gsl_multimin_fdfminimizer_x</b> (<var>const gsl_multimin_fdfminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffdfminimizer_005fx-2531"></a></var><br>
— Function: gsl_vector * <b>gsl_multimin_fminimizer_x</b> (<var>const gsl_multimin_fminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffminimizer_005fx-2532"></a></var><br>
— Function: double <b>gsl_multimin_fdfminimizer_minimum</b> (<var>const gsl_multimin_fdfminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffdfminimizer_005fminimum-2533"></a></var><br>
— Function: double <b>gsl_multimin_fminimizer_minimum</b> (<var>const gsl_multimin_fminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffminimizer_005fminimum-2534"></a></var><br>
— Function: gsl_vector * <b>gsl_multimin_fdfminimizer_gradient</b> (<var>const gsl_multimin_fdfminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffdfminimizer_005fgradient-2535"></a></var><br>
— Function: double <b>gsl_multimin_fminimizer_size</b> (<var>const gsl_multimin_fminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffminimizer_005fsize-2536"></a></var><br>
<blockquote><p>These functions return the current best estimate of the location of the
minimum, the value of the function at that point, its gradient,
and minimizer specific characteristic size for the minimizer <var>s</var>.
</p></blockquote></div>
<div class="defun">
— Function: int <b>gsl_multimin_fdfminimizer_restart</b> (<var>gsl_multimin_fdfminimizer * s</var>)<var><a name="index-gsl_005fmultimin_005ffdfminimizer_005frestart-2537"></a></var><br>
<blockquote><p>This function resets the minimizer <var>s</var> to use the current point as a
new starting point.
</p></blockquote></div>
<hr>The GNU Scientific Library - a free numerical library licensed under the GNU GPL<br>Back to the <a href="/software/gsl/">GNU Scientific Library Homepage</a></body></html>
|
