モデルコールバック

モデルのコールバックは、モデルを読み込んだ後や保存した後など、指定したアクションポイントで実行されます。

同じコールバックのほとんどをライブラリに対して設定できます。ライブラリに設定できるのはライブラリに対して実行できるコールバックだけです。たとえば、ライブラリはシミュレーションできないため、シミュレーションの一部として呼び出される InitFcn コールバックはライブラリに対しては設定できません。

モデルのコールバックの作成

Simulink^® エディターで、プロパティインスペクターを開きます。[モデル化] タブの [設計] で [プロパティインスペクター] をクリックします。
モデルの最上位階層で何も選択せずに、[プロパティ] タブの [コールバック] セクションに設定するコールバックを選択します。
ボックス内に、コールバックで実行する関数を入力します。

プログラムによりモデルのコールバックを作成するには、関数 set_param を使用して、MATLAB^® コードをモデルコールバックパラメーターに割り当てます。モデルのコールバックパラメーターを参照してください。

参照モデルのコールバック

モデルの階層構造では、コールバックの実行は、最上位モデルとその参照モデルでそれぞれのコールバックが実行される順序が反映されます。たとえば、以下を仮定します。

モデル A:
- アクセラレータモードでモデル B を参照する。
- MATLAB ワークスペース内に変数を作成する PostLoadFcn コールバックが設定されている。
- [リビルド] コンフィギュレーションパラメーターが [常に行う]、[任意の変更を検出] または [既知の依存関係で任意の変更が検出された場合] に設定されている。
モデル B:
- MATLAB ワークスペースをクリアする CloseFcn コールバックが設定されている。
- ビルドされていない、または期限が切れている。

モデル A のシミュレーションによって、参照モデル B のリビルドがトリガーされます。Simulink がモデル B をリビルドするときに、モデル B を開閉して、モデル B の CloseFcn コールバックを呼び出します。モデル A OpenFcn コールバックによって作成された変数を含む、MATLAB ワークスペースを CloseFcn がクリアします。

モデル B の CloseFcn コールバックを使用する代わりに、モデル A の StopFcn コールバックを使用して、モデルによって使用される変数を MATLAB ワークスペースからクリアすることも可能です。または、データのデータディクショナリを使用して、ベースワークスペース内に変数を含める必要性をなくすことができます。

同じモデルの複数のインスタンスをノーマルモードで参照している場合、各インスタンスでコールバックが実行されます。

アクセラレータモードで参照されるモデルについては、Simulink は一部のコールバックを実行しません。すべてが最新の状態で、[リビルド] コンフィギュレーションパラメーターが [既知の依存関係で任意の変更が検出された場合] に設定されている場合、参照モデルはコンパイルされず、その InitFcn コールバックは実行されません。アクセラレータモードの参照モデルは、参照モデルの代わりに開始および停止する S-Function を使用するため、StartFcn や StopFcn などのコールバックは実行されません。

メモ

シミュレーション出力は、コマンドラインシミュレーションの StopFcn コールバックでは使用できません。

モデルの構造を編集するモデル InitFcn コールバックは避けなければなりません。Simulink はモデルの読み込みステータスに基づいて実行または無視する可能性があります。

モデルのコールバックパラメーター

モデルを読み込むまたは閉じるコールバックパラメーター

モデルのコールバックパラメーターいつ実行されるか

モデルのコールバックパラメーター	いつ実行されるか
`PreLoadFcn`	このコールバックは、モデルが読み込まれる前に実行されます。パラメーターは、モデルを読み込んだ後に読み込まれるため、`PreLoadFcn` モデルコールバック内ではモデルパラメーターを使用しないでください。その代わりに、`PostLoadFcn` コールバックを使用して、モデル読み込み時にモデルパラメーターを操作してください。このパラメーターに対するコールバックコードの定義は、モデルで使用される変数を読み込む際に役立ちます。モデルを開かずに、MATLAB ファイルからモデルを呼び出す場合、`load_system` 関数を使用して、`PreLoadFcn` が実行されるようにします。以下の例を参照してください。モデルを開く際の変数の読み込みモデル参照によるデータ管理の紹介参照モデルに対するシミュレーションターゲットの管理次のような制限があります。 `PreLoadFcn` コールバックでは、モデルがまだ読み込まれていないため、`get_param` は、モデルパラメーター値を返しません。代わりに、`get_param` は以下を返します。 `solver` などの標準的なモデルパラメーターの場合は、既定値 `add_param` が追加されているモデルパラメーターの場合は、エラーメッセージプログラムで Scope にアクセスすることはサポートされていません。
`PostLoadFcn`	モデルを読み込んだ後。このパラメーターに対するコールバックコードの定義は、読み込まれたモデルを必要とするインターフェイスを生成する際に役立ちます。次のような制限があります。 `PostLoadFcn` で構造的な変更を行うと、関数はモデルに未保存の変更があることを示す `Dirty` (変更未保存) フラグを設定しません。モデルを閉じたときに、Simulink が保存を求めることはありません。プログラムで Scope にアクセスすることはサポートされていません。 Simulink エディターはこのコールバックの実行後に開くため、`PostLoadFcn` コールバックはズーム倍率の設定などのモデルビューの設定に適していません。モデルにズーム情報を保存し、特定のズーム倍率でモデルを開きます。
`CloseFcn`	ブロック線図を閉じる前。モデルのブロックに設定されている `ModelCloseFcn` コールバックと `DeleteFcn` コールバックは、モデルの `CloseFcn` コールバックの前に呼び出されます。モデルのブロックの `DestroyFcn` コールバックは、モデルの `CloseFcn` コールブロックの後に呼び出されます。

