~ubuntu-branches/ubuntu/trusty/gsl-ref-html/trusty

« back to all changes in this revision

Viewing changes to Multimin-Stopping-Criteria.html

  • Committer: Bazaar Package Importer
  • Author(s): Dirk Eddelbuettel
  • Date: 2006-04-12 19:46:32 UTC
  • mfrom: (1.3.1 upstream) (3.1.1 dapper)
  • Revision ID: james.westby@ubuntu.com-20060412194632-c9lodpl075pv9si3
Tags: 1.8-1
* New upstream release 1.8
* As with previous releases, the sources were obtained from the FSF web 
  pages by means of a wget call (c.f. the debian/rules target 'upstream')

* debian/control: Standards-Version increased to 3.6.2
* debian/copyright: Updated FSF address
* debian/rules: Set DH_COMPAT=4

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<html lang="en">
 
2
<head>
 
3
<title>Multimin Stopping Criteria - GNU Scientific Library -- Reference Manual</title>
 
4
<meta http-equiv="Content-Type" content="text/html">
 
5
<meta name="description" content="GNU Scientific Library -- Reference Manual">
 
6
<meta name="generator" content="makeinfo 4.8">
 
7
<link title="Top" rel="start" href="index.html#Top">
 
8
<link rel="up" href="Multidimensional-Minimization.html#Multidimensional-Minimization" title="Multidimensional Minimization">
 
9
<link rel="prev" href="Multimin-Iteration.html#Multimin-Iteration" title="Multimin Iteration">
 
10
<link rel="next" href="Multimin-Algorithms.html#Multimin-Algorithms" title="Multimin Algorithms">
 
11
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
 
12
<!--
 
13
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006 The GSL Team.
 
14
 
 
15
Permission is granted to copy, distribute and/or modify this document
 
16
under the terms of the GNU Free Documentation License, Version 1.2 or
 
17
any later version published by the Free Software Foundation; with the
 
18
Invariant Sections being ``GNU General Public License'' and ``Free Software
 
19
Needs Free Documentation'', the Front-Cover text being ``A GNU Manual'',
 
20
and with the Back-Cover Text being (a) (see below).  A copy of the
 
21
license is included in the section entitled ``GNU Free Documentation
 
22
License''.
 
23
 
 
24
(a) The Back-Cover Text is: ``You have freedom to copy and modify this
 
25
GNU Manual, like GNU software.''-->
 
26
<meta http-equiv="Content-Style-Type" content="text/css">
 
27
<style type="text/css"><!--
 
28
  pre.display { font-family:inherit }
 
29
  pre.format  { font-family:inherit }
 
30
  pre.smalldisplay { font-family:inherit; font-size:smaller }
 
31
  pre.smallformat  { font-family:inherit; font-size:smaller }
 
32
  pre.smallexample { font-size:smaller }
 
33
  pre.smalllisp    { font-size:smaller }
 
34
  span.sc    { font-variant:small-caps }
 
35
  span.roman { font-family:serif; font-weight:normal; } 
 
36
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
 
37
--></style>
 
38
</head>
 
39
<body>
 
40
<div class="node">
 
41
<p>
 
42
<a name="Multimin-Stopping-Criteria"></a>
 
43
Next:&nbsp;<a rel="next" accesskey="n" href="Multimin-Algorithms.html#Multimin-Algorithms">Multimin Algorithms</a>,
 
44
Previous:&nbsp;<a rel="previous" accesskey="p" href="Multimin-Iteration.html#Multimin-Iteration">Multimin Iteration</a>,
 
45
Up:&nbsp;<a rel="up" accesskey="u" href="Multidimensional-Minimization.html#Multidimensional-Minimization">Multidimensional Minimization</a>
 
46
<hr>
 
47
</div>
 
48
 
 
49
<h3 class="section">35.6 Stopping Criteria</h3>
 
50
 
 
51
<p>A minimization procedure should stop when one of the following
 
52
conditions is true:
 
53
 
 
54
     <ul>
 
55
<li>A minimum has been found to within the user-specified precision.
 
56
 
 
57
     <li>A user-specified maximum number of iterations has been reached.
 
58
 
 
59
     <li>An error has occurred. 
 
60
</ul>
 
61
 
 
62
<p class="noindent">The handling of these conditions is under user control.  The functions
 
63
below allow the user to test the precision of the current result.
 
64
 
 
65
<div class="defun">
 
66
&mdash; Function: int <b>gsl_multimin_test_gradient</b> (<var>const gsl_vector * g, double epsabs</var>)<var><a name="index-gsl_005fmultimin_005ftest_005fgradient-2238"></a></var><br>
 
67
<blockquote><p>This function tests the norm of the gradient <var>g</var> against the
 
68
absolute tolerance <var>epsabs</var>. The gradient of a multidimensional
 
69
function goes to zero at a minimum. The test returns <code>GSL_SUCCESS</code>
 
70
if the following condition is achieved,
 
71
and returns <code>GSL_CONTINUE</code> otherwise.  A suitable choice of
 
72
<var>epsabs</var> can be made from the desired accuracy in the function for
 
73
small variations in x.  The relationship between these quantities
 
74
is given by <!-- {$\delta{f} = g\,\delta{x}$} -->
 
75
\delta f = g \delta x. 
 
76
</p></blockquote></div>
 
77
 
 
78
<div class="defun">
 
79
&mdash; Function: int <b>gsl_multimin_test_size</b> (<var>const double size, double epsabs</var>)<var><a name="index-gsl_005fmultimin_005ftest_005fsize-2239"></a></var><br>
 
80
<blockquote><p>This function tests the minimizer specific characteristic
 
81
size (if applicable to the used minimizer) against absolute tolerance <var>epsabs</var>. 
 
82
The test returns <code>GSL_SUCCESS</code> if the size is smaller than tolerance,
 
83
otherwise <code>GSL_CONTINUE</code> is returned. 
 
84
</p></blockquote></div>
 
85
 
 
86
   </body></html>
 
87