Предложите типы данных на основе областей значений симуляции

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

Необходимые условия

Чтобы завершить этот пример, необходимо установить следующие продукты:

Создайте новую папку и скопируйте соответствующие файлы

  1. Создайте локальную рабочую папку, например, c:\ex_2ndOrder_filter.

  2. Превратитесь в docroot\toolbox\fixpoint\examples папка. В командной строке MATLAB, введите:

    cd(fullfile(docroot, 'toolbox', 'fixpoint', 'examples')) 

  3. Скопируйте ex_2ndOrder_filter.m и ex_2ndOrder_filter_test.m файлы к вашей локальной рабочей папке.

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

    ВводИмяОписание
    Код функцииex_2ndOrder_filter.mФункция MATLAB точки входа
    Тестовый файлex_2ndOrder_filter_test.mСкрипт MATLAB, который тестирует ex_2ndOrder_filter.m

 Функция ex_2ndOrder_filter

 ex_2ndOrder_filter_test Скрипт

Настройте объект настройки фиксированной точки

Создайте настройку фиксированной точки, возражают и конфигурируют имя тестового файла.

cfg = coder.config('fixpt');
cfg.TestBenchName = 'ex_2ndOrder_filter_test';

Соберите области значений симуляции и сгенерируйте фиксированную точку

Используйте fiaccel функционируйте, чтобы преобразовать функцию MATLAB с плавающей точкой, ex_2ndOrder_filter, к фиксированной точке код MATLAB. Установите размер слова по умолчанию для типов данных с фиксированной точкой к 16.

cfg.ComputeSimulationRanges = true;
cfg.DefaultWordLength = 16;

% Derive ranges  and generate fixed-point code
fiaccel -float2fixed cfg ex_2ndOrder_filter

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

Информация о диапазоне

Щелкните по ссылке к отчету предложения по типу для ex_2ndOrder_filter функция, ex_2ndOrder_filter_report.html.

Отчет открывается в веб-браузере.

Просмотрите сгенерированную фиксированную точку код MATLAB

fiaccel генерирует версию фиксированной точки ex_2ndOrder_filter.m функция, ex_2ndOrder_filter_fixpt.m, и функция обертки, которая вызывает ex_2ndOrder_filter_fixpt. Эти файлы сгенерированы в codegen\ex_2ndOrder_filter\fixpt папка в вашей локальной рабочей папке.

function y = ex_2ndOrder_filter_fixpt(x) %#codegen
  fm = get_fimath();

  persistent z
  if isempty(z)
      z = fi(zeros(2,1), 1, 16, 15, fm);
  end
  % [b,a] = butter(2, 0.25)
  b = fi([0.0976310729378175,  0.195262145875635,  0.0976310729378175], 0, 16, 18, fm);
  a = fi([                 1, -0.942809041582063,  0.3333333333333333], 1, 16, 14, fm);

 
  y = fi(zeros(size(x)), 1, 16, 14, fm);
  for i=1:length(x)
      y(i) = b(1)*x(i) + z(1);
      z(1) = fi_signed(b(2)*x(i) + z(2)) - a(2) * y(i);
      z(2) = fi_signed(b(3)*x(i))        - a(3) * y(i);
  end
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

function fm = get_fimath()
	fm = fimath('RoundingMethod', 'Floor', 'OverflowAction', 'Wrap', 'ProductMode', 'FullPrecision', 'MaxProductWordLength', 128, 'SumMode', 'FullPrecision', 'MaxSumWordLength', 128);
end