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
91
92
93
94
95
96
97
98
99
|
<html lang="en">
<head>
<title>Minimization 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.8">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="One-dimensional-Minimization.html" title="One dimensional Minimization">
<link rel="prev" href="Providing-the-function-to-minimize.html" title="Providing the function to minimize">
<link rel="next" href="Minimization-Stopping-Parameters.html" title="Minimization Stopping Parameters">
<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 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.2 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 freedom to copy and modify this
GNU Manual, like GNU software.''-->
<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">
<p>
<a name="Minimization-Iteration"></a>
Next: <a rel="next" accesskey="n" href="Minimization-Stopping-Parameters.html">Minimization Stopping Parameters</a>,
Previous: <a rel="previous" accesskey="p" href="Providing-the-function-to-minimize.html">Providing the function to minimize</a>,
Up: <a rel="up" accesskey="u" href="One-dimensional-Minimization.html">One dimensional Minimization</a>
<hr>
</div>
<h3 class="section">33.5 Iteration</h3>
<p>The following functions drive the iteration of each algorithm. Each
function performs one iteration to update the state of any minimizer of the
corresponding type. The same functions work for all minimizers so that
different methods can be substituted at runtime without modifications to
the code.
<div class="defun">
— Function: int <b>gsl_min_fminimizer_iterate</b> (<var>gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005fiterate-2262"></a></var><br>
<blockquote><p>This function performs a single iteration of the minimizer <var>s</var>. If the
iteration encounters an unexpected problem then an error code will be
returned,
<dl>
<dt><code>GSL_EBADFUNC</code><dd>the iteration encountered a singular point where the function evaluated
to <code>Inf</code> or <code>NaN</code>.
<br><dt><code>GSL_FAILURE</code><dd>the algorithm could not improve the current best approximation or
bounding interval.
</dl>
</p></blockquote></div>
<p>The minimizer maintains a current best estimate of the position of the
minimum at all times, and the current interval bounding the minimum.
This information can be accessed with the following auxiliary functions,
<div class="defun">
— Function: double <b>gsl_min_fminimizer_x_minimum</b> (<var>const gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005fx_005fminimum-2263"></a></var><br>
<blockquote><p>This function returns the current estimate of the position of the
minimum for the minimizer <var>s</var>.
</p></blockquote></div>
<div class="defun">
— Function: double <b>gsl_min_fminimizer_x_upper</b> (<var>const gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005fx_005fupper-2264"></a></var><br>
— Function: double <b>gsl_min_fminimizer_x_lower</b> (<var>const gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005fx_005flower-2265"></a></var><br>
<blockquote><p>These functions return the current upper and lower bound of the interval
for the minimizer <var>s</var>.
</p></blockquote></div>
<div class="defun">
— Function: double <b>gsl_min_fminimizer_f_minimum</b> (<var>const gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005ff_005fminimum-2266"></a></var><br>
— Function: double <b>gsl_min_fminimizer_f_upper</b> (<var>const gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005ff_005fupper-2267"></a></var><br>
— Function: double <b>gsl_min_fminimizer_f_lower</b> (<var>const gsl_min_fminimizer * s</var>)<var><a name="index-gsl_005fmin_005ffminimizer_005ff_005flower-2268"></a></var><br>
<blockquote><p>These functions return the value of the function at the current estimate
of the minimum and at the upper and lower bounds of the interval for the
minimizer <var>s</var>.
</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>
|
