Minimizes a function of N variables subject to linear constraints using a derivative-free, interpolation-based trust-region method.
NOTE: Routine LIN_CON_TRUST_REGION is available in double precision only.
Required Arguments
FCN — User-supplied subroutine to evaluate the function to be minimized. The usage is CALL FCN (N, X, F), where
N – Length of X. (Input)
X – Array of length N, the point at which the function is evaluated. (Input) X should not be changed by FCN.
F – The computed function value at the point X. (Output)
FCN must be declared EXTERNAL in the calling program.
NPT – The number of interpolation conditions, which is required to be in the interval [N+2,(N+1)*(N+2)/2]. Typical choices are NPT=N+6 and NPT=2*N+1. Larger values tend to be highly inefficient when the number of variables is substantial, due to the amount of work and extra difficulty of adjusting more points. (Input)
A – Array of size M by N containing the constraints. The constraints are of the form
, where denotes the i-th constraint. (Input)
B – Array of size M containing the right-hand sides of the constraints. (Input)
RHOBEG – The initial value of a trust region radius, 0 < RHOEND <= RHOBEG. Typically, RHOBEG should be about 1/10 of the greatest expected change to a variable. (Input)
RHOEND – The final value of a trust region radius, 0 < RHOEND <= RHOBEG. Variable RHOEND should indicate the accuracy that is required in the final values of the variables. (Input)
X – Array of size N containing the computed solution. (Output)
Optional Arguments
M – Number of constraints. (Input) Default: M = SIZE (A,1).
N – Number of variables. (Input) Default: N = SIZE (X,1).
IPRINT – Parameter indicating the desired output level. (Input)
IPRINT
Action
0
No output printed
1
Output printed only upon return from LIN_CON_TRUST_REGION.
2
The best feasible vector of variables so far and the corresponding value of the objective function are printed whenever RHO is re-duced, where RHO is the current lower bound on the trust region radius.
3
Output each new value of FVALUE with its variables.
Default: IPRINT = 0.
XGUESS – Array of size N that contains an initial guess to the minimum. If the initial guess is not feasible, then it is replaced by a feasible starting point determined as the solution of a constrained linear least-squares problem. (Input) Default: XGUESS = 0.0.
MAXFCN – On input, maximum allowed number of function evaluations. (Input/Output) On output, actual number of function evaluations needed. Default: MAXFCN = 200.
FVALUE – Function value at the computed solution. (Output)
FORTRAN 90 Interface
Generic: CALL LIN_CON_TRUST_REGION (FCN, NPT, A, B, RHOBEG, RHOEND, X [, …])
Specific: The specific interface name is D_LIN_CON_TRUST_REGION. This subroutine is available in double precision only.
Description
The routine LIN_CON_TRUST_REGION implements a trust-region method that forms quadratic models by interpolation to solve linearly constrained optimization problems of the form
where is a function of n variables, is the constraint matrix, and .
Usually, many degrees of freedom remain in each new model after satisfying the interpolation conditions. These remaining degrees of freedom are taken up by minimizing the Frobenius norm of the change to the second derivative matrix of the model, see Powell (2004).
One new function value is calculated at each iteration, usually at a point where the current model predicts a reduction in the least value so far reached by the objective function subject to the linear constraints. Alternatively, the algorithm may choose a new vector of variables to replace an interpolation point that is too far away for reliability, in which case this new point need not satisfy the linear constraints.
The maximum number of function evaluations is exceeded.
4
4
Computer rounding errors prevent further refinement of X.
4
5
Algorithm has stopped because the denominator of the updating formula is zero.
2. Since LIN_CON_TRUST_REGION uses only function-value information at each step to determine a new approximate minimum, it could be quite inefficient on smooth problems compared to other methods, such as those implemented in routine LCONF, which takes into account derivative information at each iteration. Hence, routine LIN_CON_TRUST_REGION should be used only as a last resort if derivatives are available.
Example
In this example, Rosenbrock’s post office problem,
subject to
is solved with an initial feasible guess (10.0, 10.0, 10.0), and the solution is printed.