ドキュメンテーション

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

Simulink.sdi.snapshot

シミュレーション データ インスペクター プロットのコンテンツをキャプチャ

構文

fig = Simulink.sdi.snapshot
[fig,image] = Simulink.sdi.snapshot
Simulink.sdi.snapshot(Name,Value)
Simulink.sdi.snapshot(Name,Value)
Simulink.sdi.snapshot(Name,Value)

説明

fig = Simulink.sdi.snapshot は、開いているシミュレーション データ インスペクター セッションで Figure ハンドル fig を使用してプロット領域の Figure を作成します。

[fig,image] = Simulink.sdi.snapshot は、開いているシミュレーション データ インスペクター セッションで Figure ハンドル fig を使用してプロット領域の Figure を作成し、イメージ データを配列 image で返します。

Simulink.sdi.snapshot(Name,Value) は、名前と値のペアによって指定されたオプションに従って、シミュレーション データ インスペクター プロットのイメージをキャプチャします。

fig = Simulink.sdi.snapshot(Name,Value) は、名前と値のペアによって指定されたオプションに従って、シミュレーション データ インスペクター プロットのイメージをキャプチャします。Figure が作成されている場合、この構文は Figure ハンドル fig を返します。

[fig, image] = Simulink.sdi.snapshot(Name,Value) は、名前と値のペアによって指定されたオプションに従って、シミュレーション データ インスペクター プロットのイメージをキャプチャします。指定されたオプションが適切な場合、この構文は Figure ハンドル fig とイメージ データの配列 image を返します。

すべて折りたたむ

この例では、整列後の信号の表示設定を、ある実行から別の実行にコピーする方法について説明します。

モデルのシミュレーションと実行オブジェクトの取得

vdp モデルのシミュレーションを実行し、可視化するデータの実行を作成します。

load_system('vdp')
set_param('vdp','SaveFormat','Dataset','SaveOutput','on')
sim('vdp')

runIndex = Simulink.sdi.getRunCount;
runID = Simulink.sdi.getRunIDByIndex(runIndex);
vdpRun = Simulink.sdi.getRun(runID);

信号の表示設定を変更

Simulink.sdi.Run オブジェクトを使用して実行内の信号にアクセスします。次に、信号の表示設定を変更し、それらをシミュレーション データ インスペクターでプロットします。シミュレーション データ インスペクターを開き、Simulink.sdi.snapshot を使用して結果を表示します。

sig1 = vdpRun.getSignalByIndex(1);
sig2 = vdpRun.getSignalByIndex(2);

sig1.LineColor = [0 0 1];
sig1.LineDashed = '-.';

sig2.LineColor = [1 0 0];
sig2.LineDashed = ':';

シミュレーション データ インスペクターからのスナップショットをキャプチャ

Simulink.sdi.CustomSnapshot オブジェクトを作成し、関数 Simulink.sdi.snapshot を使用してシミュレーション データ インスペクターのコンテンツのスナップショットをプログラムによりキャプチャします。

snap = Simulink.sdi.CustomSnapshot;

snap.Rows = 2;
snap.YRange = {[-2.25 2.25],[-3 3]};
snap.plotOnSubPlot(1,1,sig1,true)
snap.plotOnSubPlot(2,1,sig2,true)

fig = Simulink.sdi.snapshot("from","custom","to","figure","settings",snap);

表示設定を新しいシミュレーション実行にコピー

別の Mu 値でモデルを再度シミュレートします。次に、最初の実行から表示設定をコピーして、新しい実行を可視化します。plot 入力を true として指定し、新しい実行から信号をプロットします。

set_param('vdp/Mu','Gain','5')
sim('vdp')

runIndex2 = Simulink.sdi.getRunCount;
runID2 = Simulink.sdi.getRunIDByIndex(runIndex2);
run2 = Simulink.sdi.getRun(runID2);

sigIDs = Simulink.sdi.copyRunViewSettings(runID,runID2,true);

新しいシミュレーション実行のスナップショットをキャプチャ

Simulink.sdi.CustomSnapshot オブジェクトを使用して新しいシミュレーション実行のスナップショットをキャプチャします。最初に、サブプロットから信号をクリアします。次に、新しい実行から信号をプロットし、別のスナップショットをキャプチャします。

snap.clearSignals
snap.YRange = {[-2.25 2.25],[-8 8]};
snap.plotOnSubPlot(1,1,sigIDs(1),true)
snap.plotOnSubPlot(2,1,sigIDs(2),true)

fig = snap.snapshot("to","figure");

入力引数

すべて折りたたむ

名前と値のペアの引数

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

例: 'to','figure','props',{'Name','My Data'}

スナップショットに含めるコンテンツ。

  • 'opened' — 開いているシミュレーション データ インスペクター セッションのグラフィカルな表示領域にあるすべてのサブプロットを含めます。

  • 'active' — 開いているシミュレーション データ インスペクター セッションにあるアクティブな (選択されている) サブプロットのみを含めます。

  • 'comparison' — 選択されている比較実行の比較プロットまたは開いているシミュレーション データ インスペクター セッションにある信号を含めます。

  • 'custom' — 名前と値のペア settingsSimulink.sdi.CustomSnapshot オブジェクトによって指定されたコンテンツを含めます。'from','custom' オプションを使用すると、シミュレーション データ インスペクターを開いたり、開いているシミュレーション データ インスペクター セッションに影響を与えることなくスナップショットを作成できます。'from','custom' を指定する場合、名前と値のペア settings を含めます。

例: 'from','comparison'

データ型: char | string

作成するスナップショットのタイプ。

  • 'image' — Figure を作成し、Figure ハンドルとイメージ データの配列を返します。'to','image' を指定すると、figimage のどちらの出力にも値があります。

  • 'figure' — Figure を作成し、Figure ハンドルを返します。'to','figure' を指定すると、fig の出力には値があり、image の出力は空になります。

  • 'file' — 名前と値のペア filename によって指定された名前をもつ PNG ファイルに保存します。名前と値のペア filename を指定しない場合、ファイルには plots.png という名前が付けられます。'to','file' を指定すると、figimage の出力はどちらも空になります。

  • 'clipboard' — プロットをシステムのクリップボードにコピーします。クリップボードから、イメージを Microsoft® Word などの別のプログラムに貼り付けることができます。'to','clipboard' を指定すると、figimage の出力はどちらも空になります。

例: 'to','file'

データ型: char | string

'to','file' を指定したときにスナップショットを格納するイメージ ファイルの名前。

例: 'filename','MyImage.png'

データ型: char | string

Figure のプロパティ。cell 配列として指定します。Figure のプロパティ で説明されている Figure プロパティの設定を含めることができます。

例: 'props',{'Name','MyData','NumberTitle','off'}

データ型: char | string

カスタム スナップショット設定を指定する Simulink.sdi.CustomSnapshot オブジェクト。名前と値のペア settings を使用してイメージの寸法 (ピクセル単位)、サブプロット レイアウト、x 軸と y 軸の範囲を指定することができます。

例: 'settings',customSnap

データ型: char | string

出力引数

すべて折りたたむ

Figure のハンドル。指定されたオプションで Figure が作成されないときは、fig の出力は空になります。

イメージ データの配列。image の出力は、入力引数や名前と値のペア to を指定せずに Simulink.sdi.snapshot を使用した場合や、'to','image' を指定した場合に値を持ちます。

R2018a で導入