The following table describes optimization options. Create options
using the optimoptions
function,
or optimset
for fminbnd
, fminsearch
, fzero
,
or lsqnonneg
.
See the individual function reference pages for information about available option values and defaults.
The default values for the options vary depending on which optimization function you call with
options
as an input argument. You can determine the default option
values for any of the optimization functions by entering
optimoptions('
or the
equivalent solvername
')optimoptions(@
. For
example,solvername
)
optimoptions('fmincon')
returns a list of the options and the default values for the
default 'interiorpoint'
fmincon
algorithm.
To find the default values for another fmincon
algorithm,
set the Algorithm
option. For example,
opts = optimoptions('fmincon','Algorithm','sqp')
optimoptions
“hides” some
options, meaning it does not display their values. Those options do
not appear in this table. Instead, they appear in Hidden Options.
Optimization Options
Option Name  Description  Used by Functions  Restrictions 

AbsoluteGapTolerance 
Nonnegative real.
 intlinprog  optimoptions only 
AbsoluteMaxObjectiveCount  Number of F(x) to minimize the worst case absolute values.  
Algorithm  Chooses the algorithm used by the solver.  fmincon , fminunc , fsolve , linprog , lsqcurvefit , lsqlin , lsqnonlin , quadprog  
BranchRule 
Rule for choosing the component for branching:
 intlinprog  optimoptions only 
CheckGradients  Compare usersupplied analytic derivatives (gradients or Jacobian, depending on the selected solver) to finite differencing derivatives. 
 optimoptions only. For optimset , use DerivativeCheck 
ConstraintTolerance  Tolerance on the constraint violation. 
 optimoptions only. For optimset , use TolCon 
CutGeneration 
Level of cut generation (see Cut Generation):
 intlinprog  optimoptions only 
CutMaxIterations  Number of passes through all cut generation methods before
entering the branchandbound phase, an integer from 1 through 50 .
Disable cut generation by setting the CutGeneration option
to 'none' .  intlinprog  optimoptions only 
Display  Level of display.
 All. See the individual function reference pages for the values that apply.  
EqualityGoalCount  Specify the number of objectives required for the objective  optimoptions only. For optimset , use GoalsExactAchieve  
FiniteDifferenceStepSize  Scalar or vector step size factor for finite differences. When
you set
sign′(x)
= sign(x) except sign′(0) = 1 .
Central finite differences are
FiniteDifferenceStepSize expands
to a vector. The default is sqrt(eps) for forward
finite differences, and eps^(1/3) for central finite
differences. 
 optimoptions only. For optimset , use FinDiffRelStep 
FiniteDifferenceType  Finite differences, used to estimate gradients, are either 
 optimoptions only. For optimset , use FinDiffType 
FunctionTolerance  Termination tolerance on the function value. 
 optimoptions only. For optimset , use TolFun 
HessianApproximation  Method of Hessian approximation: Ignored
when  optimoptions only. For optimset , use Hessian  
HessianFcn  Usersupplied Hessian, specified as a function handle (see Including Hessians).  fmincon , fminunc  optimoptions only. For optimset , use HessFcn 
HessianMultiplyFcn  Usersupplied Hessian multiply function, specified as a function handle. Ignored when  optimoptions only. For optimset , use HessMult  
Heuristics 
Algorithm for searching for feasible points (see Heuristics for Finding Feasible Solutions):
 intlinprog  optimoptions only 
HeuristicsMaxNodes  Strictly positive integer that bounds the number of nodes intlinprog can
explore in its branchandbound search for feasible points. See Heuristics for Finding Feasible Solutions.  intlinprog  optimoptions only 
HonorBounds  The default  fmincon  optimoptions only. For optimset , use AlwaysHonorConstraints 
IntegerPreprocess 
Types of integer preprocessing (see MixedInteger Program Preprocessing):
 intlinprog  optimoptions only 
IntegerTolerance  Real from 1e6 through 1e3 ,
where the maximum deviation from integer that a component of the solution x can
have and still be considered an integer. IntegerTolerance is
not a stopping criterion.  intlinprog  optimoptions only 
JacobianMultiplyFcn  Userdefined Jacobian multiply function, specified as a function handle. Ignored unless
 
LinearSolver  Type of internal linear solver in algorithm:

 
LPMaxIterations  Strictly positive integer, the maximum number of simplex algorithm iterations per node during the branchandbound process.  intlinprog  optimoptions only 
LPOptimalityTolerance  Nonnegative real where reduced costs must exceed LPOptimalityTolerance for
a variable to be taken into the basis.  intlinprog  optimoptions only 
MaxFunctionEvaluations  Maximum number of function evaluations allowed. 
 optimoptions only. For optimset , use MaxFunEvals 
MaxIterations  Maximum number of iterations allowed.  optimoptions only. For optimset , use MaxIter  
MaxFeasiblePoints  Strictly positive integer. intlinprog stops
if it finds MaxFeasiblePoints integer feasible
points.  intlinprog  optimoptions only 
MaxNodes  Strictly positive integer that is the maximum number of nodes the solver explores in its branchandbound process.  
MaxTime  Maximum amount of time in seconds allowed for the algorithm.  
NodeSelection 
Choose the node to explore next.
 intlinprog  optimoptions only 
