ドキュメンテーション センター

  • 評価版
  • 製品アップデート

目次

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

Simulink.sdi.report

シミュレーション データ インスペクター ツールからレポートを生成する

構文

Simulink.sdi.report()
Simulink.sdi.report(Name,Value)

説明

Simulink.sdi.report() は、シミュレーション データ インスペクターの [信号の検証] タブで現在のビューとデータを作成します。

Simulink.sdi.report(Name,Value) はレポートに含める情報を指定するパラメーター Name, Value ペアを使用してレポートを作成します。

入力引数

名前/値のペアの引数

オプションの Name,Value 引数のペアをコンマ区切りで指定します。ここで、Name は引数名で、Value は対応する値です。Name は単一引用符 (' ') で囲まなければなりません。Name1,Value1,...,NameN,ValueN のように、複数の名前と値のペア引数を、任意の順番で指定できます。

'ReportToCreate'

レポートに含めるシミュレーション データ インスペクターのタブ表示を指定する

説明
'Inspect Signals' (既定の設定)[信号の検証] タブに表示される情報
'Compare Signals'[信号の比較] タブに表示される情報
'Compare Runs'[実行の比較] タブに表示される情報

既定値: 'Inspect Signals'

'ReportOutputFolder'

生成レポートの場所を指定する MATLAB 文字列。

既定値: <現在の作業フォルダー>/slprj/sdi

'ReportOutputFile'

レポート ファイル名を指定する MATLAB 文字列。

既定値: 'SDI_report.html'

'PreventOverwritingFile'

論理値。レポート ファイルが存在し、値が true の場合は、レポート ジェネレーターによってファイル名がインクリメントされます。false の場合は、レポート ジェネレーターによりレポート ファイルが (存在する場合) 上書きされます。

既定値: true

'ColumnsToReport'

シミュレーション データ インスペクターで使用できるすべての信号メタデータをリストした列挙クラス Simulink.sdi.SignalMetaData から値を指定する行列。たとえば、[実行] および [同期方法] 列を [信号の比較] レポートに含めるには、変数 signal_metadata を作成します。

signal_metadata = [Simulink.sdi.SignalMetaData.Run, Simulink.sdi.SignalMetaData.SyncMethod];

信号の検証と信号の比較タブに使用できる表の列

列挙要素表の列についての説明
BlockPath (既定の設定)ブロック パス
SignalName (既定の設定)信号名
Line (既定の設定)ライン スタイル
AbsTol (既定の設定)正の数 (ユーザー指定)
RelTol (既定の設定)正の数 (ユーザー指定)
SyncMethod時間ベクトルを配置する方法:[union][intersection][uniform] (ユーザー指定)
DataSourceデータ ソースを指定する文字列 (logsout.Stick.Data)
TimeSeriesRootSimulink.Timeseries オブジェクトの名前を示す文字列 (logsout.Stick.Time)
TimeSource時間データを含んだ配列を示す文字列 (logsout.Stick.Time)
InterpMethodデータを配置する方法:[zoh][linear] (ユーザー指定)
Portログが作成された信号を発生する出力端子のインデックス
Dimensions信号の次元数
Channel行列データのチャンネル
Runシミュレーションの実行名
Model信号データのモデル名
SID「Simulink 識別子」
  • [実行 1:SID]

  • [実行 2:SID]

[実行の比較] タブで使用できる表の列

説明
Result (既定の設定)指定した実行全体の信号の比較結果
AbsTol1 (既定の設定)絶対許容誤差
RelTol1 (既定の設定)相対許容誤差
AlignedBy (既定の設定)シミュレーションの実行間で信号データを整列する場合に使用するメタデータ
LinkToPlot (既定の設定)各比較結果のプロットへのリンク
BlockPath1最初の実行からの信号のブロック パス
BlockPath22 番目の実行から信号のブロック パス
SignalName1最初の実行からの信号名
SignalName22 番目の実行からの信号名
DataSource1最初の実行からのデータ名
DataSource22 番目の実行からのデータ名
SID1最初の実行からのデータの「Simulink 識別子」
SID22 番目の実行からのデータの「Simulink 識別子」
SyncMethod1最初の実行に指定された同期方法
InterpMethod1最初の実行に指定された内挿法
Channel1最初の実行に指定されたチャンネル

