Main Content

新旧のオプション名

R2016a では、多くのオプション名が変更されました。optimset には、レガシ オプション名のみを使用できます。optimoptions には、レガシと現在の両方の名前を使用できます。ただし、optimoptions でレガシ名と値のペアを使ってオプションを設定すると、現在の等価な値が表示されます。たとえば、レガシ オプション TolX は現在のオプション StepTolerance と等価です。

options = optimoptions('fsolve','TolX',1e-4)
options = 

  fsolve options:

   Options used by current Algorithm ('trust-region-dogleg'):
   (Other available algorithms: 'levenberg-marquardt', 'trust-region-reflective')

   Set properties:
               StepTolerance: 1.0000e-04

   Default properties:
                   Algorithm: 'trust-region-dogleg'
              CheckGradients: 0
                     Display: 'final'
    FiniteDifferenceStepSize: 'sqrt(eps)'
        FiniteDifferenceType: 'forward'
           FunctionTolerance: 1.0000e-06
      MaxFunctionEvaluations: '100*numberOfVariables'
               MaxIterations: 400
         OptimalityTolerance: 1.0000e-06
                   OutputFcn: []
                     PlotFcn: []
    SpecifyObjectiveGradient: 0
                    TypicalX: 'ones(numberOfVariables,1)'
                 UseParallel: 0

   Show options not used by current Algorithm ('trust-region-dogleg')

次の表は、同じ情報を示しています。1 つ目の表にはレガシ オプション名のアルファベット順に、2 つ目の表には現在のオプション名のアルファベット順にオプションが列挙されています。各表には、変更された名前または値が異なる名前のみが含まれ、値はレガシと現在で異なる場合のみ表示されます。Global Optimization Toolbox のソルバーの変更については、Options Changes in R2016a (Global Optimization Toolbox)を参照してください。

オプション名 (レガシの順序)

レガシ名現在の名前レガシ値現在の値
AlwaysHonorConstraintsHonorBounds'bounds', 'none'true, false
BranchingRuleBranchRule  
CutGenMaxIterCutMaxIterations  
DerivativeCheckCheckGradients'on', 'off'true, false
FinDiffRelStepFiniteDifferenceStepSize  
FinDiffTypeFiniteDifferenceType  
GoalsExactAchieveEqualityGoalCount  
GradConstrSpecifyConstraintGradient'on', 'off'true, false
GradObjSpecifyObjectiveGradient'on', 'off'true, false
HessianHessianApproximation'user-supplied', 'bfgs', 'lbfgs', 'fin-diff-grads', 'on', 'off'

'bfgs', 'lbfgs', 'finite-difference'

HessianFcn または HessianMultiplyFcn が空でない場合は無視される

HessFcnHessianFcn  
HessMultHessianMultiplyFcn  
HessUpdate (fminunc 用に R2022a で変更)HessianApproximation"bfgs", "lbfgs", {"lbfgs",Positive Integer}, "dfp", "steepdesc""bfgs", "lbfgs", {"lbfgs",Positive Integer}
IPPreprocessIntegerPreprocess  
JacobianSpecifyObjectiveGradient  
JacobMultJacobianMultiplyFcn  
LPMaxIterLPMaxIterations  
MaxFunEvalsMaxFunctionEvaluations  
MaxIterMaxIterations  
MaxNumFeasPointsMaxFeasiblePoints  
MinAbsMaxAbsoluteMaxObjectiveCount  
PlotFcnsPlotFcn  
RelObjThresholdObjectiveImprovementThreshold  
RootLPMaxIterRootLPMaxIterations  
ScaleProblemScaleProblem'obj-and-constr', 'none'true, false
SubproblemAlgorithmSubproblemAlgorithm'cg', 'ldl-factorization''cg', 'factorization'
TolConConstraintTolerance  
TolFun (使用方法 1)OptimalityTolerance  
TolFun (使用方法 2)FunctionTolerance  
TolFunLPLPOptimalityTolerance  
TolGapAbsAbsoluteGapTolerance  
TolGapRelRelativeGapTolerance  
TolIntegerIntegerTolerance  
TolXStepTolerance  

オプション名 (現在の順序)

現在の名前レガシ名現在の値レガシ値
AbsoluteGapToleranceTolGapAbs  
AbsoluteMaxObjectiveCountMinAbsMax  
BranchRuleBranchingRule  
CheckGradientsDerivativeChecktrue, false'on', 'off'
ConstraintToleranceTolCon  
CutMaxIterationsCutGenMaxIter  
EqualityGoalCountGoalsExactAchieve  
FiniteDifferenceStepSizeFinDiffRelStep  
FiniteDifferenceTypeFinDiffType  
FunctionToleranceTolFun (使用方法 2)  
HessianApproximation (fmincon 用)Hessian

'bfgs', 'lbfgs', 'finite-difference'

HessianFcn または HessianMultiplyFcn が空でない場合は無視される

'user-supplied', 'bfgs', 'lbfgs', 'fin-diff-grads', 'on', 'off'
HessianApproximation (fminunc 用)(fminunc 用に R2022a で変更)HessUpdate

"bfgs", "lbfgs", {"lbfgs",Positive Integer}

"bfgs", "lbfgs", {"lbfgs",Positive Integer}, "dfp", "steepdesc"
HessianFcnHessFcn  
HessianMultiplyFcnHessMult  
HonorBoundsAlwaysHonorConstraintstrue, false'bounds', 'none'
IntegerPreprocessIPPreprocess  
IntegerToleranceTolInteger  
JacobianMultiplyFcnJacobMult  
LPMaxIterationsLPMaxIter  
LPOptimalityToleranceTolFunLP  
MaxFeasiblePointsMaxNumFeasPoints  
MaxFunctionEvaluationsMaxFunEvals  
MaxIterationsMaxIter  
ObjectiveImprovementThresholdRelObjThreshold  
OptimalityToleranceTolFun (使用方法 1)  
PlotFcnPlotFcns  
RelativeGapToleranceTolGapRel  
RootLPMaxIterationsRootLPMaxIter  
ScaleProblemScaleProblemtrue, false'obj-and-constr', 'none'
SpecifyConstraintGradientGradConstrtrue, false'on', 'off'
SpecifyObjectiveGradientGradObj または Jacobiantrue, false'on', 'off'
StepToleranceTolX  
SubproblemAlgorithmSubproblemAlgorithm'cg', 'factorization''cg', 'ldl-factorization'

関連するトピック