кодер. CodeConfig

Параметры конфигурации для генерации кода C/C++ из кода MATLAB

Описание

Объект coder.CodeConfig содержит параметры конфигурации, которые codegen использует для генерации статической библиотеки, динамически подключаемой библиотеки или исполняемой программы. Передайте объект функции codegen при помощи опции -config.

Создание

Синтаксис

cfg = coder.config(build_type)
cfg = coder.config(build_type, 'ecoder', false)

Описание

пример

cfg = coder.config(build_type) создает объект настройки генерации кода для заданного типа сборки, который может быть статической библиотекой, динамически подключаемой библиотекой или исполняемой программой. Если продукт Embedded Coder® не установлен, он создает объект coder.CodeConfig. В противном случае это создает объект coder.EmbeddedCodeConfig.

cfg = coder.config(build_type, 'ecoder', false) создает объект coder.CodeConfig для заданного выходного типа, даже если вам установили Embedded Coder.

Входные параметры

развернуть все

Выведите, чтобы создать из сгенерированного кода C/C++, заданного как одно из значений в этой таблице.

ЗначениеОписание
'LIB'Статическая библиотека
'DLL'Динамически подключаемая библиотека
'EXE'Исполняемая программа

Свойства

развернуть все

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

ЗначениеОписание
'Faster Builds'

Оптимизирует сборку в течение более короткого времени изготовления.

'Faster Runs'

Оптимизирует сборку для более быстрых рабочих исполняемых файлов.

'Debug'

Оптимизирует сборку для отладки.

'Specify'

Включает свойство CustomToolchainOptions для индивидуальной настройки настроек для инструментов в выбранном наборе инструментальных средств. Если свойство Toolchain установлено в 'Automatically locate an installed toolchain', то установка BuildConfiguration к 'Specify' изменяет Toolchain на расположенный набор инструментальных средств.

Заменяющая библиотека кода для сгенерированного кода, заданного как одно из значений в этой таблице:

ЗначениеОписание
'None'

Это значение является значением по умолчанию.

Не пользуется заменяющей библиотекой кода.

Названная заменяющая библиотека кода

Генерирует вызовы определенной платформы, компилятора или заменяющей библиотеки стандартов кода. Список именованных библиотек зависит от:

  • Установленные пакеты поддержки.

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

  • Создали ли вы и указали заменяющие библиотеки кода, с помощью продукта Embedded Coder.

Совместимые библиотеки зависят от этих параметров:

  • TargetLang

  • TargetLangStandard

  • ProdHWDeviceType в объекте настройки аппаратной реализации.

Embedded Coder предлагает больше библиотек и способность создать и пользоваться заменяющими библиотеками пользовательского кода.

MATLAB® Coder™ генерирует минимальный набор операторов #include для заголовочных файлов, требуемых выбранной заменяющей библиотекой кода.

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

Примечание

Программное обеспечение MATLAB Coder не поддерживает коллбэки TLC.

Максимальное количество функциональных специализаций для рекурсии времени компиляции, заданной как положительное целое число. Чтобы запретить рекурсию в коде MATLAB, установите CompileTimeRecursionLimit на 0. Предел рекурсии времени компиляции по умолчанию является достаточно большим для большинства рекурсивных функций, которые требуют этого типа рекурсии. Если генерация кода перестала работать из-за предела рекурсии времени компиляции, и вы хотите рекурсию времени компиляции, пытаетесь увеличить предел. Также измените свой код MATLAB так, чтобы генератор кода использовал рекурсию во время выполнения. Смотрите Достигнутый Предел Рекурсии Времени компиляции.

Максимальное количество инструкций, что постоянная папка выполняется. В некоторых ситуациях генерация кода требует, чтобы конкретные инструкции были постоянными. Если сворачивание констант останавливается, прежде чем эти инструкции постоянно свернуты, сбои генерации кода. В этом случае увеличьте значение ConstantFoldingTimeout.

Смотрите оптимизацию MATLAB Coder в сгенерированном коде.

