Документация

Местоположение сгенерированных файлов фиксированной точки

По умолчанию процесс преобразования фиксированной точки генерирует файлы в папке под названием codegen/fcn_name/fixpt в вашей локальной рабочей папке. fcn_name имя функции MATLAB^®, которую вы преобразуете в фиксированную точку.

Минимизация fi- броски, чтобы улучшить удобочитаемость кода

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

Например, вот фиксированная точка, сгенерированная для константного выражения x = 1/sqrt(2) когда выбранный размер слова равняется 14.

x = 1/sqrt(2);

x = fi(1/sqrt(2), 0, 14, 14, fm);

Предотвращение переполнения в сгенерированной фиксированной точке

Процесс преобразования избегает переполнения:

Управление ростом разрядности

Рост разрядности управлений процессом преобразования при помощи преобразованных в нижний индекс присвоений, то есть, присвоения, которые используют двоеточие (:) оператор, в сгенерированном коде. Когда вы используете преобразованные в нижний индекс присвоения, MATLAB перезаписывает значение левого аргумента стороны, но сохраняет существующий размер типа данных и массива. Используя преобразованное в нижний индекс присвоение сохраняет фиксированную точку переменных фиксированной точки вместо того, чтобы непреднамеренно повернуть их в, удваивается. Поддержание фиксированной точки сокращает количество описаний типа в сгенерированном коде. Преобразованное в нижний индекс присвоение также предотвращает рост разрядности, который полезен, когда это необходимо, чтобы обеспечить конкретный тип данных для выхода.

Предотвращение потери области значений или точности

% A = 1;
% B = 5
function [y,z] = unsigned_subtraction(A,B)
  y = A - B;
  
  C = -20;
  z = C - B;
end

%#codegen
% A = 1;
% B = 5
function [y,z] = unsigned_subtraction_fixpt(A,B)
 
fm = fimath('RoundingMethod', 'Floor', 'OverflowAction', 'Wrap', 'ProductMode', 'FullPrecision', 'MaxProductWordLength', 128, 'SumMode', 'FullPrecision', 'MaxSumWordLength', 128);
y = fi(fi_signed(A) - B, 1, 3, 0, fm);
C = fi(-20, 1, 6, 0, fm);
z = fi(C - B, 1, 6, 0, fm);
end
 
 
function y = fi_signed(a)
coder.inline( 'always' );
if isfi( a ) && ~(issigned( a ))
  nt = numerictype( a );
  new_nt = numerictype( 1, nt.WordLength + 1, nt.FractionLength );
  y = fi( a, new_nt, fimath( a ) );
else
  y = a;
end
end

% A = 1, B = 100, C = 1000
function [y, z] = lb_node(A, B, C)
  %% single rows
  y = [A B C];
  %% multiple rows
  z = [A 5; A B; A C];
end

%#codegen
% A = 1, B = 100, C = 1000
function [y, z] = lb_node_fixpt(A, B, C)
  %% single rows
  fm = fimath('RoundingMethod', 'Floor', 'OverflowAction', 'Wrap', 'ProductMode', 'FullPrecision', 'MaxProductWordLength', 128, 'SumMode', 'FullPrecision', 'MaxSumWordLength', 128);

  y = fi([fi(A, 0, 10, 0, fm) B C], 0, 10, 0, fm);
  
  %% multiple rows
  z = fi([fi(A, 0, 10, 0, fm) 5; fi(A, 0, 7, 0, fm) B; fi(A, 0, 10, 0, fm) C], 0, 10, 0, fm);
end

Обработка Непостоянных mpower Экспонент

Если функция, которую вы преобразуете, имеет скалярный вход, и mpower вход экспоненты не является постоянным, процесс преобразования устанавливает fimath ProductMode к SpecifyPrecision в сгенерированном коде. С этой установкой тип выходных данных может быть определен во время компиляции.

Например, рассмотрите следующий алгоритм MATLAB.

% a = 1
% b = 3
function y = exp_operator(a, b)
  % exponent is a constant so no need to specify precision
  y = a^3;
  % exponent is not a constant, use 'SpecifyPrecision' for 'ProductMode'
  y = b^a;
end

В сгенерированной фиксированной точке, для выражения y = a^3 , экспонента является константой, таким образом, нет никакой потребности задать точность. Для выражения, y = b^a, экспонента не является постоянной, таким образом, ProductMode установлен в SpecifyPrecision.

%#codegen
% a = 1
% b = 3
function y = exp_operator_fixpt(a, b)
  % exponent is a constant so no need to specify precision
  fm = fimath('RoundingMethod', 'Floor', 'OverflowAction', 'Wrap', 'ProductMode', 'FullPrecision', 'MaxProductWordLength', 128, 'SumMode', 'FullPrecision', 'MaxSumWordLength', 128);

  y = fi(a^3, 0, 2, 0, fm);
  % exponent is not a constant, use 'SpecifyPrecision' for 'ProductMode'
  y(:) = fi(b, 'ProductMode', 'SpecifyPrecision', 'ProductWordLength', 2, 'ProductFractionLength', 0 )^a;
end