From 4b64cf486f5c999fd8167758cae27839f3b50848 Mon Sep 17 00:00:00 2001 From: Harpreet Date: Sat, 3 Sep 2016 00:34:27 +0530 Subject: Structure updated and intqpipopt files added --- .../help/en_US/scilab_en_US_help/intfminimax.html | 195 +++++++++++++++++++++ 1 file changed, 195 insertions(+) create mode 100644 newstructure/help/en_US/scilab_en_US_help/intfminimax.html (limited to 'newstructure/help/en_US/scilab_en_US_help/intfminimax.html') diff --git a/newstructure/help/en_US/scilab_en_US_help/intfminimax.html b/newstructure/help/en_US/scilab_en_US_help/intfminimax.html new file mode 100644 index 0000000..9200598 --- /dev/null +++ b/newstructure/help/en_US/scilab_en_US_help/intfminimax.html @@ -0,0 +1,195 @@ + + + intfminimax + + + +
+ + + + +
+ << intfmincon + + + FOSSEE Optimization Toolbox + + + intfminunc >> + +
+
+
+ + + + FOSSEE Optimization Toolbox >> FOSSEE Optimization Toolbox > intfminimax + +

+

intfminimax

+

Solves minimax constraint problem

+ + +

Calling Sequence

+ 
xopt = intfminimax(fun,x0,intcon)
+xopt = intfminimax(fun,x0,intcon,A,b)
+xopt = intfminimax(fun,x0,intcon,A,b,Aeq,beq)
+xopt = intfminimax(fun,x0,intcon,A,b,Aeq,beq,lb,ub)
+xopt = intfminimax(fun,x0,intcon,A,b,Aeq,beq,lb,ub,nonlinfun)
+xopt = intfminimax(fun,x0,intcon,A,b,Aeq,beq,lb,ub,nonlinfun,options)
+[xopt, fval] = intfminimax(.....)
+[xopt, fval, maxfval]= intfminimax(.....)
+[xopt, fval, maxfval, exitflag]= intfminimax(.....)
+ +

Parameters

+
fun: +

The function to be minimized. fun is a function that accepts a vector x and returns a vector F, the objective functions evaluated at x.

+
x0 : +

a vector of double, contains initial guess of variables.

+
A : +

a matrix of double, represents the linear coefficients in the inequality constraints A⋅x ≤ b.

+
intcon : +

a vector of integers, represents which variables are constrained to be integers

+
b : +

a vector of double, represents the linear coefficients in the inequality constraints A⋅x ≤ b.

+
Aeq : +

a matrix of double, represents the linear coefficients in the equality constraints Aeq⋅x = beq.

+
beq : +

a vector of double, represents the linear coefficients in the equality constraints Aeq⋅x = beq.

+
lb : +

a vector of double, contains lower bounds of the variables.

+
ub : +

a vector of double, contains upper bounds of the variables.

+
nonlinfun: +

function that computes the nonlinear inequality constraints c⋅x ≤ 0 and nonlinear equality constraints c⋅x = 0.

+
xopt : +

a vector of double, the computed solution of the optimization problem.

+
fopt : +

a double, the value of the function at x.

+
maxfval: +

a 1x1 matrix of doubles, the maximum value in vector fval

+
exitflag : +

The exit status. See below for details.

+
output : +

The structure consist of statistics about the optimization. See below for details.

+
lambda : +

The structure consist of the Lagrange multipliers at the solution of problem. See below for details.

+ +

Description

+

intfminimax minimizes the worst-case (largest) value of a set of multivariable functions, starting at an initial estimate. This is generally referred to as the minimax problem.

+

+

Currently, intfminimax calls intfmincon which uses the bonmin algorithm.

+

max-min problems can also be solved with intfminimax, using the identity

+

+

The options allows the user to set various parameters of the Optimization problem. +It should be defined as type "list" and contains the following fields. +

+The objective function must have header : +
F = fun(x)
+where x is a n x 1 matrix of doubles and F is a m x 1 matrix of doubles where m is the total number of objective functions inside F. +On input, the variable x contains the current point and, on output, the variable F must contain the objective function values.

+

By default, the gradient options for intfminimax are turned off and and intfmincon does the gradient opproximation of objective function. In case the GradObj option is off and GradConstr option is on, intfminimax approximates Objective function gradient using numderivative toolbox.

+

If we can provide exact gradients, we should do so since it improves the convergence speed of the optimization algorithm.

+

+

The exitflag allows to know the status of the optimization which is given back by Ipopt. +

+

For more details on exitflag see the ipopt documentation, go to http://www.coin-or.org/bonmin/

+

+ +

Examples

+ 
// A basic case :
+// we provide only the objective function and the nonlinear constraint
+// function
+function f=myfun(x)
+f(1)= 2*x(1)^2 + x(2)^2 - 48*x(1) - 40*x(2) + 304;     //Objectives
+f(2)= -x(1)^2 - 3*x(2)^2;
+f(3)= x(1) + 3*x(2) -18;
+f(4)= -x(1) - x(2);
+f(5)= x(1) + x(2) - 8;
+endfunction
+// The initial guess
+x0 = [0.1,0.1];
+// The expected solution : only 4 digits are guaranteed
+xopt = [4 4]
+fopt = [0 -64 -2 -8 0]
+intcon = [1]
+maxfopt = 0
+// Run fminimax
+[x,fval,maxfval,exitflag] = intfminimax(myfun, x0,intcon)
+// Press ENTER to continue
+ +

Examples

+ 
// A case where we provide the gradient of the objective
+// functions and the Jacobian matrix of the constraints.
+// The objective function and its gradient
+function [f, G]=myfun(x)
+f(1)= 2*x(1)^2 + x(2)^2 - 48*x(1) - 40*x(2) + 304;
+f(2)= -x(1)^2 - 3*x(2)^2;
+f(3)= x(1) + 3*x(2) -18;
+f(4)= -x(1) - x(2);
+f(5)= x(1) + x(2) - 8;
+G = [ 4*x(1) - 48, -2*x(1), 1, -1, 1;
+2*x(2) - 40, -6*x(2), 3, -1, 1; ]'
+endfunction
+// The nonlinear constraints
+function [c, ceq, DC, DCeq]=confun(x)
+// Inequality constraints
+c = [1.5 + x(1)*x(2) - x(1) - x(2), -x(1)*x(2) - 10]
+// No nonlinear equality constraints
+ceq=[]
+DC= [x(2)-1, -x(2);
+x(1)-1, -x(1)]'
+DCeq = []'
+endfunction
+// Test with both gradient of objective and gradient of constraints
+minimaxOptions = list("GradObj","on","GradCon","on");
+// The initial guess
+x0 = [0,10];
+intcon = [2]
+// Run intfminimax
+[x,fval,maxfval,exitflag] = intfminimax(myfun,x0,intcon,[],[],[],[],[],[], confun, minimaxOptions)
+ +

Authors

+
+
+ +
+ + + + + + +
Report an issue
+ << intfmincon + + + FOSSEE Optimization Toolbox + + + intfminunc >> + +
+
+
+ + -- cgit