このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
showInstrumentationResults
インストルメント化されたコンパイル済み C コード関数によるログ作成結果
構文
showInstrumentationResults('
mex_fcn
')
showInstrumentationResults ('mex_fcn
' '-options
')
showInstrumentationResults mex_fcn
showInstrumentationResults mex_fcn -options
説明
showInstrumentationResults('
はコード生成レポートを開き、インストルメント化された MEX 関数 mex_fcn
')mex_fcn
の呼び出しによる結果を表示します。レポートの変数と式にマウス ポインターを置くと、ログ情報が表示されます。ログ情報には、指定したオプションに応じて、最小値と最大値、推奨された小数部の長さまたは語長、現在の範囲に対する割合、値が常に 0 または正の整数となるかどうかなどが含まれます。関数 buildInstrumentedMex
でこれらを含めるように指定した場合は、ヒストグラムも含められます。[変数] タブの概要表にも同じ情報が表示されます。
showInstrumentationResults ('
により、コード生成レポートの計測結果セクションのオプションを指定できます。mex_fcn
' '-options
')
showInstrumentationResults
および mex_fcn
showInstrumentationResults
は、コード生成レポートを開く代替構文です。mex_fcn -options
showInstrumentationResults
が呼び出されると、instrumentation
/mex_fcn
/html/index.html
という名前のファイルが作成されます。mex_fcn
はインストルメント化された MEX 関数の対応する名前です。このファイルを選択すると、Web ベースのコード生成レポートが開きます。このファイルを MATLAB® 内で開くには、ファイルを右クリックし [MATLAB の外部で開く] を選択します。インストルメント化された mex_fcn
が呼び出されていない場合は、showInstrumentationResults
はエラーを返します。
入力引数
|
| ||||||||||||||
|
計測結果オプション。
|
例
インストルメント化された MEX 関数を生成し、次にテスト バッチを実行します。showInstrumentationResults
を呼び出し、コード生成レポートを開きます。
メモ
showInstrumentationResults
のログに記録された結果には、インストルメント化された MEX 関数への今までの呼び出しの結果が累積されています。ログをクリアするには、clearInstrumentationResults
を参照してください。
一時ディレクトリを作成し、サンプル関数を Fixed-Point Designer™ からインポートします。
tempdirObj=fidemo.fiTempdir('showInstrumentationResults') copyfile(fullfile(matlabroot,'toolbox','fixedpoint',... 'fidemos','fi_m_radix2fft_withscaling.m'),... 'testfft.m','f')
プロトタイプの入力引数を定義します。
T = numerictype('DataType','ScaledDouble','Scaling',... 'Unspecified'); n = 128; x = complex(fi(zeros(n,1),T)); W = coder.Constant(fi(fidemo.fi_radix2twiddles(n),T));
インストルメント化した MEX 関数を生成します。
-o
オプションを使用して、MEX 関数名を指定します。buildInstrumentedMex testfft -o testfft_instrumented... -args {x,W} -histogram
テスト ベンチを実行し、計測結果を記録します。
showInstrumentationResults
を呼び出してレポートを開きます。レポート内の変数の上で一時停止して、シミュレーションの最小値と最大値、推奨された小数部の長さ、現在の範囲に対する割合と 0 または正の整数ステータスを表示します。for i=1:20 x(:) = 2*rand(size(x))-1; y = testfft_instrumented(x); end showInstrumentationResults testfft_instrumented... -proposeFL -percentSafetyMargin 10
[変数] タブの
をクリックして変数のヒストグラムを表示します。
この図の詳細については、
NumericTypeScope
のリファレンス ページを参照してください。ヒストグラムの表示を閉じて、結果ログをクリアします。
clearInstrumentationResults testfft_instrumented
MEX 関数をクリアし、次に一時ファイルを削除します。
clear testfft_instrumented; tempdirObj.cleanUp;
バージョン履歴
R2011b で導入
参考
fiaccel
| clearInstrumentationResults
| buildInstrumentedMex
| NumericTypeScope
| codegen
(MATLAB Coder) | mex