ObjectiveCutOff  Real greater than Inf . The default is Inf .  intlinprog  optimoptions only 
ObjectiveImprovementThreshold  Nonnegative real. intlinprog changes the current feasible solution only
when it locates another with an objective function value that is at least
ObjectiveImprovementThreshold lower: (fold – fnew)/(1 + fold) >
ObjectiveImprovementThreshold.  intlinprog  optimoptions only 
ObjectiveLimit  If the objective function value goes below  fmincon , fminunc , quadprog  
OptimalityTolerance  Termination tolerance on the firstorder optimality. 
 optimoptions only. For optimset , use TolFun 
OutputFcn  Specify one or more userdefined functions that the optimization function calls at each iteration. Pass a function handle or a cell array of function handles. See Output Function or intlinprog Output Functions and Plot Functions. 
 
PlotFcn  Plots various measures of progress while the algorithm executes. Select from predefined
plots or write your own. Give the function name as listed, or as a function handle
such as
See Plot Functions or intlinprog Output Functions and Plot Functions. 
 optimoptions only. For optimset , use PlotFcns 
RelativeGapTolerance 
Real from
tolerance =  intlinprog  optimoptions only 
RootLPAlgorithm 
Algorithm for solving linear programs:
 intlinprog  optimoptions only 
RootLPMaxIterations  Nonnegative integer that is the maximum number of simplex algorithm iterations to solve the initial linear programming problem.  intlinprog  optimoptions only 
ScaleProblem  For  fmincon  
SpecifyConstraintGradient  Userdefined gradients for the nonlinear constraints.  optimoptions only. For optimset , use GradConstr  
SpecifyObjectiveGradient  Userdefined gradients or Jacobians for the objective functions. 
 optimoptions only. For optimset , use GradObj or Jacobian 
StepTolerance  Termination tolerance on x.  optimoptions only. For optimset , use TolX  
SubproblemAlgorithm  Determines how the iteration step is calculated.  fmincon  
TypicalX  Array that specifies typical magnitude of array of parameters 
 
UseParallel  When 

optimoptions
“hides” some
options, meaning it does not display their values. To learn how to
view these options, and why they are hidden, see View Options.
Function reference pages list these options in italics.
This table lists the hidden Optimization Toolbox™ options.
Options that optimoptions
Hides
Option Name  Description  Used by Functions  Restrictions 

Diagnostics  Display diagnostic information about the function to be minimized or solved.  All but  
DiffMaxChange  Maximum change in variables for finite differencing. 
 
DiffMinChange  Minimum change in variables for finite differencing. 
 
FunValCheck  Check whether objective function and constraints values
are valid. Note

 
HessPattern  Sparsity pattern of the Hessian for finite differencing.
The size of the matrix is nbyn, where n is the number of elements
in  
HessUpdate  QuasiNewton updating scheme.  
InitBarrierParam  Initial barrier value.  fmincon  
InitDamping  Initial LevenbergMarquardt parameter.  fsolve , lsqcurvefit , lsqnonlin  optimoptions only 
InitTrustRegionRadius  Initial radius of the trust region.  fmincon  
JacobPattern  Sparsity pattern of the Jacobian for finite differencing.
The size of the matrix is  
LPPreprocess 
Type of preprocessing for the solution to the relaxed linear program (see Linear Program Preprocessing):
 intlinprog  optimoptions only 
MaxPCGIter  Maximum number of iterations of preconditioned conjugate gradients method allowed. 
 
MaxProjCGIter  A tolerance for the number of projected conjugate gradient iterations; this is an inner iteration, not the number of iterations of the algorithm.  fmincon  
MaxSQPIter  Maximum number of iterations of sequential quadratic programming method allowed.  
MeritFunction  Use goal attainment/minimax merit function (multiobjective)
vs.  
PrecondBandWidth  Upper bandwidth of preconditioner for PCG. Setting to 
 
Preprocess  Level of LP preprocessing prior to simplex or dual simplex algorithm iterations.  optimoptions only  
RelLineSrchBnd  Relative bound on line search step length.  
RelLineSrchBndDuration  Number of iterations for which the bound specified in  
ScaleProblem  When using the  fsolve , lsqcurvefit , lsqnonlin  
TolConSQP  Constraint violation tolerance for the inner SQP iteration.  fgoalattain , fmincon , fminimax , fseminf  
TolPCG  Termination tolerance on the PCG iteration. 
 
TolProjCG  A relative tolerance for projected conjugate gradient algorithm; this is for an inner iteration, not the algorithm iteration.  fmincon  
TolProjCGAbs  Absolute tolerance for projected conjugate gradient algorithm; this is for an inner iteration, not the algorithm iteration.  fmincon 
For the reasons these options are hidden, see Options that optimoptions Hides (Global Optimization Toolbox).
Options that optimoptions
Hides
Option Name  Used by Functions 

Cache 

CacheSize 

CacheTol 

DisplayInterval 

FunValCheck 

HybridInterval 

InitialPenalty 

MaxMeshSize 

MeshRotate 

MigrationDirection 

MigrationFraction 

MigrationInterval 

PenaltyFactor 

PlotInterval 

StallTest 

TolBind  patternsearch 