Ускорьте код для данных Переменного Размера

Данные переменного размера являются данными, размер которых может измениться во время выполнения. Поддержки MATLAB® ограниченные и неограниченные данные переменного размера для генерации кода. Bounded variable-size data зафиксировал верхние границы. Эти данные могут быть выделены статически на стеке или динамически на куче. Unbounded variable-size data не имеет зафиксированных верхних границ. Эти данные должны быть выделены на куче. По умолчанию, для MEX и генерации кода C/C++, поддержка данных переменного размера включена, и динамическое выделение памяти включено для массивов переменного размера, размер которых превышает настраиваемый порог.

Отключите поддержку данных Переменного Размера

По умолчанию, для MEX и ускорения C/C++ кода, поддержка данных переменного размера включена. Вы изменяете переменные настройки калибровки в командной строке.

  1. Создайте объект настройки для генерации кода.

    cfg = coder.mexconfig;

  2. Установите EnableVariableSizing опция:

    cfg.EnableVariableSizing = false;

  3. Используя -config опция, передайте объект настройки fiaccel :

    fiaccel -config cfg foo
    

Управляйте динамическим выделением памяти

По умолчанию динамическое выделение памяти включено для массивов переменного размера, размер которых превышает настраиваемый порог. Если вы отключаете поддержку данных переменного размера, вы также отключаете динамическое выделение памяти. Можно изменить настройки динамического выделения памяти в командной строке.

  1. Создайте объект настройки для ускорения кода. Например, для MEX-функции:

    mexcfg = coder.mexconfig;

  2. Установите DynamicMemoryAllocation опция:

    УстановкаДействие
    mexcfg.DynamicMemoryAllocation='Off';
    Динамическое выделение памяти отключено. Все данные переменного размера выделяются статически на стеке.
    mexcfg.DynamicMemoryAllocation='AllVariableSizeArrays';
    Динамическое выделение памяти включено для всех массивов переменного размера. Все данные переменного размера выделяются динамически на куче.
    mexcfg.DynamicMemoryAllocation='Threshold';
    Динамическое выделение памяти включено для всех массивов переменного размера, размер которых (в байтах) больше или равен значению, заданному с помощью Dynamic memory allocation threshold параметр. Массивы переменного размера, размер которых меньше этого порога, выделяются на стеке.

  3. Опционально, если вы устанавливаете Dynamic memory allocation к 'Threshold', сконфигурируйте Dynamic memory allocation threshold точно настраивать выделение памяти.

  4. Используя -config опция, передайте объект настройки fiaccel:

    fiaccel -config mexcfg foo
    

Ускорьте код для функций MATLAB с данными Переменного Размера

Вот основной рабочий процесс, который генерирует код MEX.

  1. В редакторе MATLAB добавьте директиву компиляции %#codegen во главе вашей функции.

    Эта директива:

    • Указывает, что вы намереваетесь сгенерировать код для алгоритма MATLAB

    • Включает регистрацию в Анализаторе кода MATLAB, чтобы обнаружить потенциальные ошибки во время генерации кода

  2. Решите проблемы, обнаруженные Анализатором кода.

    В некоторых случаях Анализатор кода MATLAB предупреждает вас, когда ваш код присваивает данные фиксированный размер, но позже выращивает данные, такой как присвоением или конкатенацией в цикле. Если те данные, как предполагается, отличаются по размеру во время выполнения, можно проигнорировать эти предупреждения.

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

    • -args {coder.typeof...} если у вас есть входные параметры переменного размера

    • -report сгенерировать отчет генерации кода

    Например:

    fiaccel -report foo -args {coder.typeof(0,[2 4],1)}
    
    Эта команда использует coder.typeof задавать один вход переменного размера для функционального foo. Первый аргумент, 0, указывает на тип входных данных (double) и сложность (real). Второй аргумент, [2 4], указывает на размер, матрицу с двумя размерностями. Третий аргумент, 1, указывает, что вход переменный измеренный. Верхняя граница 2 для первой размерности и 4 для второго измерения.

    Примечание

    Во время компиляции, fiaccel обнаруживает переменные и поля структуры, которые изменяют размер после того, как вы задаете их, и сообщает об этих случаях как об ошибках. Кроме того, fiaccel выполняет проверку на этапе выполнения, чтобы сгенерировать ошибки, когда данные превышают верхние границы.

  4. Зафиксируйте ошибки несоответствия размера:

    Причина:Как зафиксировать:Для получения дополнительной информации:
    Вы пытаетесь изменить размер данных после того, как его размер был заблокирован.Объявите, что данные переменные измеренный.Смотрите диагностирование и фиксацию ошибок несоответствия размера.
  5. Зафиксируйте ошибки верхних границ

    Причина:Как зафиксировать:Для получения дополнительной информации:
    MATLAB не может определить или вычислить верхнюю границуЗадайте верхнюю границу.Смотрите задают верхние границы для массивов Переменного Размера (Simulink) и диагностирование и фиксация ошибок несоответствия размера.
    MATLAB пытается вычислить верхнюю границу для неограниченных данных переменного размера.Если данные неограниченны, включите динамическое выделение памяти. Смотрите динамическое выделение памяти управления
  6. Сгенерируйте код C/C++ с помощью fiaccel функция.

