Замена математической функции кода

Эта тема показывает вам, как разработать заменяющую библиотеку кода, чтобы оптимизировать производительность математических функций путем обеспечения примера того, как задать замену кода для sin функция. Чтобы разработать заменяющую библиотеку кода используют или интерактивный или программируемый подход. Для получения дополнительной информации о том, как разработать заменяющую библиотеку кода, или если вы ищете информацию о том, как указать или проверить заменяющие библиотеки кода, смотрите, Разрабатывают Заменяющую Библиотеку Кода.

В интерактивном режиме разработайте заменяющую библиотеку кода

  1. Откройте среду. Откройте Code Replacement Tool (crtool) из командной строки MATLAB со следующей командой:

    >>crtool
  2. Составление таблицы.

    1. В crtool меню выберите File> New Table.

    2. На правой панели назовите таблицу crl_table_sin. Нажмите Apply.

  3. Создайте запись. В crtool меню выберите File> New entry> Function.

  4. Создайте параметры записи. В Function выпадающий список выберите sin. Информация об алгоритме появляется в crtool. В данном примере оставьте параметр незаданным.

  5. Создайте концептуальное представление. Концептуальное представление описывает подпись функции, которую вы хотите заменить. В подразделе Conceptual function crtool задайте возвращаемый аргумент, y1, и входной параметр, u1, с Data Type двойных и Argument Type Скаляра.

  6. Создайте представление реализации. Представление реализации описывает подпись функции оптимизации. В данном примере, чтобы указать, что аргументы реализации имеют тот же порядок и свойства в качестве концептуальных аргументов, установите флажок Make conceptual and implementation argument types the same.

  7. Укажите информацию сборки. Кликните по вкладке Build Information, чтобы открыть панель Requirements сборки. Задайте файлы (источник, заголовок, объект), которого генератор кода требует для замены кода. В данном примере вы не должны указывать информацию сборки.

  8. Подтвердите и сохраните. Кликните по вкладке Mapping Information и проверьте, что поля заполнены в как показано. Нажмите Validate entry. В crtool меню выберите File> Save table> Save.

  9. Укажите заменяющую библиотеку кода. Регистрация создает библиотеку, состоявшую из таблиц, которые вы задаете. В crtool меню выберите File> Generate registration file. В Сгенерировать регистрационном диалоговом окне файла заполните поля как показано:

  10. Проверьте заменяющую библиотеку кода. Закройте crtool. Из командной строки MATLAB откройте библиотеку при помощи Code Replacement Viewer и проверьте, что таблица и запись правильно заданы. Сконфигурируйте свою модель, чтобы пользоваться заменяющей библиотекой кода, сгенерировать код и проверить, что замена происходит как ожидалось. Если неожиданное поведение происходит, исследуйте журналы удачи и неудачи, чтобы диагностировать. Для получения дополнительной информации смотрите, Проверяют Заменяющую Библиотеку Кода.

