カスタムブロックの機能の比較

カスタムブロックを作成する場合、次のことを考慮してください。

そのブロックが連続または離散の状態動作をモデル化するか。
シミュレーションの性能は重要か。
カスタムブロックを含むモデルのコードを生成する必要があるか。

この表は、各カスタムブロックタイプにおける 3 つの懸念事項への対処を示しています。

モデル化における考慮事項

カスタムブロックタイプ	状態ダイナミクスのモデル化	シミュレーションの性能	コード生成
Interpreted MATLAB Function	なし	高速ではない	サポートなし
Level-2 MATLAB S-Function	あり	高速ではない	TLC ファイルが必要
MATLAB Function	なし	高速	サポートあり、ただし例外あり
MATLAB System	あり	高速	サポートあり、ただし例外あり
S-Function	あり	高速	TLC ファイルまたは非インライン S-Function のサポートが必要
C Caller	なし	高速	サポートあり
C Function	あり	高速	サポートあり
S-Function Builder	あり	高速	サポートあり
Simulink Function	あり	高速	サポートあり
Subsystem	あり	高速	サポートあり
Fcn	なし	非常に高速	サポートあり

カスタムブロックの詳細設計については次を考慮してください。

複数の入力端子と出力端子が必要なカスタムブロックかどうか。
Simulink^® エンジンとやり取りするコールバックメソッドは何か、また、どのカスタムブロックであればそれらコールバックメソッドのすべて、またはサブセットを実装できるようになるか。
Simulink ブロック線図の更新速度に対するカスタムブロックの影響が重要かどうか。

状態動作のモデル化

現在の出力を計算するために以前の出力の一部またはすべてを要求するブロックの、状態動作をモデル化する必要があります。詳細については、状態変数を参照してください。

カスタムブロックタイプ	メモ
Fcn, Interpreted MATLAB Function, C Caller	状態動作をモデル化できない。
MATLAB Function, C Function	`persistent` 変数を使用することで離散状態をモデル化できる。
Level-2 MATLAB^® S-Function	`ContStates` 実行時オブジェクトメソッドまたは `Dwork` 実行時オブジェクトメソッドをブロックコールバックメソッドと組み合わせて使用することで連続状態動作と離散状態動作の両方をモデル化できる。サポートされるメソッドのリストについては、Write Level-2 MATLAB S-FunctionsのLevel-2 MATLAB S-Function Callback Methodsを参照。
MATLAB System	System object™ の`DiscreteState` プロパティをブロックコールバックメソッドと組み合わせて使用することで離散状態動作をモデル化できる。このブロックは System object メソッドを次のコールバックメソッドに対して使用する。`mdlOutputs` (`stepImpl`、`outputImpl`)、`mdlUpdate` (`updateImpl`)、`mdlInitializeConditions` (`resetImpl`)、`mdlStart` (`setupImpl`)、`mdlTerminate` (`releaseImpl`)。詳細については、System object とはを参照。
C MEX S-Function, S-Function Builder	ブロックコールバックメソッドを組み合わせて使用することで連続状態動作と離散状態動作の両方をモデル化できる。詳細については、Callback Methods for C MEX S-Functionsを参照。
Simulink Function	エンジンと直接通信する。連続および離散 Simulink ブロックライブラリにある適切なブロックを使用することで状態動作をモデル化できる。異なる呼び出し元からこの関数が複数回呼び出される場合、状態値はそれらの呼び出しの間でも維持される。詳細については、複数のサイトからの Simulink Function ブロックの呼び出しを参照してください。
Subsystem	エンジンと直接通信する。連続および離散 Simulink ブロックライブラリにある適切なブロックを使用することで状態動作をモデル化できる。

シミュレーションの性能

ほとんどのアプリケーションについて、すべてのカスタムブロックタイプは十分なシミュレーション性能を提供します。実性能の表示を得るには、Simulink プロファイラーを使用してください。詳細については、Simulink プロファイラーによるパフォーマンスデータの取得を参照してください。

性能表示の 2 つのカテゴリは、インターフェイスコストとアルゴリズムコストです。インターフェイスコストは、データを Simulink エンジンからブロックに移動するのに要する時間です。アルゴリズムコストは、ブロックで実装したアルゴリズムを実行するのに要する時間です。

