Solver Parameters

The following parameters can be passed to the APPSPACK::Solver. If using an input file, these should be in the "Solver" sublist (see Using the APPSPACK Executables). These parameters are presented in the order in which they are processed.

"Debug" (int) - Prints everything up to the level specified, as follows.
1. Final solution.
2. Every new minimum
3. Initialization data
4. All evaluated trial points
5. Directions corresponding to a new minimum
6. All unevaluated trial points
7. Directions at every iteration
Defaults to 3.
[Used by APPSPACK::Print::Print().]
"Precision" (int) - Number of digits of precision in output. See APPSPACK::Print::precision. Defaults to 3.
[Used by APPSPACK::Print::Print().]
"Initial X" (double vector) - The starting point. Defaults to vector halfway between the upper and lower bounds; i.e.,
$x_{i} = \frac{u_i - l_i}{2} + l_i = \frac{u_i + l_i}{2}$

[Used by APPSPACK::Solver::initializeBestPointPtr(). Also accessed by APPSPACK::Cache::Manager::Manager().]
"Initial F" (double or double vector) - The function value(s) corresponding to the initial guess. Defaults to $+\infty$ .
[Used by APPSPACK::Solver::initializeBestPointPtr().Also accessed by APPSPACK::Cache::Manager::Manager().]
"Initial Step" (double) - The initial step length ( $\Delta$ ). Defaults to 1.0.
[Used by APPSPACK::Solver::initializeBestPointPtr().]
"Sufficient Decrease Factor" (double) - Value of $\alpha$ used in sufficient decrease calculation; see APPSPACK::Point::alpha. Defaults to 0.01.
[Used by APPSPACK::Solver::initializeBestPointPtr().]
"Step Tolerance" (double) - The step stopping tolerance ( $\Delta_{\rm tol}$ ). Defaults to 0.01.
[First used by APPSPACK::Directions::Directions(). Also accessed by APPSPACK::Cache::Manager::Manager() and APPSPACK::Solver::Solver().]
"Minimum Step" (double) - The minimum step size for a new best point ( $\Delta_{\min}$ ). Defaults to twice the "Step Tolerance".
[Used by APPSPACK::Directions::Directions().]
"Contraction Factor" (double) - The reduction in the step after an unsuccessful function evaluations. Defaults to 0.5.
[Used by APPSPACK::Directions::Directions().]
"Cache Comparison Tolerance" (double) - The tolerance to declare two points equal (with respect to the infinity-norm) for cache comparisons. Defaults to half the "Step Tolerance".
[Used by APPSPACK::Cache::Manager::Manager().]
"Cache Input File" (string) - Name of input file with cached function values. See APPSPACK::Cache::Manager for file format.
[Used by APPSPACK::Cache::Manager::parseInputFile().]
"Cache Output File" (string) - Name of output file for storing cached function values. Contents of the file will not be overwritten; instead, new values are appended to the end of the file. The same file may be used for input and output.
[Used by APPSPACK::Cache::Manager::openOutputFile().]
"Cache File Precision" (int) - Determines the number of decimal places that will be stored for cached function values.
[Used by APPSPACK::Cache::Manager::writeToOutputFile().]
"Solution File" (string) - Name of output file where final solution will be written.
[Used by APPSPACK::Solver::writeSolutionFile().]
"Solution File Precision" (int) - Determines the number of decimal places that will be stored for final solution. Defaults to 14.
[Used by APPSPACK::Solver::writeSolutionFile().]
"Synchronous" (bool) - Force APPSPACK to wait for all function evaluations at every iteration so that it behaves like synchronous pattern search. Defaults to false.
[Used by APPSPACK::Conveyor::Conveyor().]
"Max Queue Size" (int) - Number of points that remain in the pending queue after a successful iteration. Defaults to 0.
[Used by APPSPACK::Conveyor::Conveyor().]
"Minimum Exchange Return" (int) - Minimum number of values that should be returned by the APPSPACK::Conveyor::exchange function. Defaults to 1.
[Used by APPSPACK::Conveyor::Conveyor().]
"Maximum Exchange Return" (int) - Maximum number of values that should be returned by the APPSPACK::Conveyor::exchange function. Defaults to max{ "Minimum Exchange Return", 1000 }.
[Used by APPSPACK::Conveyor::Conveyor().]
"Function Tolerance" (APPSPACK::Value or double) - Stop when the function goes below this tolerance. Default is not to use this stopping criterion.
[Used by APPSPACK::Solver::Solver().]
"Maximum Evaluations" (int) - Stop when the number of function evaluations exceeds this tolerance. Default is not to use this stopping criterion.
[Used by APPSPACK::Solver::Solver().]
"Use Random Order" (bool) - If true, points are added to the queue in random order. When running in asynchronous mode this can reduce the tendency for initial search directions to be overemphasized. The default is false.
[Used by APPSPACK::Solver::Solver().]
"Bounds Tolerance" (double) - The tolerance to determine if a bound constraint is active. Defaults to half the "Step Tolerance".
[Used by APPSPACK::Solver::Solver().]
"Epsilon Max" (double) - Defines the maximum allowable radius about a current point to be used when determining whether or not a given constraint is active. Defaults to twice the "Step Tolerance".
[Used by APPSPACK::Directions::Directions().]
"Add Projected Normals" (bool) - If true, the generators for the normal cone are added to the pattern search. If equality constraints are present, the generators are first projected to lie in the null space of the equality constraint matrix. Defaults to true.
[Used by APPSPACK::Directions::Directions().]
"Add Projected Compass" (bool) - If true, the standard compass search directions
$\{\pm e_1, \pm e_2, \ldots, \pm e_n \}$
are added to the pattern search after being projected into the null space of the active constraints. Defaults to false.
[Used by APPSPACK::Directions::Directions().]

See also:: Step 2: Create an APPSPACK input file
Linear Constraint Parameters