Overload List
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)
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Fun | TMKLTRFunction | |
| 2 | JacProc | TJacobianFunction | |
| 3 | X | TVec | source TVec |
| 4 | Y | TVec | source TVec |
| 5 | CustomData | Object | |
| 6 | LB | TVec | source TVec |
| 7 | UB | TVec | source TVec |
| 8 | MaxIter | Int32 | |
| 9 | MaxTrialIter | Int32 | |
| 10 | EPSArray | Double[] | |
| 11 | Rs | Double | scalar |
| 12 | StopReason | TOptStopReason (ref) | |
| 13 | Control | TOptControl |
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)
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Fun | TMKLTRFunction | |
| 2 | JacProc | TJacobianFunction | |
| 3 | X | TVec | source TVec |
| 4 | Y | TVec | source TVec |
| 5 | CustomData | Object | |
| 6 | MaxIter | Int32 | |
| 7 | MaxTrialIter | Int32 | |
| 8 | EPSArray | Double[] | |
| 9 | Rs | Double | scalar |
| 10 | StopReason | TOptStopReason (ref) | |
| 11 | Control | TOptControl |
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.
| # | Name | Type | Description |
|---|---|---|---|
| 1 | Fun | TVectorFunction | |
| 2 | JacProc | TJacobianFunction | |
| 3 | X | TVec | source TVec |
| 4 | Y | TVec | source TVec |
| 5 | LB | TVec | source TVec |
| 6 | UB | TVec | source TVec |
| 7 | Consts | Double[] | |
| 8 | OConsts | Object[] | |
| 9 | MaxIter | Int32 | |
| 10 | MaxTrialIter | Int32 | |
| 11 | EPSArray | Double[] | |
| 12 | Rs | Double | scalar |
| 13 | StopReason | TOptStopReason (ref) | |
| 14 | Control | TOptControl |
Returns: Int32
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.
| # | Name | Description |
|---|---|---|
| 1 | Fun | The objective function to be minimized. |
| 2 | JacProc | The Jacobian matrix calculation procedure. If it is nil, then the numerical approximation will be used to evaluate Jacobi matrix elements. |
| 3 | X | Stores the initial estimates for X. On completion returns estimates, evaluated at function minimum. |
| 4 | Y | Returns objective function value, evaluated at minimum. |
| 5 | Consts | Additional Fun constant parameteres (can be/is usually nil). |
| 6 | OConsts | Additional Fun constant parameteres (can be/is usually nil). |
| 7 | MaxIter | Defines the maximum number of main TR algorithm loops. |
| 8 | MaxTrialIter | Defines the maximum number of iterations of trial-step calculation. |
| 9 | Control | Optional object, which allows the interruption of the search. |
| 10 | EPSArray | Array 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)|| |
| 11 | Rs | Positive 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. |
| 12 | StopReason | Returns the TR algorithm stop reason. |
Returns: Int32 - the number of iterations needed for results.
What it computes. Solves the nonlinear least-squares problem
min_x 1/2 || F(x)||_2^2 for the residual vector 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.