メインコンテンツ

setPreSimFcn

Simulink.SimulationInput オブジェクトで各シミュレーションを開始する前に実行する MATLAB 関数を指定する

説明

simIn = setPreSimFcn(simIn,func) は、各シミュレーションの開始前に、関数ハンドル func に関連付けられたコールバック関数を登録します。この関数には Simulink.SimulationInput オブジェクトが引数として渡されます。func は任意の MATLAB® 関数であり、Simulink.SimulationInput オブジェクトを変更するために使用できます。func を使用して Simulink.SimulationInput オブジェクトを変更した場合は、Simulink.SimulationInput オブジェクトを唯一の出力引数として返す必要があります。

入力引数

すべて折りたたむ

シミュレーション入力とコンフィギュレーション。Simulink.SimulationInput オブジェクトとして指定します。

各シミュレーションの前に実行する関数。関数ハンドルまたは関数名として指定します。setPreSimFcn は、x 引数の形式で Simulink.SimulationInput オブジェクトを渡します。func の値は、シミュレーションで使用するために Simulink.SimulationInput オブジェクトである必要があります。以下に例を示します。

simIn = setPreSimFcn(simIn,@myPreSim)
この例では、myPreSim は MATLAB 関数です。
% The function can change the contents of the simulation input before parsim runs the simulation.
function newSimIn = myPreSim(simIn); 
    % Start by preserving the information already in the simulation input.  
    newSimIn = simIn; 
    % Add a new model parameter to your simulation input in the preSimFcn.
    newSimIn = newSimIn.setModelParameter("myParameter","StopTime","10"); 
end

追加の入力を使用して、プリシミュレーション関数も関数ハンドルとして指定できます。

% The function can change the contents of the simulation input before parsim runs the simulation.
function newSimIn = myPreSim_additionalArgs(simIn,additionalArg1,additionalArg2) 
    % Start by preserving the information already in the simulation input.
    newSimIn = simIn;
    % Add a new model parameter to simIn as an additional argument.
    newSimIn = newSimIn.setModelParameter("StopTime",additionalArg1); 
end

出力引数

すべて折りたたむ

プリシミュレーション関数が追加されたシミュレーションのコンフィギュレーション。Simulink.SimulationInput オブジェクトとして返されます。

バージョン履歴

R2017a で導入