Класс коллбэка для библиотеки BLAS вызывает в коде, сгенерированном для определенного низкоуровневого вектора и операций над матрицей в коде MATLAB, заданном как вектор символов.

Если вы задаете класс коллбэка BLAS для определенных низкоуровневых векторных и матричных функций, генератор кода производит вызовы BLAS при помощи интерфейса CBLAS C к вашей библиотеке BLAS. Класс коллбэка обеспечивает имя вашего заголовочного файла CBLAS, имена типов данных CBLAS и информацию, запрошенную, чтобы соединиться с вашей библиотекой BLAS. Если этот параметр пуст, генератор кода производит код для матричных функций вместо вызова BLAS.

Смотрите ускоряют Матричные операции в сгенерированном автономном коде при помощи вызовов BLAS.

Класс коллбэка для библиотеки FFTW вызывает в коде, сгенерированном для функций БПФ в коде MATLAB, заданном как вектор символов.

Чтобы улучшить скорость выполнения функций БПФ, генератор кода производит вызовы библиотеки FFTW, которую вы задаете в классе коллбэка. Если этот параметр пуст, генератор кода использует свои собственные алгоритмы для функций БПФ вместо того, чтобы вызвать библиотеку FFTW.

Смотрите ускоряют быстрые преобразования Фурье в сгенерированном автономном коде при помощи вызовов библиотеки FFTW.

Пользовательский код, который появляется около верхней части каждого заголовочного файла C/C++, сгенерированного из вашего кода MATLAB, заданного как вектор символов.

Включайте папки, чтобы добавить к включать пути при компиляции сгенерированного кода. Укажите, что список включает папки как вектор символов. В векторе символов, отдельном, включают папки символом pathsep. Например:

cfg = coder.config('lib','ecoder',false);
cfg.CustomInclude = ['C:\Project' pathsep 'C:\Custom Files'];

Пользовательский код, чтобы включать в сгенерированное инициализирует функцию, заданную как вектор символов.

Класс коллбэка для библиотеки LAPACK вызывает в коде, сгенерированном для определенных функций линейной алгебры в коде MATLAB, заданном как вектор символов.

Если вы задаете класс коллбэка LAPACK для определенных функций линейной алгебры, генератор кода производит вызовы LAPACK при помощи интерфейса LAPACKE C к вашей библиотеке LAPACK. Класс коллбэка обеспечивает имя вашего заголовочного файла LAPACKE и информации, запрошенной, чтобы соединиться с вашей библиотекой LAPACK. Если этот параметр пуст, генератор кода производит код для функций линейной алгебры вместо вызова LAPACK.

Смотрите ускоряют линейную алгебру в сгенерированном автономном коде при помощи вызовов LAPACK.

Статические файлы библиотеки, чтобы соединиться со сгенерированным кодом, заданным как вектор символов. В векторе символов разделите имена файлов библиотеки символом pathsep.

Исходные файлы, чтобы скомпилировать и соединиться со сгенерированным кодом, заданным как вектор символов. В векторе символов разделите имена исходного файла символом pathsep.

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

Предположим, что вы задаете foo.cpp как исходный файл. Если foo.c и foo.cpp находятся оба на пути поиска файлов, вы не можете быть уверены, использует ли процесс сборки foo.c или foo.cpp.

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

Не задавайте статическое функциональное определение C.

Код, который появляется в сгенерированной оконечной функции, заданной как вектор символов.

Пользовательские настройки для инструментов в выбранном наборе инструментальных средств, заданном как массив ячеек.

Зависимости:

  • Свойство Toolchain определяет, какие инструменты и опции появляются в массиве ячеек.

  • Установка свойства BuildConfiguration к Specify включает CustomToolchainOptions.

Во-первых, получите текущие настройки. Например:

cfg = coder.config('lib');
cfg.BuildConfiguration='Specify';
opt = cfg.CustomToolchainOptions

Затем отредактируйте значения в opt.

Эти значения выводят из файла определения набора инструментальных средств и сторонних параметров компилятора. Смотрите Пользовательскую Регистрацию Набора инструментальных средств.