カスタムブロックタイプ	メモ
Fcn	シミュレーションの性能が最も優れています。このブロックは Simulink エンジンと緊密に統合されており、シミュレーションとコード生成用に最適化されています。
Interpreted MATLAB Function	インターフェイスの関係で、性能はやや低速ながら、MATLAB 関数と同じアルゴリズムコストになります。ブロックデータ (入力や出力など) が Interpreted MATLAB Function ブロックとの間でやり取りされるとき、Simulink エンジンはこのデータを MATLAB 配列にパッケージ化します。このパッケージ化には時間がかかり、通信時に一時的にメモリ要求が増加します。このインターフェイスでフレームや配列のような大量のデータをやり取りすると、性能がかなり低速になることがあります。データが変換された後は、MATLAB 実行エンジンがアルゴリズムを実行します。その結果、アルゴリズムコストは MATLAB 関数と同じになります。
Level-2 MATLAB S-Function	Interpreted MATLAB Function ブロックと同じアルゴリズムコストが発生しますが、インターフェイスコストはわずかながら高くなります。MATLAB S-Function は複数の入力と出力を扱うので、Interpreted MATLAB Function ブロックよりパッケージが複雑です。さらに、Simulink エンジンは実装したブロックメソッドごとに MATLAB 実行エンジンを呼び出しますが、Interpreted MATLAB Function ブロックは `Outputs` メソッドに対してのみ MATLAB 実行エンジンを呼び出します。
MATLAB Function	コードを生成してシミュレーションを実行するので、コストは他の Simulink 組み込みブロックと同じになります。このブロックのアルゴリズムコストの解析は、ブロックの実装方法のせいで難しくなっています。平均すると、このブロックの関数と MATLAB 関数はほぼ同じ速度で実行されます。 MATLAB 実行エンジンを呼び出すために `coder.extrinsic` を使用するコードが MATLAB Function ブロックにある場合、MATLAB S-Function または Interpreted MATLAB Function ブロックで発生するすべてのコストが発生します。MATLAB 実行エンジンが MATLAB Function ブロックから呼び出されると、意図しない実行を避けるために、確認の警告が出ます。アルゴリズムコストを削減するには、すべての MATLAB Function ブロックのデバッグを無効にします。
MATLAB System	インタープリター型実行モードでは、モデルが MATLAB 実行エンジンを使用してブロックをシミュレートするため、性能は Level-2 MATLAB S-function に類似します。コード生成モードでは、モデルが生成コードを使用してブロックをシミュレートするため、性能は MATLAB Function に類似します。詳細については、この表の MATLAB Function の項目を参照してください。
C Caller, C Function	モデルを初めてシミュレートするときは、カスタムコードの解析とビルドが原因で、実行速度が遅くなる可能性があります。最初のコンパイル後にシミュレーションを高速化するには、[コンフィギュレーションパラメーター] から、コンパイルを高速化するために [Faster Builds] を選択し、シミュレーションを高速化するために [Faster Runs] を選択します。
C MEX S-Function	コンパイルされたコードを使ってシミュレーションを実行するので、コストは Simulink 組み込みブロックと同じになります。アルゴリズムコストは S-Function の複雑度によって異なります。
S-Function Builder	このブロックは指定した仕様と C コードのみから S-Function をビルドします。モデルで生成された S-Function のラッパーとしてこのブロックを使用することもできます。C MEX S-Function と比較すると、このブロックのアルゴリズムコストはラッパーからのみ発生します。
Simulink Function、Subsystem	ライブラリに含まれている場合、ブロックが通常のサブシステムとしてモデル内に存在する場合に比べて、インターフェイスやアルゴリズムの追加コストは発生しません。性能は、サブシステム内で実行されるアルゴリズムの複雑度に比例します。サブシステムがライブラリの中にある場合、オーバーヘッドはブロック線図がはじめて更新されるときやシミュレーションの準備をするときに、まだ読み込まれていないライブラリを Simulink が読み込むときに発生します。参照されているすべてのライブラリブロックが変更されていない場合、Simulink はその後ライブラリを再読み込みしません。モデルがライブラリを使用しなかった場合よりも、モデルのコンパイルは速くなります。

コード生成

モデルがより大きなシステムの一部である場合、コード生成が必要です。カスタムブロックタイプの中には Simulink Coder™ でコード生成をサポートしないものがあります。

