このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
snapshot
カスタム スナップショットを作成する
構文
説明
は、fig
= snapshot(snap
)Simulink.sdi.CustomSnapshot
オブジェクト snap
のプロパティに従って Figure を作成し、Figure のハンドル fig
を返します。
は、1 つ以上の fig
= snapshot(snap
,Name,Value
)Name,Value
の引数で指定された追加オプションを使用して Figure を作成し、Figure ハンドルを返します。
[
は、1 つ以上の fig
,image
] = snapshot(snap
,Name,Value
)Name,Value
の引数で指定された追加オプションを使用して Figure を作成し、Figure ハンドルとイメージ データの配列を返します。
例
実行への表示設定のコピー
ある実行から別の実行に表示設定をコピーし、Simulink.sdi.CustomSnapshot
オブジェクトを使用して Figure を作成します。
モデルのシミュレーションと実行オブジェクトの取得
出力データを保存するように vdp
モデルを構成します。シミュレーションを実行してデータを作成します。
load_system("vdp") set_param("vdp","SaveFormat","Dataset","SaveOutput","on") set_param("vdp/Mu","Gain","1"); sim("vdp");
シミュレーション データ インスペクターのプログラムによるインターフェイスを使用して、実行データにアクセスします。
runIndex = Simulink.sdi.getRunCount; runID = Simulink.sdi.getRunIDByIndex(runIndex); vdpRun = Simulink.sdi.getRun(runID);
信号表示設定の変更
Simulink.sdi.Run
オブジェクトを使用して実行内の信号にアクセスします。次に、信号の表示設定を変更します。この例では、各信号のラインの色とスタイルを指定します。実行の表示設定は、各信号の表示設定とプロット領域に対して指定された表示設定で構成されています。
sig1 = getSignalByIndex(vdpRun,1); sig2 = getSignalByIndex(vdpRun,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;
Simulink.sdi.CustomSnapshot
オブジェクトのプロパティを使用して、サブプロット レイアウトや軸の範囲といったプロット設定を構成したり、信号をプロットしたりできます。Simulink.sdi.CustomSnapshot
オブジェクトを使用して Figure を作成するときに、これらのプロット設定はシミュレーション データ インスペクターに影響しません。
snap.Rows = 2; snap.YRange = {[-2.25 2.25],[-3 3]}; plotOnSubPlot(snap,1,1,sig1,true) plotOnSubPlot(snap,2,1,sig2,true)
関数 Simulink.sdi.snapshot
を使用して、Simulink.sdi.CustomSnapshot
オブジェクトのプロパティで指定した Figure を生成します。
fig = Simulink.sdi.snapshot("From","custom","To","figure","Settings",snap);
新しいシミュレーション実行への表示設定のコピー
別の Mu
値でモデルを再度シミュレートします。シミュレーション データ インスペクターのプログラムによるインターフェイスを使用して、シミュレーション データにアクセスします。
set_param("vdp/Mu","Gain",".5") sim("vdp"); runIndex2 = Simulink.sdi.getRunCount; runID2 = Simulink.sdi.getRunIDByIndex(runIndex2); run2 = Simulink.sdi.getRun(runID2);
前の手順で作成したような新たな出力データのプロットを作成するには、関数 Simulink.sdi.copyRunViewSettings
を使用して、表示設定を 1 行のコードで実行にコピーできます。この関数は Simulink.sdi.CustomSnapshot
オブジェクトのプロット設定を自動的に更新しないため、プロットを更新するかどうかを決定する入力を false
として指定します。
sigIDs = Simulink.sdi.copyRunViewSettings(runID,runID2,false);
新しいシミュレーション実行のスナップショットの取得
Simulink.sdi.CustomSnapshot
オブジェクトを使用して新しいシミュレーション実行のスナップショットをキャプチャします。最初に、サブプロットから信号をクリアします。次に、新しい実行から信号をプロットし、別のスナップショットをキャプチャします。
clearSignals(snap) snap.YRange = {[-2.25 2.25],[-8 8]}; plotOnSubPlot(snap,1,1,sigIDs(1),true) plotOnSubPlot(snap,2,1,sigIDs(2),true) fig = snapshot(snap,"To","figure");
入力引数
snap
— カスタム スナップショット設定
Simulink.sdi.CustomSnapshot
オブジェクト
カスタム スナップショット設定。Simulink.sdi.CustomSnapshot
オブジェクトとして指定します。
名前と値の引数
引数のオプションのペアを Name1=Value1,...,NameN=ValueN
として指定します。Name
は引数名、Value
は対応する値です。名前と値の引数は他の引数の後に表示されなければなりませんが、ペアの順序は重要ではありません。
例: snapshot(snap,To="image")
R2021a より前は、名前と値をそれぞれコンマを使って区切り、Name
を引用符で囲みます。
例: 'To','figure','Props',{'Name','My Data'}
To
— 作成するスナップショットのタイプ
"image"
(既定値) | "figure"
| "file"
| "clipboard"
作成するスナップショットのタイプ。以下として指定します。
"image"
— Figure を作成し、Figure ハンドルとイメージ データの配列を返します。"To","image"
を指定すると、fig
とimage
のどちらの出力にも値があります。"figure"
— Figure を作成し、Figure ハンドルを返します。"To","figure"
を指定すると、fig
の出力には値があり、image
の出力は空になります。"file"
— 名前と値の引数Filename
によって指定された名前をもつ PNG ファイルに保存します。名前と値の引数Filename
を指定しない場合、ファイルにはplots.png
という名前が付けられます。"To","file"
を指定すると、fig
とimage
の出力はどちらも空になります。"clipboard"
— プロットをシステムのクリップボードにコピーします。クリップボードから、イメージを Microsoft® Word などの別のプログラムに貼り付けることができます。"To","clipboard"
を指定すると、fig
とimage
の出力はどちらも空になります。
例: "To","file"
データ型: char
| string
Filename
— イメージ ファイルの名前
"plots.png"
(既定値) | 文字配列 | string
"To","file"
を指定したときにスナップショットを格納するイメージ ファイルの名前。文字配列または string として指定します。
例: "Filename","MyImage.png"
データ型: char
| string
Props
— Figure のプロパティ
cell 配列
Figure のプロパティ。cell 配列として指定します。Figure をカスタマイズするには、Figure のプロパティ で説明されている Figure プロパティの設定を含めることができます。
例: "Props",{"Name","MyData","NumberTitle","off"}
データ型: char
| string
出力引数
fig
— Figure ハンドル
Figure ハンドル
Figure のハンドル。Figure ハンドルとして指定します。指定されたオプションで Figure が作成されないときは、fig
の出力は空になります。
image
— イメージ データ
配列
イメージ データ。配列として返されます。image
の出力は、入力引数や名前と値の引数 To
を指定せずに Simulink.sdi.snapshot
を使用した場合や、'To','image'
を指定した場合に値をもちます。
バージョン履歴
R2018a で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)