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

Simulink.SimulationInput クラス

パッケージ: Simulink
スーパークラス:

複数または個々のシミュレーション用にモデルを変更する SimulationInput オブジェクトを作成

説明

Simulink.SimulationInput オブジェクトを使用して、モデルを変更し、その変更した状態でシミュレーションを実行できます。これらの変更は、モデルに一時的に適用されます。Simulink.SimulationInput オブジェクトを使って、次を変更できます。

• 初期状態

• モデル パラメーター

• ブロック パラメーター

• 外部入力

• 変数

Simulink.SimulationInput オブジェクトにより、in.setPreSimFcn と in.setPostSimFcn をそれぞれ使用して、各シミュレーションの開始時と終了時に MATLAB^® 関数が実行されるように指定することもできます。Simulink.SimulationInput は、モデル参照が独自のデータ ディクショナリをもつことができる機能をサポートしていません。

構築

in = Simulink.SimulationInput('modelName') は、モデルの SimulationInput オブジェクトを作成します。

入力引数

modelName — モデルの名前

文字ベクトル

モデルの名前を引数として渡して Simulink.SimulationInput オブジェクトを作成します。

例: in = Simulink.SimulationInput('cstr')

プロパティ

ModelName — モデルの名前

文字ベクトル

SimulationInput オブジェクトが作成されるモデルの名前。

InitialState — 初期状態

Simulink.op.ModelOperatingPoint オブジェクト

Simulink.op.ModelOperatingPoint オブジェクトとして指定されるシミュレーションのモデルの初期状態。

ExternalInput — 外部入力

数値配列、Dataset オブジェクト、timeseries、文字配列

シミュレーションのモデルに追加される外部入力。

BlockParameters — ブロック パラメーター

Simulink.Simulation.BlockParameter の配列

変更されるモデルのブロック パラメーター。

Variables — 変数

Simulink.Simulation.Variable の配列

変更されるモデルの変数。

ModelParameters — モデル パラメーター

Simulink.Simulation.ModelParameter の配列

変更されるモデルのモデル パラメーター。

PreSimFcn — 関数

MATLAB 関数

シミュレーションの開始前に実行する MATLAB 関数。

PostSimFcn — 関数

MATLAB 関数

シミュレーション後に実行する MATLAB 関数。

UserString — ユーザー文字列

文字配列

シミュレーションの簡単な説明。文字配列として指定します。

メソッド

メソッド	目的
setModelParameter	SimulationInput オブジェクトによって、特定のシミュレーションに使用するモデル パラメーターを設定
setBlockParameter	SimulationInput オブジェクトを使用して特定のシミュレーションに使用されるブロック パラメーターを設定
setInitialState	SimulationInput オブジェクトを使用して特定のシミュレーションに使用する初期状態を設定
setExternalInput	SimulationInput オブジェクトを使用してシミュレーションに外部入力を設定
setVariable	SimulationInput オブジェクトを使用してシミュレーションの変数を設定
setPreSimFcn	SimulationInput オブジェクトを使用して、各シミュレーションの開始前に MATLAB 関数が実行されるように指定します。
setPostSimFcn	SimulationInput オブジェクトを使用して、シミュレーションが完了するたびに MATLAB 関数が実行されるように指定します。
applyToModel	SimulationInput オブジェクトを使用して指定されたモデルに変更を適用
validate	SimulationInput オブジェクトの内容を検証
loadVariablesFromMATFile	MAT ファイルから Simulink.SimulationInput オブジェクトに変数を読み込む

例

Simulink.SimulationInput オブジェクトの作成

この例では、SimulationInput オブジェクトの作成方法を説明します。

モデルを開きます。

openExample('simulink/OpenTheModelExample');
open_system('ex_sldemo_househeat');
load_system('ex_sldemo_househeat')

1 つのモデルに単一の SimulationInput オブジェクトを作成します。

model = 'ex_sldemo_househeat';
in = Simulink.SimulationInput(model);

Simulink.SimulationInput オブジェクトの配列の作成

この例では、SimulationInput オブジェクトの配列を作成する方法を示します。

for ループを使用して SimulationInput オブジェクトの配列を作成します。

model = 'vdp';
for i = 10:-1:1
   in(i) = Simulink.SimulationInput(model);
end

Simulink.SimulationInput オブジェクトの配列を使用したブロック パラメーターの設定

この例では、SimulationInput オブジェクトを介してモデルのブロック パラメーターを変更します。

モデルを開きます。

openExample('simulink/OpenTheModelExample');
open_system('ex_sldemo_househeat');
load_system('ex_sldemo_househeat')

このモデルの SimulationInput オブジェクトを作成します。

mdl = 'sldemo_househeat';
in = Simulink.SimulationInput(mdl);

ブロック パラメーターを変更します。

in = in.setBlockParameter('sldemo_househeat/Set Point','Value','300');

モデルのシミュレーションを実行します。

out = sim(in)

Simulink.SimulationInput オブジェクトの配列の外部入力としてデータセットを使用

この例では、データセットを使用して、Simulink.SimulationInput オブジェクトに外部入力を設定する方法を説明します。

モデルを開きます。

mdl = 'sldemo_mdlref_counter';
open_system(mdl);

このモデルのための Dataset オブジェクトを作成します。

t = (0:0.01:10)';
ds{1} = timeseries(5*ones(size(t)),t);
ds{2} = timeseries(10*sin(t),t);
ds{3} = timeseries(-5*ones(size(t)),t);

Simulink.SimulationInput オブジェクトを作成し、外部入力を設定します。

in = Simulink.SimulationInput('sldemo_mdlref_counter');
in = in.setExternalInput('ds.getElement(1),ds.getElement(2),ds.getElement(3)');

その他の残りの変数を式に追加します。データセットも SimulationInput オブジェクト上に存在することを確認してください。

モデルのシミュレーションを実行します。

in = in.setVariable('ds',ds);

モデルのシミュレーションを実行します。

out = parsim(in)

参考

Simulation Manager | Simulink.SimulationInput | applyToModel | loadVariablesFromMATFile | parsim | setBlockParameter | setExternalInput | setInitialState | setModelParameter | setPostSimFcn | setPreSimFcn | setVariable | validate

トピック

• 複数のシミュレーションの実行
• parsim を使用した並列シミュレーションの実行

R2017a で導入