exponenta event banner

кодер

Открыть приложение кодера MATLAB

Описание

coder открывает приложение MATLAB® Coder™. Чтобы создать проект, на Избранной странице Исходных файлов, обеспечивают имена файлов точки входа. Приложение создает проект с именем по умолчанию, которое является именем первого файла точки входа. Чтобы открыть существующий проект, на панели инструментов приложения щелкните, а затем щелкните Открыть существующий проект.

Если продукт Embedded Coder ® установлен, при создании проекта приложение включает функции Embedded Coder. Если функции встроенного кодера включены, для создания кода требуется лицензия встроенного кодера. Чтобы отключить функции встроенного кодера, в параметрах построения проекта на вкладке «Все параметры» в разделе «Дополнительно» задайте для параметра «Использовать встроенные функции кодера» значение No.

coder projectname открывает приложение MATLAB Coder с использованием существующего проекта с именем projectname.prj.

пример

coder -open projectname открывает приложение MATLAB Coder с использованием существующего проекта с именем projectname.prj.

пример

coder -build projectname строит существующий проект с именем projectname.prj.

пример

coder -new projectname открывает приложение MATLAB Coder, создающее проект с именем projectname.prj. Если продукт Embedded Coder установлен, приложение создает проект с включенными функциями Embedded Coder. Чтобы отключить эти функции, в параметрах построения проекта на вкладке «Все параметры» в разделе «Дополнительно» задайте для параметра «Использовать встроенные функции кодера» значение No.

coder -ecoder false -new projectname открывает приложение MATLAB Coder, создающее проект с именем projectname.prj. Приложение создает проект с отключенными функциями Embedded Coder, даже если установлен продукт Embedded Coder.

пример

coder -tocode projectname -script scriptname преобразует существующий проект с именем projectname.prj к эквивалентному сценарию команд MATLAB. Сценарий имеет имя scriptname.

  • Если scriptname существует, coder перезаписывает его.

  • Сценарий воспроизводит конфигурацию построения проекта в объекте конфигурации и создает проект. Сценарий:

    • Создание объекта конфигурации с именем cfg.

    • Определяет переменную ARGS для типов ввода функций.

    • Определяет переменную GLOBALS для исходных значений глобальных данных.

    • Запускает codegen команда. При запуске сценария функции начального уровня, которые являются аргументами для codegen должен находиться в пути поиска.

  • cfg, ARGS, и GLOBALS появляются в базовой рабочей области только после запуска сценария.

Если проект включает автоматическое преобразование фиксированной точки, coder генерирует два сценария:

  • Сценарий scriptname содержит команды MATLAB для:

    • Создайте объект конфигурации кода, имеющий те же параметры, что и проект.

    • Запустить codegen для преобразования функции MATLAB с фиксированной точкой в функцию C с фиксированной точкой.

  • Сценарий, имя файла которого является конкатенацией имени, указанного scriptname и созданный суффикс имени файла с фиксированной точкой, заданный файлом проекта. Если scriptname указывает расширение файла, имя файла сценария включает расширение файла. Например, если scriptname является myscript.m и суффикс является значением по умолчанию _fixpt, имя сценария: myscript_fixpt.m.

    Этот сценарий содержит команды MATLAB для:

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

    • Запустить codegen для преобразования функции MATLAB с плавающей запятой в функцию MATLAB с фиксированной запятой.

Для проекта, который включает преобразование с фиксированной точкой, перед преобразованием проекта в скрипты выполните шаг Test Numerics процесса преобразования с фиксированной точкой.

coder -tocode projectname преобразует существующий проект с именем projectname.prj к эквивалентному сценарию команд MATLAB. Сценарий записывается в окно команд.

coder -toconfig projectname экспортирует настройки конфигурации кода, сохраненные в файле проекта кодера MATLAB, в объект конфигурации кода. Выполнение этой команды возвращает объект конфигурации кода, соответствующий projectname. Дополнительные сведения о том, какой объект конфигурации кода возвращается для различных параметров файла проекта, см. в разделе Общий доступ к параметрам конфигурации построения.

пример

cfg = coder('-toconfig','projectname') возвращает объект конфигурации, содержащий параметры конфигурации кода, сохраненные в файле проекта кодера MATLAB. Выполнение этой команды возвращает объект конфигурации кода cfg соответствующие projectname. Дополнительные сведения о том, какой объект конфигурации кода возвращается для различных параметров файла проекта, см. в разделе Общий доступ к параметрам конфигурации построения.

coder -typeEditor открывает пустое диалоговое окно «Редактор типов кодеров». Если диалоговое окно уже открыто, эта команда выводит его на передний план экрана.

См. раздел Создание и редактирование типов ввода с помощью редактора типов кодеров.

Примеры

свернуть все

Откройте приложение MATLAB Coder с помощью существующего проекта MATLAB Coder my_coder_project.

coder -open my_coder_project

Создание проекта кодера MATLAB с именем my_coder_project.

coder -build my_coder_project

Откройте приложение MATLAB Coder и создайте проект с именем my_coder_project.

coder -new my_coder_project

Преобразование проекта кодера MATLAB с именем my_coder_project.prj в скрипт MATLAB с именем myscript.m.

