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

Simulink.sdi.createRun

シミュレーション データ インスペクターで実行を作成する

説明

runID = Simulink.sdi.createRun はシミュレーション データ インスペクター リポジトリ内に名前のない空の実行を作成し、実行 ID を返します。Simulink.sdi.getRun を使用して実行用の Simulink.sdi.Run オブジェクトを取得できます。これにより、メタデータと信号を実行に追加できるようになります。

runID = Simulink.sdi.createRun(runName)runName という名前の空の実行を作成します。

runID = Simulink.sdi.createRun(var) はワークスペース変数 var 内のデータを含む var という名前の実行を作成します。

runID = Simulink.sdi.createRun(runName,'vars',var,var2,...,varn) はベース ワークスペース内の 1 つ以上の変数からのデータを含む runName という名前の実行を作成します。実行内の信号は変数名から名前を取得します。

runID = Simulink.sdi.createRun(runName,'namevalue',sourceNames,sigValues) は cell 配列 sigValues 内のデータをもつ runName という名前の実行を作成します。sourceNames の cell 配列は sigValues データのソースとして使用する名前を指定します。

runID = Simulink.sdi.createRun(runName,'file',filename) は、filename で指定された MAT、CSV、MDF、または Microsoft® Excel® ファイルからのデータをもつ実行を作成します。

[runID,runIndex] = Simulink.sdi.createRun(___) はシミュレーション データ インスペクター リポジトリで作成された実行に対する実行 ID と実行インデックスを返します。

[runID,runIndex,signalIDs] = Simulink.sdi.createRun(___) はシミュレーション データ インスペクター内の実行 ID、実行インデックスと、実行内の信号の信号 ID を返します。

すべて折りたたむ

この例は、シミュレーション データ インスペクターでデータ用に実行を作成する方法をいくつか示します。シミュレーション出力、ワークスペース データ、ファイルから実行を作成できます。

データの作成

ワークスペース データまたはファイルからシミュレーション データ インスペクターの実行を作成できます。Simulink.sdi.createRun 用の namevalue 構文は階層データに役立つことがあります。各シナリオで使用するサンプル データを作成します。

% Create timeseries workspace data
time = linspace(0,20,101);

sine_vals = sin(2*pi/5*time);
sine_ts = timeseries(sine_vals,time);
sine_ts.Name = 'Sine, T=5';

cos_vals = cos(2*pi/8*time);
cos_ts = timeseries(cos_vals,time);
cos_ts.Name = 'Cosine, T=8';

% Create Dataset workspace data
sinusoids_ds = Simulink.SimulationData.Dataset;
sinusoids_ds = sinusoids_ds.add(cos_ts);
sinusoids_ds = sinusoids_ds.add(sine_ts);

doubSine = 2*sine_ts;
doubCos = 2*cos_ts;

doubSinusoids_ds = Simulink.SimulationData.Dataset;
doubSinusoids_ds = doubSinusoids_ds.add(doubSine);
doubSinusoids_ds = doubSinusoids_ds.add(doubCos);

% Save workspace data to a MAT-file
save sinusoids.mat sine_ts cos_ts

実行オブジェクトで実行を作成

Simulink.sdi.Run オブジェクトの create メソッドを使用して実行オブジェクトを作成してから、add メソッドを使用してデータを実行に追加できます。add メソッドはすべての読み込みデータ形式とログ データ形式をサポートしています。

% Create a run
sinusoidsRun = Simulink.sdi.Run.create;
sinusoidsRun.Name = 'Sinusoids';
sinusoidsRun.Description = 'Sine and cosine signals of different frequencies';

% Add timeseries data to run
sinusoidsRun.add('vars',sine_ts,cos_ts);

変数の実行を作成

シミュレーション データ インスペクターで検査して比較する対象の信号が 1 つのみの場合、単純な構文を使用して実行を作成できます。実行は変数と同じ名前を取得します。

runID = Simulink.sdi.createRun(sine_ts);

名前付きの空の実行を作成

この構文では、空の実行を作成してその名前を指定できます。次に、返された runID を使用して実行にデータを追加できます。

