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'единственныйint8int16int32int64uint8uint16uint32, или '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