'ShortenBlockPath'

論理値。値が true で、ブロックのパス名が長すぎる場合は、シミュレーション データ インスペクターによってレポート内の名前が短くされます。値が false である場合は、ブロック全体のパス名がレポートに表示されます。

既定値: true

'LaunchReport'

論理値。作成した後に値が true である場合は、生成レポートが開きます。

既定値: true

'SignalsToReport'

'Compare Runs' 表示専用

説明
'ReportOnlyMismatchedSignals'2 つの実行を比較した後で一致しない信号のみを含む
'ReportAllSignals'比較した 2 つの実行内のすべての信号を含む

既定値: 'ReportOnlyMismatchedSignals'

[信号の検証] 表示からレポートを作成します。

% Configure model "slexAircraftExample" for logging and simulate
simOut = sim('slexAircraftExample', 'SaveOutput','on', ...
             'SaveFormat', 'StructureWithTime', ...
             'ReturnWorkspaceOutputs', 'on');
  
% Create a Data Inspector run
[~, ~, signalIDs] = Simulink.sdi.createRun('My Run', 'base', {'simOut'});
  
% Select signals for plotting
for i = 1:length( signalIDs )
   signal = Simulink.sdi.getSignal(signalIDs(i));
   signal.checked = true;
end
  
% Create default report, which is the Inspect Signals view
Simulink.sdi.report();
 

[信号の比較] 表示からレポートを作成します。

% Configure model "slexAircraftExample" for logging and simulate
simOut = sim('slexAircraftExample', 'SaveOutput','on', ...
             'SaveFormat', 'StructureWithTime', ...
             'ReturnWorkspaceOutputs', 'on');
  
% Create a Data Inspector run
[~, ~, signalIDs] = Simulink.sdi.createRun('My Run', 'base', {'simOut'});
  
% Compare two signals
Simulink.sdi.compareSignals( signalIDs(1), signalIDs(2) );
 
% Report on the signal comparison
Simulink.sdi.report('ReportToCreate', 'Compare Signals', ...
                    'ReportOutputFolder', tempdir, 'ReportOutputFile', 'myReport.html');
 

[信号の実行] 表示からレポートを作成します。

% Configure model "slexAircraftExample" for logging and simulate
set_param('slexAircraftExample/Pilot','WaveForm','square');
simOut = sim('slexAircraftExample', 'SaveOutput','on', ...
                  'SaveFormat', 'StructureWithTime', ...
                  'ReturnWorkspaceOutputs', 'on');

% Create a Simulation Data Inspector run, Simulink.sdi.Run, from simOut in the base workspace
runID1 = Simulink.sdi.createRun('First Run','namevalue',{'simOut'},{simOut});

% Simulate again
set_param('slexAircraftExample/Pilot','WaveForm','sawtooth');
simOut = sim('slexAircraftExample', 'SaveOutput','on', ...
             'SaveFormat', 'StructureWithTime', ...
             'ReturnWorkspaceOutputs', 'on');
      
% Create another Simulation Data Inspector run
runID2 = Simulink.sdi.createRun('Second Run','namevalue',{'simOut'},{simOut});

% Compare two runs
difference = Simulink.sdi.compareRuns(runID1, runID2);

% Specify columns to include in the report
metaDataOfInterest = [Simulink.sdi.SignalMetaData.Result, ...
                    Simulink.sdi.SignalMetaData.BlockPath1, ...
                    Simulink.sdi.SignalMetaData.RelTol1];
% Report on the run comparison
Simulink.sdi.report('ReportToCreate', 'Compare Runs', ...
                    'ColumnsToReport', metaDataOfInterest, ...
                    'SignalsToReport', 'ReportAllSignals' );

代替方法

シミュレーション データ インスペクター ツールでレポートを生成するには、[ファイル][レポートの生成] を選択します。

参考

| |

この情報は役に立ちましたか?