showInstrumentationResults

Результаты регистрируются оснащенной, скомпилированной функцией кода С

Синтаксис

showInstrumentationResults('mex_fcn') showInstrumentationResults ('mex_fcn' '-options') showInstrumentationResults mex_fcn showInstrumentationResults mex_fcn -options

Описание

showInstrumentationResults('mex_fcn') открывает Отчет Генерации кода, показывая результаты вызова оснащенной MEX-функции mex_fcn. Наведение на переменные и выражения в отчете отображает регистрируемую информацию. Регистрируемая информация включает минимальные и максимальные значения, предложенные дробные или размеры слова, процент текущей области значений, и является ли значение всегда целым числом, в зависимости от которых опций вы задаете. Если вы задаете, чтобы включать их в функцию buildInstrumentedMex, гистограммы также включены. Та же информация отображена в сводной таблице во вкладке Variables.

showInstrumentationResults ('mex_fcn' '-options') задает опции для раздела результатов инструментирования Отчета Генерации кода.

showInstrumentationResults mex_fcn и showInstrumentationResults mex_fcn -options альтернативные синтаксисы для открытия Отчета Генерации кода.

Когда вы вызываете showInstrumentationResults, файл с именем, instrumentation/mex_fcn/html/index.html создается. mex_fcn является именем соответствующей оснащенной MEX-функции. Выбор этого файла открывает веб-версию Отчета Генерации кода. Чтобы открыть этот файл из MATLAB^®, щелкните правой кнопкой по файлу и выберите Open Outside MATLAB. showInstrumentationResults возвращает ошибку, если оснащенный mex_fcn еще не был назван.

Входные параметры

mex_fcn

Оснащенная MEX-функция, созданная с помощью buildInstrumentedMex.

options

Опции результатов инструментирования.

`-defaultDT T`	Тип данных по умолчанию, чтобы сделать предложение для двойных или одних входных параметров типа данных, где `T` является или объектом numerictype или одним из следующего: `'remainFloat'`, `'double'`, `'single'`, `'int8'`, `'int16'`, `'int32'`, `'int64'`, `'uint8'`, `'uint16'`, `'uint32'` или `'uint64'`. Если вы указываете`, что int` или `uint`, и размер слова со знаком - то, что значение `int` или `uint` и дробная длина предложены. Значением по умолчанию является `remainFloat`, который не предлагает типов данных.
`-nocode`	Не отображайте код MATLAB в печатаемом отчете. Отобразите только таблицы регистрируемых переменных. Эта опция только имеет эффект в сочетании с опцией `-printable`.
`-optimizeWholeNumbers`	Оптимизируйте размер слова переменных, журналы min симуляции которых / макс. журналы указывают, что они всегда - целые числа.
`-percentSafetyMargin N`	Запас прочности в течение min симуляции / макс., где `N` является процентным значением.
`-printable`	Создайте и откройте печатаемый отчет HTML. Отчет открывает в системном браузере.
`-proposeFL`	Предложите дробные длины для заданных размеров слова.
`-proposeWL`	Предложите размеры слова для заданных дробных длин.

Примеры

Сгенерируйте оснащенную 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, чтобы открыть отчет. Просмотрите симуляцию минимальные и максимальные значения, предложил дробную длину, процент текущей области значений и состояние целого числа путем приостановки по переменной в отчете.
```
for i=1:20
   x(:) = 2*rand(size(x))-1;
   y = testfft_instrumented(x);
end

showInstrumentationResults testfft_instrumented...
   -proposeFL -percentSafetyMargin 10
```

Просмотрите гистограмму для переменной путем нажатия во вкладке Variables.

Для получения информации о фигуре обратитесь к странице с описанием NumericTypeScope.
Закройте отображение гистограммы и затем, очистите журнал результатов.
```
clearInstrumentationResults testfft_instrumented
```
Очистите MEX-функцию, затем удалите временные файлы.
```
clear testfft_instrumented;
tempdirObj.cleanUp;
```

Документация

showInstrumentationResults

Синтаксис

Описание

Входные параметры

Примеры

Примечание

Смотрите также

Представленный в R2011b

Документация Fixed-Point Designer

Поддержка