Options Vector

Nonlinear Optimization Examples

Options Vector

The options vector, represented by the "opt" argument, enables you to specify a variety of options, such as the amount of printed output or particular update or line-search techniques. Table 11.2 gives a summary of the available options.

Table 11.2: Summary of the Elements of the Options Vector

Index	Description
1	specifies minimization, maximization, or the number of least-squares functions
2	specifies the amount of printed output
3	NLPDD, NLPLM, NLPNRA, NLPNRR, NLPTR: specifies the scaling of the Hessian matrix (HESCAL)
4	NLPCG, NLPDD, NLPHQN, NLPQN: specifies the update technique (UPDATE)
5	NLPCG, NLPHQN, NLPNRA, NLPQN (with no nonlinear constraints): specifies the line-search technique (LIS)
6	NLPHQN: specifies version of hybrid algorithm (VERSION)
	NLPQN with nonlinear constraints: specifies version of $\mu$ update
7	NLPDD, NLPHQN, NLPQN: specifies initial Hessian matrix (INHESSIAN)
8	Finite Difference Derivatives: specifies type of differences and how to compute the difference interval
9	NLPNRA: specifies the number of rows returned by the sparse Hessian module
10	NLPNMS, NLPQN: specifies the total number of constraints returned by the "nlc" module
11	NLPNMS, NLPQN: specifies the number of equality constraints returned by the "nlc" module

The following list contains detailed explanations of the elements of the options vector:

opt[1] indicates whether the problem is minimization or maximization. The default, opt[1]=0, specifies a minimization problem, and opt[1]=1 specifies a maximization problem. For least-squares problems, opt[1]=m specifies the number of functions or observations, which is the number of values returned by the "fun" module. This information is necessary to allocate memory for the return vector of the "fun" module.

opt[2] specifies the amount of output printed by the subroutine. The higher the value of opt[2], the more printed output is produced. The following table indicates the specific items printed for each value.

Value of opt[2] Printed Output

0 No printed output is produced. This is the default.

1 The summaries for optimization start and termination are produced, as well as the iteration history.

2 The initial and final parameter estimates are also printed.

3 The values of the termination criteria and other control parameters are also printed.

4 The parameter vector, x, is also printed after each iteration.

5 The gradient vector, g, is also printed after each iteration.

opt[3] selects a scaling for the Hessian matrix, G. This option is relevant only for the NLPDD, NLPLM, NLPNRA, NLPNRR, and NLPTR subroutines. If opt $[3]\ne 0$ , the first iteration and each restart iteration set the diagonal scaling matrix D⁽⁰⁾ = diag(d_i⁽⁰⁾), where

$d_i^{(0)} = \sqrt{\max(| G^{(0)}_{i,i}|,\epsilon)}$

and G⁽⁰⁾_i,i are the diagonal elements of the Hessian matrix, and $\epsilon$ is the machine precision. The diagonal scaling matrix D⁽⁰⁾ = diag(d_i⁽⁰⁾) is updated as indicated in the following table.

Value of opt[3] Scaling Update

0 No scaling is done.

1 Mor $\acute{e}$ (1978) scaling update:
$d_i^{(k+1)} = \max(d_i^{(k)}, \sqrt{\max(| G^{(k)}_{i,i}|,\epsilon)})$

2 Dennis, Gay, and Welsch (1981) scaling update:
$d_i^{(k+1)} = \max(0.6 * d_i^{(k)}, \sqrt{\max(| G^{(k)}_{i,i}|,\epsilon)})$

3 d_i is reset in each iteration: $d_i^{(k+1)} = \sqrt{\max(| G^{(k)}_{i,i}|,\epsilon)}$

For the NLPDD, NLPNRA, NLPNRR, and NLPTR subroutines, the default is opt[3]=0; for the NLPLM subroutine, the default is opt[3]=1.

opt[4] defines the update technique for (dual) quasi-Newton and conjugate gradient techniques. This option applies to the NLPCG, NLPDD, NLPHQN, and NLPQN subroutines. For the NLPCG subroutine, the following update techniques are available.

Value of opt[4] Update Method for NLPCG

1 automatic restart method of Powell (1977) and Beale (1972). This is the default.

2 Fletcher-Reeves update (Fletcher 1987)

3 Polak-Ribiere update (Fletcher 1987)

