showInstrumentationResults

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

Синтаксис

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 ®, щелкните его правой кнопкой мыши и выберите «Открыть вне MATLAB ».showInstrumentationResults возвращает ошибку, если instrumented mex_fcn пока не вызывался.

Входные аргументы

mex_fcn

Инструментальная функция MEX, созданная с помощью buildInstrumentedMex.

options

Параметры результатов инструментирования.

`-defaultDT T`	Тип данных по умолчанию для двойных или одиночных входных данных, где `T` является объектом числового типа или одним из следующих объектов: `'remainFloat'`, `'double'`, `'single'`, `'int8'`, `'int16'`, `'int32'`, `'int64'`, `'uint8'`, `'uint16'`, `'uint32'`, или `'uint64'`. При указании `int` или `uint`, значение и длина слова таковы, что `int` или `uint` предложено значение и длина дроби. Значение по умолчанию: `remainFloat`, которая не предлагает никаких типов данных.
`-nocode`	Не выводите код MATLAB в распечатываемом отчете. Отображение только таблиц регистрируемых переменных. Эта опция действует только в сочетании с `-printable` вариант.
`-optimizeWholeNumbers`	Оптимизируйте длину слова переменных, журналы моделирования которых показывают, что они всегда являются целыми числами.
`-percentSafetyMargin N`	Запас прочности для моделирования мин/макс, где `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
```

Просмотрите гистограмму переменной, щелкнув вкладку Переменные.

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

См. также

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

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