ドキュメンテーション

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

Simulink.SimulationInput クラス

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

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

説明

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

  • 初期状態

  • モデル パラメーター

  • ブロック パラメーター

  • 外部入力

  • 変数

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

構築

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

入力引数

すべて展開する

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

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

プロパティ

すべて展開する

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

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

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

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

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

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

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

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

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

メソッド

メソッド

目的

setModelParameter

SimulationInput オブジェクトによって、特定のシミュレーションに使用するモデル パラメーターを設定

setBlockParameter

SimulationInput オブジェクトを使用して特定のシミュレーションに使用されるブロック パラメーターを設定

setInitialState

SimulationInput オブジェクトを使用して特定のシミュレーションに使用する初期状態を設定

setExternalInput

SimulationInput オブジェクトを使用してシミュレーションに外部入力を設定

setVariable

SimulationInput オブジェクトを使用してシミュレーションの変数を設定

setPreSimFcn

SimulationInput オブジェクトを使用して、各シミュレーションの開始前に MATLAB 関数が実行されるように指定します。

setPostSimFcn

SimulationInput オブジェクトを使用して、シミュレーションが完了するたびに MATLAB 関数が実行されるように指定します。

applyToModel

SimulationInput オブジェクトを使用して指定されたモデルに変更を適用

validate

SimulationInput オブジェクトの内容を検証

loadVariablesFromMATFile

MAT ファイルから Simulink.SimulationInput オブジェクトに変数を読み込む

すべて折りたたむ

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

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

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

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

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

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

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

モデルを開きます。

mdl = 'sldemo_househeat';
open_system(mdl);

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

in = Simulink.SimulationInput(mdl);

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

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

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

out = sim(in)

この例では、データセットを使用して、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)

R2017a で導入