4 Conjugate-descent update of Fletcher (1987)

For the unconstrained or linearly constrained NLPQN subroutine, the following update techniques are available.

Value of opt[4] Update Method for NLPQN

1 dual Broyden, Fletcher, Goldfarb, and Shanno (DBFGS) update of the Cholesky factor of the Hessian matrix. This is the default.

2 dual Davidon, Fletcher, and Powell (DDFP) update of the Cholesky factor of the Hessian matrix

3 original Broyden, Fletcher, Goldfarb, and Shanno (BFGS) update of the inverse Hessian matrix

4 original Davidon, Fletcher, and Powell (DFP) update of the inverse Hessian matrix

For the NLPQN subroutine used with the "nlc" module and for the NLPDD and NLPHQN subroutines, only the first two update techniques in the second table are available.

opt[5] defines the line-search technique for the unconstrained or linearly constrained NLPQN subroutine, as well as the NLPCG, NLPHQN, and NLPNRA subroutines. Refer to Fletcher (1987) for an introduction to line-search techniques. The following table describes the available techniques.

Value of opt[5] Line-Search Method

1 This method needs the same number of function and gradient calls for cubic interpolation and cubic extrapolation; it is similar to a method used by the Harwell subroutine library.

2 This method needs more function than gradient calls for quadratic and cubic interpolation and cubic extrapolation; it is implemented as shown in Fletcher (1987) and can be modified to exact line search with the par[6] argument (see the "Control Parameters Vector" section). This is the default for the NLPCG, NLPNRA, and NLPQN subroutines.

3 This method needs the same number of function and gradient calls for cubic interpolation and cubic extrapolation; it is implemented as shown in Fletcher (1987) and can be modified to exact line search with the par[6] argument.

4 This method needs the same number of function and gradient calls for stepwise extrapolation and cubic interpolation.

5 This method is a modified version of the opt[5]=4 method.

6 This method is the golden section line search of Polak (1971), which uses only function values for linear approximation.

7 This method is the bisection line search of Polak (1971), which uses only function values for linear approximation.

8 This method is the Armijo line-search technique of Polak (1971), which uses only function values for linear approximation.

For the NLPHQN least-squares subroutine, the default is a special line-search method that is based on an algorithm developed by Lindstr $\ddot{o}$ m and Wedin (1984). Although it needs more memory, this method sometimes works better with large least-squares problems.

opt[6] is used only for the NLPHQN subroutine and the NLPQN subroutine with nonlinear constraints.
In the NLPHQN subroutine, it defines the criterion for the decision of the hybrid algorithm to step in a Gauss-Newton or a quasi-Newton search direction. You can specify one of the three criteria that correspond to the methods of Fletcher and Xu (1987). The methods are HY1 (opt[6]=1), HY2 (opt[6]=2), and HY3 (opt[6]=2), and the default is HY2.
In the NLPQN subroutine with nonlinear constraints, it defines the version of the algorithm used to update the vector $\mu$ of the Lagrange multipliers. The default is opt[6]=2, which specifies the approach of Powell (1982a,b). You can specify the approach of Powell (1978b) with opt[6]=1.
opt[7] defines the type of start matrix, G⁽⁰⁾, used for the Hessian approximation. This option applies only to the NLPDD, NLPHQN, and NLPQN subroutines. If opt[7]=0, which is the default, the quasi-Newton algorithm starts with a multiple of the identity matrix where the scalar factor depends on par[10]; otherwise, it starts with the Hessian matrix computed at the starting point x⁽⁰⁾.
opt[8] defines the type of finite difference approximation used to compute first- or second-order derivatives and whether the finite difference intervals, h, should be computed using an algorithm of Gill, Murray, Saunders, and Wright (1983). The value of opt[8] is a two-digit integer, ij.

If opt[8] is missing or j=0, the fast but not very precise forward difference formulas are used; if $j \neq 0$ , the numerically more expensive central difference formulas are used.