Замена типа данных в сгенерированном коде, заданном как одно из значений в этой таблице.

ЗначениеОписание
'CBuiltIn'

Это значение является значением по умолчанию.

Генератор кода использует встроенные типы данных C.

'CoderTypeDefs'Генератор кода использует предопределенные типы данных от rtwtypes.h

Объект Configuration для генерации кода для нейронных сетей для глубокого обучения, заданных как объект coder.MklDNNConfig или объект coder.ARMNEONConfig.

Объект coder.MklDNNConfig содержит параметры, характерные для генерации Кода С++ для глубокого обучения с помощью Intel® MKL-DNN. Чтобы создать объект coder.MklDNNConfig, используйте coder.DeepLearningConfig. Например:

cfg = coder.config('mex');
cfg.TargetLang = 'C++';
cfg.DeepLearningConfig = coder.DeepLearningConfig('mkldnn');

Объект coder.ARMNEONConfig содержит параметры, характерные для генерации Кода С++ для глубокого обучения, пользующегося Библиотекой ARM® Compute. Чтобы создать объект coder.ARMNEONConfig, используйте coder.DeepLearningConfig. Например:

cfg = coder.config('lib');
cfg.TargetLang = 'C++';
cfg.DeepLearningConfig = coder.DeepLearningConfig('arm-compute');

Генерация кода для нейронных сетей для глубокого обучения требует Deep Learning Toolbox™ и Интерфейса MATLAB Coder для пакета поддержки Библиотек Глубокого обучения.

Смотрите, что генерация кода для нейронных сетей для глубокого обучения с MKL-DNN и генерация кода для нейронных сетей для глубокого обучения с ARM вычисляют библиотеку.

Зависимость: Если DeepLearningConfig установлен, codegen устанавливает TargetLang на C++.

Описание объекта, заданное как вектор символов.

Режим динамического выделения памяти, заданный как одно из значений в этой таблице.

ЗначениеОписание
'Threshold'

Это значение является значением по умолчанию.

Генератор кода выделяет память динамически на куче для массивов переменного размера, размер которых (в байтах) больше, чем или равен DynamicMemoryAllocationThreshold.

'AllVariableSizeArrays'Генератор кода динамически выделяет память для всех массивов переменного размера на куче.
'Off'

Генератор кода статически выделяет память для массивов переменного размера на стеке.

Неограниченные массивы переменного размера требуют динамического выделения памяти.

Зависимости:

  • EnableVariableSizing включает этот параметр.

  • Установка этого DynamicMemoryAllocation к 'Threshold' включает параметр DynamicMemoryAllocationThreshold.

Смотрите генерируют код для данных Переменного Размера.

Порог размера для динамического выделения памяти массивов переменного размера, заданных как положительное целое число. Генератор кода использует динамическое выделение памяти для массивов переменного размера, размер которых (в байтах) больше, чем или равен порогу.

Зависимость:

  • Установка DynamicMemoryAllocation к 'Threshold' включает этот параметр.

Смотрите генерируют код для данных Переменного Размера.

Автоматические внешние вызовы функции, заданные как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Генератор кода обрабатывает некоторые общие функции визуализации как внешние функции. Вы не должны объявлять эти функции как внешние при помощи coder.extrinsic. Эта возможность уменьшает количество времени, что вы тратите создание вашего кода, подходящего для генерации кода.

falseГенератор кода не обрабатывает общие функции визуализации как внешние функции, если вы не объявляете их как внешних при помощи coder.extrinsic.

Некоторыми общими функциями визуализации является plot, disp и figure. Смотрите Внешние Функции.

Оптимизация memcpy, заданная как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Если возможно, генератор кода использует оптимизацию memcpy. Чтобы оптимизировать код, который копирует последовательные элементы массива, оптимизация memcpy заменяет код на вызов memcpy. Когда число элементов, чтобы скопировать известно во время компиляции, генератор кода использует свойство MemcpyThreshold определить, использовать ли оптимизацию. См. memcpy Оптимизацию.

