MATLAB Function レポート

MATLAB^® 関数を使用する MATLAB Function ブロックまたは Stateflow^® チャートを含む Simulink^® モデルのシミュレート、更新、またはモデルからのコード生成を行うと、Simulink は、モデル内の MATLAB 関数ごとにレポートを生成します。レポートには関数の変数および式の型情報が示されます。この情報は、エラーや警告の発生元を特定するのに役立ちます。

Stateflow では、各 Stateflow チャートに対して、その中の MATLAB 関数の数に関係なく、レポートが 1 つ作成されます。

モデルに同一の MATLAB Function ブロックがある場合、それらの同一ブロックに対して 1 つのレポートが生成されます。

MATLAB Function レポートを開く

MATLAB Function レポートを開くには、次のいずれかの方法を使用します。

MATLAB 関数を開く。[関数] タブで、[関数レポート] をクリックします。
モデルのシミュレーションまたは更新を行う。コンパイルエラーが発生した場合は、[診断ビューアー] ウィンドウで、report リンクを選択します。
MATLAB Function ブロックの場合、ブロックに関連付けられた MATLABFunctionConfiguration オブジェクトで関数 openReport を呼び出す。詳細については、プログラムからの MATLAB Function レポートへのアクセスを参照してください。

メモ

MATLAB Function レポートを最初に開いたときに、Simulink でモデルが自動的に更新されます。その後、ブロックの MATLAB コードに変更を加える場合は、レポートを再度開く前にモデルを更新しなければなりません。更新しない場合、レポートには変更が反映されません。[モデル化] タブで [モデルの更新] を選択するか、Ctrl+D キーボードショートカットを使用します。MATLAB Function ブロックエディターの場合は、代わりに Ctrl+Shift+D キーボードショートカットを使用してモデルを更新します。

MATLAB ソースコードの解析

[MATLAB ソース] ペインの [関数リスト] ビューでは、含まれているファイルで関数が整理されます。呼び出し構造に従って関数を可視化するには、[呼び出しツリー] ビューを使用します。

MATLAB Function レポートは読み取り専用です。関数を編集するには、[MATLAB ソース] ペインで関数の名前を選択し、[エディターで開く] をクリックします。

コードペインで MATLAB 関数を表示するには、[MATLAB ソース] ペインで関数の名前をクリックします。コードペインで、変数または式の上で一時停止すると、ツールヒントに、そのサイズ、型および実数/複素数に関する情報が表示されます。さらに、構文の強調表示は、MATLAB 構文要素と、関数が外部関数であるかどうか、引数が定数であるかどうかといった特定のコード生成属性を識別するのにも役立ちます。

外部関数

レポートは紫色のテキストで外部関数を識別します。ツールヒントは関数が外部関数であることを示しています。

This image shows the report when it identifies the extrinsic function. The extrinsic function is purple.

定数引数

オレンジ色のテキストは、エントリポイント関数または特殊な関数へのコンパイル時の定数引数を示しています。ツールヒントにはその定数値が表示されます。

This image shows the report when it identifies a compile-time costant argument. The constant a is highlighted in orange.

定数引数の値を把握することで、生成された関数シグネチャを理解することができます。また、コード生成で異なる定数引数値をもつ関数の特殊化が作成された場合に確認することもできます。

ワークスペースの変数に値をエクスポートするには、[エクスポート] アイコンをクリックします。

エラーメッセージと警告メッセージの表示

エラーと警告を表示するには、レポートの下部のペインで、[すべてのメッセージ] タブを開きます。エラーまたは警告に関するソースコードを強調表示するには、メッセージをクリックします。最初のメッセージに対処するのが最も効率よいアプローチです。その後のエラーや警告の多くは、最初のメッセージに関連して発生したものです。

MATLAB 変数の表示

選択した MATLAB 関数の変数に関する情報を表示するには、レポートの下部のペインで、[変数] タブを開きます。

変数テーブルには以下の情報が表示されます。

クラス、サイズ、実数/複素数
固定小数点型のプロパティ

この情報は、型の伝播を理解して型の不一致エラーを特定するのに役立ちます。

[変数] タブの視覚的なインジケーター

次の表では、変数テーブルで使用される記号、バッジおよびその他のインジケーターについて説明します。

変数テーブルの列	インジケーター	説明
名前	展開アイコン	変数には、展開アイコンをクリックすることで表示できる要素やプロパティがあります。
名前	`{:}`	同種 cell 配列 (すべての要素のプロパティは同じになります)。
名前	`{n}`	異種混合 cell 配列の `n` 番目の要素。
クラス	`v > n`	`v` は異なるクラス、サイズ、実数/複素数で再利用されます。数値 `n` は、一意のプロパティセットをもつ再利用を特定します。名前が変更された変数で一時停止すると、クラス、サイズおよび実数/複素数を共有するこの変数のインスタンスのみがレポートで強調表示されます。同じ変数を異なるプロパティで再利用するを参照してください。
サイズ	`:n`	上限が `n` の可変サイズの配列。
サイズ	`:?`	上限なしの可変サイズの配列。
サイズ	イタリック	実行中に次元によってサイズが変更されない可変サイズの配列。
クラス	接頭辞 `sparse`	スパース配列。
クラス	接頭辞 `complex`	複素数。
クラス		固定小数点型。固定小数点プロパティを表示するには、バッジをクリックします。