Exponenta Banner

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.

  1. Создайте временную директорию, затем импортируйте функцию, взятую в качестве примера, из Fixed-Point Designer™.

    tempdirObj=fidemo.fiTempdir('showInstrumentationResults')
copyfile(fullfile(matlabroot,'toolbox','fixedpoint',...
   'fidemos','fi_m_radix2fft_withscaling.m'),...
   'testfft.m','f')

  2. Задайте прототипные входные параметры.

    T = numerictype('DataType','ScaledDouble','Scaling',...
   'Unspecified');

n = 128;
x = complex(fi(zeros(n,1),T));
W = coder.Constant(fi(fidemo.fi_radix2twiddles(n),T));

  3. Сгенерируйте оснащенную MEX-функцию. Используйте опцию -o, чтобы задать имя MEX-функции.

    buildInstrumentedMex testfft -o testfft_instrumented...
   -args {x,W} -histogram

  4. Запустите испытательный стенд, чтобы записать результаты инструментирования. Вызовите showInstrumentationResults, чтобы открыть отчет. Просмотрите симуляцию минимальные и максимальные значения, предложил дробную длину, процент текущей области значений и состояние целого числа путем приостановки по переменной в отчете.

    for i=1:20
   x(:) = 2*rand(size(x))-1;
   y = testfft_instrumented(x);
end

showInstrumentationResults testfft_instrumented...
   -proposeFL -percentSafetyMargin 10

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

    Для получения информации о фигуре обратитесь к странице с описанием NumericTypeScope.

  2. Закройте отображение гистограммы и затем, очистите журнал результатов.

    clearInstrumentationResults testfft_instrumented

  3. Очистите MEX-функцию, затем удалите временные файлы.

    clear testfft_instrumented;
tempdirObj.cleanUp;

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

| | | | |

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

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