Changes between Version 8 and Version 9 of OfficialTolArchiveNetworkNonLinGloOpt

Timestamp:

Dec 1, 2010, 2:44:29 PM (14 years ago)

Author:

Víctor de Buen Remiro

Comment:

--

OfficialTolArchiveNetworkNonLinGloOpt

@@ -40 +40 @@
 == Guia del usuario ==
 
+Los problemas se definirán como una instancia de {{{Class @Problem}}} definida en [source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/problem.tol problem.tol]  
+
 === Formulación de funciones objetivo y de restricción ===
 
@@ -49 +51 @@
 }}}
 
-En el caso de que se quiera usar un método que precise el gradiente, no se 
+siendo tanto {{{x}}} como {{{gradient}}} matrices de {{{n}}} filas y 1 columna.
+
+Aún en el caso de que se quiera usar un método que precise el gradiente, no  
 necesariamente se exigirá calcular el mismo cada vez que se quiera evaluar 
 la función. En tales casos se le pasará la matriz vacía para indicar que 
@@ -90 +94 @@
 }}}
 
+=== Características obligatorias en la definición del problema  ===
+
+{{{
+#!cpp
+//If you sign ==- 1 minimized, and if sign == 1 maximizes
+  Real sign;         
+  
+//If true, a global optimal point will be searched. Else just a 
+//local one.
+  Real neededGlobal;  
+ 
+//Minimum analytical class of target and constraining functions must be one
+//of elements of 
+//Set NonLinGloOpt::AnalyticalClass =
+//{[[
+//  Real ARBITRARY            = -1,  // Arbitrary functions
+//  Real CONTINUOUS           =  0,  // Class C_0: Continuous
+//  Real DIFFERENTIABLE       =  1,  // Class C_1: Differentiable
+//  Real TWICE_DIFFERENTIABLE =  2   // Class C_2: Twice differentiable
+//]]};
+  Real id_analyticalClass;
+
+//Indicates if the gradient known or unknown in an analytical or 
+//numerical way. Must be one element of 
+//Set NonLinGloOpt::GradientKnowneledge =
+//[[
+//Real NONE        = 0,  //Doesn't exists or it's too hard to calculate
+//Real ANALITICAL  = 1,  //Use analitical gradient
+//Real NUMERICAL   = 2   //Use numerical gradient
+//]];
+  Real id_useGradient;  
+  
+//Target function could be a simple Code or a class method of an
+//instance owner.
+// - Real target(Matrix x, Matrix gradient)
+// - Set target = [[NameBlock owner, Code method]]
+//When argument gradient is not empty, then the function, or the 
+//method must update it. 
+  Anything target;
+
+//Initial values of variables 
+  Matrix x0;        
+
+}}}
+
+=== Características opcionales en la definición del problema  ===
+
+Hay otra serie de carcterísticas del problema que son opcionales pues o bien tienen 
+un valor por defecto predefinido o bien existe un método interno que les da un valor 
+adecuado.
+{{{
+#!cpp
+//Optimization method. If not specified the system will choose one
+//by calling method select_automatic_algorithm
+  Real id_algorithm = ?;  //Numerical identifier NonLinGloOpt::Algorithm
+  Text co_algorithm = ""; //Codified name
+
+//Lower bounds of the variables (-1/0 if none)
+  Matrix lower_bounds = Rand(0,0,0,0); 
+
+//Variable upper bounds (+1/0 if none)
+  Matrix upper_bounds = Rand(0,0,0,0);
+
+//Set of inequality constraints g(x)<=0
+//Conjunto de elementos Code o [[NameBlock owner, Code target]] para métodos
+//Constraining function could be a simple Code or a class method of an
+//instance owner.
+// - Real g (Matrix x, Matrix gradient)
+// - Set g = [[NameBlock owner, Code method]]
+//When argument gradient is not empty, then the function, or the 
+//method must update it. 
+  Set inequations = Copy(Empty); 
+
+//Set of equality constraints h(x)<=0
+//Conjunto de elementos Code o [[NameBlock owner, Code target]] para métodos
+//Constraining function could be a simple Code or a class method of an
+//instance owner.
+// - Real h (Matrix x, Matrix gradient)
+// - Set h = [[NameBlock owner, Code method]]
+//When argument gradient is not empty, then the function, or the 
+//method must update it. 
+  Set equations = Copy(Empty);   
+
+//Tolerance for the evaluation of inequality constraints
+  Real inequationTolerance = 1E-8;
+
+//Tolerance for the evaluation of the equality constraints
+  Real equationTolerance = 1E-8;
+
+//Relative tolerance of the stop criteria
+  Real relativeTolerance = 1E-6; 
+
+//Maximum run time
+  Real maxTime = ?;
+
+//If verboseEach>0, evaluation of target funciton will be traced 
+//each the specified number of evaluations.
+  Real verboseEach = 100;
+
+}}}
+
+
+=== 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.
+
+[[Image(source:/tolp/OfficialTolArchiveNetwork/NonLinGloOpt/doc/opt_methods.png)]]
+
 == Tutorial == 
 
 La mejor forma de aprender a usar cualquier cosa es empezar a usarla de forma
 controlada, para lo cual se dispone de una batería de ejemplos a disposición de 
-los usuairos.
+los usuarios.
 
 === Función objetivo bivariante no lineal con restricciones de desigualdad no lineal === 
@@ -200 +331 @@
 {{{
 #!cpp
-#Require NonLinGloOpt;
 
 //Creating the optimizer instance
@@ -248 +378 @@
 
  
+
+
+