最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

addTolerance

クラス: fxpOptimizationOptions

最適化されたシステムの数値許容誤差の指定

構文

addTolerance(options,block_path,port_index,tolerance_type,tolerance_value)

説明

addTolerance(options,block_path,port_index,tolerance_type,tolerance_value) は、tolerance_type で指定された許容誤差タイプと tolerance_value で指定された値を使用して、block_path および port_index で指定された出力信号に対する数値許容誤差を指定します。

入力引数

すべて展開する

許容誤差の指定を追加する fxpOptimizationOptions オブジェクト。

許容誤差を追加するブロックのパス。文字ベクトルとして指定します。

データ型: char | string

許容誤差を指定する block_path で指定されたブロックの出力端子のインデックス。スカラー整数として指定します。

データ型: double

指定した端子に追加する許容誤差のタイプ。絶対許容誤差 AbsTol、相対許容誤差 RelTol、または時間の許容誤差 TimeTol として指定します。

データ型: char

block_path および port_index で指定された信号に対する許容される誤差のレベル。

tolerance_type'AbsTol' に設定されている場合、tolerance_value は元の出力と新しい設計の出力の間で許容される最大差の絶対値を表します。

tolerance_type'RelTol' に設定されている場合、tolerance_value は元の出力と新しい設計の出力の間の最大相対差 (パーセンテージで指定) を表します。たとえば、値 1e-2 は元の出力と新しい設計の出力の最大差が 1% であることを示します。

tolerance_type'TimeTol' に設定されている場合、tolerance_value は、最大値と最小値によって比較する上限値と下限値が定義される時間間隔 (秒単位) を定義します。詳細については、シミュレーション データ インスペクターでデータを比較する方法 (Simulink)を参照してください。

データ型: double

すべて展開する

データ型を最適化するシステムを読み込みます。

load_system('ex_auto_gain_controller');

fxpOptimizationOptions オブジェクトを既定のプロパティ値で作成します。

options = fxpOptimizationOptions;

最適化プロセスで使用が必要となる数値許容誤差を指定するには、fxpOptimizationOptions オブジェクトの addTolerance メソッドを使用します。許容誤差の制約を複数指定する場合は、このメソッドを制約ごとに 1 回呼び出します。相対許容誤差と絶対許容誤差のいずれかの制約を指定できます。

addTolerance(options, 'ex_auto_gain_controller/output_signal', 1, 'AbsTol', 5e-2);
addTolerance(options, 'ex_auto_gain_controller/input_signal', 1, 'RelTol', 1e-2);

showTolerances メソッドを使用して、指定した fxpOptimizationOptions オブジェクトに追加されたすべての許容誤差の制約を表示します。

showTolerances(options)
                      Path                       Port_Index    Tolerance_Type    Tolerance_Value
    _________________________________________    __________    ______________    _______________

    {'ex_auto_gain_controller/output_signal'}        1           {'AbsTol'}           0.05      
    {'ex_auto_gain_controller/input_signal' }        1           {'RelTol'}           0.01      

R2018a で導入