エントリポイント関数の入力のプロパティの指定
入力プロパティを指定しなければならない理由
Fixed-Point Designer™ は MATLAB® ファイル内のすべての変数のプロパティをコンパイル時に判別しなければなりません。MATLAB ファイル内の変数のプロパティを推定するために、Fixed-Point Designer は、"基本" 関数 ("最上位" 関数または "エントリポイント" 関数としても知られる) への入力のプロパティを特定できなければなりません。そのため、基本関数に入力がある場合は、これらの入力のプロパティを Fixed-Point Designer に指定しなければなりません。基本関数が入力パラメーターをもたない場合は、Fixed-Point Designer では MATLAB ファイルを修正せずにコンパイルできます。基本関数から呼び出されるローカル関数または外部関数に対する入力のプロパティは指定する必要はありません。
メモ
基本関数を MATLAB 名前空間内に含めることはできません。名前空間外にラッパー関数を基本関数として作成します。新しい関数内で目的の関数を基本関数として呼び出します。
入力の型の指定方法
| 方法 | 長所 | 短所 |
|---|---|---|
Define Input Properties at the Command Line メモ MATLAB コード内で
|
|
|
|
|
指定するプロパティ
基本関数が入力をもつ場合は、入力ごとに次のプロパティを指定しなければなりません。
| 対象 | 指定するプロパティ | ||||
|---|---|---|---|---|---|
| クラス | サイズ | 実数/複素数 | numerictype | fimath | |
| 固定小数点入力 |
|
|
|
|
|
| 構造体の入力の各フィールド | |||||
| その他の入力 |
|
|
| ||
既定のプロパティ値
Fixed-Point Designer では基本関数入力のプロパティに対して次の既定値が割り当てられます。
| プロパティ | 既定値 |
|---|---|
| クラス | double |
| サイズ | scalar |
| 実数/複素数 | real |
numerictype | 既定値なし |
fimath | MATLAB 既定の fimath オブジェクト |
サポートされているクラス
以下の表に Fixed-Point Designer でサポートされているクラス名を示します。
| クラス名 | 説明 |
|---|---|
logical | 真および偽の値の論理配列 |
char | 文字配列 |
int8 | 8 ビット符号付き整数配列 |
uint8 | 8 ビット符号なしの整数配列 |
int16 | 16 ビット符号付き整数配列 |
uint16 | 16 ビット符号なしの整数配列 |
int32 | 32 ビット符号付き整数配列 |
uint32 | 32 ビット符号なしの整数配列 |
int64 | 64 ビット符号付き整数配列 |
uint64 | 64 ビット符号なしの整数配列 |
single | 単精度浮動小数点または固定小数点の数値配列 |
double | 倍精度浮動小数点または固定小数点の数値配列 |
struct | 構造体配列 |
embedded.fi | 固定小数点の数値配列 |
基本入力のプロパティの指定規則
基本入力のプロパティを指定するときは次の規則に従います。
cell 配列内の要素の順序は、基本関数シグネチャ内での入力の出現順に対応していなければなりません。たとえば、cell 配列内の最初の要素は、最初の基本関数入力のプロパティを定義します。
MATLAB 関数内で発生する引数よりも少ない数の引数を生成するには、生成された関数で使用する引数の数に対してのみプロパティを指定します。
MATLAB 関数に入力引数がある場合、入力引数をもたない関数を生成するには、空の cell 配列を
-argsに渡します。クラスが固定小数点 (
fi) である基本関数入力ごとに、入力のnumerictypeとfimathプロパティを指定します。クラスが
structである基本関数入力ごとに、その各フィールドのプロパティを、構造体定義内での出現順に指定します。特定の形状の空配列を受け入れる MEX、SIL、または PIL 関数を生成した場合、生成された関数は他の形状の空配列も受け入れます。MEX、SIL、または PIL 関数は、コード生成時に指定された配列の形状と一致するように、空の実行時の入力配列の形状を変更します。
