Создание скомпилированной функции кода C, включая инструментарий регистрации
buildInstrumentedMex переводит файл MATLAB ®fcn -optionsfcn.mbuildInstrumentedMex и fiaccel одинаковы, за исключением buildIntstrumentedMex не имеет fi объектные ограничения и поддерживает '-coder' вариант.
buildInstrumentedMex переводит функции MATLAB fcn_1... fcn_n -options -coderfcn_1fcn_n'-coder' вариант.
Создайте инструментальную функцию MEX. Запустите тестовый стенд, а затем просмотрите результаты регистрации.
Создайте временную папку, а затем импортируйте примерную функцию из Fixed-Point Designer™.
tempdirObj=fidemo.fiTempdir('buildInstrumentedMex') copyfile(fullfile(matlabroot,'toolbox','fixedpoint',... 'fidemos','fi_m_radix2fft_withscaling.m'),... 'testfft.m','f')
Определите входные аргументы прототипа.
n = 128; x = complex(zeros(n,1)); W = coder.Constant(fidemo.fi_radix2twiddles(n));
Создайте инструментальную функцию MEX. Используйте -o для указания имени функции MEX. Используйте -histogram для вычисления гистограмм. (При наличии лицензии MATLAB Coder™ можно также добавить -coder вариант. В этом случае используйте buildInstrumentedMex testfft -coder -o testfft_instrumented -args {x,W} вместо следующей строки кода.)
Примечание
Как fiaccel, buildInstrumentedMex генерирует функцию MEX. Для получения информации о создании кода C см. код MATLAB
codegen (Кодер MATLAB).
buildInstrumentedMex testfft -o testfft_instrumented... -args {x,W} -histogram
Запустите тестовый файл для записи результатов инструментирования. Звонить showInstrumentationResults для открытия отчета. Просмотрите минимальное и максимальное значения моделирования и состояние целого номера, приостановив работу над переменной в отчете. Кроме того, в таблице можно просмотреть предлагаемые типы данных для номеров с двойной точностью.
for i=1:20 y = testfft_instrumented(randn(size(x))); end showInstrumentationResults testfft_instrumented
Просмотрите гистограмму переменной, щелкнув
вкладку Переменные.
Для получения информации о рисунке см. NumericTypeScope справочная страница.
Закройте экран гистограммы и затем очистите журнал результатов.
clearInstrumentationResults testfft_instrumented;Очистите функцию MEX и удалите временные файлы.
clear testfft_instrumented;
tempdirObj.cleanUp;В локальной папке, доступной для записи, создайте функции ep1.m и ep2.m.
function y1 = ep1(u) %#codegen y1 = u; end
function y2 = ep2(u, v) %#codegen y2 = u + v; end
Создайте инструментальную функцию MEX для двух функций точки входа. Используйте -o для указания имени функции MEX. Используйте -histogram для вычисления гистограмм. Используйте -coder возможность генерации нескольких точек входа с помощью buildInstrumentedMex функция.
u = 1:100; v = 5:104; buildInstrumentedMex -o sharedmex ... ep1 -args {u} ... % Entry point 1 ep2 -args {u, v} ... % Entry point 2 -histogram -coder
Вызовите первую функцию точки входа, используя сгенерированную функцию MEX.
y1 = sharedmex('ep1', u);Вызовите вторую функцию начального уровня, используя сгенерированную функцию MEX.
y2 = sharedmex('ep2', u, v);Показать результаты инструментирования.
showInstrumentationResults sharedmex 
Примечание
Создание функции MEX для нескольких функций начального уровня с помощью buildInstrumentedMex требуется лицензия кодера MATLAB.
Функции MATLAB, поставляемые вместе с программным обеспечением, не используются. Если функция верхнего уровня является такой функцией MATLAB, ничего не регистрируется. Вы также не можете использовать сценарии инструментов.
Результаты измерений накапливаются при каждом вызове функции MEX. Использовать clearInstrumentationResults для очистки предыдущих результатов в журнале.
Некоторые шаблоны кодирования пропускают значительный объем данных, но используют лишь небольшую часть этих данных. В таких случаях при использовании может наблюдаться снижение производительности buildInstrumentedMex. В следующем шаблоне: subfun использует только один элемент входного массива, A. Для нормального выполнения - количество времени на выполнение subfun один раз остается постоянным независимо от размера A. Функция topfun требования subfun
N время и, таким образом, общее время выполнения topfun пропорционально N. Однако при использовании инструментальных средств время выполнения subfun один раз становится пропорциональным N^2. Это изменение происходит потому, что минимальные и максимальные данные вычисляются по всему массиву. Когда A является большим, расчеты могут привести к значительному снижению производительности. Поэтому по возможности следует передавать только те данные, которые действительно необходимы функции.
function A = topfun(A)
N = numel(A);
for i=1:N
A(i) = subfun(A,i);
end
end
function b = subfun(A,i)
b = 0.5 * A(i);
end
function A = topfun(A)
N = numel(A);
for i=1:N
A(i) = subfun(A(i));
end
end
function b = subfun(a)
b = 0.5 * a;
end
clearInstrumentationResults | fiaccel | mex | NumericTypeScope | showInstrumentationResults | codegen (кодер MATLAB)