fiaccel

固定小数点コードの高速化と浮動小数点 MATLAB コードの固定小数点 MATLAB コードへの変換

構文

fiaccel -options fcn fiaccel -float2fixed fcn

説明

fiaccel -options fcn では、MATLAB^® ファイル fcn.m が、固定小数点コードを高速化する MEX 関数に変換されます。fiaccel を使用するには、コードが次の要件のいずれかを満たしていなければなりません。

最上位の関数が入力や出力をもたず、コードで fi が使用されている。
最上位の関数が出力または非定数の入力をもち、少なくとも 1 つの出力または入力が fi である。
最上位の関数が組み込み整数クラス (int8、uint8、int16、uint16、int32、uint32、int64 または uint64) を含む入力または出力を少なくとも 1 つもち、コードで fi が使用されている。

メモ

最上位レベルファイルが Unicode 文字を含むパス上にある場合、コード生成はそのファイルを検出できない場合があります。

fiaccel -float2fixed fcn は、浮動小数点 MATLAB 関数 fcn を固定小数点 MATLAB コードに変換します。

入力引数

fcn

MEX 関数を生成する、元の MATLAB 関数。fcn はコード生成に適していなければなりません。コード生成の詳細は、コードの高速化と MATLAB からのコード生成を参照してください。

options

コンパイラオプションの選択肢。fiaccel では、構成オブジェクトを使用して指定されたオプションよりも、個々のコマンドラインオプションが優先されます。コマンドラインオプションが競合する場合は、最も右にあるオプションが優先されます。

`-args` `example_inputs`	サンプル入力値の cell 配列を指定して、MATLAB 関数入力のサイズ、クラスおよび実数/複素数を定義します。cell 配列におけるサンプル入力の位置は、MATLAB 関数定義における入力引数の位置に対応していなければなりません。関数定義よりも入力引数が少ない関数を生成するには、適用しない引数に対するサンプル値を省略します。サンプル入力は、そのサンプル入力を適用する関数の直後に指定します。サンプル値の代わりに、`coder.Type` オブジェクトを指定できます。`coder.Type` オブジェクトを作成するには、`coder.typeof` を使用します。
`-config` `config_object`	`config_object` に基づき、`coder.mexconfig` を使用して MATLAB 変数として定義される、MEX 生成パラメーターを指定します。以下に例を示します。 cfg = coder.mexconfig;
`-d` `out_folder`	生成されたファイルを `out_folder` で指定された絶対パスまたは相対パスに保存します。`out_folder` で指定されたフォルダーが存在しない場合、関数 `fiaccel` はフォルダーを作成します。フォルダーの場所を指定しない場合、`fiaccel` は既定のフォルダー内にファイルを生成します。 fiaccel/mex/fcn. `fcn` はコマンドラインで指定された MATLAB 関数の名前です。フォルダー名にはアスタリスク (`*`)、疑問符 (`?`)、ドル記号 ($) およびシャープ記号 (`#`) は使用できません。
`-float2fixed` `float2fixed_cfg_name`	`float2fixed_cfg_name` という名前の、浮動小数点から固定小数点に変換する構成オブジェクトで指定された設定を使用して、固定小数点 MATLAB コードを生成します。このオプションでは、`fiaccel` はファイルを `codegen/fcn_name/fixpt` フォルダーに生成します。 `float2fixed_cfg_name` の `TestBenchName` プロパティを設定しなければなりません。たとえば、次のようにします。 fixptcfg.TestBenchName = 'myadd_test'; これは、`myadd_test` が浮動小数点から固定小数点への構成オブジェクト `fixptcfg` のテストファイルであることを指定します。このオプションは、`-global` オプションと一緒に使用できません。
`-g`	最適化を無効にして、デバッグモードで MEX 関数をコンパイルします。指定しない場合、`fiaccel` は最適なモードで MEX 関数を生成します。
`-global` `global_values`	MATLAB ファイルのグローバル変数の初期値を指定します。コンパイルする関数でグローバル変数を初期化するために cell 配列 `global_values` 内の値を使用します。cell 配列には各グローバル変数の名前と初期値を指定しなければなりません。関数 `fiaccel` を使用してコンパイルする前にグローバル変数を初期化しなければなりません。`-global` オプションを使用してグローバル変数に初期値を提供しない場合、`fiaccel` は MATLAB グローバルワークスペース内の変数をチェックします。初期値を指定しないと `fiaccel` はエラーを生成します。生成された MEX コードと MATLAB は、それぞれ独自のグローバルデータのコピーをもっています。一貫性を維持するために、これらの 2 つが情報をやり取りするときには必ずそれらのグローバルデータを同期しなければなりません。データを同期しないと、グローバル変数は異なるものになる可能性があります。このオプションは、`-float2fixed` オプションと一緒に使用できません。
`-I` `include_path`	`include_path` をコード生成パスの先頭に追加します。 MATLAB コードを MEX コードに変換する際には、`fiaccel` は "最初に" コード生成パスを検索します。
`-launchreport`	コード生成レポートを生成して開きます。このオプションを指定しないと、`fiaccel` ではエラーメッセージまたは警告メッセージが発生した場合、あるいは `-report` オプションを指定した場合にのみレポートが生成されます。
`-nargout`	生成されたエントリポイント関数で出力引数の数を指定します。コードジェネレーターは指定した数の出力引数を MATLAB 関数定義での発生順に生成します。
`-o` `output_file_name`	`output_file_name` を基本名とし、プラットフォーム固有の拡張子を付けて、MEX 関数を生成します。 `output_file_name` にはファイル名を指定するかまたは既存のパスを含めることができます。出力ファイル名を指定しないと、基本名は `fcn_mex` になります。これによって、元の MATLAB 関数と MEX 関数を実行して、結果を比較できます。
`-O` `optimization_option`	`optimization_option` の値に基づいて、生成される MEX コードを最適化します。 `enable:inline` — 関数インライン化を有効にします。 `disable:inline` — 関数インライン化を無効にします。指定しない場合、`fiaccel` ではインライン化を使用して最適化が行われます。
`-report`	コード生成レポートを生成します。このオプションを指定しないと、`fiaccel` ではエラーメッセージまたは警告メッセージが発生した場合、あるいは `-launchreport` オプションを指定した場合にのみレポートが生成されます。
`-?`	`fiaccel` コマンドのヘルプを表示します。

