GlobalSearch class -

Display

Detail level of iterative display. Possible values:

• 'final' — Report summary results after run finishes.

• 'iter' — Report results after the initial fmincon run, after Stage 1, after every 200 start points, and after every run of fmincon, in addition to the final summary.

• 'off' — No display.

Default: 'final'

DistanceThresholdFactor

A multiplier for determining whether a trial point is in an existing basin of attraction. For details, see Examine Stage 2 Trial Point to See if fmincon Runs.

Default: 0.75

MaxTime

Time in seconds for a run. GlobalSearch halts when it sees MaxTime seconds have passed since the beginning of the run.

Default: Inf

MaxWaitCycle

A positive integer tolerance appearing in several points in the algorithm:

• If the observed penalty function of MaxWaitCycle consecutive trial points is at least the penalty threshold, then raise the penalty threshold (see PenaltyThresholdFactor).

• If MaxWaitCycle consecutive trial points are in a basin, then update that basin's radius (see BasinRadiusFactor).

Default: 20

NumStageOnePoints

Number of start points in Stage 1. For details, see Obtain Stage 1 Start Point, Run.

Default: 200

NumTrialPoints

Number of potential start points to examine in addition to x0 from the problem structure. GlobalSearch runs only those potential start points that pass several tests. For more information, see GlobalSearch Algorithm.

Default: 1000

OutputFcns

A function handle or cell array of function handles to output functions. Output functions run after each local solver call. They also run when the global solver starts and ends. Write your output functions using the syntax described in OutputFcns. See Example: GlobalSearch Output Function.

Default: []

PenaltyThresholdFactor

Determines increase in the penalty threshold. For details, see React to Large Counter Values.

Default: 0.2

PlotFcns

A function handle or cell array of function handles to plot functions. Plot functions run after each local solver call. They also run when the global solver starts and ends. Write your plot functions using the syntax described in OutputFcns. There are two built-in plot functions:

• @gsplotbestf plots the best objective function value.

• @gsplotfunccount plots the number of function evaluations.

See Example: MultiStart Plot Function.

Default: []

StartPointsToRun

Directs the solver to exclude certain start points from being run:

• all — Accept all start points.

• bounds — Reject start points that do not satisfy bounds.

• bounds-ineqs — Reject start points that do not satisfy bounds or inequality constraints.

GlobalSearch checks the StartPointsToRun property only during Stage 2 of the GlobalSearch algorithm (the main loop). For more information, see GlobalSearch Algorithm.

Default: 'all'

TolFun

Describes how close two objective function values must be for solvers to consider them identical for creating the vector of local solutions. Solvers consider two solutions identical if they are within TolX distance of each other and have objective function values within TolFun of each other. If both conditions are not met, solvers report the solutions as distinct. Set TolFun to 0 to obtain the results of every local solver run. Set TolFun to a larger value to have fewer results.

Default: 1e-6

TolX

Describes how close two points must be for solvers to consider them identical for creating the vector of local solutions. Solvers compute the distance between a pair of points with norm, the Euclidean distance. Solvers consider two solutions identical if they are within TolX distance of each other and have objective function values within TolFun of each other. If both conditions are not met, solvers report the solutions as distinct. Set TolX to 0 to obtain the results of every local solver run. Set TolX to a larger value to have fewer results.

Default: 1e-6