false

Генератор кода не использует оптимизацию memcpy.

Распараллеливание parfor - циклы, заданные как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Если возможно, генератор кода пользуется библиотекой OpenMP, чтобы произвести итерации цикла, которые запускаются параллельно.

false

Генератор кода обрабатывает parfor - циклы как for - циклы.

Смотрите parfor.

Использование библиотеки OpenMP не совместимо со своевременной (JIT) компиляцией. Если EnableJIT и EnableOpenMP является true, генератор кода использует JIT-компиляцию и обрабатывает parfor - циклы как for - циклы.

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

ЗначениеОписание
true

Это значение является значением по умолчанию.

Рекурсивные функции позволены в сгенерированном коде.

false

Рекурсивные функции не позволены в сгенерированном коде.

Некоторые стандарты кодирования, такие как MISRA®, не позволяют рекурсию. Чтобы увеличить вероятность генерации кода, который совместим с MISRA C®, устанавливает EnableRuntimeRecursion на false.

Если ваш код MATLAB требует рекурсии во время выполнения, и EnableRuntimeRecursion является false, сбои генерации кода.

Смотрите генерацию кода для рекурсивных функций.

Поддержка массивов переменного размера, заданная как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Массивы переменного размера позволены для генерации кода.

false

Массивы переменного размера не позволены для генерации кода.

Зависимость:

  • Включает Dynamic memory allocation.

Смотрите генерацию кода для массивов Переменного Размера.

Режим разделения файла, заданный как одно из значений в этой таблице.

ЗначениеОписание
'MapMFileToCFile'

Это значение является значением по умолчанию.

Генератор кода производит отдельные файлы C/C++ для каждого файла языка MATLAB.

'SingleFile'Генератор кода производит один файл для функций C/C++, которые сопоставляют с вашими функциями точки входа MATLAB. Генератор кода производит отдельные файлы C/C++ для служебных функций.

Смотрите как сгенерированный код разделов MATLAB Coder.

Генерация только исходного кода, заданного как одно из значений в этой таблице.

ЗначениеОписание
false

Это значение является значением по умолчанию.

Генератор кода производит исходный код C/C++ и создает объектный код.

true

Генератор кода производит исходный код C/C++, но не вызывает сделать команду или создает объектный код. Когда вы выполняете итерации между изменением кода MATLAB, и генерация кода C/C++, генерируя только код может сэкономить время.

Комментарии в сгенерированном коде, заданном как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Генератор кода помещает комментарии в сгенерированный код.

falseГенератор кода не помещает комментарии в сгенерированный код.

Пример C/C++ основная генерация файла, заданная как одно из значений в этой таблице.

ЗначениеОписание
'GenerateCodeOnly'

Это значение является значением по умолчанию.

Генератор кода генерирует пример C/C++ основная функция, но не компилирует его.

'DoNotGenerate'

Генератор кода не генерирует пример C/C++ основная функция.

'GenerateCodeAndCompile'

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

Если параметром GenCodeOnly является true, генератор кода не компилирует C/C++ основная функция.

Основная функция примера является шаблоном, чтобы помочь вам записать C/C++ основную функцию, которая вызывает сгенерированный код C/C++. Смотрите Включают Сгенерированный код Используя Пример Основная Функция.

Генерация make-файла во время процесса сборки, заданного как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Генератор кода генерирует make-файл во время процесса сборки.

falseГенератор кода не генерирует make-файл во время процесса сборки. Задайте инструкции для обработки постгенерации кода, включая компиляцию и соединение, в команде постгенерации кода. Смотрите Индивидуальную настройку Процесса сборки.

Генерация файлов поддержки для неличных данных, заданных как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Генератор кода производит файлы поддержки для неличных данных (Inf и NaN), только если сгенерированный код использует неличные данные.

false

Генератор кода всегда производит файлы поддержки для неличных данных (Inf и NaN).

Зависимость:

  • Установка SupportNonFinite к true включает этот параметр.

Отчет генерации кода, заданный как одно из значений в этой таблице.