PreLoadFcn

このコールバックは、モデルが読み込まれる前に実行されます。

パラメーターは、モデルを読み込んだ後に読み込まれるため、PreLoadFcn モデルコールバック内ではモデルパラメーターを使用しないでください。その代わりに、PostLoadFcn コールバックを使用して、モデル読み込み時にモデルパラメーターを操作してください。

このパラメーターに対するコールバックコードの定義は、モデルで使用される変数を読み込む際に役立ちます。

モデルを開かずに、MATLAB ファイルからモデルを呼び出す場合、load_system 関数を使用して、PreLoadFcn が実行されるようにします。

以下の例を参照してください。

次のような制限があります。

PreLoadFcn コールバックでは、モデルがまだ読み込まれていないため、get_param は、モデルパラメーター値を返しません。代わりに、get_param は以下を返します。
- solver などの標準的なモデルパラメーターの場合は、既定値
- add_param が追加されているモデルパラメーターの場合は、エラーメッセージ
プログラムで Scope にアクセスすることはサポートされていません。

PostLoadFcn

モデルを読み込んだ後。

このパラメーターに対するコールバックコードの定義は、読み込まれたモデルを必要とするインターフェイスを生成する際に役立ちます。

次のような制限があります。

PostLoadFcn で構造的な変更を行うと、関数はモデルに未保存の変更があることを示す Dirty (変更未保存) フラグを設定しません。モデルを閉じたときに、Simulink が保存を求めることはありません。
プログラムで Scope にアクセスすることはサポートされていません。

Simulink エディターはこのコールバックの実行後に開くため、PostLoadFcn コールバックはズーム倍率の設定などのモデルビューの設定に適していません。モデルにズーム情報を保存し、特定のズーム倍率でモデルを開きます。

CloseFcn

ブロック線図を閉じる前。

モデルのブロックに設定されている ModelCloseFcn コールバックと DeleteFcn コールバックは、モデルの CloseFcn コールバックの前に呼び出されます。モデルのブロックの DestroyFcn コールバックは、モデルの CloseFcn コールブロックの後に呼び出されます。

モデルを保存するコールバックパラメーター

モデルのコールバックパラメーター	いつ実行されるか
`PreSaveFcn`	モデルを保存する前。
`PostSaveFcn`	モデルを保存した後。メモ `PostSaveFcn` で構造的な変更を行うと、関数はモデルに未保存の変更があることを示す `Dirty` (変更未保存) フラグを設定しません。モデルを閉じたときに、Simulink が保存を求めることはありません。

モデルシミュレーションのコールバックパラメーター

モデルのコールバックパラメーター	いつ実行されるか
`InitFcn`	ブロックパラメーターが評価される前の更新フェーズ中に呼び出される。モデルの更新中およびシミュレーション中に呼び出されます。`InitFcn` コールバックの詳細については、初期化関数を参照してください。以下の例を参照してください。プログラムによるハイパーリンクの作成 MATLAB コードを使用したオブジェクトの追跡
`StartFcn`	シミュレーションフェーズの前に呼び出される。モデルの更新中には呼び出されません。
`PauseFcn`	シミュレーションの一時停止時。
`ContinueFcn`	シミュレーションを継続する前。
`StopFcn`	シミュレーションの終了時。出力は、`StopFcn` が実行される前にワークスペースの変数とファイルに書き込まれます。シミュレーション出力は、コマンドラインシミュレーションの `StopFcn` コールバックでは使用できません。