If opt[8] is missing or $i \neq 1,2,{ or }3$ , the finite difference intervals h are based only on the information of par[8] or par[9], which specifies the number of accurate digits to use in evaluating the objective function and nonlinear constraints, respectively. If i = 1,2, or3, the intervals are computed with an algorithm by Gill, Murray, Saunders, and Wright (1983). For i=1, the interval is based on the behavior of the objective function; for i=2, the interval is based on the behavior of the nonlinear constraint functions; and for i=3, the interval is based on the behavior of both the objective function and the nonlinear constraint functions.
The algorithm of Gill, Murray, Saunders, and Wright (1983) that computes the finite difference intervals h_j can be very expensive in the number of function calls it uses. If this algorithm is required, it is performed twice, once before the optimization process starts and once after the optimization terminates. See the "Finite Difference Approximations of Derivatives" section for details.
opt[9] indicates that the Hessian module "hes" returns a sparse definition of the Hessian, in the form of an nn ×3 matrix instead of the default dense n ×n matrix. If opt[9] is zero or missing, the Hessian module must return a dense n ×n matrix. If you specify opt[9]=nn, the module must return a sparse nn ×3 table. See the "Objective Function and Derivatives" section for more details. This option applies only to the NLPNRA algorithm. If the dense specification contains a large proportion of analytical zero derivatives, the sparse specification may save memory and computer time.
opt[10] specifies the total number of nonlinear constraints returned by the "nlc" module. If you specify nc nonlinear constraints with the "nlc" argument module, you must specify opt[10]=nc to allocate memory for the return vector.
opt[11] specifies the number of nonlinear equality constraints returned by the "nlc" module. If the first nec constraints are equality constraints, you must specify opt[11]=nec. The default value is opt[11]=0.

Chapter Contents
Previous
Next
Top

*Value of opt[2]*	Printed Output
0	No printed output is produced. This is the default.
1	The summaries for optimization start and termination are produced, as well as the iteration history.
2	The initial and final parameter estimates are also printed.
3	The values of the termination criteria and other control parameters are also printed.
4	The parameter vector, x, is also printed after each iteration.
5	The gradient vector, g, is also printed after each iteration.

*Value of opt[3]*	Scaling Update
0	No scaling is done.
1	Mor $\acute{e}$ (1978) scaling update: $d_i^{(k+1)} = \max(d_i^{(k)}, \sqrt{\max(\| G^{(k)}_{i,i}\|,\epsilon)})$
2	Dennis, Gay, and Welsch (1981) scaling update: $d_i^{(k+1)} = \max(0.6 * d_i^{(k)}, \sqrt{\max(\| G^{(k)}_{i,i}\|,\epsilon)})$
3	d_i is reset in each iteration: $d_i^{(k+1)} = \sqrt{\max(\| G^{(k)}_{i,i}\|,\epsilon)}$

*Value of opt[4]*	Update Method for NLPCG
1	automatic restart method of Powell (1977) and Beale (1972). This is the default.
2	Fletcher-Reeves update (Fletcher 1987)
3	Polak-Ribiere update (Fletcher 1987)
4	Conjugate-descent update of Fletcher (1987)

*Value of opt[4]*	Update Method for NLPQN
1	dual Broyden, Fletcher, Goldfarb, and Shanno (DBFGS) update of the Cholesky factor of the Hessian matrix. This is the default.
2	dual Davidon, Fletcher, and Powell (DDFP) update of the Cholesky factor of the Hessian matrix
3	original Broyden, Fletcher, Goldfarb, and Shanno (BFGS) update of the inverse Hessian matrix
4	original Davidon, Fletcher, and Powell (DFP) update of the inverse Hessian matrix

*Value of opt[5]*	Line-Search Method
1	This method needs the same number of function and gradient calls for cubic interpolation and cubic extrapolation; it is similar to a method used by the Harwell subroutine library.
2	This method needs more function than gradient calls for quadratic and cubic interpolation and cubic extrapolation; it is implemented as shown in Fletcher (1987) and can be modified to exact line search with the par[6] argument (see the "Control Parameters Vector" section). This is the default for the NLPCG, NLPNRA, and NLPQN subroutines.
3	This method needs the same number of function and gradient calls for cubic interpolation and cubic extrapolation; it is implemented as shown in Fletcher (1987) and can be modified to exact line search with the par[6] argument.
4	This method needs the same number of function and gradient calls for stepwise extrapolation and cubic interpolation.
5	This method is a modified version of the opt[5]=4 method.
6	This method is the golden section line search of Polak (1971), which uses only function values for linear approximation.
7	This method is the bisection line search of Polak (1971), which uses only function values for linear approximation.
8	This method is the Armijo line-search technique of Polak (1971), which uses only function values for linear approximation.