このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

Simulink.SimulationInput

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

説明

Simulink.SimulationInput オブジェクトを使用して、モデルを変更し、その変更した状態でシミュレーションを実行できます。これらの変更は、モデルに一時的に適用されます。Simulink.SimulationInput オブジェクトを使用して、初期状態、モデル パラメーター、ブロック パラメーター、外部入力、および変数を変更できます。Simulink.SimulationInput オブジェクトにより、関数 setPreSimFcn と setPostSimFcn を使用して、各シミュレーションの開始時と終了時に MATLAB^® 関数が実行されるように指定することもできます。

作成

simIn = Simulink.SimulationInput('ModelName') は、与えられたモデルの Simulink.SimulationInput を作成します。その後、Simulink.SimulationInput オブジェクトに対して下記の関数を使用してシミュレーション パラメーターを変更し、モデルをシミュレートできます。

プロパティ

ModelName — モデルの名前

文字ベクトル

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

InitialState — 初期状態

Simulink.op.ModelOperatingPoint オブジェクト

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

ExternalInput — 外部入力

Simulink.SimulationData.Dataset オブジェクト | timeseries オブジェクト | 数値配列

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

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

Simulink.Simulation.BlockParameter オブジェクトの配列

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

Variables — 変数

Simulink.Simulation.Variable オブジェクトの配列

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

ModelParameters — モデル パラメーター

Simulink.Simulation.ModelParameter オブジェクトの配列

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

PreSimFcn — プリシミュレーション関数

MATLAB 関数

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

PostSimFcn — ポスト シミュレーション関数

MATLAB 関数

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

UserString — ユーザー文字列

文字配列 | string

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

オブジェクト関数

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

例

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

SimulationInput オブジェクトを作成します。

モデルを開きます。

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

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

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

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

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

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

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

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

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

モデルを開きます。

openExample("simulink_general/sldemo_househeatExample") 

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

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

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

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

モデルをシミュレートします。

out = sim(simIn);

Simulink.SimulationInput オブジェクトで Dataset を外部入力として使用

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

モデルを開きます。

mdl = 'sldemo_mdlref_counter';
open_system(mdl);

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

t = (0:0.01:10)';
ds = Simulink.SimulationData.Dataset;
ds = setElement(ds,1,timeseries(5*ones(size(t)),t));
ds = setElement(ds,2,timeseries(10*sin(t),t));
ds = setElement(ds,3,timeseries(-5*ones(size(t)),t));

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

simIn = Simulink.SimulationInput('sldemo_mdlref_counter');
simIn = setExternalInput(simIn,ds);

モデルをシミュレートします。

out = parsim(simIn);

バージョン履歴

R2017a で導入

参考

関数

• sim | parsim | batchsim

ツール

• シミュレーション マネージャー

オブジェクト

• Simulink.SimulationOutput

トピック

• Running Multiple Simulations
• 家の熱モデルの parsim を使用した並列シミュレーションの実行