ЗначениеОписание
false

Это значение является значением по умолчанию.

Генератор кода представляет отчет, только если сообщения об ошибке или предупреждающие сообщения происходят, или если вы устанавливаете LaunchReport на true.

trueГенератор кода представляет отчет генерации кода.

Объект, который задает аппаратную плату. Чтобы создать объект coder.Hardware, используйте coder.hardware. Например:

cfg = coder.config('lib');
hw = coder.hardware('Raspberry Pi');
cfg.Hardware = hw;

Прежде чем вы будете использовать coder.hardware, необходимо установить пакет поддержки для оборудования.

Зависимости:

  • Установка Hardware настраивает объект аппаратной реализации и другие параметры конфигурации для конкретной аппаратной платы.

  • Если DeepLearningConfig установлен в объект coder.ARMNEONConfig, и Hardware пуст, то codegen устанавливает свойство GenCodeOnly на true.

Примечание:

  • Предположим, что вы создаете объект coder.CodeConfig cfg в сеансе работы с MATLAB и используете его в другом сеансе работы с MATLAB. Если хосту - компьютеру MATLAB для второго сеанса не задали аппаратную плату в свойстве cfg.Hardware, установленном на нем, этот параметр возвращается к своему значению по умолчанию. Значением по умолчанию является [].

Объект аппаратной реализации, который задает специфичные для оборудования параметры конфигурации для генерации кода C/C++. coder.config создает объект coder.CodeConfig с набором свойств HardwareImplementation к объекту coder.HardwareImplementation со значениями параметров по умолчанию для хоста - компьютера MATLAB.

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

ЗначениеОписание
true

Отчет генерации кода отображает потенциальные проблемы эффективности из-за главного строкой размещения. (Это значение является значением по умолчанию.)

falseОтчет генерации кода не отображает проблемы, связанные с размещением массивов.

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

Присвоение плавания и дважды обнуляет с memset, заданным как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Если возможно, генератор кода использует оптимизацию memset для присвоения нуля с плавающей точкой к последовательным элементам массива. Чтобы присвоить последовательные элементы массива, оптимизация memset использует вызов memset. Когда число элементов, чтобы присвоить известно во время компиляции, генератор кода использует свойство MemcpyThreshold определить, использовать ли оптимизацию. См. memset Оптимизацию.

false

Генератор кода не использует оптимизацию memset для присвоения плавания и удваивает нуль до последовательных элементов массива.

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

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

Эта возможность особенно важна для встраиваемых процессоров, где размер стека может быть ограничен.

Смотрите, что управление встраивает.

Функциональный порог размера для встраивания, заданный как положительное целое число.

Если другие условия не предотвращают встраивание, генератор кода встраивает функции, которые меньше, чем порог.

Функциональный размер измеряется как отвлеченное число инструкций, не фактических инструкций MATLAB или инструкций в целевом процессоре. Получить поведение встраивания, которое вы хотите, эксперимент с порогом. Например, если пороговые результаты по умолчанию во встраивании больших функций и генерации больших сумм кода С, настройте порог, пока вы не будете удовлетворены размером сгенерированного кода.

Смотрите, что управление встраивает.

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

Функциональный размер измеряется как отвлеченное число инструкций, не фактических инструкций MATLAB или инструкций в целевом процессоре. Получить поведение встраивания, которое вы хотите, эксперимент с порогом. Например, если пороговые результаты по умолчанию во встраивании больших функций и генерации больших сумм кода С, настройте порог, пока вы не будете удовлетворены размером сгенерированного кода.

Смотрите, что управление встраивает.

Автоматический открытый из отчета генерации кода, заданного как одно из значений в этой таблице.

ЗначениеОписание
false

Это значение является значением по умолчанию.

Если ошибки или предупреждения происходят, или если GenerateReport является true, генератор кода представляет отчет, но не открывает отчет.

trueГенератор кода производит и открывает отчет генерации кода.

