Optimization.TrustRegion Method

Overload List

#SignatureDescription
1Int32 TrustRegion(TMKLTRFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, Object CustomData, TVec LB, TVec UB, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)
2Int32 TrustRegion(TMKLTRFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, Object CustomData, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)
3Int32 TrustRegion(TVectorFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, TVec LB, TVec UB, Double[] Consts, Object[] OConsts, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)Trust region algorithm to find bounded minimum of vector function.
4Int32 TrustRegion(TVectorFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, Double[] Consts, Object[] OConsts, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)Trust region algorithm for finding minimum of vector function.

Overload 1: Int32 TrustRegion(TMKLTRFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, Object CustomData, TVec LB, TVec UB, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)

#NameTypeDescription
1FunTMKLTRFunction
2JacProcTJacobianFunction
3XTVecsource TVec
4YTVecsource TVec
5CustomDataObject
6LBTVecsource TVec
7UBTVecsource TVec
8MaxIterInt32
9MaxTrialIterInt32
10EPSArrayDouble[]
11RsDoublescalar
12StopReasonTOptStopReason (ref)
13ControlTOptControl

Returns: Int32

Overload 2: Int32 TrustRegion(TMKLTRFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, Object CustomData, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)

#NameTypeDescription
1FunTMKLTRFunction
2JacProcTJacobianFunction
3XTVecsource TVec
4YTVecsource TVec
5CustomDataObject
6MaxIterInt32
7MaxTrialIterInt32
8EPSArrayDouble[]
9RsDoublescalar
10StopReasonTOptStopReason (ref)
11ControlTOptControl

Returns: Int32

Overload 3: Int32 TrustRegion(TVectorFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, TVec LB, TVec UB, Double[] Consts, Object[] OConsts, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)

Trust region algorithm to find bounded minimum of vector function.

#NameTypeDescription
1FunTVectorFunction
2JacProcTJacobianFunction
3XTVecsource TVec
4YTVecsource TVec
5LBTVecsource TVec
6UBTVecsource TVec
7ConstsDouble[]
8OConstsObject[]
9MaxIterInt32
10MaxTrialIterInt32
11EPSArrayDouble[]
12RsDoublescalar
13StopReasonTOptStopReason (ref)
14ControlTOptControl

Returns: Int32

Remarks:

Additional parameters LB and UB define x lower and/or upper bounds.

Overload 4: Int32 TrustRegion(TVectorFunction Fun, TJacobianFunction JacProc, TVec X, TVec Y, Double[] Consts, Object[] OConsts, Int32 MaxIter, Int32 MaxTrialIter, Double[] EPSArray, Double Rs, ref TOptStopReason StopReason, TOptControl Control)

Trust region algorithm for finding minimum of vector function.

#NameDescription
1FunThe objective function to be minimized.
2JacProcThe Jacobian matrix calculation procedure. If it is nil, then the numerical approximation will be used to evaluate Jacobi matrix elements.
3XStores the initial estimates for X. On completion returns estimates, evaluated at function minimum.
4YReturns objective function value, evaluated at minimum.
5ConstsAdditional Fun constant parameteres (can be/is usually nil).
6OConstsAdditional Fun constant parameteres (can be/is usually nil).
7MaxIterDefines the maximum number of main TR algorithm loops.
8MaxTrialIterDefines the maximum number of iterations of trial-step calculation.
9ControlOptional object, which allows the interruption of the search.
10EPSArrayArray of size 6. Contains stopping tests. * eps[0]: Grad < eps[0] * eps[1]: ||F(x)|| < eps[1] * eps[2]: ||A(x)ij|| < eps[2] * eps[3]: ||s|| < eps[3] * eps[4]: ||F(x)||- ||F(x) - A(x)s|| < eps[4] * eps[5]: trial step precision. If eps[5] = 0, then eps[5] = 1E-10, where * A(x) = the jacobi matrix * F(x) = ||y - f(x)||
11RsPositive input variable used in determining the initial step bound, the initial size of the trust region. In most cases the factor should lie within the interval (0.1, 100.0). The generally recommended value is 100, which is used by default, if this param is set to 0.
12StopReasonReturns the TR algorithm stop reason.

Returns: Int32 - the number of iterations needed for results.

Remarks:

What it computes. Solves the nonlinear least-squares problem
min_x 1/2 || F(x)||_2^2 for the residual vector F(x)=yf(x)F(x)=y-f(x) using Intel MKL's derivative trust-region solver (dtrnlsp; the bounded overload uses dtrnlspbc with the box LB <= x <= UB). At each step a trial step is accepted only if it stays inside the current trust region, whose radius is grown or shrunk from the agreement between the model and the true decrease. The Jacobian A(x)=d F/d x is supplied by JacProc or, when that is nil, approximated numerically.

Domain. X holds the n starting variables; Y
receives the m residual components (its length sets m). This is a double-precision routine; drive it with mvDouble vectors. EPSArray are six non-negative stopping thresholds; Rs ≥ 0 sets the initial trust radius (0 selects the default 100).

Defined behaviour. Returns the iteration count; X holds
the minimizer and Y the residual there. StopReason is Dew.Math.TOptStopReason.OptResConverged when || F|| falls below EPSArray[1], or one of Dew.Math.TOptStopReason.OptResSmallGrad,

Dew.Math.TOptStopReason.optResSmallJacobian, Dew.Math.TOptStopReason.OptResSmallStep,
Dew.Math.TOptStopReason.OptResMaxIter per the MKL stop code. Building MtxVec

Core (no MKL) raises an exception; this routine is not available under .NET.

The Trust Region (TR) algorithms are relatively new iterative algorithms for solving nonlinear optimization problems. They are widely used in power engineering, finance, applied mathematics, physics, computer science, economics, sociology, biology, medicine, mechanical engineering, chemistry, and other areas. TR methods have global convergence and local super convergence, which differenciates them from line search methods and Newton methods. TR methods have better convergence when compared with widely-used Newton-type methods.

The main idea behind TR algorithm is calculating a trial step and checking if the next values of x belong to the trust region. Calculation of the trial step is strongly associated with the approximation model.

For more on TR algorithm, check the following links:

  • http://iridia.ulb.ac.be/~fvandenb/optimization/optimizationIntro.html
  • http://en.wikipedia.org/wiki/Trust_region

Note:
This function is currently not supported under .NET. The objective function calls are threaded. The objective function should not be allocating any memory on the heap because calling threads are created outside of Delphi/BCB code.