Changes between Version 16 and Version 17 of OfficialTolArchiveNetworkNonLinGloOpt

Timestamp:

Jan 4, 2011, 2:22:49 PM (15 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

OfficialTolArchiveNetworkNonLinGloOpt

@@ -59 +59 @@
 La cadena de métodos se define como un conjunto de métodos que será instancias de {{{Class @Method}}} definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/method.tol method.tol] y que se irán añadiendo a la instancia {{{Class @PipeLine}}} mediante el método {{{AddMethod}}}. Si no se especifica ningún método se utilizará uno acorde con la definición del problema.
 
-Cada método tendrá definido una serie de parámetros que controlen los criterios de parada y que se incorporarán como instancia de {{{Class @StopCriteria}}}  definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/stopCriteria.tol stopCriteria.tol]
+El algoritmo de optimización de cada método estará implementado como parte de un motor de optimización que estará definido como una instancia de la clase abstracta {{{Class @Engine}}} definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/engine.tol engine.tol] y de la cual por el momento sólo estará disponible la herencia {{{@Engine_NLopt}}} definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/engine_nlopt.tol engine_nlopt.tol] y que corresponde a la librería C++ [http://ab-initio.mit.edu/wiki/index.php/NLopt_C-plus-plus_Reference nlopt].
+
+Cada método tendrá definido una serie de parámetros que controlen los criterios de parada y que se incorporarán como instancia de {{{Class @StopCriteria}}} definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/stopCriteria.tol stopCriteria.tol]
 
 === Formulación de funciones objetivo y de restricción ===
@@ -121 +123 @@
 #!cpp
 //Set sign ==- 1 for minimization, sign == 1 for maximization
-  Real sign;         
+  Real sign;
   
 //If true, a global optimal point will be searched. Else just a 
 //local one.
-  Real neededGlobal;  
+  Real neededGlobal;
  
 //Minimum analytical class of target and constraining functions must be one
@@ -140 +142 @@
 //Indicates if the gradient is known analytically or numerically. 
 //Must be an element of 
-//Set NonLinGloOpt::GradientKnowneledge =
+//Set NonLinGloOpt::GradientKnowledge =
 //[[
 //Real NONE        = 0,  //Doesn't exists or it's too hard to calculate
@@ -146 +148 @@
 //Real NUMERICAL   = 2   //Use numerical gradient
 //]];
-  Real id_useGradient;  
+  Real id_useGradient;
   
+//Number of variables
+  Real n;
+
 //Target function could be a simple Code or a class method of a
 //particular instance.
@@ -156 +161 @@
   Anything target;
 
-//Initial values of variables in an nx1 column matrix
-  Matrix x0;        
-
 }}}
 
@@ -168 +170 @@
 {{{
 #!cpp
-//Optimization method. 
-//It must be an element of NonLinGloOpt::Algorithm
-//If it is not specified the system will choose one by calling method 
-//select_automatic_algorithm
-  Real id_algorithm = ?;
-
 //Lower bounds for the variables 
 //These must be specified by an nx1 column matrix with the minimum value for each 
 //variable, or -1/0 if the variable is not bounded below
 //If there are no lower bounds at all then it's the empty matrix
-  Matrix lower_bounds = Rand(0,0,0,0); 
+  Matrix lower_bounds = Rand(0,0,0,0);
 
 //Upper bounds for the variables 
@@ -194 +190 @@
 //When argument gradient is not empty, then the function, or the 
 //method must update it. 
-  Set inequations = Copy(Empty); 
+  Set inequations = Copy(Empty);
 
 //Set of equality constraints h(x)<=0
@@ -204 +200 @@
 //When argument gradient is not empty, then the function, or the 
 //method must update it. 
-  Set equations = Copy(Empty);   
+  Set equations = Copy(Empty);
 
 //Tolerance for the evaluation of inequality constraints to avoid  
@@ -214 +210 @@
   Real equationTolerance = 1E-8;
 
-//Relative tolerance of the stopping criteria
-  Real relativeTolerance = 1E-6; 
-
-//Maximum run time for the stopping criteria
-  Real maxTime = ?;
-
-//If verboseEach>0, the evaluation of the target function will be traced 
-//every "verboseEach" evaluations.
-  Real verboseEach = 100;
-
 }}}
 
@@ -229 +215 @@
 === Creación y lanzamiento de la optimización ===
 
-Una vez definido un problema hay que crear el motor de optimización como una instancia de {{{Class @Opt}}} definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/opt.tol opt.tol] 
-{{{
-#!cpp
-//Creating the optimizer instance
-NonLinGloOpt::@Opt opt = problem::create_optimizer(?);
-}}}
-
-y finalmente se llamará al método de optimización para que ejecute el algoritmo
-
-{{{
-#!cpp
-//Running the optimization
-Real opt::optimize_problem(problem);
-}}}
-
-Entre medio de ambas acciones, el usuario avanzado puede retocar la instancia 
-{{{opt}}} mediante los métodos de {{{@Opt}}}, cada uno de los cuales implementa 
-los métodos de la clase C++ interna {{{nlopt::opt}}} cuya API puede verse 
-[http://ab-initio.mit.edu/wiki/index.php/NLopt_C-plus-plus_Reference aquí]
-Estos métodos pueden leerse directamente en el [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/opt.tol código TOL] o exporarse en la interfaz de TOLBase.
+El esqueleto del código de uso del paquete sería el siguiente
+{{{
+#!cpp
+//Defines the problem and the optimization pipe-line
+NonLinGloOpt::@PipeLine pipe_line = [[
+  //The problem (or problems) to be optimized. In this version just the first 
+  //one will be solved
+  Set problems = [[ NonLinGloOpt::@Problem problem = [[
+    ...
+  ]] ]];
+  //The system will show a trace every this number of evaluations of target 
+  //function 
+  Real verboseEach = 100
+]];
+
+//Runs the optimization sequence
+Real pipe_line::optimize(?);
+
+//Access to optimal point
+Matrix pipe_line::x.opt;
+//Access to optimal value of target function
+Real pipe_line::y.opt;
+
+}}}
+
 
 [[Image(source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/doc/opt_methods.png)]]