このページは機械翻訳を使用して翻訳されました。最新版の英語を参照するには、ここをクリックします。

saoptimset

（非推奨）シミュレーテッド アニーリング オプション構造を作成する

saoptimset は推奨されません。代わりに optimoptions を使用してください。詳細については、バージョン履歴を参照してください。

構文

saoptimset
options = saoptimset
options = saoptimset('param1',value1,'param2',value2,...)
options = saoptimset(oldopts,'param1',value1,...)
options = saoptimset(oldopts,newopts)
options = saoptimset('simulannealbnd')


説明

入力引数または出力引数のない saoptimset は、有効な値を含むパラメーターの完全なリストを表示します。

options = saoptimset (入力引数なし) は、シミュレーテッド アニーリング法のオプション、つまり パラメーター を含む options という構造体を作成し、すべてのパラメーターを [] に設定します。

options = saoptimset('param1',value1,'param2',value2,...) は構造体 options を作成し、'param1' の値を value1 に、'param2' の値を value2 に設定するなどします。指定されていないパラメーターはすべて [] に設定されます。パラメーター名を一意に定義するのに十分な先頭の文字のみを入力するだけで十分です。パラメーター名の大文字と小文字は区別されません。文字値の場合、大文字と小文字の区別が正しく、完全な値が必要であることに注意してください。

options = saoptimset(oldopts,'param1',value1,...) は、指定されたパラメーターを指定された値に変更して、oldopts のコピーを作成します。

options = saoptimset(oldopts,newopts) は、既存のオプション構造 oldopts と新しいオプション構造 newopts を組み合わせます。空でない値を持つ newopts 内のパラメーターは、oldopts 内の対応する古いパラメーターを上書きします。

options = saoptimset('simulannealbnd') は、'simulannealbnd' に関連するすべてのパラメーター名とデフォルト値を含むオプション構造を作成します。以下に例を示します。

saoptimset('simulannealbnd')

ans = 
          AnnealingFcn: @annealingfast
        TemperatureFcn: @temperatureexp
         AcceptanceFcn: @acceptancesa
                TolFun: 1.0000e-006
        StallIterLimit: '500*numberofvariables'
           MaxFunctionEvaluations: '3000*numberofvariables'
             TimeLimit: Inf
         MaxIterations: Inf
        ObjectiveLimit: -Inf
               Display: 'final'
       DisplayInterval: 10
             HybridFcn: []
        HybridInterval: 'end'
              PlotFcns: []
          PlotInterval: 1
            OutputFcns: []
    InitialTemperature: 100
      ReannealInterval: 100
              DataType: 'double'

オプション

次の表は、saoptimset で設定できるオプションを示しています。これらのオプションとその値の詳細な説明については、シミュレーテッド アニーリング オプション を参照してください。{} 内の値はデフォルト値を示します。コマンド ラインで saoptimset と入力してオプションパラメーターを表示することもできます。

optimoptions は 斜体 でリストされているオプションを非表示にしますが、saoptimset は非表示にしません。optimoptions で非表示になっているオプションを参照してください。

オプション	説明	値
AcceptanceFcn	新しいポイントが受け入れられるかどうかを判断するためにアルゴリズムが使用する関数。'acceptancesa' または関数ハンドルとして指定します。	関数ハンドル | {'acceptancesa'}
AnnealingFcn	アルゴリズムが新しいポイントを生成するために使用する関数。組み込みアニーリング関数または関数ハンドルの名前として指定します。	関数ハンドル | 関数名 | 'annealingboltz' | {'annealingfast'}
DataType	決定変数の種類	'custom' | {'double'}
Display	表示レベル	'off' | 'iter' | 'diagnose' | {'final'}
DisplayInterval	反復表示の間隔	正の整数 | {10}
FunctionTolerance	関数値の終了許容誤差 オプション構造の場合は、TolFun を使用します。	非負のスカラー | {1e-6}
HybridFcn	ソルバーの反復中または反復の最後に、HybridFcn (別の最適化関数) を自動的に実行します。名前または関数ハンドルとして指定します。 ハイブリッド関数を使用する場合を参照してください。	'fminsearch' | 'patternsearch' | 'fminunc' | 'fmincon' | {[]} または 1行2列のセル配列 | {@solver, hybridoptions}（solver = fminsearch、patternsearch、fminunc、またはfmincon {[]}）
HybridInterval	HybridFcn が呼び出される間隔（'end' または 'never' でない場合）	正の整数 | 'never' | {'end'}
InitialTemperature	温度の初期値	非負スカラー | 正ベクトル | {100}
MaxFunctionEvaluations	許可される目的関数評価の最大数 オプション構造の場合は、MaxFunEvals を使用します。	非負整数 | {3000*numberOfVariables}
MaxIterations	許容される反復回数の最大数 オプション構造の場合は、MaxIter を使用します。	非負整数 | {Inf}
MaxStallIterations	現在の時点での適応度関数値の平均変化がoptions.FunctionTolerance未満となる反復回数 オプション構造の場合は、StallIterLimit を使用します。	非負整数 | {500*numberOfVariables}
MaxTime	アルゴリズムはMaxTime秒間実行された後に停止します オプション構造の場合は、TimeLimit を使用します。	非負のスカラー | {Inf}
ObjectiveLimit	必要な最小目的関数値	スカラー | {-Inf}
OutputFcn	関数は反復データを取得し、実行時にオプションを変更できます。 オプション構造の場合は、OutputFcns を使用します。	関数ハンドル | 関数ハンドルのセル配列 | {[]}
PlotFcn	反復中に呼び出されるプロット関数 オプション構造の場合は、PlotFcns を使用します。	関数ハンドル | 組み込みプロット関数名 | 関数ハンドルのセル配列 | 組み込みプロット関数名のセル配列 | 'saplotbestf' | 'saplotbestx' | 'saplotf' | 'saplotstopping' | 'saplottemperature' | {[]}
PlotInterval	プロット関数は間隔ごとに呼び出されます	正の整数 | {1}
ReannealInterval	再アニーリング間隔	非負整数 | {100}
TemperatureFcn	温度スケジュールを更新するために使用される関数	関数ハンドル | 組み込み温度関数名 | 'temperatureboltz' | 'temperaturefast' | {'temperatureexp'}

バージョン履歴

R2007a で導入

R2018b: 関数 saoptimset は非推奨

オプションを設定する場合、gaoptimset、psoptimset、および saoptimset 関数は推奨されません。代わりに optimoptions を使用してください。

optimoptions と他の関数を使用する場合の主な違いは、optimoptions ではソルバー名を最初の引数として含めることです。たとえば、ga で反復表示を設定するには、次のようにします。

options = optimoptions('ga','Display','iter');
% instead of
options = gaoptimset('Display','iter');

その他の違いは、一部のオプション名が変更されたことです。optimoptions では古い名前を引き続き使用できます。詳細は、R2016aのオプション変更を参照してください。

optimoptions は他の関数に比べて次のような利点があります:

• optimoptions は、特にライブ エディターで、より優れた自動コード提案と補完を提供します。

• さまざまな関数の代わりに、単一のオプション設定関数を使用できます。

現時点では、gaoptimset、psoptimset、saoptimset を削除する予定はありません。

参考

optimoptions | simulannealbnd

トピック

• シミュレーテッド アニーリング オプション