Bruce A. Murtagh; Graduate School of Management, Macquarie University, Sydney, Australia

Michael A. Saunders, Walter Murray; Department of EESOR, Stanford University, CA

Philip E. Gill; Department of Mathematics, University of California, San Diego, La Jolla, CA

# Introduction

This document describes the GAMS interface to MINOS which is a general purpose nonlinear programming solver.

GAMS/MINOS is a specially adapted version of the solver that is used for solving linear and nonlinear programming problems in a GAMS environment.

GAMS/MINOS is designed to find solutions that are locally optimal. The nonlinear functions in a problem must be smooth (i.e., their first derivatives must exist).The functions need not be separable. Integer restrictions cannot be imposed directly.

A certain region is defined by the linear constraints in a problem and by the bounds on the variables. If the nonlinear objective and constraint functions are convex within this region, any optimal solution obtained will be a global optimum. Otherwise there may be several local optima, and some of these may not be global. In such cases the chances of finding a global optimum are usually increased by choosing a staring point that is "sufficiently close", but there is no general procedure for determining what "close" means, or for verifying that a given local optimum is indeed global.

Linearly constrained models are solved with a very efficient and reliable reduced gradient technique that takes advantage of the sparsity of the model. Models with nonlinear constraints are solved with a method that iteratively solves subproblems with linearized constraints and an augmented Lagrangian objective function. This iterative scheme implies that only the final, optimal solution is sure to be feasible w.r.t the nonlinear constraints. This is in contrast to the feasible path method used by some other NLP solvers, e.g., CONOPT. MINOS and CONOPT are very complementary to each other as they employ very different algorithms. See MINOS vs CONOPT for a comparison of the two solvers.

GAMS allows you to specify values for many parameters that control GAMS/MINOS, and with careful experimentation you may be able to influence the solution process in a helpful way. All MINOS options available through GAMS/MINOS are summarized at the end of this document.

For LP (and RMIP) models that cause difficulty for the standard solvers, QUADMINOS provides considerably greater reliability and accuracy by using quadruple-precision floating-point arithmetic. Although it is slower by a factor of 20 or 30 for cold-start runs, you can use standard MINOS or another LP solver first and let them do their best. Warm-starts with QUADMINOS may give greatly improved solutions at moderate cost.

The documentation below refers to both MINOS and QUADMINOS. To take advantage of QUADMINOS, the main requirement is to set a few runtime options to non-default values in order to request higher accuracy. For example, it is reasonable to set

   Feasibility tolerance  1e-15
Optimality  tolerance  1e-15


because IEEE Quad floating-point has nearly 34 digits of precision. For an example of using Double and Quad MINOS together, see [DQQ] in the GAMS model library.

# How to Run a Model with GAMS/MINOS

MINOS is capable of solving many types of models, including LP, NLP, DNLP and QCP. If MINOS is not specified as the default solver for the desired model type (e.g. NLP), then the following statement can be used in your GAMS model to select MINOS:

option nlp=minos;


The option statement should appear before the solve statement.

To be complete, we mention that the solver can be also specified on the command line, as in:

> gams camcge nlp=minos


This will override the global default, but if an algorithm option has been specified inside the model, then that specification takes precedence.

# Overview of GAMS/MINOS

GAMS/MINOS is a system designed to solve large-scale optimization problems expressed in the following form:

$\begin{array}{lcllr} \textrm{NLP}: & ~~~~~~~~~~~~~ & \textrm{minimize} & F(x) +c^Tx + d^Ty & ~~~~~~~~~~~~~~~~(1) \\[5pt] & ~~~~~~~~~~~~~ & \textrm{subject to} & f(x) + A_1 y \sim b_1 & ~~~~~~~~~~~~~~~~(2) \\ & ~~~~~~~~~~~~~ & & A_2 x + A_3 y \sim b_2 & ~~~~~~~~~~~~~~~~(3) \\ & ~~~~~~~~~~~~~ & & \displaystyle \ell \le \begin{pmatrix}x \\ y\end{pmatrix} \le u & ~~~~~~~~~~~~~~~~(4) \\ \end{array}$

where the vectors $$c$$, $$d$$, $$b_1$$, $$b_2$$, $$\ell$$, $$u$$ and the matrices $$A_1$$, $$A_2$$, $$A_3$$ are constant, $$F(x)$$ is a smooth scalar function, and $$f(x)$$ is a vector of smooth functions. The $$\sim$$ signs mean that individual constraints may be defined using $$\le$$, $$=$$ or $$\ge$$ corresponding to the GAMS constructs =L= , =E= and =G=.

The components of $$x$$ are called the nonlinear variables, and the components of $$y$$ are the linear variables. Similarly, the equations in $$(2)$$ are called the nonlinear constraints, and the equations in $$(3)$$ are the linear constraints. Equations $$(2)$$ and $$(3)$$ together are called the general constraints.

Let $$m_1$$ and $$n_1$$ denote the number of nonlinear constraints and variables, and let $$m$$ and $$n$$ denote the total number of (general) constraints and variables. Thus, $$A_3$$ has $$m-m_1$$ rows and $$n-n_1$$ columns. The constraints $$(4)$$ specify upper and lower bounds on all variables. These are fundamental to many problem formulations and are treated specially by the solution algorithms in GAMS/MINOS. Some of the components of $$\ell$$ and $$u$$ may be $$-\infty$$ or $$+\infty$$ respectively, in accordance with the GAMS use of -INF and +INF.

The vectors $$b_1$$ and $$b_2$$ are called the right-hand side, and together are denoted by $$b$$.

## Linear Programming

If the functions $$F(x)$$ and $$f(x)$$ are absent, the problem becomes a linear program. Since there is no need to distinguish between linear and nonlinear variables, we use $$x$$ rather than $$y$$. GAMS/MINOS converts all general constraints into equalities, and the only remaining inequalities are simple bounds on the variables. Thus, we write linear programs in the form

$\begin{array}{lcll} \textrm{LP}: & ~~~~~~~~~~~~~ & \textrm{minimize} & c^Tx \\[5pt] & ~~~~~~~~~~~~~ & \textrm{subject to} & Ax + Is =0 \\ & ~~~~~~~~~~~~~ & & \displaystyle \ell \le \begin{pmatrix}x \\ s\end{pmatrix} \le u \\ \end{array}$

where the elements of $$x$$ are your own GAMS variables, and $$s$$ is a set of slack variables: one for each general constraint. For computational reasons, the right-hand side $$b$$ is incorporated into the bounds on $$s$$.

In the expression $$Ax + Is = 0$$ we write the identity matrix explicitly if we are concerned with columns of the associated matrix $$\begin{pmatrix} A & I\end{pmatrix}$$. Otherwise we will use the equivalent notation $$Ax + s = 0$$.

GAMS/MINOS solves linear programs using a reliable implementation of the primal simplex method  , in which the constraints $$Ax + Is = 0$$ are partitioned into the form

\begin{equation*} B x_B + N x_N = 0, \end{equation*}

where the basis matrix is square and nonsingular. The elements of $$x_B$$ and $$x_N$$ are called the basic or nonbasic variables respectively. Together they are a permutation of the vector

\begin{equation*} \begin{pmatrix} x\\ s\end{pmatrix}. \end{equation*}

Normally, each nonbasic variable is equal to one of its bounds, and the basic variables take on whatever values are needed to satisfy the general constraints. (The basic variables may be computed by solving the linear equations $$B x_B = N x_N$$.) It can be shown that if an optimal solution to a linear program exists, then it has this form.

The simplex method reaches such a solution by performing a sequence of iterations, in which one column of $$B$$ is replaced by one column of $$N$$ (and vice versa), until no such interchange can be found that will reduce the value of $$c^Tx$$.

As indicated nonbasic variables usually satisfy their upper and lower bounds. If any components of $$x_B$$ lie significantly outside their bounds, we say that the current point is infeasible. In this case, the simplex method uses a Phase 1 procedure to reduce the sum of infeasibilities to zero. This is similar to the subsequent Phase 2 procedure that optimizes the true objective function $$c^Tx$$.

If the solution procedures are interrupted, some of the nonbasic variables may lie strictly between their bounds $$\ell_j < x_j < u_j$$. In addition, at a "feasible" or "optimal" solution, some of the basic variables may lie slightly outside their bounds: $$\ell_j - \delta < x_j < \ell_j$$ or $$u_j < x_j < u_j + \delta$$ where $$\delta$$ is a feasibility tolerance (typically $$10^{-6}$$). In rare cases, even nonbasic variables might lie outside their bounds by as much as $$\delta$$.

GAMS/MINOS maintains a sparse $$LU$$ factorization of the basis matrix $$B$$, using a Markowitz ordering scheme and Bartels-Golub updates, as implemented in the Fortran package LUSOL  (see [30, 29, 203, 204] ). The basis factorization is central to the efficient handling of sparse linear and nonlinear constraints.

## Problems with a Nonlinear Objective

When nonlinearities are confined to the term $$F(x)$$ in the objective function, the problem is a linearly constrained nonlinear program. GAMS/MINOS solves such problems using a reduced-gradient algorithm  combined with a quasi-Newton algorithm that is described in  . In the reduced-gradient method, the constraints $$Ax + Is = 0$$ are partitioned into the form

\begin{equation*} Bx_B + Sx_S + Nx_N = 0 \end{equation*}

