NOX::LineSearch::MoreThuente Class ReferenceMore'-Thuente Line Search. Original code by Dianne O'Leary, modfified by Tammy Kolda and Roger Pawlowski for the NOX project. This version has been slightly optimized and also supports Homer Walker's work on adaptive forcing terms and Ared/Pred conditions. It also allows for arbitrary merit functions and norms to be supplied by the user.
Inheritance diagram for NOX::LineSearch::MoreThuente:[legend]Collaboration diagram for NOX::LineSearch::MoreThuente:[legend]List of all members.
More'-Thuente Line Search. Original code by Dianne O'Leary, modfified by Tammy Kolda and Roger Pawlowski for the NOX project. This version has been slightly optimized and also supports Homer Walker's work on adaptive forcing terms and Ared/Pred conditions. It also allows for arbitrary merit functions and norms to be supplied by the user.
This code is based on the More'-Thuente line search from the 1983 MINPACK Project. More specifically, this code is based on Dianne O'Leary's 1991 Matlab-implementation of the More'-Thuente line search. The original comments are preserved in the descriptions of the individual subroutines. What follows is an updated summary.
The merit function we are minimizing is given by
(alternatively the user can define this)
The purpose of the More'-Thuente line search is to find a step which satisfies a sufficient decrease condition and a curvature condition. At each stage the subroutine updates an interval of uncertainty with endpoints stx and sty. The interval of uncertainty is initially chosen so that it contains a minimizer of the modified function
If a step is obtained for which the modified function has a nonpositive function value and nonnegative derivative, then the interval of uncertainty is chosen so that it contains a minimizer of .
The algorithm is designed to find a step which satisfies one of two sufficient decrease conditions:
(1) Armijo-Goldstein Condition
(2) Ared/Pred Condtition
and the curvature condition
If ftol is less than gtol and if, for example, the function is bounded below, then there is always a step which satisfies both conditions. If no step can be found which satisfies both conditions, then the algorithm usually stops when rounding errors prevent further progress. In this case stp only satisfies the sufficient decrease condition.
Modifications from NOX::LineSearch::MoreThuente
1. Added the option to use Ared/Pred conditions as describe in Homer Walker's papers. 2. Added support to use an adjustable forcing term as describe in Homer Walker's papers. 3. Added the option to use directional derivatives in computing the slope instead of explicitly computing the Jacobian. This eliminates the need to recompute the Jacobian at each inner iteration of the More'-Thuente algorithm. 4. Added the ability to use the NOX::Parameter::UserNorm and NOX::Parameter::MeritFunction objects to supply user defined norms and merit functions to the line search.
This line search can be called via NOX::LineSearch::Manager.
This line search is used if "More'-Thuente2" is the "Method" in the "Line Search" sublist. (See NOX::LineSearch::Manager for details.)
The following parameters can be specified for this line search in the "More'-Thuente2" sublist of the "Line Search" sublist:
- "Sufficient Decrease Condition" - Choice to use for the sufficient decrease condition. Options are "Ared/Pred" or "Armijo-Goldstein" (defaults to "Armijo-Goldstein").
1. "Armijo-Goldstein" conditions:
2. "Ared/Pred" conditions: where is the linear solve tolerance in the inexact Newton method.
- "Sufficient Decrease" - The ftol in the sufficient decrease condition (defaults to 1.0e-4)
- "Curvature Condition" - The gtol in the curvature condition (defaults to 0.9999)
- "Optimize Slope Calculation" - Boolean value. If set to true the value of is estimated using a directional derivative in a call to NOX::LineSearch::Common::computeSlopeWithOutJac. If false the slope computation is computed with the NOX::LineSearch::Common::computeSlope method. Setting this to true eliminates having to compute the Jacobian at each inner iteration of the More'-Thuente line search (defaults to false).
- "User Defined Norm" - The user can redefine the norm that is used in the Ared/Pred sufficient decrease condition by supplying a NOX::Parameter::UserNorm derived object in the parameter list with this key.
- "Merit Function" - The user can supply their own merit function to the line search by supplying a NOX::Parameter::MeritFunction derived object with this key.
- "Interval Width" - The maximum width of the interval containing the minimum of the modified function (defaults to 1.0e-15)
- "Maximum Step" - maximum allowable step length (defaults to 1.0e6)
- "Minimum Step" - minimum allowable step length (defaults to 1.0e-12)
- "Max Iters" - maximum number of right-hand-side and corresponding Jacobian evaluations (defaults to 20)
- "Default Step" - starting step length (defaults to 1.0)
- "Recovery Step Type" - Determines the step size to take when the line search fails. Choices are:
"Constant" [default] - Uses a constant value set in "Recovery Step".
"Last Computed Step" - Uses the last value computed by the line search algorithm.
- "Recovery Step" - The value of the step to take when the line search fails. Only used if the "Recovery Step Type" is set to "Constant". Defaults to value for "Default Step".
A sublist for output parameters will be created called "Output" in the parameter list used to instantiate or reset the class. Valid output parameters are:
- "Total Number of Line Search Calls" - Total number of calls to the compute() method of this line search.
- "Total Number of Non-trivial Line Searches" - The total number of steps that could not directly take a full step and meet the required "Convergence Criteria" (i.e. The line search had to reduce the step length using inner iteration calculations over iterate ).
- "Total Number of Failed Line Searches" - total number of line searches that failed and used a recovery step.
- "Total Number of Line Search Inner Iterations" - total number of inner iterations performed by this object.
Member Function Documentation
Perform a line search.
- denotes the new solution to be calculated (corresponding to
- denotes the step to be calculated (
- denotes the search direction (
- denotes the previous solution (i.e., the result of s.getPreviousSolutionGroup().getX())
In the end, we should have computed and updated
grp so that
The documentation for this class was generated from the following files:
Generated on Thu Sep 18 12:38:39 2008 for NOX by 188.8.131.52