runID = Simulink.sdi.createRun('My Waves');
signalID = Simulink.sdi.addToRun(runID,'vars',cos_ts);

複数のワークスペース変数から実行を作成

対象の信号がワークスペース内の複数の変数にある場合、'vars' 構文を使用します。この構文を使用して、単一の変数から作成された実行にカスタム名を指定することもできます。

runID = Simulink.sdi.createRun(' My Sinusoids','vars',sine_ts,cos_ts);

実行を作成してデータのソースを指定

実行データのソースに名前を指定すると、特に階層データで役立つことがあります。'namevalue' 構文を使用してデータ ソース名を指定します。

runID = Simulink.sdi.createRun('Waves','namevalue',{'Sinusoids',...
    'BigSinusoids'},{sinusoids_ds,doubSinusoids_ds});

ファイル内のデータから実行を作成

'file' 構文を使用して、データのファイルから直接シミュレーション データ インスペクターで実行を作成できます。

runID = Simulink.sdi.createRun('Wave Data','file','sinusoids.mat');

シミュレーション データ インスペクターで実行を表示

[検査] ペインで実行を表示し、各実行作成メソッドによる結果を確認します。メタデータを表示する実行または信号を選択できます。

Simulink.sdi.view

この例では、シミュレーション データ インスペクターで実行を作成するときに信号データにアクセスする方法について説明します。

実行のデータを生成

この例では、正弦信号と余弦信号の時系列データを作成します。

% Create timeseries workspace data
time = linspace(0, 20, 101);

sine_vals = sin(2*pi/5*time);
sine_ts = timeseries(sine_vals,time);
sine_ts.Name = 'Sine, T=5';

cos_vals = cos(2*pi/8*time);
cos_ts = timeseries(cos_vals,time);
cos_ts.Name = 'Cosine, T=8';

実行を作成して信号 ID を返す

Simulink.sdi.Run オブジェクトを介して信号 ID にアクセスする代わりに、Simulink.sdi.createRun 構文を複数の戻り引数を伴って使用すると、信号 ID をより直接的に取得できます。

[runID,runIndex,sigIDs] = Simulink.sdi.createRun('Sinusoids','vars',...
    sine_ts,cos_ts);

cosID = sigIDs(2);
cosSig = Simulink.sdi.getSignal(cosID);

信号プロパティを変更してシミュレーション データ インスペクターで表示

Simulink.sdi.Signal オブジェクトを使用して信号プロパティを表示および変更し、シミュレーション データ インスペクターで信号をプロットできます。

cosSig.Checked = true;
cosSig.AbsTol = 0.05;
Simulink.sdi.view
cosSig.Name

入力引数

すべて折りたたむ

シミュレーション データ インスペクター内の実行の名前。

例: 'Baseline Simulation'

シミュレーション データ インスペクター内の実行の作成対象となるデータを含むベース ワークスペース内の変数。シミュレーション データ インスペクターにはデータの関連する時間ベクトルが必要です。Simulink.sdi.createRun では timeseriesSimulink.SimulationData.Dataset を含めたすべての読み込みデータ形式とログ データ形式がサポートされます。

var が唯一の引数の場合は 1 つの var 引数が提供され、2 番目の引数 'vars' を指定する場合は、1 つ以上の var 引数が提供されます。

例: myData

文字ベクトルの cell 配列。各要素は実行内のデータのソース名です。2 番目の引数に対して 'namevalue' を指定する場合は sigNames 入力を指定します。

例: {'sig1','sig2'}

実行の信号データを含む変数の cell 配列。2 番目の引数に対して 'namevalue' を指定する場合は sigValues 入力を指定します。

例: {var1,var2}

実行データを含むファイルのファイル名。2 番目の引数に対して 'file' を指定する場合は filename 入力を指定します。MAT、CSV、または Microsoft Excel ファイルから実行を作成できます。また、mdf、mf4、mf3、data、または dat ファイル拡張子を持つ MDF ファイルからも実行を作成できます。

例: 'simulation.mat'

出力引数

すべて折りたたむ

新しい実行の実行識別子。

シミュレーション データ インスペクター リポジトリ内の新しい実行のインデックス。

実行内の信号の信号 ID を含むベクトル。

R2011b で導入