Ускорьте код для функции MATLAB, которая расширяет вектор в цикле

О функции MATLAB uniquetol

Этот пример использует функциональный uniquetol. Эта функция возвращается в векторном B версия входного вектора A, где элементы уникальны для в допуске tol друг из друга. В векторном BabsBiBJ))> tol для всех i и j. Первоначально, примите входной вектор A может сохранить до 100 элементов.

function B = uniquetol(A, tol)
A = sort(A);
B = A(1);
k = 1;
for i = 2:length(A)
   if abs(A(k) - A(i)) > tol
      B = [B A(i)];
      k = i;
   end
end

Шаг 1: добавьте директиву компиляции для генерации кода

Добавьте %#codegen директива компиляции во главе функции:

function B = uniquetol(A, tol) %#codegen
A = sort(A);
B = A(1);
k = 1;
for i = 2:length(A)
   if abs(A(k) - A(i)) > tol
      B = [B A(i)];
      k = i;
   end
end

Шаг 2: решите проблемы, обнаруженные анализатором кода

Анализатор кода обнаруживает ту переменную B может изменить размер в for- цикл. Это выдает это предупреждение:

The variable 'B' appears to change size on every loop iteration.
Consider preallocating for speed.

В этой функции, векторном B должен расшириться в размере, когда он добавляет значения из векторного A. Поэтому можно проигнорировать это предупреждение.

Шаг 3: сгенерируйте код MEX

Чтобы сгенерировать код MEX, используйте fiaccel функция.

  1. Сгенерируйте MEX-функцию для uniquetol:

    T = numerictype(1, 16, 15);
    fiaccel -report uniquetol -args {coder.typeof(fi(0,T),[1 100],1),coder.typeof(fi(0,T))}
    

     Что означают эти параметры командной строки?

    Выполнение этой команды генерирует ошибку компилятора:

    ??? Size mismatch (size [1 x 1] ~= size [1 x 2]).
    The size to the left is the size 
    of the left-hand side of the assignment.
    
  2. Откройте сообщение об ошибке и выберите вкладку Variables.

Ошибка указывает на несоответствие размера между левой стороной и правой стороной оператора присваивания B = [B A(i)];. Присвоение B = A(1) устанавливает размер B как скаляр фиксированного размера (1 x 1). Поэтому конкатенация [B A(i)] создает 1 x 2 вектора.

Шаг 4: зафиксируйте ошибку несоответствия размера

Чтобы зафиксировать эту ошибку, объявите B быть вектором переменного размера.

  1. Добавьте этот оператор в uniquetol функция:

    coder.varsize('B');

    Это должно появиться перед B используется (чтение). Например:

    function B = uniquetol(A, tol) %#codegen
    A = sort(A);
    
    coder.varsize('B');
    
    B = A(1);
    k = 1;
    for i = 2:length(A)
       if abs(A(k) - A(i)) > tol
          B = [B A(i)]; 
          k = i;
       end
    end

    Функциональный coder.varsize объявляет каждый экземпляр B в uniquetol быть переменный измеренный.

  2. Сгенерируйте код снова с помощью той же команды:

    fiaccel -report uniquetol -args {coder.typeof(fi(0,T),[1 100],1),coder.typeof(fi(0,T))}

    В текущей папке, fiaccel генерирует MEX-функцию для uniquetol названный uniquetol_mex и обеспечивает ссылку на отчет генерации кода.

  3. Щелкните по ссылке отчета Представления.

  4. В отчете генерации кода выберите вкладку Variables.

    Размер переменной B 1x:?, указание, что это - переменный размер без верхних границ.

Шаг 5: сравните скорость выполнения MEX-функции к оригинальному коду

Запустите исходный алгоритм MATLAB и MEX-функцию с теми же входными параметрами для того же количества итераций цикла и сравните их скорости выполнения.

  1. Создайте входные параметры правильного класса, сложности и размера, чтобы передать uniquetol MATLAB и MEX-функции.

    x = fi(rand(1,90), T);
    tol = fi(0, T);
    
  2. Запустите исходный uniquetol функция в цикле и измерила, сколько времени, она берет, чтобы выполнить 10 итераций цикла.

    tic; for k=1:10, b = uniquetol(x,tol); end; tSim=toc
    
  3. Запустите сгенерированную MEX-функцию с теми же входными параметрами для того же количества итераций цикла.

    tic; for k=1:10, b = uniquetol_mex(x,tol); end; tSim_mex=toc
    
  4. Сравните времена выполнения.

    r = tSim/tSim_mex
    

    Этот пример показывает что, генерируя MEX-функцию с помощью fiaccel значительно ускоряет осуществление алгоритма фиксированной точки.

Для просмотра документации необходимо авторизоваться на сайте