Циклы с меньшим количеством итераций, чем этот порог являются кандидатами на автоматическое разворачивание генератором кода. Этот порог применяется ко всему for - циклы в вашем коде MATLAB. Для отдельного for - цикл, директива coder.unroll, помещенная сразу, прежде чем, цикл более приоритетен по сравнению с оптимизацией развертывания цикла. Порог может также примениться к некоторому for - циклы, произведенные во время генерации кода.

Смотрите разворачивают циклы for.

Включение исходного кода MATLAB как комментарии в сгенерированном коде, заданном как одно из значений в этой таблице.

ЗначениеОписание
false

Это значение является значением по умолчанию.

Генератор кода не вставляет исходный код MATLAB как комментарии в сгенерированном коде. Генератор кода не включает подпись функции MATLAB в функциональный баннер.

true

Генератор кода вставляет исходный код MATLAB как комментарии в сгенерированном коде. Тег трассируемости сразу предшествует каждой строке исходного кода. Тег трассируемости помогает вам определить местоположение соответствующего исходного кода MATLAB. Смотрите Трассировку Сгенерированный Код C/C++ к Исходному коду MATLAB.

Если у вас есть Embedded Coder в отчете генерации кода, тег трассируемости соединяется с исходным кодом.

Генератор кода также включает подпись функции MATLAB в функциональный баннер.

Зависимость:

  • GenerateComments включает этот параметр.

Смотрите Трассировку Сгенерированный Код C/C++ к Исходному коду MATLAB.

Максимальное количество символов в сгенерированных идентификаторах, заданных как положительное целое число в области значений [31, 256]. Это свойство применяется к сгенерированной функции, введите определение и имена переменных. Чтобы избежать усечения идентификаторов целевым компилятором C, задайте значение, которое совпадает с максимальной длиной идентификатора целевого компилятора C.

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

Минимальный размер, в байтах, для memcpy или memset оптимизации, заданной как положительное целое число.

Чтобы оптимизировать сгенерированный код, который копирует последовательные элементы массива, генератор кода пытается заменить код на вызов memcpy. Чтобы оптимизировать сгенерированный код, который присваивает литеральную константу последовательным элементам массива, генератор кода пытается заменить код на вызов memset.

Количество байтов является количеством элементов массива, чтобы скопировать или присвоить умноженный на количество байтов, требуемых для типа данных C/C++.

Если число элементов, чтобы скопировать или присвоить является переменным (не известный во время компиляции), генератор кода игнорирует свойство MemcpyThreshold.

См. memcpy Оптимизацию и memset Оптимизацию.

Мультиэкземпляр, повторно используемый код, заданный как одно из значений в этой таблице.

ЗначениеОписание
false

Это значение является значением по умолчанию.

Генератор кода не производит мультиэкземпляр, повторно используемый код.

true

Генератор кода производит допускающий повторное использование, код мультиэкземпляра, который повторно используем.

См. повторно используемый код.

Имя объекта, заданное как вектор символов.

Выведите, чтобы создать из сгенерированного кода C/C++, заданного как одно из значений в этой таблице.

ЗначениеОписание
'LIB'Статическая библиотека
'DLL'Динамически подключаемая библиотека
'EXE'Исполняемая программа

Передайте структуры в отношении функций точки входа, заданных как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

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

Примечание

Функция точки входа, которая пишет в поле параметра структуры, перезаписывает входное значение.

falseСгенерированный код передает структуры значением.

Этот параметр применяется только к функциям точки входа.

Смотрите аргументы структуры передачи ссылкой или значением в сгенерированном коде.

Команда, чтобы настроить сборку, обрабатывающую после генерации MEX-функции с codegen, заданным как вектор символов.

Смотрите индивидуальную настройку процесса сборки.

Генерация кода, который использует N-мерную индексацию, заданную как одно из значений в этой таблице.

ЗначениеОписание
false

Сгенерируйте код, который использует одномерную индексацию. (Это значение является значением по умолчанию.)

trueСгенерируйте код, который использует N-мерную индексацию.

Смотрите генерируют код, который использует n-мерную индексацию.