coder -tocode my_coder_project -script my_script.m

Определите функцию MATLAB, myadd, которая возвращает сумму двух значений.

function y = myadd(u,v) %#codegen
y = u + v;
end

Создание проекта кодера MATLAB myadd.prj:

  • Откройте приложение Кодер MATLAB. Укажите myadd в качестве функции точки входа.

  • На странице Определить типы вводов (Define Inputs Types) укажите u и v как двойные скаляры.

  • На странице «Создание кода» задайте для параметра «Тип построения» значение MEX. Оставьте другие параметры файла проекта со значениями по умолчанию.

В командной строке MATLAB выполните следующую команду:

cfg = coder('-toconfig','myadd.prj');

Генератор кода создает coder.MexCodeConfig объект cfg который содержит параметры конфигурации кода, сохраненные в myadd.prj.

Проверка свойств cfg.

cfg = 

    Description: 'class MexCodeConfig: MEX configuration objects with C code.'
    Name: 'MexCodeConfig'

-------------------------------- Report -------------------------------

                      GenerateReport: true
                        LaunchReport: false
                   ReportInfoVarName: ''
          ReportPotentialDifferences: false

------------------------------- Debugging -----------------------------

                     EchoExpressions: true
                     EnableDebugging: false
                  EnableMexProfiling: false

---------------------------- Code Generation --------------------------

                      ConstantInputs: 'CheckValues'
                           EnableJIT: false
                 FilePartitionMethod: 'MapMFileToCFile'
                         GenCodeOnly: false
    HighlightPotentialRowMajorIssues: true
                  PostCodeGenCommand: ''
             PreserveArrayDimensions: false
                            RowMajor: false
                          TargetLang: 'C'

------------------------ Language And Semantics -----------------------

           CompileTimeRecursionLimit: 50
              ConstantFoldingTimeout: 40000
             DynamicMemoryAllocation: 'Threshold'
    DynamicMemoryAllocationThreshold: 65536
            EnableAutoExtrinsicCalls: true
              EnableRuntimeRecursion: true
                EnableVariableSizing: true
                      ExtrinsicCalls: true
                GlobalDataSyncMethod: 'SyncAlways'
               InitFltsAndDblsToZero: true
               PreserveVariableNames: 'None'
           SaturateOnIntegerOverflow: true

------------------------- C++ Language Features -----------------------

                        CppNamespace: ''

----------------- Safety (disable for faster execution) ---------------

                     IntegrityChecks: true
                ResponsivenessChecks: true

---------------- Function Inlining and Stack Allocation ---------------

                    InlineStackLimit: 4000
                     InlineThreshold: 10
                  InlineThresholdMax: 200
                       StackUsageMax: 200000

----------------------------- Optimizations ---------------------------

                        EnableMemcpy: true
                        EnableOpenMP: true
                     MemcpyThreshold: 64

------------------------------- Comments ------------------------------

                    GenerateComments: true
                MATLABSourceComments: false

------------------------------ Custom Code ----------------------------

                    CustomHeaderCode: ''
                       CustomInclude: ''
                   CustomInitializer: ''
                       CustomLibrary: ''
                        CustomSource: ''
                    CustomSourceCode: ''
                    CustomTerminator: ''
                   ReservedNameArray: ''

Входные аргументы

свернуть все

Имя проекта кодера MATLAB, который требуется создать, открыть или построить. Имя проекта не должно содержать пробелов.

Имя сценария, который требуется создать при использовании -tocode опция с -script вариант. Имя сценария не должно содержать пробелов.

Выходные аргументы

свернуть все

Объект конфигурации кода, содержащий параметры конфигурации, хранящиеся в файле проекта кодера MATLAB.

Ограничения

  • coder не поддерживается в MATLAB Online™.

Совет

  • При совместном использовании лицензии Embedded Coder используйте coder -ecoder false -new projectname для создания проекта, для которого не требуется эта лицензия. Если продукт Embedded Coder установлен, приложение создает проект с отключенными функциями Embedded Coder. Если эти функции отключены, для создания кода не требуется лицензия Embedded Coder. Чтобы включить функции встроенного кодера, в параметрах построения проекта на вкладке «Все параметры» в разделе «Дополнительно» задайте для параметра «Использовать встроенные функции кодера» значение Yes.

  • Создание проекта или открытие существующего проекта приводит к закрытию других проектов MATLAB Coder или Fixed-Point Converter.

  • Если установка не включает продукт Embedded Coder, настройки Embedded Coder не отображаются. Однако значения этих параметров сохраняются в файле проекта. При открытии проекта в установке, включающей продукт Embedded Coder, отображаются эти параметры.

  • Проект Конвертер фиксированных точек открывается в приложении Конвертер фиксированных точек. Чтобы преобразовать проект в проект Кодер MATLAB, в приложении Конвертер фиксированных точек:

    1. Щелкните значок и выберите «Повторно открыть проект как».

    2. Выбрать MATLAB Coder.

Альтернативы

  • На вкладке Приложения в разделе Создание кода щелкните Кодер MATLAB.

  • Используйте codegen для создания кода в командной строке.

Представлен в R2011a