カスタムブロックタイプ	メモ
Fcn	コード生成をサポートします。
Interpreted MATLAB Function	コード生成をサポートしない。
C Caller, C Function	コード生成をサポートします。
Level-2 MATLAB S-Function	Target Language Compiler (TLC) 関数を使って実装されたアルゴリズムに対してのみコードを生成します。アクセラレータモードとエクスターナルモードのシミュレーションでは、アルゴリズムを TLC で実装することなく S-Function を MATLAB 実行エンジンを呼び返してインタープリターで実行するようにできます。MATLAB S-Function が `SimViewingDevice` である場合、Simulink Coder 製品はコード生成時に自動的にそのブロックを除外します。
MATLAB Function, MATLAB System	コード生成をサポートします。ただし、ブロックが MATLAB 実行エンジンを呼び出す場合、MATLAB 実行エンジンの呼び出しがブロックの出力に影響しない場合にのみ、ビルドに Simulink Coder 製品が使用されます。この条件下では、Simulink Coder 製品は生成された C コードからこれらの呼び出しを除外します。この機能によって、組み込みコードを生成する場合でも可視化コードをそのまま残すことができます。
C MEX S-Function, S-Function Builder	いずれもコード生成をサポートします。インラインでない S-Function のコード生成では、Simulink Coder 製品は C MEX 関数を使用。 C MEX S-Function の場合には、インライン化された S-Function が必要な場合や、手書きコードのラッパーを作成する必要がある場合は、S-Function の TLC ファイルを記述しなければならない。 S-Function Builder の場合には、[ラッパー TLC の生成] オプションを選択して自動的に TLC ファイルを生成できる。詳細については、S-Function とコード生成 (Simulink Coder)を参照してください。
Simulink Function	コード生成をサポートします。
Subsystem	サブシステムに含まれるブロックがコード生成をサポートする限り、コード生成をサポートします。詳細については、サブシステム (Simulink Coder)を参照してください。

複数の入力端子と出力端子

次のタイプのカスタムブロックでは、複数の入力端子と出力端子がサポートされます。

カスタムブロックタイプ	メモ
Fcn, Interpreted MATLAB Function	サポートされる入力端子と出力端子はそれぞれ 1 つのみ。
MATLAB Function	バスを含む、複数の入力端子と出力端子をサポート。詳細については、MATLAB Function ブロック内での構造体の作成およびMATLAB Function ブロックへのバスの付加を参照してください。
MATLAB System	バスを含む、複数の入力端子と出力端子をサポート。さらに、`getNumInputs` メソッドおよび `getNumOutputs` メソッドを使用して、System object のプロパティに基づいて入力端子と出力端子の数を変更できる。
C Caller, C Function	バスを含む、複数の入力端子と出力端子をサポート。
Level-2 MATLAB S-Function、C MEX S-Function、S-Function Builder	複数の入力端子と出力端子をサポート。さらに、ユーザー定義のパラメーターに基づいて入力端子と出力端子の数を変更できる。C MEX S-Function および S-Function Builder はバスをサポートしている。
Simulink Function	バスを含む、複数の入力端子と出力端子をサポート。
サブシステム	バスを含む、複数の入力端子と出力端子をサポート。さらに、ユーザー定義のパラメーターに基づいて入力端子と出力端子の数を変更できる。詳細については、自己修正可能なリンク付きサブシステムを参照してください。

Simulink ブロック線図の更新速度

Simulink は毎回のシミュレーションの前と、ユーザーに要求されたときにブロック線図を更新します。ブロックごとに、ブロック線図の更新プロセスで何らかのオーバーヘッドが発生します。

カスタムブロックタイプ	メモ
Fcn, Interpreted MATLAB Function	ブロック線図の更新コストは低コストです。
MATLAB Function, C Caller, C Function	コードの生成を通してシミュレーションを行います。したがって、ブロックがはじめて更新されるときはかなり時間がかかる場合があります。コードの生成はインクリメンタルなので、ブロックとそれに接続する信号が変更されていないときは、Simulink はブロックを繰り返し更新しません。
MATLAB System	ブロック線図の更新でコードを生成しないため、MATLAB Function より高速。コードの生成はインクリメンタルなので、ブロックとそれに接続する信号が変更されていないときは、Simulink はブロックを繰り返し更新しません。
C MEX S-Function、Level-2 MATLAB S-Function	ブロック線図の更新で実行されるメソッドをオーバーライドするときにのみ、他の Simulink ブロックより大きなオーバーヘッドが発生します。メソッドが複雑になると、ブロック線図を更新する時間が目に見えて長くなります。ブロック線図を更新するときに実行されるメソッドのリストは、Simulink Engine Interaction with C S-Functionsのプロセスの図解を参照してください。ブロック線図を更新するとき、モデルの初期化の段階で Simulink は mdlStart までのすべての関連メソッドを呼び出しますが、`mdlStart` はその中に含まれません。
Simulink Function、Subsystem	速度は、サブシステム内で実行されるアルゴリズムの複雑度に比例します。サブシステムがライブラリの中にある場合、オーバーヘッドはブロック線図がはじめて更新されるときやシミュレーションの準備をするときに、まだ読み込まれていないライブラリを Simulink が読み込むときに発生します。参照されているすべてのライブラリブロックが変更されていない場合、Simulink はその後ライブラリを再読み込みしません。モデルがライブラリを使用しない場合よりも、モデルのコンパイルは速くなります。