例

テストファイルを作成し、移動平均を計算します。その後、fiaccel を使用してコードを高速化し、比較を行います。

function avg = test_moving_average(x)
%#codegen
if nargin < 1,
    x = fi(rand(100,1),1,16,15);
end
z = fi(zeros(10,1),1,16,15);
avg = x;
for k = 1:length(x)
    [avg(k),z] = moving_average(x(k),z);
end

function [avg,z] = moving_average(x,z)
%#codegen
if nargin < 2,
    z = fi(zeros(10,1),1,16,15);
end
z(2:end) = z(1:end-1);  	% Update buffer
z(1) = x;	              	% Add new value
avg = mean(z);          % Compute moving average

% Use fiaccel to create a MEX function and 
% accelerate the code
x = fi(rand(100,1),1,16,15);
fiaccel test_moving_average -args {x} -report

% Compare the non-accelerated and accelerated code.
x = fi(rand(100,1),1,16,15);

% Non-compiled version
tic,avg = test_moving_average(x);toc
% Compiled version
tic,avg = test_moving_average_mex(x);toc

浮動小数点 MATLAB コードの固定小数点への変換

coder.FixptConfig オブジェクト fixptcfg を既定の設定で作成します。

fixptcfg = coder.config('fixpt');

テストベンチの名前を設定します。この例では、テストベンチ関数名は dti_test です。

fixptcfg.TestBenchName = 'dti_test';

浮動小数点の MATLAB 関数を固定小数点の MATLAB コードに変換します。この例では、MATLAB 関数名は dti です。

fiaccel -float2fixed fixptcfg dti

バージョン履歴

R2011a で導入

参考