Simulink.sdi.compareSignals
2 つの Simulink.sdi.Signal オブジェクトでデータを比較する
構文
説明
diff = Simulink.sdi.compareSignals(sigID1,sigID2)sigID1 と sigID2 に対応する信号を比較し、その結果を Simulink.sdi.DiffSignalResult オブジェクトに返します。比較結果を計算する方法の詳細については、シミュレーション データ インスペクターでデータを比較する方法を参照してください。
diff = Simulink.sdi.compareSignals(sigID1,sigID2,Name=Value)sigID1 と sigID2 に対応する信号を比較します。 (R2023a 以降)
例
シミュレーション データ インスペクターのプログラムによるインターフェイスを使用して、同じ実行内の信号を比較できます。この例では、航空機用縦方向フライト コントローラーの入力信号と出力信号を比較します。
飛行制御データを含むシミュレーション データ インスペクターのセッション ファイルを読み込みます。
Simulink.sdi.load("AircraftExample.mldatx");最新の実行にアクセスするには、Simulink.sdi.Run.getLatest 関数を使用します。
aircraftRun = Simulink.sdi.Run.getLatest;
Simulink.sdi.getSignalsByName 関数を使用して、コントローラーへの入力を表す Stick 信号と、出力を表す alpha, rad 信号にアクセスします。
stick = getSignalsByName(aircraftRun,"Stick"); alpha = getSignalsByName(aircraftRun,"alpha, rad");
信号 ID を使い、Simulink.sdi.compareSignals 関数を使用して Stick 信号と alpha, rad 信号を比較します。Stick 信号がベースラインです。そのベースラインと比較する信号が alpha, rad 信号です。
comparisonResults = Simulink.sdi.compareSignals(stick.ID,alpha.ID); match = comparisonResults.Status
match =
ComparisonSignalStatus enumeration
OutOfTolerance
比較結果は許容誤差の範囲外です。関数 Simulink.sdi.view を使用して、シミュレーション データ インスペクターを開き、比較結果を表示および解析できます。
Simulink.sdi.view
比較に使用する時間と振幅の許容誤差値を指定できます。比較のベースライン信号に指定された許容誤差値が比較に使用されます。位相シフトを考慮して、Stick 信号に 1 の時間の許容誤差を設定します。振幅の違いを考慮して、Stick 信号に 0.1 の絶対許容誤差値を設定します。
stick.TimeTol = 1; stick.AbsTol = 0.1;
信号を再度比較します。今回は、絶対許容誤差と時間の許容誤差により、信号比較はパスします。
comparisonResults = Simulink.sdi.compareSignals(stick.ID,alpha.ID); match = comparisonResults.Status
match =
ComparisonSignalStatus enumeration
WithinTolerance
この例では、シミュレーション データ インスペクターの関数 Simulink.sdi.compareSignals を使用して異なるシミュレーション実行の信号を比較する方法について説明します。比較する対象の信号が 1 つのみの場合、信号比較を使用すると比較データをもつ Simulink.sdi.diffSignalResult オブジェクトが直接返されます。
シミュレーション データの生成
slexAircraftExample モデルを使用してシミュレーション実行を生成します。実行間で入力フィルターの時定数を変更します。
% Load example model load_system('slexAircraftExample') % Mark the alpha, rad signal for streaming Simulink.sdi.markSignalForStreaming('slexAircraftExample/Aircraft Dynamics Model',4,'on') % Simulate system out_1 = sim('slexAircraftExample'); % Change input filter time constant modelWorkspace = get_param('slexAircraftExample','modelworkspace'); assignin(modelWorkspace,'Ts',0.2) % Simulate again out_2 = sim('slexAircraftExample');
信号比較のための信号 ID を取得
実行 ID を使用して実行オブジェクトを作成したら、getSignalIDByIndex を使用して Simulink.sdi.compareSignals に渡す信号 ID を取得します。
% Get run data
runIDs = Simulink.sdi.getAllRunIDs;
runID1 = runIDs(end-1);
runID2 = runIDs(end);
run1 = Simulink.sdi.getRun(runID1);
run2 = Simulink.sdi.getRun(runID2);
sigID1 = getSignalIDByIndex(run1,1);
sigID2 = getSignalIDByIndex(run2,1);信号の比較
信号を比較し、シミュレーション データ インスペクターを開いて結果を表示します。
diffResult = Simulink.sdi.compareSignals(sigID1,sigID2); Simulink.sdi.view
入力引数
名前と値の引数
出力引数
制限
シミュレーション データ インスペクターは以下の比較をサポートしていません。
データ型
int64またはuint64の信号可変サイズの信号
信号の比較や実行の比較を複数実行する場合、最新の DiffSignalResult オブジェクトのみが表示可能なプロパティをもちます。
バージョン履歴
R2011b で導入
