|
15
|
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
|
|
2 <!--NewPage-->
|
|
|
3 <HTML>
|
|
|
4 <HEAD>
|
|
|
5 <!-- Generated by javadoc (build 1.6.0_17) on Sat Mar 27 22:46:15 EDT 2010 -->
|
|
|
6 <META http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
|
7 <TITLE>
|
|
|
8 VectorialConvergenceChecker (Commons Math 2.1 API)
|
|
|
9 </TITLE>
|
|
|
10
|
|
|
11 <META NAME="date" CONTENT="2010-03-27">
|
|
|
12
|
|
|
13 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../../stylesheet.css" TITLE="Style">
|
|
|
14
|
|
|
15 <SCRIPT type="text/javascript">
|
|
|
16 function windowTitle()
|
|
|
17 {
|
|
|
18 if (location.href.indexOf('is-external=true') == -1) {
|
|
|
19 parent.document.title="VectorialConvergenceChecker (Commons Math 2.1 API)";
|
|
|
20 }
|
|
|
21 }
|
|
|
22 </SCRIPT>
|
|
|
23 <NOSCRIPT>
|
|
|
24 </NOSCRIPT>
|
|
|
25
|
|
|
26 </HEAD>
|
|
|
27
|
|
|
28 <BODY BGCOLOR="white" onload="windowTitle();">
|
|
|
29 <HR>
|
|
|
30
|
|
|
31
|
|
|
32 <!-- ========= START OF TOP NAVBAR ======= -->
|
|
|
33 <A NAME="navbar_top"><!-- --></A>
|
|
|
34 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
|
|
|
35 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
|
|
|
36 <TR>
|
|
|
37 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
|
|
38 <A NAME="navbar_top_firstrow"><!-- --></A>
|
|
|
39 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
|
|
|
40 <TR ALIGN="center" VALIGN="top">
|
|
|
41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
|
|
42 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
|
|
43 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
|
|
44 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/VectorialConvergenceChecker.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
|
|
|
45 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
|
|
46 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
|
|
|
47 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
|
|
48 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
|
|
49 </TR>
|
|
|
50 </TABLE>
|
|
|
51 </TD>
|
|
|
52 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
|
|
53 </EM>
|
|
|
54 </TD>
|
|
|
55 </TR>
|
|
|
56
|
|
|
57 <TR>
|
|
|
58 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
|
|
59 <A HREF="../../../../../org/apache/commons/math/optimization/UnivariateRealOptimizer.html" title="interface in org.apache.commons.math.optimization"><B>PREV CLASS</B></A>
|
|
|
60 <A HREF="../../../../../org/apache/commons/math/optimization/VectorialPointValuePair.html" title="class in org.apache.commons.math.optimization"><B>NEXT CLASS</B></A></FONT></TD>
|
|
|
61 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
|
|
62 <A HREF="../../../../../index.html?org/apache/commons/math/optimization/VectorialConvergenceChecker.html" target="_top"><B>FRAMES</B></A>
|
|
|
63 <A HREF="VectorialConvergenceChecker.html" target="_top"><B>NO FRAMES</B></A>
|
|
|
64 <SCRIPT type="text/javascript">
|
|
|
65 <!--
|
|
|
66 if(window==top) {
|
|
|
67 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
|
|
|
68 }
|
|
|
69 //-->
|
|
|
70 </SCRIPT>
|
|
|
71 <NOSCRIPT>
|
|
|
72 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
|
|
|
73 </NOSCRIPT>
|
|
|
74
|
|
|
75
|
|
|
76 </FONT></TD>
|
|
|
77 </TR>
|
|
|
78 <TR>
|
|
|
79 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
|
|
80 SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
|
|
|
81 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
|
|
82 DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
|
|
|
83 </TR>
|
|
|
84 </TABLE>
|
|
|
85 <A NAME="skip-navbar_top"></A>
|
|
|
86 <!-- ========= END OF TOP NAVBAR ========= -->
|
|
|
87
|
|
|
88 <HR>
|
|
|
89 <!-- ======== START OF CLASS DATA ======== -->
|
|
|
90 <H2>
|
|
|
91 <FONT SIZE="-1">
|
|
|
92 org.apache.commons.math.optimization</FONT>
|
|
|
93 <BR>
|
|
|
94 Interface VectorialConvergenceChecker</H2>
|
|
|
95 <DL>
|
|
|
96 <DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../../../org/apache/commons/math/optimization/SimpleVectorialPointChecker.html" title="class in org.apache.commons.math.optimization">SimpleVectorialPointChecker</A>, <A HREF="../../../../../org/apache/commons/math/optimization/SimpleVectorialValueChecker.html" title="class in org.apache.commons.math.optimization">SimpleVectorialValueChecker</A></DD>
|
|
|
97 </DL>
|
|
|
98 <HR>
|
|
|
99 <DL>
|
|
|
100 <DT><PRE>public interface <A HREF="../../../../../src-html/org/apache/commons/math/optimization/VectorialConvergenceChecker.html#line.37"><B>VectorialConvergenceChecker</B></A></DL>
|
|
|
101 </PRE>
|
|
|
102
|
|
|
103 <P>
|
|
|
104 This interface specifies how to check if a <A HREF="../../../../../org/apache/commons/math/optimization/DifferentiableMultivariateVectorialOptimizer.html" title="interface in org.apache.commons.math.optimization"><CODE>optimization algorithm</CODE></A> has converged.
|
|
|
105
|
|
|
106 <p>Deciding if convergence has been reached is a problem-dependent issue. The
|
|
|
107 user should provide a class implementing this interface to allow the optimization
|
|
|
108 algorithm to stop its search according to the problem at hand.</p>
|
|
|
109 <p>For convenience, two implementations that fit simple needs are already provided:
|
|
|
110 <A HREF="../../../../../org/apache/commons/math/optimization/SimpleVectorialValueChecker.html" title="class in org.apache.commons.math.optimization"><CODE>SimpleVectorialValueChecker</CODE></A> and <A HREF="../../../../../org/apache/commons/math/optimization/SimpleVectorialPointChecker.html" title="class in org.apache.commons.math.optimization"><CODE>SimpleVectorialPointChecker</CODE></A>. The first
|
|
|
111 one considers convergence is reached when the objective function value does not
|
|
|
112 change much anymore, it does not use the point set at all. The second one
|
|
|
113 considers convergence is reached when the input point set does not change
|
|
|
114 much anymore, it does not use objective function value at all.</p>
|
|
|
115 <P>
|
|
|
116
|
|
|
117 <P>
|
|
|
118 <DL>
|
|
|
119 <DT><B>Since:</B></DT>
|
|
|
120 <DD>2.0</DD>
|
|
|
121 <DT><B>Version:</B></DT>
|
|
|
122 <DD>$Revision: 780674 $ $Date: 2009-06-01 11:10:55 -0400 (Mon, 01 Jun 2009) $</DD>
|
|
|
123 </DL>
|
|
|
124 <HR>
|
|
|
125
|
|
|
126 <P>
|
|
|
127
|
|
|
128 <!-- ========== METHOD SUMMARY =========== -->
|
|
|
129
|
|
|
130 <A NAME="method_summary"><!-- --></A>
|
|
|
131 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
|
|
|
132 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
|
|
133 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
|
|
|
134 <B>Method Summary</B></FONT></TH>
|
|
|
135 </TR>
|
|
|
136 <TR BGCOLOR="white" CLASS="TableRowColor">
|
|
|
137 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
|
|
|
138 <CODE> boolean</CODE></FONT></TD>
|
|
|
139 <TD><CODE><B><A HREF="../../../../../org/apache/commons/math/optimization/VectorialConvergenceChecker.html#converged(int, org.apache.commons.math.optimization.VectorialPointValuePair, org.apache.commons.math.optimization.VectorialPointValuePair)">converged</A></B>(int iteration,
|
|
|
140 <A HREF="../../../../../org/apache/commons/math/optimization/VectorialPointValuePair.html" title="class in org.apache.commons.math.optimization">VectorialPointValuePair</A> previous,
|
|
|
141 <A HREF="../../../../../org/apache/commons/math/optimization/VectorialPointValuePair.html" title="class in org.apache.commons.math.optimization">VectorialPointValuePair</A> current)</CODE>
|
|
|
142
|
|
|
143 <BR>
|
|
|
144 Check if the optimization algorithm has converged considering the last points.</TD>
|
|
|
145 </TR>
|
|
|
146 </TABLE>
|
|
|
147
|
|
|
148 <P>
|
|
|
149
|
|
|
150 <!-- ============ METHOD DETAIL ========== -->
|
|
|
151
|
|
|
152 <A NAME="method_detail"><!-- --></A>
|
|
|
153 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
|
|
|
154 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
|
|
|
155 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
|
|
|
156 <B>Method Detail</B></FONT></TH>
|
|
|
157 </TR>
|
|
|
158 </TABLE>
|
|
|
159
|
|
|
160 <A NAME="converged(int, org.apache.commons.math.optimization.VectorialPointValuePair, org.apache.commons.math.optimization.VectorialPointValuePair)"><!-- --></A><H3>
|
|
|
161 converged</H3>
|
|
|
162 <PRE>
|
|
|
163 boolean <A HREF="../../../../../src-html/org/apache/commons/math/optimization/VectorialConvergenceChecker.html#line.53"><B>converged</B></A>(int iteration,
|
|
|
164 <A HREF="../../../../../org/apache/commons/math/optimization/VectorialPointValuePair.html" title="class in org.apache.commons.math.optimization">VectorialPointValuePair</A> previous,
|
|
|
165 <A HREF="../../../../../org/apache/commons/math/optimization/VectorialPointValuePair.html" title="class in org.apache.commons.math.optimization">VectorialPointValuePair</A> current)</PRE>
|
|
|
166 <DL>
|
|
|
167 <DD>Check if the optimization algorithm has converged considering the last points.
|
|
|
168 <p>
|
|
|
169 This method may be called several time from the same algorithm iteration with
|
|
|
170 different points. This can be detected by checking the iteration number at each
|
|
|
171 call if needed. Each time this method is called, the previous and current point
|
|
|
172 correspond to points with the same role at each iteration, so they can be
|
|
|
173 compared. As an example, simplex-based algorithms call this method for all
|
|
|
174 points of the simplex, not only for the best or worst ones.
|
|
|
175 </p>
|
|
|
176 <P>
|
|
|
177 <DD><DL>
|
|
|
178 <DT><B>Parameters:</B><DD><CODE>iteration</CODE> - index of current iteration<DD><CODE>previous</CODE> - point from previous iteration<DD><CODE>current</CODE> - point from current iteration
|
|
|
179 <DT><B>Returns:</B><DD>true if the algorithm is considered to have converged</DL>
|
|
|
180 </DD>
|
|
|
181 </DL>
|
|
|
182 <!-- ========= END OF CLASS DATA ========= -->
|
|
|
183 <HR>
|
|
|
184
|
|
|
185
|
|
|
186 <!-- ======= START OF BOTTOM NAVBAR ====== -->
|
|
|
187 <A NAME="navbar_bottom"><!-- --></A>
|
|
|
188 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
|
|
|
189 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
|
|
|
190 <TR>
|
|
|
191 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
|
|
|
192 <A NAME="navbar_bottom_firstrow"><!-- --></A>
|
|
|
193 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
|
|
|
194 <TR ALIGN="center" VALIGN="top">
|
|
|
195 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
|
|
|
196 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
|
|
|
197 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
|
|
|
198 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/VectorialConvergenceChecker.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
|
|
|
199 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
|
|
|
200 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
|
|
|
201 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
|
|
|
202 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
|
|
|
203 </TR>
|
|
|
204 </TABLE>
|
|
|
205 </TD>
|
|
|
206 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
|
|
|
207 </EM>
|
|
|
208 </TD>
|
|
|
209 </TR>
|
|
|
210
|
|
|
211 <TR>
|
|
|
212 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
|
|
213 <A HREF="../../../../../org/apache/commons/math/optimization/UnivariateRealOptimizer.html" title="interface in org.apache.commons.math.optimization"><B>PREV CLASS</B></A>
|
|
|
214 <A HREF="../../../../../org/apache/commons/math/optimization/VectorialPointValuePair.html" title="class in org.apache.commons.math.optimization"><B>NEXT CLASS</B></A></FONT></TD>
|
|
|
215 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
|
|
|
216 <A HREF="../../../../../index.html?org/apache/commons/math/optimization/VectorialConvergenceChecker.html" target="_top"><B>FRAMES</B></A>
|
|
|
217 <A HREF="VectorialConvergenceChecker.html" target="_top"><B>NO FRAMES</B></A>
|
|
|
218 <SCRIPT type="text/javascript">
|
|
|
219 <!--
|
|
|
220 if(window==top) {
|
|
|
221 document.writeln('<A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>');
|
|
|
222 }
|
|
|
223 //-->
|
|
|
224 </SCRIPT>
|
|
|
225 <NOSCRIPT>
|
|
|
226 <A HREF="../../../../../allclasses-noframe.html"><B>All Classes</B></A>
|
|
|
227 </NOSCRIPT>
|
|
|
228
|
|
|
229
|
|
|
230 </FONT></TD>
|
|
|
231 </TR>
|
|
|
232 <TR>
|
|
|
233 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
|
|
234 SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD>
|
|
|
235 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
|
|
|
236 DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD>
|
|
|
237 </TR>
|
|
|
238 </TABLE>
|
|
|
239 <A NAME="skip-navbar_bottom"></A>
|
|
|
240 <!-- ======== END OF BOTTOM NAVBAR ======= -->
|
|
|
241
|
|
|
242 <HR>
|
|
|
243 Copyright © 2003-2010 <a href="http://www.apache.org/">The Apache Software Foundation</a>. All Rights Reserved.
|
|
|
244 </BODY>
|
|
|
245 </HTML>
|