Программно разработайте заменяющую библиотеку кода

  1. Откройте среду. Откройте программируемый интерфейс в меню MATLAB путем выбора New> Function.

  2. Составление таблицы.

    1. Создайте функцию с именем вашей заменяющей таблицы библиотеки кода, которая не имеет аргументов и возвращает объект таблицы. Можно использовать эту функцию, чтобы вызвать заменяющую таблицу библиотеки кода.

    2. Создайте объект таблицы путем вызова RTW.TflTable.

    function hTable = crl_table_sin()
    % Create a function to call the code replacement library table 
    
    %% Create a table object
    hTable = RTW.TflTable;
    
  3. Создайте запись. Поскольку этот пример заменяет функцию, создайте заменяющую запись кода в своей таблице путем вызывания функции записи RTW.TflCFunctionEntry.

    function hTable = crl_table_sin()
    % Create a code replacement library table 
    
    %% Create a table object
    hTable = RTW.TflTable;
    
    %% Create an entry
    hEntry = rtw.TflCFunctionEntry;
    
  4. Создайте параметры записи. Начиная с этого примеры заменяют функцию, создайте параметры записи путем вызова функционального setTflCFunctionEntryParameters.

    function hTable = crl_table_sin()
    % Create a code replacement library table 
    
    %% Create a table object
    hTable = RTW.TflTable;
    
    %% Create an entry 
    hEntry = RTW.TflCFunctionEntry;
    
    %% Create entry parameters
    hEntry.setTflCFunctionEntryParameters(...
            'Key',                         'sin', ...
            'Priority',                    30, ...
            'ImplementationName',          'mySin', ...
            'ImplementationHeaderFile',    'basicMath.h', ...
            'ImplementationSourceFile',    'basicMath.c');
  5. Создайте концептуальное представление. Концептуальное представление описывает подпись функции, которую вы хотите заменить. Существует несколько способов создать концептуальное представление. Чтобы явным образом задать свойства аргумента, вызовите функциональный createAndAddConceptualArg.

    function hTable = crl_table_sin()
    % Create a code replacement library table
    
    %% Create a table object
    hTable = RTW.TflTable;
    
    %% Create an entry 
    hEntry = RTW.setTflCFunctionEntry;
    
    %% Create entry parameters
    hEntry.setTflCFunctionEntryParameters(...
            'Key',                         'sin', ...
            'Priority',                    30, ...
            'ImplementationName',          'mySin', ...
            'ImplementationHeaderFile',    'basicMath.h', ...
            'ImplementationSourceFile',    'basicMath.c');
    
    %% Create the conceptual representation
    hEntry.createAndAddConceptualArg(...
            'RTW.TflArgNumeric',      ...
            'Name',                   'y1',...
            'IOType',                 'RTW_IO_OUTPUT',...
            'DataTypeMode',           'double');
    
    hEntry.createAndAddConceptualArg(...
            'RTW.TflArgNumeric',      ...
            'Name',                   'u1', ...
            'IOType',                 'RTW_IO_INPUT',...
            'DataTypeMode',           'double');
    
  6. Создайте представление реализации. Представление реализации описывает подпись функции оптимизации. Существует несколько способов создать представление реализации. Чтобы указать, что аргументы реализации имеют тот же порядок и свойства в качестве концептуальных аргументов, вызовите функциональный copyConceptualArgsToImplementation. Добавьте полную запись в таблицу путем вызова функционального addEntry.

    function hTable = crl_table_sin()
    % Create a code replacement library table
    
    %% Create a table object
    hTable = RTW.TflTable;
    
    %% Create an entry 
    hEntry = RTW.setTflCFunctionEntry;
    
    %% Create entry parameters
    hEntry.setTflCFunctionEntryParameters(...
            'Key',                         'sin', ...
            'Priority',                    30, ...
            'ImplementationName',          'mySin', ...
            'ImplementationHeaderFile',    'basicMath.h', ...
            'ImplementationSourceFile',    'basicMath.c');
    
    %% Create the conceptual representation
    hEntry.createAndAddConceptualArg(...
            'RTW.TflArgNumeric',      ...
            'Name',                   'y1',...
            'IOType',                 'RTW_IO_OUTPUT',...
            'DataTypeMode',           'double');
    
    hEntry.createAndAddConceptualArg(...
            'RTW.TflArgNumeric',      ...
            'Name',                   'u1', ...
            'IOType',                 'RTW_IO_INPUT',...
            'DataTypeMode',           'double');
    
    %% Create the Conceptual Representation
    copyConceptualArgsToImplementation(fcn_entry);
    
    %% Add the entry to the table
    hTable.addEntry(hEntry);
    
  7. Укажите информацию сборки. В параметрах записи задайте файлы (заголовок, источник, объект), в котором генератор кода нужен для замены кода. В данном примере создайте информацию, не требуется.

  8. Подтвердите и сохраните. В меню MATLAB сохраните этот файл настройки путем выбора File> Save. Из командной строки подтвердите заменяющую таблицу библиотеки кода путем вызова его:

    >> hTable = crl_table_sin
  9. Укажите заменяющую библиотеку кода. Регистрация создает заменяющую библиотеку кода путем определения имени библиотеки, заменяющих таблиц кода и другой информации. Создайте регистрационный файл (новый файл функции) с этими спецификациями:

    function rtwTargetInfo(cm)
     
    cm.registerTargetInfo(@loc_register_crl);
    end
     
    function this = loc_register_crl 
     
    this(1) = RTW.TflRegistry; 
    this(1).Name = 'CRL for sin function replacement’;
    this(1).TableList = {'crl_table_sin.m'}; % table created in this example
    this(1).TargetHWDeviceType = {'*'};
    this(1).Description = 'Example code replacement library';
    
    end
    
  10. Проверьте заменяющую библиотеку кода. Откройте библиотеку при помощи Code Replacement Viewer и проверьте, что таблица и запись правильно заданы. Сконфигурируйте свою модель, чтобы пользоваться заменяющей библиотекой кода, сгенерировать код и проверить, что замена происходит как ожидалось. Если неожиданное поведение происходит, исследуйте журналы удачи и неудачи, чтобы диагностировать. Для получения дополнительной информации смотрите, Проверяют Заменяющую Библиотеку Кода.

Похожие темы