where $$x_s$$ is a set of superbasic variables. At a solution, the basic and superbasic variables will lie somewhere between their bounds (to within the feasibility tolerance $$\delta$$, while nonbasic variables will normally be equal to one of their bounds, as before. Let the number of superbasic variables be $$s$$, the number of columns in $$S$$. (The context will always distinguish $$s$$ from the vector of slack variables.) At a solution, $$s$$ will be no more than $$n_1$$, the number of nonlinear variables. In many practical cases we have found that $$s$$ remains reasonably small, say 200 or less, even if $$n_1$$ is large.

In the reduced-gradient algorithm, $$x_s$$ is regarded as a set of "independent variables" or "free variables" that are allowed to move in any desirable direction, namely one that will improve the value of the objective function (or reduce the sum of infeasibilities). The basic variables can then be adjusted in order to continue satisfying the linear constraints.

If it appears that no improvement can be made with the current definition of $$B$$, $$S$$ and $$N$$, some of the nonbasic variables are selected to be added to $$S$$, and the process is repeated with an increased value of $$s$$. At all stages, if a basic or superbasic variable encounters one of its bounds, the variable is made nonbasic and the value of $$s$$ is reduced by one.

A step of the reduced-gradient method is called a minor iteration. For linear problems, we may interpret the simplex method as being the same as the reduced-gradient method, with the number of superbasic variable oscillating between 0 and 1.

A certain matrix $$Z$$ is needed now for descriptive purposes. It takes the form

\begin{equation*} \begin{pmatrix} -B^{-1}S \\ I \\ 0 \end{pmatrix} \end{equation*}

though it is never computed explicitly. Given an $$LU$$ factorization of the basis matrix $$B$$, it is possible to compute products of the form $$Zq$$ and $$Z^Tg$$ by solving linear equations involving $$B$$ or $$B^T$$. This in turn allows optimization to be performed on the superbasic variables, while the basic variables are adjusted to satisfy the general linear constraints.

An important feature of GAMS/MINOS is a stable implementation of a quasi-Newton algorithm for optimizing the superbasic variables. This can achieve superlinear convergence during any sequence of iterations for which the $$B$$, $$S$$, $$N$$ partition remains constant. A search direction $$q$$ for the superbasic variables is obtained by solving a system of the form

\begin{equation*} R^TRq = -Z^Tg \end{equation*}

where $$g$$ is a gradient of $$F(x)$$, $$Z^Tg$$ is the reduced gradient, and $$R$$ is a dense upper triangular matrix. GAMS computes the gradient vector $$g$$ analytically, using automatic differentiation. The matrix $$R$$ is updated in various ways in order to approximate the reduced Hessian according to $$R^TR \approx Z^THZ$$ where $$H$$ is the matrix of second derivatives of $$F(x)$$ (the Hessian).

Once $$q$$ is available, the search direction for all variables is defined by $$p = Zq$$. A ine search is then performed to find an approximate solution to the one-dimensional (w.r.t. α) problem

\begin{equation*} \begin{split} \textrm{minimize} \>\> & F(x+\alpha p) \\ \textrm{subject to} \>\> & 0 < \alpha < \beta \end{split} \end{equation*}

where $$\beta$$ is determined by the bounds on the variables. Another important piece in GAMS/MINOS is a step-length procedure used in the linesearch to determine the step-length $$\alpha$$ (see  ). The number of nonlinear function evaluations required may be influenced by setting the Linesearch tolerance, as discussed in Section Detailed Description of MINOS Options .

As in a linear programming solver, an equation $$B^T\pi= gB$$ is solved to obtain the dual variables or shadow prices $$\pi$$ where $$gB$$ is the gradient of the objective function associated with basic variables. It follows that $$gB - B^T \pi= 0$$. The analogous quantity for superbasic variables is the reduced-gradient vector $$Z^Tg = gs - s^T \pi$$; this should also be zero at an optimal solution. (In practice its components will be of order $$r ||\pi||$$ where $$r$$ is the optimality tolerance, typically $$10^{-6}$$, and $$||\pi||$$ is a measure of the size of the elements of $$\pi$$.)

## Problems with Nonlinear Constraints

If any of the constraints are nonlinear, GAMS/MINOS employs a project Lagrangian algorithm, based on a method due to  , see  . This involves a sequence of major iterations, each of which requires the solution of a linearly constrained subproblem. Each subproblem contains linearized versions of the nonlinear constraints, as well as the original linear constraints and bounds.

At the start of the $$k^{\hbox{th}}$$ major iteration, let $$x_k$$ be an estimate of the nonlinear variables, and let $$\lambda_k$$ be an estimate of the Lagrange multipliers (or dual variables) associated with the nonlinear constraints. The constraints are linearized by changing $$f(x)$$ in equation (2) to its linear approximation:

\begin{equation*} f'(x, x_k) = f(x_k) + J(x_k) (x - x_k) \end{equation*}

or more briefly

\begin{equation*} f' = f_k+ J_k (x - x_k) \end{equation*}

where $$J(x_k)$$ is the Jacobian matrix evaluated at $$x_k$$. (The $$i$$-th row of the Jacobian is the gradient vector of the $$i$$-th nonlinear constraint function. As with the objective gradient, GAMS calculates the Jacobian using automatic differentiation).

The subproblem to be solved during the $$k$$-th major iteration is then

$\begin{array}{lllr} & \textrm{minimize} & F(x) +c^Tx + d^Ty - \lambda_k^T(f-f') + 0.5\rho (f-f')^T(f-f') & ~~~~~~~~~~~~~~~~(5) \\[5pt] & \textrm{subject to} & f' + A_1 y \sim b_1 & ~~~~~~~~~~~~~~~~(6) \\ & & A_2 x + A_3 y \sim b_2 & ~~~~~~~~~~~~~~~~(7) \\ & & \displaystyle \ell \le \begin{pmatrix}x \\ y\end{pmatrix} \le u & ~~~~~~~~~~~~~~~~(8) \\ \end{array}$

The objective function $$(5)$$ is called an augmented Lagrangian. The scalar $$\rho$$ is a penalty parameter, and the term involving $$\rho$$ is a modified quadratic penalty function.

GAMS/MINOS uses the reduced-gradient algorithm to minimize $$(5)$$ subject to $$(6)$$ – $$(8)$$. As before, slack variables are introduced and $$b_1$$ and $$b_2$$ are incorporated into the bounds on the slacks. The linearized constraints take the form

\begin{equation*} \begin{pmatrix}J_k & A_1 \\ A_2 & A_3\end{pmatrix} \begin{pmatrix}x \\ y \end{pmatrix} + \begin{pmatrix}I & 0 \\ 0 & I\end{pmatrix} \begin{pmatrix}s_1\\ s_2 \end{pmatrix}= \begin{pmatrix}J_k x_k - f_k\\ 0 \end{pmatrix} \end{equation*}

This system will be referred to as $$Ax + Is = 0$$ as in the linear case. The Jacobian $$J_k$$ is treated as a sparse matrix, the same as the matrices $$A_1$$, $$A_2$$, and $$A_3$$.

In the output from GAMS/MINOS, the term Feasible subproblem indicates that the linearized constraints have been satisfied. In general, the nonlinear constraints are satisfied only in the limit, so that feasibility and optimality occur at essentially the same time. The nonlinear constraint violation is printed every major iteration. Even if it is zero early on (say at the initial point), it may increase and perhaps fluctuate before tending to zero. On "well behaved problems", the constraint violation will decrease quadratically (i.e., very quickly) during the final few major iterations.

# Modeling Issues

Formulating nonlinear models requires that the modeler pays attention to some details that play no role when dealing with linear models.

## Starting Points

The first issue is specifying a starting point. It is advised to specify a good starting point for as many nonlinear variables as possible. The GAMS default of zero is often a very poor choice, making this even more important.

As an (artificial) example consider the problem where we want to find the smallest circle that contains a number of points $$(x_i,y_i)$$:

$\begin{array}{lcllr} \textrm{Example}: & ~~~~~~~~~~~~~ & \textrm{minimize} & r \\[5pt] & ~~~~~~~~~~~~~ & \textrm{subject to} & (x_i-a)^2 + (y_i-b)^2 \le r^2, \> \> r \ge 0. \\ \end{array}$

This problem can be modeled in GAMS as follows.

set i 'points' /p1*p10/;

parameters
x(i)    'x coordinates',
y(i)    'y coordinates';

* fill with random data
x(i) = uniform(1,10);
y(i) = uniform(1,10);

variables
a       'x coordinate of center of circle'
b       'y coordinate of center of circle'

equations
e(i)    'points must be inside circle';

e(i).. sqr(x(i)-a) + sqr(y(i)-b) =l= sqr(r);

r.lo = 0;

model m /all/;
option nlp=minos;
solve m using nlp minimizing r;


Without help, MINOS will not be able to find an optimal solution. The problem will be declared infeasible. In this case, providing a good starting point is very easy. If we define

\begin{eqnarray*} x_{\min} &=& \min_i x_i,\\ y_{\min} &=& \min_i y_i,\\ x_{\max} &=& \max_i x_i,\\ y_{\max} &=& \max_i y_i, \end{eqnarray*}

then good estimates are

\begin{eqnarray*} a &=& (x_{\min}+x_{\max})/2, \\ b &=& (y_{\min}+y_{\max})/2, \\ r &=& \sqrt{ (a-x_{\min})^2 + (b-y_{\min})^2}. \end{eqnarray*}

Thus we include in our model:

parameters xmin,ymin,xmax,ymax;
xmin = smin(i, x(i));
ymin = smin(i, y(i));
xmax = smax(i, x(i));
ymax = smax(i, y(i));

* set starting point
a.l = (xmin+xmax)/2;
b.l = (ymin+ymax)/2;
r.l = sqrt( sqr(a.l-xmin) + sqr(b.l-ymin) );


and now the model solves very easily.

Level values can also be set away from zero implicitly as a result of assigning bounds. When a variable is bounded away from zero, for instance by the statement Y.LO = 1;, the implicit projection of variable levels onto their bounds that occurs when a model is solved will initialize Y away from zero.

## Bounds

Setting appropriate bounds can be very important to steer the algorithm away from uninteresting areas, and to prevent function evaluation errors from happening.

If your model contains a real power of the form x**y it is important to add a bound $$x > 0.001$$, as real exponentation is evaluated in GAMS as $$\exp(y \log(x))$$. In some cases one cannot write a bound directly, e.g. if the equation is $$z = x^{f(y)}$$. In that case it is advised to introduce an extra variable and equation:

\begin{equation*} \begin{split} z &= x^{\vartheta } \\ \vartheta &= f(y) \\ \vartheta &\ge \varepsilon \end{split} \end{equation*}

(Note that the functions SQR(x) and POWER(x,k) are integer powers and do not require $$x$$ to be positive).

If the model produces function evaluation errors adding bounds is prefered to raising the DOMLIM limit.

Bounds in GAMS are specified using X.LO(i)=0.001 and X.UP(i) = 1000.

## Scaling

Although MINOS has some facilities to scale the problem before starting to optimize it, it remains an important task for the modeler to provide a well-scaled model. This is especially the case for nonlinear models. GAMS has special syntax features to specify row and column scales that allow the modeler to keep the equations in a most natural form. For more information consult the GAMS User's Guide.

## The Objective Function

The first step GAMS/MINOS performs is to try to reconstruct the objective function. In GAMS, optimization models minimize or maximize an objective variable. MINOS however works with an objective function. One way of dealing with this is to add a dummy linear function with just the objective variable. Consider the following GAMS fragment:

obj.. z =e= sum(i, sqr(resid(i)));

model m /all/;
solve m using nlp minimizing z;


This can be cast in form NLP (equations $$(1)-(4)$$) by saying minimize $$z$$ subject to $$z = \sum_i resid^2_i$$ and the other constraints in the model. Although simple, this approach is not always preferable. Especially when all constraints are linear it is important to minimize $$\sum_i resid^2_i$$ directly. This can be achieved by a simple reformulation: $$z$$ can be substituted out. The substitution mechanism carries out the formulation if all of the following conditions hold:

• the objective variable $$z$$ is a free continuous variable (no bounds are defined on $$z$$),
• $$z$$ appears linearly in the objective function,
• the objective function is formulated as an equality constraint,
• $$z$$ is only present in the objective function and not in other constraints.

For many models it is very important that the nonlinear objective function be used by MINOS. For instance the model [CHEM] from the model library solves in 21 iterations. When we add the bound

energy.lo = 0;


to the objective variable energy and thus prevent it from being substituted out, MINOS will not be able to find a feasible point for the given starting point.

This reformulation mechanism has been extended for substitutions along the diagonal. For example, the GAMS model

Variables x,y,z;
Equations e1,e2;

e1..z =e= y;
e2..y =e= sqr(1+x);

model m /all/;

option nlp=minos;
solve m using nlp minimizing z;


will be reformulated as an unconstrained optimization problem

$\begin{array}{lrl} & \text{minimize} ~~\text{f(x)} & =(1+x)^2. \\ \end{array}$

These additional reformulations can be turned off by using the statement option reform = 0; (see Section GAMS Options).

# GAMS Options

The standard GAMS options (e.g. iterlim, domlim) can be used to control GAMS/MINOS. For more details, see section Controlling a Solver via GAMS Options. We highlight some of the details of this usage below for cases of special interest.

iterlim

Sets the minor iteration limit. MINOS will stop as soon as the number of minor iterations exceeds the iteration limit and report the current solution.

domlim

Sets the domain error limit. Domain errors are evaluation errors in the nonlinear functions. An example of a domain error is trying to evaluate $$\sqrt{x}$$ for $$x<0$$. Other examples include taking logs of negative numbers, and evaluating the real power $$x^y$$ for $$x < \varepsilon$$ ( $$x^y$$ is evaluated as $$\exp(y \log x)$$). When such an error occurs the count of domain errors is incremented: MINOS will stop if this count exceeds the limit. If the limit has not been reached, reasonable estimates for the function (and derivatives, if requested) are returned and MINOS continues. For example, in the case of $$\sqrt{x}, x<0$$ a zero is passed back for the function value and a large value for the derivative. In many cases MINOS will be able to recover from these domain errors, especially when they happen at some intermediate point. Nevertheless it is best to add appropriate bounds or linear constraints to ensure that these domain errors don't occur. For example, when an expression $$\log(x)$$ is present in the model, add a statement like x.lo = 0.001;.

bratio

Ratio used in basis acceptance test. When a previous solution or solution estimate exists, GAMS automatically passes this solution to MINOS so that it can reconstruct an advanced basis. When too many new (i.e. uninitialized with level and/or marginal values) variables or constraints enter the model, it may be better not to use existing basis information, but to instead crash a new basis. The bratio determines how quickly an existing basis is discarded. A value of 1.0 will discard any basis, while a value of 0.0 will retain any basis.

workfactor

By default, GAMS/MINOS computes an estimate of the amount of workspace needed by MINOS, and passes this workspace on to MINOS for use in solving the model. This estimate is based on the model statistics: number of (nonlinear) equations, number of (nonlinear) variables, number of (nonlinear) nonzeroes, etc. In most cases this is sufficient to solve the model. In some rare cases MINOS may need more memory, and the user can provide this by specifying a value of workfactor greater than 1. The computed memory estimate is multiplied by the workfactor to determine the amount of workspace made available to MINOS for the solve.

workspace

The workspace option is deprecated: use the workfactor option instead. The workspace option specifies the amount of memory, in MB, that MINOS will use.

reform

This option controls the objective reformulation mechanism described in Section The Objective Function The default value of 100 will cause GAMS/MINOS to try further substitutions along the diagonal after the objective variable has been removed. Any other value will disable this diagonal procedure.

# Summary of MINOS Options

The performance of GAMS/MINOS is controlled by a number of parameters or "options." Each option has a default value that should be appropriate for most problems. For special situations it is possible to specify non-standard values for some or all of the options through the MINOS option file. While the content of an option file is solver-specific, the details of how to create an option file and instruct the solver to use it are not. This topic is covered in section The Solver Options File.

Note that the option file is not case sensitive. Examples for using the option file can be found at the end of this section. The tables below contain summary information about the MINOS options, default values, and links to more detailed explanations.

## Output related options

Option Description Default
debug level Controls amount of debug information written 0
log frequency Controls iteration logging to listing file 100
print level Controls amount of information printed during optimization 0
scale print Print scaling factors
solution Prints MINOS solution NO
summary frequency Controls iteration logging to summary (log file) 100

## Tolerances

Option Description Default
crash tolerance Allow crash procedure to ignore small elements in eligible columns 0.1
feasibility tolerance Feasibility tolerance for linear constraints 1.0e-6
linesearch tolerance Controls accuracy of steplength selected 0.1
LU density tolerance When to use dense factorization 0.5
LU factor tolerance Trade-off between stability and sparsity in basis factorization 100.0
LU singularity tolerance Protection against ill-conditioned basis matrices 1.0e-11
LU update tolerance Trade-off between stability and sparsity in basis updating 10.0
optimality tolerance Reduced gradient optimality check 1.0e-6
row tolerance Accuracy requirement for nonlinear rows 1.0e-6
scale print tolerance Scale print flag and set tolerance 0.9
scale tolerance Scale tolerance 0.9
subspace tolerance Determines when nonbasics becomes superbasic 0.5

## Limits

Option Description Default
hessian dimension Size of Hessian matrix 1
iterations limit Minor iteration limit GAMS iterlim
major iterations Max number of major iterations 50
minor iterations Max number of minor iterations between linearizations of nonlinear constraints 40
superbasics limit Maximum number of superbasics 1
unbounded objective value Determines when a problem is called unbounded 1.0e20
unbounded step size Determines when a problem is called unbounded 1.0e10

## Other algorithmic options

Option Description Default
check frequency Controls frequency of linear constraint satisfaction test 60
completion Completion level for subproblems (full/partial) FULL
crash option Controls the basis crash algorithm 3
expand frequency Setting for anti-cycling mechanism 10000
factorization frequency Number of iterations between basis factorizations 100
lagrangian Determines form of objection function in the linearized subproblems YES
LU complete pivoting LUSOL pivoting strategy
LU partial pivoting LUSOL pivoting strategy
LU rook pivoting LUSOL pivoting strategy
major damping parameter Prevents large relative changes between subproblem solutions 2.0
minor damping parameter Limit change in x during linesearch 2.0
multiple price Multiple pricing 1
partial price Number of segments in partial pricing strategy 10
penalty parameter Used in modified augmented Lagrangian automatic
radius of convergence controls final reduction of penalty parameter 0.01
scale all variables Synonym to scale option 2
scale linear variables Synonym to scale option 1
scale no Synonym to scale option 0
scale nonlinear variables Synonym to scale option 2
scale option Scaling 1
scale yes Synonym to scale option 1
start assigned nonlinears Starting strategy when there is no basis SUPERBASIC
verify constraint gradients Synonym to verify level 2
verify gradients Synonym to verify level 3
verify level Controls verification of gradients 0
verify no Synonym to verify level 0
verify objective gradients Synonym to verify level 1
verify yes Synonym to verify level 3
weight on linear objective Composite objective weight 0.0

## Examples of GAMS/MINOS Option File

The following example illustrates the use of certain options that might be helpful for "difficult" models involving nonlinear constraints. Experimentation may be necessary with the values specified, particularly if the sequence of major iterations does not converge using default values.

* These options might be relevant for very nonlinear models.
Major damping parameter  0.2   * may prevent divergence.
Minor damping parameter  0.2   * if there are singularities
* in the nonlinear functions.
Penalty parameter       10.0   * or 100.0 perhaps-a value
* higher than the default.
Scale linear variables         * (This is the default.)


Conversely, nonlinearly constrained models that are very nearly linear may optimize more efficiently if some of the cautious defaults are relaxed:

* Suggestions for models with MILDLY nonlinear constraints
Completion   Full
Penalty parameter        0.0  * or 0.1 perhaps-a value
* smaller than the default.
* Scale one of the following
Scale all variables           * if starting point is VERY GOOD.
Scale linear variables        * if they need it.
Scale No                      * otherwise.


Most of the options should be left at their default values for any given model. If experimentation is necessary, we recommend changing just one option at a time.

# Special Notes

## Modeling Hints

Unfortunately, there is no guarantee that the algorithm just described will converge from an arbitrary starting point. The concerned modeler can influence the likelihood of convergence as follows:

• Specify initial activity levels for the nonlinear variables as carefully as possible (using the GAMS suffix .L).
• Include sensible upper and lower bounds on all variables.
• Specify a Major damping parameter that is lower than the default value, if the problem is suspected of being highly nonlinear
• Specify a Penalty parameter $$\rho$$ that is higher than the default value, again if the problem is highly nonlinear.

In rare cases it may be safe to request the values $$\lambda_k = 0$$ and $$\rho = 0$$ for all subproblems, by specifying Lagrangian=No. However, convergence is much more likely with the default setting, Lagrangian=Yes. The initial estimate of the Lagrange multipliers is then $$\lambda_0 = 0$$, but for later subproblems $$\lambda_k$$ is taken to be the Lagrange multipliers associated with the (linearized) nonlinear constraints at the end of the previous major iteration.

For the first subproblem, the default value for the penalty parameter is $$\rho= 100.0/m_1$$ where $$m_1$$ is the number of nonlinear constraints. For later subproblems, $$\rho$$ is reduced in stages when it appears that the sequence $$\{x_k, \lambda_k\}$$ is converging. In many cases it is safe to specify $$\lambda = 0$$, particularly if the problem is only mildly nonlinear. This may improve the overall efficiency.

## Storage

GAMS/MINOS uses one large array of memory for most of its workspace. The implementation places no fixed limit on the size of a problem or on its shape (many constraints and relatively few variables, or vice versa). In general, the limiting factor will be the amount of physical memory available on a particular machine, and the amount of computation time one is willing to spend.

Some detailed knowledge of a particular model will usually indicate whether the solution procedure is likely to be efficient. An important quantity is $$m$$, the total number of general constraints in $$(2)$$ and $$(3)$$. The amount of workspace required by GAMS/MINOS is roughly $$100m$$ doubles, or $$800m$$ bytes for workspace. A further 300K bytes, approximately, are needed for the program itself, along with buffer space for several files. Very roughly, then, a model with $$m$$ general constraints requires about $$(m+300)$$ K bytes of memory.

Another important quantity is $$n$$, the total number of variables in $$x$$ and $$y$$. The above comments assume that $$n$$ is not much larger than $$m$$, the number of constraints. A typical ratio for $$n/m$$ is 2 or 3.

If there are many nonlinear variables (i.e., if $$n_1$$ is large), much depends on whether the objective function or the constraints are highly nonlinear or not. The degree of nonlinearity affects $$s$$, the number of superbasic variables. Recall that $$s$$ is zero for purely linear problems. We know that $$s$$ need never be larger than $$n_1+1$$. In practice, $$s$$ is often very much less than this upper limit.

In the quasi-Newton algorithm, the dense triangular matrix $$R$$ has dimension $$s$$ and requires about $$s^2/2$$ words of storage. If it seems likely that $$s$$ will be very large, some aggregation or reformulation of the problem should be considered.

# The GAMS/MINOS Log File

MINOS writes different logs for LPs, NLPs with linear constraints, and NLPs with non-linear constraints. In this section, a sample log file is shown for each case, and the messages that appear are explained.

## Linear Programs

MINOS uses a standard two-phase simplex method for LPs. In the first phase, the sum of the infeasibilities at each iteration is minimized. Once feasibility is attained, MINOS switches to phase 2 where it minimizes (or maximizes) the original objective function. The different objective functions are called the phase 1 and phase 2 objectives. Notice that the marginals in phase 1 are with respect to the phase 1 objective. This means that if MINOS interrupts in phase 1, the marginals are "wrong" in the sense that they do not reflect the original objective.

The log for the problem TURKPOW is as follows:

GAMS Rev 235  Copyright (C) 1987-2010 GAMS Development. All rights reserved
--- Starting compilation
--- turkpow.gms(230) 3 Mb
--- Starting execution: elapsed 0:00:00.009
--- turkpow.gms(202) 4 Mb
--- Generating LP model turkey
--- turkpow.gms(205) 4 Mb
---   350 rows  949 columns  5,872 non-zeroes
--- Executing MINOS: elapsed 0:00:00.025

GAMS/MINOS       Aug 18, 2010 23.5.2 WIN 19143.19383 VS8 x86/MS Windows
M I N O S  5.51     (Jun 2004)

GAMS/MINOS 5.51, Large Scale Nonlinear Solver
B. A. Murtagh, University of New South Wales
P. E. Gill, University of California at San Diego,
W. Murray, M. A. Saunders, and M. H. Wright,
Systems Optimization Laboratory, Stanford University

Work space allocated           --    1.60 Mb

Itn  ninf      sinf       objective
100     3 2.283E-01 -2.51821463E+04
200     0 0.000E+00  2.02819284E+04
300     0 0.000E+00  1.54107277E+04
400     0 0.000E+00  1.40211808E+04
500     0 0.000E+00  1.33804183E+04
600     0 0.000E+00  1.27082709E+04

EXIT - Optimal Solution found, objective:        12657.77

--- Restarting execution
--- turkpow.gms(205) 0 Mb
--- Reading solution for model turkey
--- turkpow.gms(230) 3 Mb
*** Status: Normal completion


The first line that is written by MINOS is the version string: GAMS/MINOS Aug 18, 2010 23.5.2 WIN 19143.19383 VS8 x86/MS Windows This line identifies which version of the MINOS libraries and links you are using, and is only to be deciphered by GAMS support personnel.

After some advertisement text we see the amount of work space (i.e. memory) that is allocated: 1.60 Mb. When MINOS is loaded, the amount of memory needed is first estimated. This estimate is based on statistics like the number of rows, columns and non-zeros. This amount of memory is then allocated and the problem loaded into MINOS.

The columns have the following meaning:

Itn

Iteration number.

ninf

Number of infeasibilities. If nonzero the current iterate is still infeasible.

sinf

The sum of the infeasibilities. This number is minimized during Phase I. Once the model is feasible this number is zero.

objective

The value of the objective function: $$z = \sum c_i x_i$$. In phase II this number is maximized or minimized. In phase I it may move in the wrong direction.

The final line indicates the exit status of MINOS.

## Linearly Constrained NLP's

The log is basically the same as for linear models. The only difference is that not only matrix rows and columns need to be loaded, but also instructions for evaluating functions and gradients.

The log for the problem WEAPONS is as follows:

GAMS Rev 235  Copyright (C) 1987-2010 GAMS Development. All rights reserved
--- Starting compilation
--- weapons.gms(77) 3 Mb
--- Starting execution: elapsed 0:00:00.005
--- weapons.gms(66) 4 Mb
--- Generating NLP model war
--- weapons.gms(68) 6 Mb
---   13 rows  66 columns  156 non-zeroes
---   706 nl-code  65 nl-non-zeroes
--- weapons.gms(68) 4 Mb
--- Executing MINOS: elapsed 0:00:00.013

GAMS/MINOS       Aug 18, 2010 23.5.2 WIN 19143.19383 VS8 x86/MS Windows
M I N O S  5.51     (Jun 2004)

GAMS/MINOS 5.51, Large Scale Nonlinear Solver
B. A. Murtagh, University of New South Wales
P. E. Gill, University of California at San Diego,
W. Murray, M. A. Saunders, and M. H. Wright,
Systems Optimization Laboratory, Stanford University

Work space allocated           --    0.82 Mb

Itn  ninf      sinf       objective
100     0 0.000E+00  1.71416714E+03
200     0 0.000E+00  1.73483184E+03

EXIT - Optimal Solution found, objective:        1735.570

--- Restarting execution
--- weapons.gms(68) 0 Mb
--- Reading solution for model war
--- weapons.gms(77) 3 Mb
*** Status: Normal completion


## NLP's with Nonlinear Constraints

For models with nonlinear constraints the log is more complicated. The library model [CAMCGE] from the model library is such an example: the log output resulting from running it is shown below.

GAMS Rev 235  Copyright (C) 1987-2010 GAMS Development. All rights reserved
--- Starting compilation
--- camcge.gms(450) 3 Mb
--- Starting execution: elapsed 0:00:00.010
--- camcge.gms(441) 4 Mb
--- Generating NLP model camcge
--- camcge.gms(450) 6 Mb
---   243 rows  280 columns  1,356 non-zeroes
---   5,524 nl-code  850 nl-non-zeroes
--- camcge.gms(450) 4 Mb
--- Executing MINOS: elapsed 0:00:00.023

GAMS/MINOS       Aug 18, 2010 23.5.2 WIN 19143.19383 VS8 x86/MS Windows
M I N O S  5.51     (Jun 2004)

GAMS/MINOS 5.51, Large Scale Nonlinear Solver
B. A. Murtagh, University of New South Wales
P. E. Gill, University of California at San Diego,
W. Murray, M. A. Saunders, and M. H. Wright,
Systems Optimization Laboratory, Stanford University

Work space allocated           --    1.48 Mb

Major minor  step     objective  Feasible Optimal  nsb   ncon penalty BSswp
1     2T 0.0E+00  1.91724E+02 1.8E+02 2.0E-01    0      1 1.0E+00     0
2    90  1.0E+00  1.91735E+02 1.5E-03 7.6E+00    0      3 1.0E+00     0
3     0  1.0E+00  1.91735E+02 1.3E-09 5.5E-06    0      4 1.0E+00     0
4     0  1.0E+00  1.91735E+02 1.1E-12 2.8E-13    0      5 1.0E-01     0

EXIT - Optimal Solution found, objective:        191.7346

--- Restarting execution
--- camcge.gms(450) 0 Mb
--- Reading solution for model camcge
*** Status: Normal completion


Two sets of iterations, major and minor, are now reported. A description of the various columns present in this log file follows:

Major

A major iteration involves linearizing the nonlinear constraints and performing a number of minor iterations on the resulting subproblem. The objective for the subproblem is an augmented Lagrangian, not the true objective function.

minor

The number of minor iterations performed on the linearized subproblem. If it is a simple number like 90, then the subproblem was solved to optimality. Here, $$2T$$ means that the subproblem was terminated. In general the $$T$$ is not something to worry about. Other possible flags are $$I$$ and $$U$$, which mean that the subproblem was infeasible or unbounded. MINOS may have difficulty if these keep occurring.

step

The step size taken towards the solution suggested by the last major iteration. Ideally this should be 1.0, especially near an optimum. If the subproblem solutions are widely different, MINOS may reduce the step size under control of the Major Damping parameter.

objective

The objective function for the original nonlinear program.

Feasible

Primal infeasibility, indicating the maximum non-linear constraint violation.

Optimal

The maximum dual infeasibility, measured as the maximum departure from complementarity. If we call $$d_j$$ the reduced cost of variable $$x_j$$, then the dual infeasibility of $$x_j$$ is $$d_j \times \min\{x_j - \ell_j, 1\}$$ or $$-d_j \times \min\{u_j - x_j, 1\}$$ depending on the sign of $$d_j$$.

nsb

Number of superbasics. If the model is feasible this number cannot exceed the superbasic limit, which may need to be reset to a larger number if the numbers in this column become larger.

ncon

The number of times MINOS has evaluated the nonlinear constraints and their derivatives.

penalty

The current value of the penalty parameter in the augmented Lagrangian (the objective for the subproblems). If the major iterations appear to be converging, MINOS will decrease the penalty parameter. If there appears to be difficulty, such as unbounded subproblems, the penalty parameter will be increased.

BSswp

Number of basis swaps: the number of $$\begin{pmatrix}B & S\end{pmatrix}$$ (i.e. basic vs. superbasic) changes.

Note: The CAMCGE model (like many CGE models or other almost square systems) can better be solved with the MINOS option Start Assigned Nonlinears Basic.

# Detailed Description of MINOS Options

The following is an alphabetical list of the keywords that may appear in the GAMS/MINOS options file, and a description of their effect. Options not specified will take the default values shown.

check frequency (integer): Controls frequency of linear constraint satisfaction test

Every ith iteration after the most recent basis factorization, a numerical test is made to see if the current solution x satisfies the general linear constraints (including linearized nonlinear constraints, if any). The constraints are of the form Ax+s = 0 where s is the set of slack variables. To perform the numerical test, the residual vector r = Ax + s is computed. If the largest component of r is judged to be too large, the current basis is refactorized and the basic variables are recomputed to satisfy the general constraints more accurately.

Range: {1, ..., ∞}

Default: 60

completion (string): Completion level for subproblems (full/partial)

When there are nonlinear constraints, this determines whether subproblems should be solved to moderate accuracy (partial completion) or to full accuracy (full completion). GAMS/MINOS implements the option by using two sets of convergence tolerances for the subproblems.
Use of partial completion may reduce the work during early major iterations, unless the Minor iterations limit is active. The optimal set of basic and superbasic variables will probably be determined for any given subproblem, but the reduced gradient may be larger than it would have been with full completion. An automatic switch to full completion occurs when it appears that the sequence of major iterations is converging. The switch is made when the nonlinear constraint error is reduced below 100 * (Row tolerance), the relative change in Lambdak is 0.1 or less, and the previous subproblem was solved to optimality. Full completion tends to give better Langrange-multiplier estimates. It may lead to fewer major iterations, but may result in more minor iterations.

Default: FULL

value meaning
FULL Solve subproblems to full accuracy
PARTIAL Solve subproblems to moderate accuracy

crash option (integer): Controls the basis crash algorithm

If a restart is not being performed, an initial basis will be selected from certain columns of the constraint matrix (A I). The value of the parameter i determines which columns of A are eligible. Columns of I are used to fill gaps where necessary. If i > 0, three passes are made through the relevant columns of A, searching for a basis matrix that is essentially triangular. A column is assigned to pivot on a particular row if the column contains a suitably large element in a row that has not yet been assigned. (The pivot elements ultimately form the diagonals of the triangular basis). Pass 1 selects pivots from free columns (corresponding to variables with no upper and lower bounds). Pass 2 requires pivots to be in rows associated with equality (=E=) constraints. Pass 3 allows the pivots to be in inequality rows. For remaining (unassigned) rows, the associated slack variables are inserted to complete the basis.

Default: 3

value meaning
0 Initial basis will be a slack basis
1 All columns are eligible
2 Only linear columns are eligible
3 Columns appearing nonlinearly in the objective are not eligible
4 Columns appearing nonlinearly in the constraints are not eligible

crash tolerance (real): Allow crash procedure to ignore small elements in eligible columns

The Crash tolerance r allows the starting procedure CRASH to ignore certain small nonzeros in each column of A. If amax is the largest element in column j, other nonzeros aij in the column are ignored if |aij| < amax * r. To be meaningful, the parameter r should be in the range 0 <= r < 1. When r > 0.0 the basis obtained by CRASH may not be strictly triangular, but it is likely to be nonsingular and almost triangular. The intention is to obtain a starting basis containing more columns of A and fewer (arbitrary) slacks. A feasible solution may be reached sooner on some problems. For example, suppose the first m columns of A are the matrix shown under LU factor tolerance; i.e., a tridiagonal matrix with entries -1, 4, -1. To help CRASH choose all m columns for the initial basis, we could specify Crash tolerance r for some value of r > 0.25.

Range: [0, 1.0]

Default: 0.1

debug level (integer): Controls amount of debug information written

This causes various amounts of information to be output. Most debug levels will not be helpful to GAMS users, but they are listed here for completeness. Note that you will need to use the GAMS statement OPTION SYSOUT=on; to echo the MINOS listing to the GAMS listing file.

• debug level 0
No debug output.
• debug level 2(or more)
Output from M5SETX showing the maximum residual after a row check.
• debug level 40
Output from LU8RPC (which updates the LU factors of the basis matrix), showing the position of the last nonzero in the transformed incoming column.
• debug level 50
Output from LU1MAR (which updates the LU factors each refactorization), showing each pivot row and column and the dimensions of the dense matrix involved in the associated elimination.
• debug level 100
Output from M2BFAC and M5LOG listing the basic and superbasic variables and their values at every iteration.

Default: 0

expand frequency (integer): Setting for anti-cycling mechanism

This option is part of an anti-cycling procedure designed to guarantee progress even on highly degenerate problems. For linear models, the strategy is to force a positive step at every iteration, at the expense of violating the bounds on the variables by a small amount. Suppose the specified feasibility tolerance is delta and the expand frequency is k. Over a period of k iterations, the tolerance actually used by GAMS/MINOS increases from 0.5*delta to delta (in steps 0.5*delta/k). For nonlinear models, the same procedure is used for iterations in which there is only one superbasic variable. (Cycling can occur only when the current solution is at a vertex of the feasible region.) Thus, zero steps are allowed if there is more than one superbasic variable, but otherwise positive steps are enforced. At least every k iterations, a resetting procedure eliminates any infeasible nonbasic variables. Increasing k helps to reduce the number of these slightly infeasible nonbasic variables. However, it also diminishes the freedom to choose a large pivot element (see Pivot tolerance).

Range: {1, ..., ∞}

Default: 10000

factorization frequency (integer): Number of iterations between basis factorizations

At most i basis updates will occur between factorizations of the basis matrix. With linear programs, basis updates usually occur at every iteration. The default i is reasonable for typical problems. Higher values up to i = 200 (say) may be more efficient on problems that are extremely sparse and well scaled. When the objective function is nonlinear, fewer basis updates will occur as an optimum is approached. The number of iterations between basis factorizations will therefore increase. During these iterations a test is made regularly (according to the Check frequency) to ensure that the general constraints are satisfied. If necessary the basis will be re-factorized before the limit of i updates is reached. When the constraints are nonlinear, the Minor iterations limit will probably preempt i.

Range: {1, ..., ∞}

Default: 100

feasibility tolerance (real): Feasibility tolerance for linear constraints

When the constraints are linear, a feasible solution is one in which all variables, including slacks, satisfy their upper and lower bounds to within the absolute tolerance r. (Since slacks are included, this means that the general linear constraints are also satisfied within r.) GAMS/MINOS attempts to find a feasible solution before optimizing the objective function. If the sum of infeasibilities cannot be reduced to zero, the problem is declared infeasible. Let SINF be the corresponding sum of infeasibilities. If SINF is quite small, it may be appropriate to raise r by a factor of 10 or 100. Otherwise, some error in the data should be suspected. If SINF is not small, there may be other points that have a significantly smaller sum of infeasibilities. GAMS/MINOS does not attempt to find a solution that minimizes the sum. If Scale option = 1 or 2, feasibility is defined in terms of the scaled problem (since it is then more likely to be meaningful). A nonlinear objective function F(x) will be evaluated only at feasible points. If there are regions where F(x) is undefined, every attempt should be made to eliminate these regions from the problem. For example, for a function F(x) = sqrt(x1)+log(x2), it should be essential to place lower bounds on both variables. If Feasibility tolerance = 10-6, the bounds x1 > 10-5 and x2 > 10-4 might be appropriate. (The log singularity is more serious; in general, keep variables as far away from singularities as possible.) If the constraints are nonlinear, the above comments apply to each major iteration. A feasible solution satisfies the current linearization of the constraints to within the tolerance r. The associated subproblem is said to be feasible. As for the objective function, bounds should be used to keep x more than r away from singularities in the constraint functions f(x). At the start of major iteration k, the constraint functions f(xk) are evaluated at a certain point xk. This point always satisfies the relevant bounds (l < xk < u), but may not satisfy the general linear constraints. During the associated minor iterations, F(x) and f(x) will be evaluated only at points x that satisfy the bound and the general linear constraints (as well as the linearized nonlinear constraints). If a subproblem is infeasible, the bounds on the linearized constraints are relaxed temporarily, in several stages. Feasibility with respect to the nonlinear constraints themselves is measured against the Row tolerance (not against r). The relevant test is made at the start of a major iteration.

Default: 1.0e-6

hessian dimension (integer): Size of Hessian matrix

This specifies that an r*r triangular matrix R is to be available for use by the quasi-Newton algorithm. The matrix R approximates the reduced Hessian in that RTR approximates ZTHZ. Suppose there are s superbasic variables at a particular iteration. Whenever possible, r should be greater than s. If r > s, the first s columns of R will be used to approximate the reduced Hessian in the normal manner. If there are no further changes to the set of superbasic variables, the rate of convergence will ultimately be superlinear. If r < s, a matrix of the form

R = diag(Rr, D)

will be used to approximate the reduced Hessian, where Rr is an r * r upper triangular matrix and D is a diagonal matrix of order s - r. The rate of convergence will no longer be superlinear (and may be arbitrarily slow). The storage required is of the order sqr(r)/2, i.e. quadratic in r. In general, r should be a slight over-estimate of the final number of superbasic variables, whenever storage permits. It need never be larger than n1 + 1, where n1 is the number of nonlinear variables. For many problems it can be much smaller than n1. If Superbasics limit s is specified, the default value of r is the same number, s (and conversely). This is a safeguard to ensure super-linear convergence wherever possible. If neither r nor s is specified, GAMS chooses values for both, using certain characteristics of the problem.

Range: {1, ..., ∞}

Default: 1

iterations limit (integer): Minor iteration limit

The maximum number of minor iterations allowed (i.e., iterations of the simplex method or the reduced-gradient method). This option, if set, overrides the GAMS ITERLIM specification. If i = 0, no minor iterations are performed, but the starting point is tested for both feasibility and optimality.

Default: GAMS iterlim

lagrangian (string): Determines form of objection function in the linearized subproblems

This determines the form of the objective function used for the linearized subproblems. The default value yes is highly recommended. The Penalty parameter value is then also relevant. If No is specified, the nonlinear constraint functions will be evaluated only twice per major iteration. Hence this option may be useful if the nonlinear constraints are very expensive to evaluate. However, in general there is a great risk that convergence may not occur.

Default: YES

value meaning
NO Nondefault value (not recommended)
YES Default value (recommended)

linesearch tolerance (real): Controls accuracy of steplength selected

For nonlinear problems, this controls the accuracy with which a steplength alpha is located in the one-dimensional problem

minimize F(x+alpha*p)
subject to 0 < alpha <= beta

A linesearch occurs on most minor iterations for which x is feasible. (If the constraints are nonlinear, the function being minimized is the augmented Lagrangian.) r must be a real value in the range 0.0 < r < 1.0. The default value r = 0.1 requests a moderately accurate search. It should be satisfactory in most cases. If the nonlinear functions are cheap to evaluate, a more accurate search may be appropriate: try r = 0.01 or r = 0.001. The number of iterations should decrease, and this will reduce total run time if there are many linear or nonlinear constraints. If the nonlinear function are expensive to evaluate, a less accurate search may be appropriate; try r = 0.5 or perhaps r = 0.9. (The number of iterations will probably increase but the total number of function evaluations may decrease enough to compensate.)

Range: [0, 1.0]

Default: 0.1

log frequency (integer): Controls iteration logging to listing file

In general, one line of the iteration log is printed every ith minor iteration. A heading labels the printed items, which include the current iteration number, the number and sum of feasibilities (if any), the subproblem objective value (if feasible), and the number of evaluations of the nonlinear functions. A value such as i = 10, 100 or larger is suggested for those interested only in the final solution. Log frequency 0 may be used as shorthand for Log frequency 99999. If Print level > 0, the default value of i is 1. If Print level = 0, the default value of i is 100. If Print level = 0 and the constraints are nonlinear, the minor iteration log is not printed (and the Log frequency is ignored). Instead, one line is printed at the beginning of each major iteration.

Range: {1, ..., ∞}

Default: 100

LU complete pivoting (no value): LUSOL pivoting strategy

The LUSOL factorization implements a Markowitz-style search for pivots that locally minimize fill-in subject to a threshold pivoting stability criterion. The rook and complete pivoting options are more expensive than partial pivoting but are more stable and better at revealing rank, as long as the LU factor tolerance is not too large (say < 2.0).

LU density tolerance (real): When to use dense factorization

The density tolerance is used during LUSOL's basis factorization B=LU. Columns of L and rows of U are formed one at a time, and the remaining rows and columns of the basis are altered appropriately. At any stage, if the density of the remaining matrix exceeds this tolerance, the Markowitz strategy for choosing pivots is terminated and the remaining matrix is factored by a dense LU procedure. Raising the tolerance towards 1.0 may give slightly sparser factors, with a slight increase in factorization time.

Range: [0, 1.0]

Default: 0.5

LU factor tolerance (real): Trade-off between stability and sparsity in basis factorization

This tolerance affects the stability and sparsity of the basis factorization B = LU during factorization. The value r specified must satisfy r >= 1.0.

• The default value r = 100.0 usually strikes a good compromise between stability and sparsity.
• For large and relatively dense problems, a larger value may give a useful improvement in sparsity without impairing stability to a serious degree.
• For certain very regular structures (e.g., band matrices) it may be necessary to set r to a value smaller than the default in order to achieve stability.

Range: [1.0, ∞]

Default: 100.0

LU partial pivoting (no value): LUSOL pivoting strategy

The LUSOL factorization implements a Markowitz-style search for pivots that locally minimize fill-in subject to a threshold pivoting stability criterion. The rook and complete pivoting options are more expensive than partial pivoting but are more stable and better at revealing rank, as long as the LU factor tolerance is not too large (say < 2.0).

LU rook pivoting (no value): LUSOL pivoting strategy

The LUSOL factorization implements a Markowitz-style search for pivots that locally minimize fill-in subject to a threshold pivoting stability criterion. The rook and complete pivoting options are more expensive than partial pivoting but are more stable and better at revealing rank, as long as the LU factor tolerance is not too large (say < 2.0).

LU singularity tolerance (real): Protection against ill-conditioned basis matrices

When the basis is refactorized, the diagonal elements of U are tested as follows: if |Ujj| <= r or |Ujj| < r * maxi |Uii|, the jth column of the basis is replaced by the corresponding slack variable. (This is most likely to occur after a restart, or at the start of a major iteration.) In some cases, the Jacobian matrix may converge to values that make the basis very ill-conditioned, causing the optimization to progress very slowly (if at all). Setting r = 1.0-5, say, may help cause a judicious change of basis.

Default: 1.0e-11

LU update tolerance (real): Trade-off between stability and sparsity in basis updating

This tolerance affects the stability and sparsity of the basis factorization B = LU during updates. The value r specified must satisfy r >= 1.0.

• The default value r = 10.0 usually strikes a good compromise between stability and sparsity.
• For large and relatively dense problems, r = 25.0 (say) may give a useful improvement in sparsity without impairing stability to a serious degree.
• For certain very regular structures (e.g., band matrices) it may be necessary to set r to a value smaller than the default in order to achieve stability.

Range: [1.0, ∞]

Default: 10.0

major damping parameter (real): Prevents large relative changes between subproblem solutions

The parameter may assist convergence on problems that have highly nonlinear constraints. It is intended to prevent large relative changes between subproblem solutions (xk, lambdak) and (xk+1, lambdak+1). For example, the default value 2.0 prevents the relative change in either xk or lambdak from exceeding 200 percent. It will not be active on well behaved problems. The parameter is used to interpolate between the solutions at the beginning and end of each major iteration. Thus xk+1 and lambdak+1 are changed to xk + sigma*(xk+1 - xk) and lambdak + sigma*(lambdak+1 - lambdak) for some step-length sigma < 1. In the case of nonlinear equations (where the number of constraints is the same as the number of variables) this gives a damped Newton method. This is a very crude control. If the sequence of major iterations does not appear to be converging, one should first re-run the problem with a higher Penalty parameter (say 10 or 100 times the default rho). (Skip this re-run in the case of nonlinear equations: there are no degrees of freedom and the value of rho is irrelevant.) If the subproblem solutions continue to change violently, try reducing r to 0.2 or 0.1 (say). For implementation reasons, the shortened step to sigma applies to the nonlinear variables x, but not to the linear variables y or the slack variables s. This may reduce the efficiency of the control.

Default: 2.0

major iterations (integer): Max number of major iterations

The maximum number of major iterations allowed. It is intended to guard against an excessive number of linearizations of the nonlinear constraints, since in some cases the sequence of major iterations may not converge. The progress of the major iterations can be best monitored using Print level 0 (the default).

Default: 50

minor damping parameter (real): Limit change in x during linesearch

This parameter limits the change in x during a linesearch. It applies to all nonlinear problems, once a feasible solution or feasible subproblem has been found. A linesearch of the form

minimizealpha F(x + alpha*p)

is performed over the range 0 < alpha <= beta, where beta is the step to the nearest upper or lower bound on x. Normally, the first step length tried is a1 = min(1, beta). In some cases, such as F(x) = aebx or F(x) = axb, even a moderate change in the components of x can lead to floating-point overflow. The parameter r is therefore used to define a limit

beta2 = r(1 + ||x||)/||p||

and the first evaluation of F(x) is at the potentially smaller steplength alpha1 = min(1, beta, beta2). Wherever possible, upper and lower bounds on x should be used to prevent evaluation of nonlinear functions at meaningless points. The Minor damping parameter provides an additional safeguard. The default value r = 2.0 should not affect progress on well behaved problems, but setting r = 0.1 or 0.01 may be helpful when rapidly varying functions are present. A good starting point may be required. An important application is to the class of nonlinear least squares problems. In cases where several local optima exist, specifying a small value for r may help locate an optimum near the starting point.

Default: 2.0

minor iterations (integer): Max number of minor iterations between linearizations of nonlinear constraints

The the maximum number of feasible minor iterations allowed between successive linearizations of the nonlinear constraints. A moderate value (e.g., 20 <= i <= 50) prevents excessive efforts being expended on early major iterations, but allows later subproblems to be solved to completion. The limit applies to both infeasible and feasible iterations. In some cases, a large number of iterations (say K) might be required to obtain a feasible subproblem. If good starting values are supplied for variables appearing nonlinearly in the constraints, it may be sensible to specify a limit > K, to allow the first major iteration to terminate at a feasible (and perhaps optimal) subproblem solution. If a good initial subproblem is arbitrarily interrupted by a small limit, the subsequent linearization may be less favorable than the first. In general it is unsafe to specify a value as small as i = 1 or 2. Even when an optimal solution has been reached, a few minor iterations may be needed for the corresponding subproblem to be recognized as optimal. The Iteration limit provides an independent limit on the total minor iterations (across all subproblems). If the constraints are linear, only the Iteration limit applies: the minor iterations value is ignored.

Default: 40

multiple price (integer): Multiple pricing

Pricing refers to a scan of the current non-basic variables to determine which, if any, are eligible to become (super)basic. The multiple pricing parameter k controls the number of entering variables to choose: the k best non-basic variables are selected for admission to the set of (super)basic variables. The default k = 1 is best for linear programs, since an optimal solution will have zero superbasic variables. Warning : If k > 1, GAMS/MINOS will use the reduced-gradient method rather than the simplex method, even on purely linear problems. The subsequent iterations do not correspond to the efficient minor iterations carried out by commercial linear programming systems using multiple pricing. (In the latter systems, the classical simplex method is applied to a tableau involving k dense columns of dimension m, and k is therefore limited for storage reasons typically to the range 2 <= k <= 7.) GAMS/MINOS varies all superbasic variables simultaneously. For linear problems its storage requirements are essentially independent of k. Larger values of k are therefore practical, but in general the iterations and time required when k > 1 are greater than when the simplex method is used (k = 1). On large nonlinear problems it may be important to set k > 1 if the starting point does not contain many superbasic variables. For example, if a problem has 3000 variables and 500 of them are nonlinear, the optimal solution may well have 200 variables superbasic. If the problem is solved in several runs, it may be beneficial to use k = 10 (say) for early runs, until it seems that the number of superbasics has leveled off. If Multiple price k is specified, it is also necessary to specify Superbasic limit s for some s > k.

Range: {1, ..., ∞}

Default: 1

optimality tolerance (real): Reduced gradient optimality check

This is used to judge the size of the reduced gradients dj = gj - piT aj, where gj is the gradient of the objective function corresponding to the jth variable, aj is the associated column of the constraint matrix (or Jacobian), and pi is the set of dual variables. By construction, the reduced gradients for basic variables are always zero. Optimality will be declared if the reduced gradients for nonbasic variables at their lower or upper bounds satisfy dj/||pi|| >= -r or dj/||pi|| <= r respectively, and if dj/||pi|| <= r for superbasic variables. The ||pi|| is a measure of the size of the dual variables. It is included to make the tests independent of a scale factor on the objective function. The quantity actually used is defined by

sigma = sum(i, abs(pi(i))), ||pi|| = max{sigma/sqrt(m),1}

so that only large scale factors are compensated for. As the objective scale decreases, the optimality test tends to become an absolute (instead of a relative) test.

Default: 1.0e-6

partial price (integer): Number of segments in partial pricing strategy

This parameter is recommended for large problems that have significantly more variables than constraints. It reduces the work required for each pricing operation (when a nonbasic variable is selected to become basic or superbasic). When i = 1, all columns of the constraints matrix (A I) are searched. Otherwise, Aj and I are partitioned to give i roughly equal segments Aj, Ij (j = 1 to i). If the previous search was successful on Aj-1, Ij-1, the next search begins on the segments Aj, Ij. (All subscripts here are modulo i.) If a reduced gradient is found that is larger than some dynamic tolerance, the variable with the largest such reduced gradient (of appropriate sign) is selected to become superbasic. (Several may be selected if multiple pricing has been specified.) If nothing is found, the search continues on the next segments Aj+1, Ij+1 and so on. Partial price t (or t/2 or t/3) may be appropriate for time-stage models having t time periods

Range: {1, ..., ∞}

Default: 10

penalty parameter (real): Used in modified augmented Lagrangian

This specifies the value of rho in the modified augmented Lagrangian. It is used only when Lagrangian = yes (the default setting). For early runs on a problem with unknown characteristics, the default value should be acceptable. If the problem is known to be highly nonlinear, specify a large value, such as 10 times the default. In general, a positive value of rho may be necessary to ensure convergence, even for convex programs. On the other hand, if rho is too large, the rate of convergence may be unnecessarily slow. If the functions are not highly nonlinear or a good starting point is known, it will often be safe to specify penalty parameter 0.0. When solving a sequence of related problems, initially, use a moderate value for rho (such as the default) and a reasonably low Iterations and/or major iterations limit. If successive major iterations appear to be terminating with radically different solutions, the penalty parameter should be increased. (See also the Major damping parameter.) If there appears to be little progress between major iterations, it may help to reduce the penalty parameter.

Default: automatic

print level (integer): Controls amount of information printed during optimization

This varies the amount of information that will be output during optimization. Print level 0 sets the default log and summary frequencies to 100. It is then easy to monitor the progress of the run. Print level 1 (or more) sets the default log and summary frequencies to 1, giving a line of output for every minor iteration. Print level 1 also produces basis statistics, i.e., information relating to LU factors of the basis matrix whenever the basis is re-factorized. For problems with nonlinear constraints, certain quantities are printed at the start of each major iteration. The option value is best thought of as a binary number of the form

Print level JFLXB

where each letter stands for a digit that is either 0 or 1. The quantities referred to are:

• B Basis statistics, as mentioned above
• X xk, the nonlinear variables involved in the objective function or the constraints.
• L lambdak, the Lagrange-multiplier estimates for the nonlinear constraints. (Suppressed if Lagrangian=No, since then lambdak = 0.)
• F f(xk), the values of the nonlinear constraint functions.
• J J(xk), the Jacobian matrix.

To obtain output of any item, set the corresponding digit to 1, otherwise to 0. For example, Print level 10 sets X = 1 and the other digits equal to zero; the nonlinear variables will be printed each major iteration. If J = 1, the Jacobian matrix will be output column-wise at the start of each major iteration. Column j will be preceded by the value of the corresponding variable xj and a key to indicate whether the variable is basic, superbasic or nonbasic. (Hence if J = 1, there is no reason to specify X = 1 unless the objective contains more nonlinear variables than the Jacobian.) A typical line of output is

3 1.250000D+01 BS 1 1.00000D+00 4 2.00000D+00

which would mean that x3 is basic at value 12.5, and the third column of the Jacobian has elements of 1.0 and 2.0 in rows 1 and 4. (Note: the GAMS/MINOS row numbers are usually different from the GAMS row numbers; see the Solution option.)

Default: 0

radius of convergence (real): controls final reduction of penalty parameter

This determines when the penalty parameter rho will be reduced, assuming rho was initially positive. Both the nonlinear constraint violation (see ROWERR below) and the relative change in consecutive Lagrange multiplier estimates must be less than r at the start of a major iteration before rho is reduced or set to zero. A few major iterations later, full completion will be requested if not already set, and the remaining sequence of major iterations should converge quadratically to an optimum.

Default: 0.01

row tolerance (real): Accuracy requirement for nonlinear rows

This specifies how accurately the nonlinear constraints should be satisfied at a solution. The default value is usually small enough, since model data is often specified to about this accuracy. Let ROWERR be the maximum component of the residual vector f(x) + A1y - b1, normalized by the size of the solution. Thus

ROWERR = ||f(x) + A1y - b1||inf/(1 + XNORM)

where XNORM is a measure of the size of the current solution (x, y). The solution is considered to be feasible if ROWERR <= r. If the problem functions involve data that is known to be of low accuracy, a larger Row tolerance may be appropriate.

Default: 1.0e-6

scale all variables (no value): Synonym to scale option 2

scale linear variables (no value): Synonym to scale option 1

scale no (no value): Synonym to scale option 0

scale nonlinear variables (no value): Synonym to scale option 2

scale option (integer): Scaling

Scale Yes sets the default. (Caution: If all variables are nonlinear, Scale Yes unexpectedly does nothing, because there are no linear variables to scale). Scale No suppresses scaling (equivalent to Scale Option 0). If nonlinear constraints are present, Scale option 1 or 0 should generally be tried at first. Scale option 2 gives scales that depend on the initial Jacobian, and should therefore be used only if (a) a good starting point is provided, and (b) the problem is not highly nonlinear.

Default: 1

value meaning
0 No scaling
If storage is at a premium, this option should be used.
1 Scale linear variables
Linear constraints and variables are scaled by an iterative procedure that attempts to make the matrix coefficients as close as possible to 1.0 (see ). This will sometimes improve the performance of the solution procedures. Scale linear variables is an equivalent option.
2 Scale linear + nonlinear variables
All constraints and variables are scaled by the iterative procedure. Also, a certain additional scaling is performed that may be helpful if the right-hand side b or the solution x is large. This takes into account columns of (A I) that are fixed or have positive lower bounds or negative upper bounds. Scale nonlinear variables or Scale all variables are equivalent options.

scale print (no value): Print scaling factors

This causes the row-scales r(i) and column-scales c(j) to be printed. The scaled matrix coefficients are âij = aijc(j)/r(i). The scaled bounds on the variables and slacks are j = lj/c(j) and ûj = uj/c(j), where c(j) = r(j - n) if j > n. If a Scale option has not already been specified, Scale print sets the default scaling.

scale print tolerance (real): Scale print flag and set tolerance

See Scale Tolerance. This option also turns on printing of the scale factors.

Range: [0, 1.0]

Default: 0.9

scale tolerance (real): Scale tolerance

All forms except Scale option may specify a tolerance r where 0 < r < 1 (for example: Scale Print Tolerance = 0.99). This affects how many passes might be needed through the constraint matrix. On each pass, the scaling procedure computes the ratio of the largest and smallest nonzero coefficients in each column:

rhoj = maxi |aij|/mini |aij| (aij ≠ 0)

If maxj rhoj is less than r times its previous value, another scaling pass is performed to adjust the row and column scales. Raising r from 0.9 to 0.99 (say) usually increases the number of scaling passes through A. At most 10 passes are made. If a Scale option has not already been specified, Scale tolerance sets the default scaling.

Range: [0, 1.0]

Default: 0.9

scale yes (no value): Synonym to scale option 1

solution (string): Prints MINOS solution

This controls whether or not GAMS/MINOS prints the final solution obtained. There is one line of output for each constraint and variable. The lines are in the same order as in the GAMS solution, but the constraints and variables labeled with internal GAMS/MINOS numbers rather than GAMS names. (The numbers at the left of each line are GAMS/MINOS column numbers, and those at the right of each line in the rows section are GAMS/MINOS slacks.) The GAMS/MINOS solution may be useful occasionally to interpret certain messages that occur during the optimization, and to determine the final status of certain variables (basic, superbasic or nonbasic).

Default: NO

value meaning
NO Turn off printing of solution
YES Turn on printing of solution

start assigned nonlinears (string): Starting strategy when there is no basis

This option affects the starting strategy when there is no basis (i.e., for the first solve or when the GAMS statement option bratio = 1 is used to reject an existing basis.) This option applies to all nonlinear variables that have been assigned nondefault initial values and are strictly between their bounds. Free variables at their default value of zero are excluded. Let K denote the number of such assigned nonlinear variables.

Default: SUPERBASIC

value meaning
SUPERBASIC Default
Specify superbasic for highly nonlinear models, as long as K is not too large (say K < 100) and the initial values are good.
BASIC Good for square systems
Specify basic for models that are essentially square (i.e., if there are about as many general constraints as variables).
NONBASIC Specify nonbasic if K is large.
ELIGIBLE FOR CRASH Specify Eligible for Crash for linear or nearly linear models. The nonlinear variables will be treated in the manner described under Crash option.

subspace tolerance (real): Determines when nonbasics becomes superbasic

This controls the extent to which optimization is confined to the current set of basic and superbasic variables (Phase 4 iterations), before one or more nonbasic variables are added to the superbasic set (Phase 3). The parameter r must be a real number in the range 0 < r <= 1. When a nonbasic variable xj is made superbasic, the resulting norm of the reduced-gradient vector (for all superbasics) is recorded. Let this be ||ZT g0||. (In fact, the norm will be |dj| , the size of the reduced gradient for the new superbasic variable xj. Subsequent Phase 4 iterations will continue at least until the norm of the reduced-gradient vector satisfies ||ZT g0|| <= r||ZT g0|| is the size of the largest reduced-gradient component among the superbasic variables.) A smaller value of r is likely to increase the total number of iterations, but may reduce the number of basic changes. A larger value such as r = 0.9 may sometimes lead to improved overall efficiency, if the number of superbasic variables has to increase substantially between the starting point and an optimal solution. Other convergence tests on the change in the function being minimized and the change in the variables may prolong Phase 4 iterations. This helps to make the overall performance insensitive to larger values of r.

Range: [0, 1.0]

Default: 0.5

summary frequency (integer): Controls iteration logging to summary (log file)

A brief form of the iteration log is output to the MINOS summary file (i.e. the GAMS log file). In general, one line is output every ith minor iteration. In an interactive environment, the output normally appears at the terminal and allows a run to be monitored. If something looks wrong, the run can be manually terminated. The summary frequency controls summary output in the same way as the log frequency controls output to the print file. A value such as Summary Frequency = 10 or 100 is often adequate to determine if the solve is making progress. If Print level = 0, the default value of Summary Frequency is 100. If Print level > 0, the default value of Summary Frequency is 1. If Print level = 0 and the constraints are nonlinear, the Summary Frequency is ignored. Instead, one line is printed at the beginning of each major iteration.

Range: {1, ..., ∞}

Default: 100

superbasics limit (integer): Maximum number of superbasics

This places a limit on the storage allocated for superbasic variables. Ideally, the parameter i should be set slightly larger than the number of degrees of freedom expected at an optimal solution. For linear problems, an optimum is normally a basic solution with no degrees of freedom. (The number of variables lying strictly between their bounds is not more than m, the number of general constraints.) The default value of i is therefore 1. For nonlinear problems, the number of degrees of freedom is often called the number of independent variables. Normally, i need not be greater than n1 + 1, where n1 is the number of nonlinear variables. For many problems, i may be considerably smaller than n1. This will save storage if n1 is very large. This parameter also sets the Hessian dimension, unless the latter is specified explicitly (and conversely). If neither parameter is specified, GAMS chooses values for both, using certain characteristics of the problem.

Range: {1, ..., ∞}

Default: 1

unbounded objective value (real): Determines when a problem is called unbounded

This parameter is intended to detect unboundedness in nonlinear problems. During a line search of the form

minimizealpha F(x + alpha*p)

If |F| exceeds the parameter r or if alpha exceeds the unbounded stepsize, iterations are terminated with the exit message PROBLEM IS UNBOUNDED (OR BADLY SCALED). If singularities are present, unboundedness in F(x) may be manifested by a floating-point overflow (during the evaluation of F(x + alpha*p), before the test against r can be made. Unboundedness is best avoided by placing finite upper and lower bounds on the variables. See also the Minor damping parameter.

Default: 1.0e20

unbounded step size (real): Determines when a problem is called unbounded

This parameter is intended to detect unboundedness in nonlinear problems. During a line search of the form

minimizealpha F(x + alpha*p)

If alpha exceeds the parameter r or if |F| exceeds the unbounded objective value, iterations are terminated with the exit message PROBLEM IS UNBOUNDED (OR BADLY SCALED). If singularities are present, unboundedness in F(x) may be manifested by a floating-point overflow (during the evaluation of F(x + alpha*p), before the test against r can be made. Unboundedness is best avoided by placing finite upper and lower bounds on the variables. See also the Minor damping parameter.

Default: 1.0e10

verify constraint gradients (no value): Synonym to verify level 2

verify gradients (no value): Synonym to verify level 3

verify level (integer): Controls verification of gradients

This option controls the finite-difference check performed by MINOS on the gradients (first derivatives) computed by GAMS for each nonlinear function. GAMS computes gradients analytically, and the values obtained should normally be taken as correct.

Default: 0

value meaning
0 Cheap test
Only a cheap test is performed, requiring three evaluations of the nonlinear objective and two evaluations of the nonlinear constraints. Verify No is an equivalent option.
1 Check objective
A more reliable check is made on each component of the objective gradient. Verify objective gradients is an equivalent option.
2 Check Jacobian
A check is made on each column of the Jacobian matrix associated with the nonlinear constraints. Verify constraint gradients is an equivalent option.
3 Check objective and Jacobian
A detailed check is made on both the objective and the Jacobian. Verify, Verify gradients, and Verify Yes are equivalent options.
-1 No check

verify no (no value): Synonym to verify level 0

verify objective gradients (no value): Synonym to verify level 1

verify yes (no value): Synonym to verify level 3

weight on linear objective (real): Composite objective weight

This option controls the so-called composite objective technique. If the first solution obtained is infeasible, and if the objective function contains linear terms, and the objective weight w is positive, this technique is used. While trying to reduce the sum of infeasibilities, the method also attempts to optimize the linear portion of the objective. At each infeasible iteration, the objective function is defined to be

minimizex sigma*w(cTx) + (sum of infeasibilities)

where sigma = 1 for minimization and sigma = -1 for maximization and c is the linear portion of the objective. If an optimal solution is reached while still infeasible, w is reduced by a factor of 10. This helps to allow for the possibility that the initial w is too large. It also provides dynamic allowance for the fact the sum of infeasibilities is tending towards zero. The effect of w is disabled after five such reductions, or if a feasible solution is obtained. This option is intended mainly for linear programs. It is unlikely to be helpful if the objective function is nonlinear.

Default: 0.0

# Exit Conditions

This section discusses the exit codes printed by MINOS at the end of the optimization run.

EXIT – Optimal solution found

This is the message we all hope to see! It is certainly preferable to every other message. Of course it is quite possible that there are model formulation errors, which will (hopefully) lead to unexpected objective values and solutions. The reported optimum may be a local, and other much better optima may exist.

EXIT – The problem is infeasible

When the constraints are linear, this message can probably be trusted. Feasibility is measured with respect to the upper and lower bounds on the variables (the bounds on the slack variables correspond to the GAMS constraints). The message tells us that among all the points satisfying the general constraints $$Ax+s=0$$, there is apparently no point that satisfies the bounds on $$x$$ and $$s$$. Violations as small as the FEASIBILITY TOLERANCE are ignored, but at least one component of $$x$$ or $s$ violates a bound by more than the tolerance.

Note: Although the objective function is the sum of the infeasibilities, this sum will usually not have been minimized when MINOS recognizes the situation and exits. There may exist other points that have significantly lower sum of infeasibilities.

When nonlinear constraints are present, infeasibility is much harder to recognize correctly. Even if a feasible solution exists, the current linearization of the constraints may not contain a feasible point. In an attempt to deal with this situation MINOS may relax the bounds on the slacks associated with nonlinear rows. This perturbation is allowed a fixed number of times. Normally a feasible point will be obtained relative to the perturbed constraints, and optimization can continue on the subproblem. However, if several consecutive subproblems require such perturbation, the problem is terminated and declared INFEASIBLE. Clearly this is an ad-hoc procedure. Wherever possible, nonlinear constraints should be defined in such a way that feasible points are known to exist when the constraints are linearized.

EXIT – The problem is unbounded (or badly scaled)

For linear problems, unboundedness is detected by the simplex method when a nonbasic variable can apparently be increased by an arbitrary amount without causing a basic variable to violate a bound. A simple way to diagnose such a model is to add an appropriate bound on the objective variable.

Very rarely, the scaling of the problem could be so poor that numerical error will give an erroneous indication of unboundedness. Consider using the SCALE option.

For nonlinear problems, MINOS monitors both the size of the current objective function and the size of the change in the variables at each step. If either of these is very large (as judged by the UNBOUNDED parameter), the problem is terminated and declared UNBOUNDED. To avoid large function values, it may be necessary to impose bounds on some of the variables in order to keep them away from singularities in the nonlinear functions.

EXIT – User Interrupt

This exit code is a result of interrupting the optimization process by hitting Ctrl-C. Inside the IDE this is accomplished by hitting the Interrupt button. The solver will finish its current iteration, and return the current solution. This solution can be still intermediate infeasible or intermediate non-optimal.

EXIT – Too many iterations

The iteration limit was hit. Either the ITERLIM, or in some cases the ITERATIONS LIMIT or MAJOR ITERATION LIMIT was too small to solve the problem. In most cases increasing the GAMS ITERLIM option will resolve the problem. In other cases you will need to create a MINOS option file and set a MAJOR ITERATION LIMIT. The listing file will give more information regarding what limit was hit.

The GAMS iteration limit is displayed in the listing file under the section SOLVE SUMMARY. If the ITERLIM was hit, the message will look like:

   ITERATION COUNT, LIMIT        10001      10000


EXIT – Resource Interrupt

The solver hit the RESLIM resource limit, which is a time limit. It returned the solution at that time, which may be still intermediate infeasible or intermediate non-optimal.

The GAMS resource limit is displayed in the listing file under the section SOLVE SUMMARY. If the GAMS RESLIM was hit, the message will look like:

   RESOURCE USAGE, LIMIT       1001.570      1000.000


EXIT – The objective has not changed for many iterations

This is an emergency measure for the rare occasions when the solution procedure appears to be cycling. Suppose that a zero step is taken for several consecutive iterations, with a basis change occurring each time. It is theoretically possible for the set of basic variables to become the same as they were one or more iterations earlier. The same sequence of iterations would then occur ad infinitum.

EXIT – The Superbasics Limit is too small

The problem appears to be more non-linear than anticipated. The current set of basic and superbasic variables have been optimized as much as possible and an increase in the number of superbasics is needed. You can use the option SUPERBASICS LIMIT to increase the limit. See also option HESSIAN DIMENSION.

EXIT – Constraint and objective function could not be calculated

The function or gradient could not be evaluated. For example, this can occur when MINOS attempts to take a log or a square root of a negative number, when evaluating the expression $$x^y$$ with $$x\le 0$$, or when evaluating exp(x) for large x and the result is too large to store. The listing file will contain details about where and why evaluation errors occur. To fix this problem, add bounds so that all functions can be properly evaluated. E.g. if you have an expression $$x^y$$, add a lower bound X.LO=0.001 to your model.

In many cases the algorithm can recover from function evaluation errors, for instance if they happen in the line search while evaluating trial points. The message above appears in cases where the algorithm can not recover, and requires a reliable function or gradient evaluation.

EXIT – Function evaluation error limit

The limit of allowed function evaluation errors DOMLIM has been exceeded.

Function evaluation errors occur when MINOS attempts to evaluate the objective and/or constraints at points where these functions or their derivatives are not defined or where overflows occur. Some examples are given above. The listing file contains details about these errors.

The quick and dirty way to solve this is to increase the GAMS DOMLIM setting, but in general it is better to add bounds. E.g. if you have an expression $$x^y$$, then add a bound X.LO=0.001 to your model.

EXIT – The current point can not be improved

The line search failed. This can happen if the model is very nonlinear or if the functions are nonsmooth (using a DNLP model type).

If the model is non-smooth, consider a smooth approximation. It may be useful to check the scaling of the model and think more carefully about choosing a good starting point. Sometimes it can help to restart the model with full scaling turned on:

option nlp=minos;
solve m minimizing z using nlp; // this one gives "current point cannot be improved"
file fopt /minos.opt/;          // write option file
putclose fopt "scale all variables"/;
m.optfile=1;
solve m minimizing z using nlp; // solve with "scale all variables"


EXIT – Numerical error in trying to satisfy the linear constraints (or the linearized constraints)
The basis is very ill-conditioned.

This is often a scaling problem. Try the full scaling option scale all variables or, better yet, rescale the model in GAMS via the .scale suffix or by choosing more appropriate units for variables and RHS values.

EXIT – Not enough storage to solve the model

The amount of workspace allocated for MINOS to solve the model is insufficient. Consider increasing the GAMS option workfactor to increase the workspace allocated for MINOS to use. The listing file and log file (screen) will contain information about the current workspace allocation. Increasing the workfactor by 50% is a reasonable strategy.

EXIT– Systems error

This is a catch all return for other serious problems. Check the listing file for more messages. If needed rerun the model with OPTION SYSOUT=ON;.