Имена переменных, чтобы сохранить в сгенерированном коде, заданном как одно из значений в этой таблице.

ЗначениеОписание
'None'

Это значение является значением по умолчанию.

Генератор кода не должен сохранять имена переменных. Это может снова использовать любые переменные, которые удовлетворяют требования для переменного повторного использования.

Если ваш код использует большие структуры или массивы, установка PreserveVariableNames к 'None' может уменьшать использование памяти или улучшить скорость выполнения.

'UserNames'

Генератор кода сохраняет имена, которые соответствуют переменным, которые вы задаете в коде MATLAB. Это не заменяет ваше имя переменной на другое имя и не использует ваше имя для другой переменной. Чтобы улучшить удобочитаемость, установите PreserveVariableNames на 'UserNames'. Затем можно более легко проследить переменные в сгенерированном коде назад к переменным в коде MATLAB.

Установка PreserveVariableNames к 'UserNames' не препятствует тому, чтобы оптимизация удалила ваши переменные из сгенерированного кода, или препятствует тому, чтобы компилятор C/C++ снова использовал переменные в сгенерированном двоичном коде.

'All'

Сохраните все имена переменных. Это значение параметров отключает переменное повторное использование. Используйте его только для тестирования или отладки, не для производственного кода.

Смотрите имена переменных заповедника в сгенерированном коде.

Имя переменной, в которую вы экспортируете информацию о генерации кода, заданной как вектор символов. Генератор кода создает эту переменную в основном рабочем пространстве MATLAB. Эта переменная содержит информацию о настройках генерации кода, входных файлах, сгенерированных файлах и сообщениях генерации кода.

Смотрите, что Генерация Кода доступа Сообщает информацию Программно и кодер. Свойства ReportInfo.

Создание отчетов разности потенциалов, заданное как одно из значений в этой таблице:

ЗначениеОписание
trueГенератор кода сообщает о потенциальных различиях в поведении между сгенерированным кодом и кодом MATLAB. Разности потенциалов перечислены на вкладке отчета генерации кода. Разность потенциалов является различием, которое происходит во время выполнения только при определенных обстоятельствах.
falseГенератор кода не сообщает о разностях потенциалов.

Смотрите, что разности потенциалов сообщают.

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

Генерация кода, который использует размещение главного массива строки, заданное как одно из значений в этой таблице.

ЗначениеОписание
false

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

trueСгенерируйте код, который использует размещение главного массива строки.

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

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

ЗначениеОписание
false

Это значение является значением по умолчанию.

Сгенерированный код не проверяет ошибки в таком как за пределы индексация массива.

true

Сгенерированный код проверяет ошибки в таком как за пределы индексация массива.

Программное обеспечение сообщения об ошибке использует fprintf для сообщений ошибки при записи к stderr. Это использует abort, чтобы отключить приложение. Если fprintf и abort не доступны, необходимо обеспечить их. Функция abort резко отключает программу. Если ваша система поддерживает сигналы, можно отловить сигнал аварийного прекращения работы (SIGABRT) так, чтобы можно было управлять завершением программы.

Сообщения об ошибке находятся на английском языке.

Смотрите обнаружение ошибки времени выполнения и сообщающий в автономном коде C/C++.

Поддержка целочисленного переполнения, заданная как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

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

false

Генератор кода не производит код, чтобы обработать целочисленное переполнение. Не устанавливайте SaturateOnIntegerOverflow на false, если вы не уверены, что ваш код не зависит от поддержки целочисленного переполнения. Если вы отключаете поддержку целочисленного переполнения, и проверка ошибки времени выполнения включена, сгенерированный код производит ошибку для переполнения. Если вы отключаете поддержку целочисленного переполнения, и вы отключаете проверку ошибки времени выполнения, поведение переполнения зависит от вашего целевого компилятора C. В стандарте C поведение для целочисленного переполнения не определено. Однако большинство компиляторов C переносится на переполнении.

Этот параметр применяет только к MATLAB встроенные целочисленные типы. Это не применяется, удваивается, одиночные игры или типы данных с фиксированной точкой.

