Simulink.BlockDiagram.getInitialState
ブロック線図から初期状態データを取得する
説明
x0 = Simulink.BlockDiagram.getInitialState(mdlName)mdlName で指定したモデルをコンパイルし、参照モデル内のブロックの状態など、モデル内のブロックの状態の初期値を返します。
モデルの [保存形式] パラメーターの値が
[データセット]の場合、x0は、モデル内のブロックの初期状態情報を含むSimulink.SimulationData.Datasetオブジェクトです。モデルの [保存形式] パラメーターが
[データセット]以外の値である場合、x0は、モデル内のブロックの初期状態情報を含む構造体です。
この初期状態情報を使用して、シミュレーションの初期ブロック状態値を指定したり、線形化の初期条件を提供したりできます。状態情報はそのまま使用できます。あるいは、ブロックの状態のサブセットの状態情報を指定する場合に、個々の状態値を変更したり、構造体から状態値を削除したりすることもできます。
初期シミュレーション状態または操作点からモデルをシミュレートするには、代わりに Simulink.op.ModelOperatingPoint オブジェクトの使用を検討してください。ModelOperatingPoint オブジェクトには、ブロックの状態、非表示のブロックの状態、ソルバーの状態、実行エンジンの状態、一部のブロックの出力値など、モデルの操作点に関する完全な情報が含まれています。詳細については、Specify Initial State for Simulationを参照してください。
例
モデル vdp を開きます。このモデルでは 2 つの Integrator ブロックを使用しており、それぞれに 1 つの状態があります。
mdl = "vdp";
open_system(mdl)
モデルの [保存形式] パラメーターは、Simulink.BlockDiagram.getInitialState 関数が構造体を返すのか Simulink.SimulationData.Dataset オブジェクトを返すのかを指定します。パラメーター値を Dataset に設定します。
Simulink® ツールストリップの [モデル化] タブで [モデル設定] をクリックします。
[コンフィギュレーション パラメーター] ダイアログ ボックスで、[データのインポート/エクスポート] ペインを選択します。
[保存形式] リストから
Datasetを選択します。[コンフィギュレーション パラメーター] ダイアログ ボックスで [OK] をクリックします。
あるいは、関数 set_param を使用して、SaveFormat パラメーターの値を指定します。
set_param(mdl,SaveFormat="Dataset")関数 Simulink.BlockDiagram.getInitialState を使用してモデルのブロックの状態の Dataset オブジェクトを取得します。
initstates = Simulink.BlockDiagram.getInitialState(mdl)
initstates =
Simulink.SimulationData.Dataset 'xFinal' with 2 elements
Name BlockPath
____ _________
1 [1x1 State] '' vdp/x1
2 [1x1 State] '' vdp/x2
- Use braces { } to access, modify, or add elements using index.
x2 という名前の Integrator ブロックの状態の値を 2 に設定します。
initstates{2}.Values.Data = 2;x1 という名前の Integrator ブロックの状態情報をもつ要素を削除します。
initstates = removeElement(initstates,1);
変数 initStates を指定します。この変数には、x2 という名前の Integrator ブロックの初期状態値がモデルの初期状態として含まれます。
Simulink ツールストリップの [モデル化] タブで [モデル設定] をクリックします。
[コンフィギュレーション パラメーター] ダイアログ ボックスで、[データのインポート/エクスポート] ペインを選択します。
[初期状態] を選択します。次に、ボックスに「
initStates」と入力します。[OK] をクリックします。
あるいは、関数 set_param を使用して、LoadInitialState パラメーターおよび InitialState パラメーターを構成します。
set_param(mdl,LoadInitialState="on",InitialState="initstates")
モデルのシミュレーションを実行します。
out = sim(mdl);
両方の Integrator ブロックの出力信号を表示するには、Scope ブロックをダブルクリックします。あるいは、open_system 関数を使用してスコープ ウィンドウを開きます。
blk = mdl + "/Scope";
open_system(blk)
両方の Integrator ブロックで、初期出力値と初期状態値は共に 2 です。x2 という名前の Integrator ブロックでは、初期状態値 2 が [初期状態] パラメーターの値から取得されます。x1 という名前の Integrator ブロックでは、初期状態値 2 がブロック パラメーターで指定されています。
blk = mdl +"/x1"; get_param(blk,"InitialCondition")
ans = '2'
モデル vdp を開きます。このモデルは 2 つの Integrator ブロックを使用しています。
mdl = "vdp";
open_system(mdl)
モデルの [形式] パラメーターは、関数 Simulink.BlockDiagram.getInitialState が構造体を返すのか Simulink.SimulationData.Dataset オブジェクトを返すのかを指定します。パラメーター値を Structure に設定します。
Simulink® ツールストリップの [モデル化] タブで [モデル設定] をクリックします。
[コンフィギュレーション パラメーター] ダイアログ ボックスで、[データのインポート/エクスポート] ペインを選択します。
[形式] リストから
Structureを選択します。[コンフィギュレーション パラメーター] ダイアログ ボックスで [OK] をクリックします。
あるいは、関数 set_param を使用して、SaveFormat パラメーターの値を指定します。
set_param(mdl,"SaveFormat","Structure")
関数 Simulink.BlockDiagram.getInitialState を使用してモデルのブロックの状態の構造体を取得します。この構造体の signals フィールドに 2 つのブロックの状態 (Integrator ブロックごとに 1 つ) の情報が含まれています。
initStates = Simulink.BlockDiagram.getInitialState(mdl)
initStates = struct with fields:
time: 0
signals: [1×2 struct]
各状態の signals 構造体には、モデルで現在使用されている初期値やブロック パスなど、状態に関する情報が含まれています。
initStates.signals(2)
ans = struct with fields:
values: 0
dimensions: 1
label: 'CSTATE'
blockName: 'vdp/x2'
stateName: ''
inReferencedModel: 0
sampleTime: [0 0]
2 番目のブロックの状態は、x2 という名前の Integrator ブロックに対応しています。values フィールドを 2 に設定します。
initStates.signals(2).values = 2;
x1 という名前の Integrator ブロックの状態に関する情報が含まれた signals フィールド内の構造体を削除します。
initStates.signals(1) = [];
変数 initStates を指定します。この変数には、x2 という名前の Integrator ブロックの初期状態値がモデルの初期状態として含まれます。
Simulink ツールストリップの [モデル化] タブで [モデル設定] をクリックします。
[コンフィギュレーション パラメーター] ダイアログ ボックスで、[データのインポート/エクスポート] ペインを選択します。
[初期状態] を選択します。次に、ボックスに「
initStates」と入力します。[OK] をクリックします。
あるいは、関数 set_param を使用して、LoadInitialState パラメーターおよび InitialState パラメーターを構成します。
set_param(mdl,"LoadInitialState","on","InitialState","initStates")
モデルのシミュレーションを実行します。
out = sim(mdl);
両方の Integrator ブロックの出力信号を表示するには、Scope ブロックをダブルクリックします。Integrator ブロックの初期出力値は、初期状態値です。両方の Integrator ブロックで、初期出力値と初期状態値は共に 2 です。
x2 という名前の Integrator ブロックでは、初期状態値 2 が [初期状態] パラメーターの値から取得されます。x1 という名前の Integrator ブロックでは、初期状態値 2 がブロック パラメーターで指定されています。
blk = strcat(mdl,"/x1"); get_param(blk,"InitialCondition")
ans = '2'
入力引数
出力引数
バージョン履歴
R2006b で導入
