Разверните for - цикл путем создания копии тела цикла для каждой итерации цикла
coder.unroll()coder.unroll(flag)coder.unroll() разворачивает for - цикл. Вызов coder.unroll должен быть на строке отдельно сразу предшествованием for - цикл, который это разворачивает.
Вместо того, чтобы произвести for - цикл в сгенерированном коде, развертывание цикла производит копию for - тело цикла для каждой итерации цикла. В каждой итерации индекс цикла становится постоянным. Чтобы развернуть цикл, генератор кода должен смочь определить границы цикла for-.
Для маленьких, жестких циклов разворачивание может улучшать производительность. Однако для больших циклов, разворачивание может значительно увеличить время генерации кода и сгенерировать неэффективный код.
coder.unroll проигнорирован за пределами генерации кода.
for - цикл Чтобы произвести копии for - тело цикла в сгенерированном коде, используйте coder.unroll.
В одном файле запишите функции точки входа call_getrand и локальную функцию getrand. getrand разворачивает for - цикл, который присваивает случайные числа n-1 массиву. call_getrand вызывает getrand со значением 3.
function z = call_getrand %#codegen z = getrand(3); end function y = getrand(n) coder.inline('never'); y = zeros(n, 1); coder.unroll(); for i = 1:n y(i) = rand(); end end
Сгенерируйте статическую библиотеку.
codegen -config:lib call_getrand -report
В сгенерированном коде генератор кода производит копию for - тело цикла для каждой из этих трех итераций цикла.
static void getrand(double y[3])
{
y[0] = b_rand();
y[1] = b_rand();
y[2] = b_rand();
}
for - развертывание цикла с флагомЦикл управления, разворачивающий при помощи coder.unroll с аргументом flag.
В одном файле запишите функции точки входа call_getrand_unrollflag и локальную функцию getrand_unrollflag. Когда количество итераций цикла - меньше чем 10, getrand_unrollflag разворачивает for - цикл. call_getrand вызывает getrand со значением 50.
function z = call_getrand_unrollflag %#codegen z = getrand_unrollflag(50); end function y = getrand_unrollflag(n) coder.inline('never'); unrollflag = n < 10; y = zeros(n, 1); coder.unroll(unrollflag) for i = 1:n y(i) = rand(); end end
Сгенерируйте статическую библиотеку.
codegen -config:lib call_getrand_unrollflag -report
Количество итераций - не меньше чем 10. Поэтому генератор кода не разворачивает for - цикл. Это производит for - цикл в сгенерированном коде.
static void getrand_unrollflag(double y[50])
{
int i;
for (i = 0; i < 50; i++) {
y[i] = b_rand();
}
}
for - циклfunction z = call_getrand %#codegen z = getrand(3); end function y = getrand(n) coder.inline('never'); y = zeros(n, 1); for i = coder.unroll(1:n) y(i) = rand(); end end
for - развертывание циклаfunction z = call_getrand_unrollflag %#codegen z = getrand_unrollflag(50); end function y = getrand_unrollflag(n) coder.inline('never'); unrollflag = n < 10; y = zeros(n, 1); for i = coder.unroll(1:n, unrollflag) y(i) = rand(); end end
Иногда, генератор кода разворачивает for - цикл даже при том, что вы не используете coder.unroll. Например, если for - индексы цикла в неоднородный массив ячеек или в varargin или varargout, генератор кода разворачивает цикл. Путем разворачивания цикла генератор кода может определить значение индекса для каждой итерации цикла. Генератор кода использует эвристику, чтобы определить, когда развернуть for - цикл. Если эвристике не удается идентифицировать, что разворачивание гарантировано, или если количество итераций цикла превышает предел, сбои генерации кода. В этих случаях можно обеспечить развертывание цикла при помощи coder.unroll. Смотрите Непостоянный Индекс в varargin или varargout в цикле for.