Set up the data structures for subsequent computations
[x,bl,bu,v,cl,cu,equatn,linear] = csetup(outsdif_path, options)
string the path of the problem relative OUTSDIF.d file (see sifdecode )
a boolean 3-dimensional vector (see below)
real vector, the starting point
real vector, the lower bounds
real vector, the upper bounds
initial estimates of the Lagrange multipliers
lower bounds on the constraints
upper bounds on the constraints
a boolean array whose i-th component is %t if the i-th constraint is an equation and %f else
boolean array whose i-th component is %t if the i-th constraint is linear and %f else
[x,bl,bu,v,cl,cu]=csetup() returns the starting point in x and the lower and upper bounds on the variables in bl and bu, respectively. v contains the initial estimates of the Lagrange multipliers, and cl and cu contain the lower and upper bounds on the constraints, respectively.
[x,bl,bu,v,cl,cu,equatn,linear]=csetup() also returns equatn, an array whose i-th component is 1 if the i-th constraint is an equation and 0 else, and linear, an array whose i-th component is 1 if the i-th constraint is linear and 0 else.
[x,bl,bu,v,cl,cu]=csetup(options) or [x,bl,bu,v,cl,cu,equatn,linear]=csetup(options), where options is a 3-dimensional boolean vector, permits the reordering of the constraints and variables.
options( 1 ) = efirst, set to %t if the user wishes the general equations to occur before the general inequalities.
options( 2 ) = lfirst, set to %t if the user wishes the general linear or affine constraints to occur before the general nonlinear ones. If both efirst and lfirst are set to 1, the linear constraints will occur before the nonlinear ones. The linear constraints are ordered so that the linear equations occur before the linear inequalities. Likewise, the nonlinear equations appear before the before the nonlinear inequalities.
options( 3 ) = nvfrst, set to %t if the user wishes the nonlinear variables to occur before the linear variables. Any variable which belongs to a nontrivial group or to a nonlinear element in a trivial group is treated as a nonlinear variable. If the number of variables which appear nonlinearly in the objective function (say n_1) is different from the number of variables which appear nonlinearly in the constraints (say m_1), then the variables are ordered so that the smaller set occurs first. For example, if n_1 < m_1, the n_1 nonlinear objective variables occur first, followed by the nonlinear Jacobian variables not belonging to the first n_1 variables, followed by the linear variables.
If options is not given, the constraints and variables are not reordered.
Based on CUTEr authored by
Nicholas I.M. Gould - n.gould@rl.ac.uk - RAL
Dominique Orban - orban@ece.northwestern.edu - Northwestern
Philippe L. Toint - Philippe.Toint@fundp.ac.be - FUNDP
see http://hsl.rl.ac.uk/cuter-www