コールバックメソッド

Simulink ブロックは、(Simulink Function ブロックを除く) ブロックの動作を完全に指定するブロックコールバックメソッドを介して Simulink エンジンと通信します。各カスタムブロックタイプに異なるセットのコールバックメソッドを実装できます。ブロックが Simulink エンジンとやり取りする方法については、Simulink Engine Interaction with C S-Functionsを参照してください。この表ではS-Function Callback Methodsの名前を同等と見なして使用します。

カスタムブロックタイプ	メモ
Fcn, Interpreted MATLAB Function, MATLAB Function, C Caller	いずれも、入力された値から出力値を計算するために `mdlOutputs` メソッドを作成する。これらのブロックの 1 つを使って他のコールバックメソッドを実装することはできないため、状態動作をモデル化できない。
C Function	start、output、および terminate コールバックメソッドの実装を許可します。永続データを使用した離散状態のモデル化を許可します。
Level-2 MATLAB S-Function	コールバックメソッドのより大きなサブセットを実装でき、それには連続状態および離散状態のモデル化に使用できるメソッドが含まれる。サポートされるメソッドのリストについては、Write Level-2 MATLAB S-FunctionsのLevel-2 MATLAB S-Function Callback Methodsを参照。
MATLAB System	System object メソッドを次のコールバックメソッドに対して使用する。`mdlOutputs` (`stepImpl`、`outputImpl`)、`mdlUpdate` (`updateImpl`)、`mdlInitializeConditions` (`resetImpl`)、`mdlStart` (`setupImpl`)、`mdlTerminate` (`releaseImpl`)。詳細については、Simulink エンジンと System object メソッドとの相互作用を参照。
C MEX S-Function	コールバックメソッドの完全なセットを実装できる。
S-Function Builder	`mdlOutputs`、`mdlDerivatives`、および `mdlUpdate` を実装できる。
Simulink Function	スタンドアロンの関数としてパッケージ化される。この関数の呼び出し元はすべて、呼び出し元の場所に基づくコールバックメソッドのいずれかの一部になる。
Subsystem	エンジンと直接通信する。連続および離散 Simulink ブロックライブラリにある適切なブロックを使用することで状態動作をモデル化できる。

MATLAB S-Function とコード生成用 MATLAB 関数の比較

MATLAB S-Function とコード生成用の MATLAB 関数には根本的な違いがあります。

Simulink Coder 製品は MATLAB S-Function とコード生成用 MATLAB 関数の両方のコードを生成できます。ただし、MATLAB S-Function にはコード生成にターゲット言語のコンパイラ (TLC) ファイルが必要ですが、コード生成用 MATLAB 関数には必要ありません。
MATLAB S-Function は任意の MATLAB 関数を使用できますが、コード生成用 MATLAB 関数は MATLAB 言語のサブセットです。サポートされているコード生成用の関数のリストについては、C/C++ コードの生成でサポートされている関数およびオブジェクトを参照してください。
MATLAB S-Function は離散状態と連続状態のダイナミクスをモデル化できますが、コード生成用 MATLAB 関数は状態ダイナミクスをモデル化できません。

カスタムブロックの機能拡張

コールバックと MATLAB グラフィックスを使ってカスタムブロックの機能を拡張できます。

ブロックのコールバックは、シミュレーションの特定の時点でユーザー定義の動作を実行します。たとえば、コールバックはシミュレーションの前にデータを MATLAB ワークスペースに読み込んだり、シミュレーションの終わりにシミュレーションデータのグラフを生成したりできます。ブロックコールバックはどのカスタムブロックタイプでも使用できます。使用できるコールバックの一覧と使用方法の詳細については、ブロックのコールバックを参照してください。

App Designer (MATLAB のグラフィカルユーザーインターフェイス開発環境) はカスタムユーザーインターフェイスを手軽に作成するツールを提供します。App Designer の使用方法の詳細については、アプリの作成を参照してください。