Смотрите отключают поддержку Integer Overflow или Nonfinites.

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

Смотрите отключают поддержку Integer Overflow или Nonfinites.

Поддержка неличных значений, заданных как одно из значений в этой таблице.

ЗначениеОписание
true

Это значение является значением по умолчанию.

Если GenerateNonFiniteFilesIfUsed установлен в true, генератор кода производит код, чтобы поддержать неличные значения (Inf и NaN), только если они используются.

Если GenerateNonFiniteFilesIfUsed установлен в false, генератор кода всегда производит код, чтобы поддержать неличные значения (Inf и NaN).

false

Генератор кода не производит код, чтобы поддержать неличные значения.

Смотрите отключают поддержку Integer Overflow или Nonfinites.

Язык, чтобы использовать в сгенерированном коде, заданном как 'C' или 'C++'. Если вы задаете C++, генератор кода переносит код С в .cpp файлы так, чтобы можно было использовать компилятор C++ и интерфейс с внешними приложениями C++. Это не генерирует классы C++.

Зависимость: Если DeepLearningConfig установлен, codegen устанавливает TargetLang на C++.

Стандартная математическая библиотека, чтобы использовать для сгенерированного кода, заданного как один из этих векторов символов:

  • 'C89/C90 (ANSI)'

  • 'C99 (ISO)'

  • 'C++03 (ISO)'

Генератор кода пользуется стандартной математической библиотекой для вызовов математических операций. Стандартная математическая библиотека по умолчанию зависит от языка, который вы выбираете. Для C библиотекой по умолчанию является 'C99 (ISO)'. Для C++ библиотекой по умолчанию является 'C++03 (ISO)'.

Смотрите изменяют стандартную математическую библиотеку.

Набор инструментальных средств, чтобы использовать для создания C/C++ библиотечную или исполняемую программу, заданную как вектор символов. Список доступных наборов инструментальных средств зависит от платформы хоста - компьютера и может включать пользовательские наборы инструментальных средств, которые вы добавили. Если вы не задаете набор инструментальных средств, генератор кода определяет местоположение установленного набора инструментальных средств.

Примечание:

  • Предположим, что вы создаете объект coder.CodeConfig cfg в сеансе работы с MATLAB и используете его в другом сеансе работы с MATLAB. Если хосту - компьютеру MATLAB для второго сеанса не задали набор инструментальных средств в свойстве cfg.Toolchain, установленном на нем, этот параметр возвращается к своему значению по умолчанию. Значением по умолчанию является 'Automatically locate an installed toolchain'.

Отображение успеха генерации кода, заданное как одно из значений в этой таблице.

ЗначениеОписание
false

Это значение является значением по умолчанию.

Генератор кода не отображает успех генерации кода.

true

Генератор кода отображает успех генерации кода, включая этапы генерации кода и выход компилятора.

Примеры

свернуть все

Запишите функцию MATLAB, от которой можно сгенерировать код. Этот пример использует функциональный myadd, который возвращает сумму его входных параметров.

function c = myadd(a,b)
c = a + b;
end

Создайте объект настройки для генерации автономного кода C/C++ (статическая библиотека, динамически подключаемая библиотека или исполняемая программа). Например, создайте объект настройки для генерации статической библиотеки.

cfg = coder.config('lib');

Измените значения свойств, для которых вы не хотите использовать значения по умолчанию. Например, включите обнаружение ошибки времени выполнения и сообщающий в сгенерированном коде C/C++.

cfg.RuntimeChecks = true;

Сгенерируйте код при помощи codegen. Передайте объект настройки codegen при помощи опции -config. Укажите, что входные параметры являются скаляром дважды.

codegen myadd -config cfg -args {1 1} -report

Альтернативная функциональность

Использовать параметры конфигурации по умолчанию для сборки вводит 'LIB', 'DLL' или 'EXE', используйте опцию codegen -config:lib, -config:dll или -config:exe, соответственно. Затем вы не должны создать и передать объект настройки codegen.

Введенный в R2011a