Параметры конфигурации для генерации кода C/C++ из кода MATLAB
Объект coder.CodeConfig
содержит параметры конфигурации, которые codegen
использует для генерации статической библиотеки, динамически подключаемой библиотеки или исполняемой программы. Передайте объект функции codegen
при помощи опции -config
.
cfg = coder.config(build_type)
cfg = coder.config(build_type,
'ecoder', false)
cfg = coder.config(
создает объект настройки генерации кода для заданного типа сборки, который может быть статической библиотекой, динамически подключаемой библиотекой или исполняемой программой. Если продукт Embedded Coder® не установлен, он создает объект build_type
)coder.CodeConfig
. В противном случае это создает объект coder.EmbeddedCodeConfig
.
cfg = coder.config(
создает объект build_type
,
'ecoder', false)coder.CodeConfig
для заданного выходного типа, даже если вам установили Embedded Coder.
build_type
— Выведите, чтобы создать из сгенерированного кода C/C++'LIB'
| 'DLL'
| 'EXE'
Выведите, чтобы создать из сгенерированного кода C/C++, заданного как одно из значений в этой таблице.
Значение | Описание |
---|---|
'LIB' | Статическая библиотека |
'DLL' | Динамически подключаемая библиотека |
'EXE' | Исполняемая программа |
BuildConfiguration
— Компиляторная оптимизация или параметры настройки отладки для набора инструментальных средств'Faster Builds'
(значение по умолчанию) | 'Faster Runs'
| 'Debug'
| 'Specify'
Компиляторная оптимизация или параметры настройки отладки для набора инструментальных средств, заданного как одно из значений в этой таблице.
Значение | Описание |
---|---|
'Faster Builds' |
Оптимизирует сборку в течение более короткого времени изготовления. |
'Faster Runs' |
Оптимизирует сборку для более быстрых рабочих исполняемых файлов. |
'Debug' |
Оптимизирует сборку для отладки. |
'Specify' |
Включает свойство |
CodeReplacementLibrary
— Заменяющая библиотека кода для сгенерированного кодаЗаменяющая библиотека кода для сгенерированного кода, заданного как одно из значений в этой таблице:
Значение | Описание |
---|---|
'None' | Это значение является значением по умолчанию. Не пользуется заменяющей библиотекой кода. |
Названная заменяющая библиотека кода | Генерирует вызовы определенной платформы, компилятора или заменяющей библиотеки стандартов кода. Список именованных библиотек зависит от:
|
Совместимые библиотеки зависят от этих параметров:
TargetLang
TargetLangStandard
ProdHWDeviceType
в объекте настройки аппаратной реализации.
Embedded Coder предлагает больше библиотек и способность создать и пользоваться заменяющими библиотеками пользовательского кода.
MATLAB® Coder™ генерирует минимальный набор операторов #include
для заголовочных файлов, требуемых выбранной заменяющей библиотекой кода.
Прежде, чем установить этот параметр, проверьте, что ваш компилятор поддерживает библиотеку, которой вы хотите пользоваться. Если вы выбираете значение параметров, которое не поддерживает ваш компилятор, ошибки компилятора могут произойти.
Программное обеспечение MATLAB Coder не поддерживает коллбэки TLC.
CompileTimeRecursionLimit
— Максимальное количество функциональных специализаций для рекурсии времени компиляцииМаксимальное количество функциональных специализаций для рекурсии времени компиляции, заданной как положительное целое число. Чтобы запретить рекурсию в коде MATLAB, установите CompileTimeRecursionLimit
на 0. Предел рекурсии времени компиляции по умолчанию является достаточно большим для большинства рекурсивных функций, которые требуют этого типа рекурсии. Если генерация кода перестала работать из-за предела рекурсии времени компиляции, и вы хотите рекурсию времени компиляции, пытаетесь увеличить предел. Также измените свой код MATLAB так, чтобы генератор кода использовал рекурсию во время выполнения. Смотрите Достигнутый Предел Рекурсии Времени компиляции.
ConstantFoldingTimeout
— Максимальное количество инструкций, которые будут выполняться постоянной папкойМаксимальное количество инструкций, что постоянная папка выполняется. В некоторых ситуациях генерация кода требует, чтобы конкретные инструкции были постоянными. Если сворачивание констант останавливается, прежде чем эти инструкции постоянно свернуты, сбои генерации кода. В этом случае увеличьте значение ConstantFoldingTimeout
.
CustomBLASCallback
— Класс коллбэка BLASКласс коллбэка для библиотеки BLAS вызывает в коде, сгенерированном для определенного низкоуровневого вектора и операций над матрицей в коде MATLAB, заданном как вектор символов.
Если вы задаете класс коллбэка BLAS для определенных низкоуровневых векторных и матричных функций, генератор кода производит вызовы BLAS при помощи интерфейса CBLAS C к вашей библиотеке BLAS. Класс коллбэка обеспечивает имя вашего заголовочного файла CBLAS, имена типов данных CBLAS и информацию, запрошенную, чтобы соединиться с вашей библиотекой BLAS. Если этот параметр пуст, генератор кода производит код для матричных функций вместо вызова BLAS.
Смотрите ускоряют Матричные операции в сгенерированном автономном коде при помощи вызовов BLAS.
CustomFFTCallback
— Класс коллбэка для вызовов библиотеки FFTW Класс коллбэка для библиотеки FFTW вызывает в коде, сгенерированном для функций БПФ в коде MATLAB, заданном как вектор символов.
Чтобы улучшить скорость выполнения функций БПФ, генератор кода производит вызовы библиотеки FFTW, которую вы задаете в классе коллбэка. Если этот параметр пуст, генератор кода использует свои собственные алгоритмы для функций БПФ вместо того, чтобы вызвать библиотеку FFTW.
CustomHeaderCode
— Пользовательский код, который появляется наверху сгенерированных заголовочных файлов C/C++Пользовательский код, который появляется около верхней части каждого заголовочного файла C/C++, сгенерированного из вашего кода MATLAB, заданного как вектор символов.
CustomInclude
— Include, чтобы добавить, чтобы включать путь для компиляции сгенерированного кодаВключайте папки, чтобы добавить к включать пути при компиляции сгенерированного кода. Укажите, что список включает папки как вектор символов. В векторе символов, отдельном, включают папки символом pathsep
. Например:
cfg = coder.config('lib','ecoder',false); cfg.CustomInclude = ['C:\Project' pathsep 'C:\Custom Files'];
CustomInitializer
— Пользовательский код, чтобы включать в сгенерированное инициализирует функциюПользовательский код, чтобы включать в сгенерированное инициализирует функцию, заданную как вектор символов.
CustomLAPACKCallback
— Класс коллбэка LAPACKКласс коллбэка для библиотеки LAPACK вызывает в коде, сгенерированном для определенных функций линейной алгебры в коде MATLAB, заданном как вектор символов.
Если вы задаете класс коллбэка LAPACK для определенных функций линейной алгебры, генератор кода производит вызовы LAPACK при помощи интерфейса LAPACKE C к вашей библиотеке LAPACK. Класс коллбэка обеспечивает имя вашего заголовочного файла LAPACKE и информации, запрошенной, чтобы соединиться с вашей библиотекой LAPACK. Если этот параметр пуст, генератор кода производит код для функций линейной алгебры вместо вызова LAPACK.
Смотрите ускоряют линейную алгебру в сгенерированном автономном коде при помощи вызовов LAPACK.
CustomLibrary
— Static, чтобы соединиться со сгенерированным кодомСтатические файлы библиотеки, чтобы соединиться со сгенерированным кодом, заданным как вектор символов. В векторе символов разделите имена файлов библиотеки символом pathsep
.
CustomSource
— Исходные файлы, чтобы скомпилировать и соединиться со сгенерированным кодомИсходные файлы, чтобы скомпилировать и соединиться со сгенерированным кодом, заданным как вектор символов. В векторе символов разделите имена исходного файла символом pathsep
.
Процесс сборки ищет исходные файлы сначала в текущей папке, и затем во включать папках, которые вы задаете в CustomInclude
. Если исходные файлы с тем же именем происходят в нескольких папках на пути поиска файлов, процесс сборки может использовать различный файл, чем файл, который вы задали.
Предположим, что вы задаете foo.cpp
как исходный файл. Если foo.c
и foo.cpp
находятся оба на пути поиска файлов, вы не можете быть уверены, использует ли процесс сборки foo.c
или foo.cpp
.
CustomSourceCode
— Код, чтобы появиться около верхней части сгенерированного .c
или файла .cpp
Задайте код, чтобы появиться около верхней части сгенерированного .c
или файла .cpp
, за пределами любой функции. Задайте код как вектор символов.
Не задавайте статическое функциональное определение C.
CustomTerminator
— Код, который появляется в сгенерированной оконечной функции Код, который появляется в сгенерированной оконечной функции, заданной как вектор символов.
CustomToolchainOptions
— Custom для инструментов в выбранном наборе инструментальных средствПользовательские настройки для инструментов в выбранном наборе инструментальных средств, заданном как массив ячеек.
Зависимости:
Свойство Toolchain
определяет, какие инструменты и опции появляются в массиве ячеек.
Установка свойства BuildConfiguration
к Specify
включает CustomToolchainOptions
.
Во-первых, получите текущие настройки. Например:
cfg = coder.config('lib'); cfg.BuildConfiguration='Specify'; opt = cfg.CustomToolchainOptions
Затем отредактируйте значения в opt
.
Эти значения выводят из файла определения набора инструментальных средств и сторонних параметров компилятора. Смотрите Пользовательскую Регистрацию Набора инструментальных средств.
DataTypeReplacement
— Замена типа данных в сгенерированном коде'CBuiltIn'
| 'CoderTypeDefs'
Замена типа данных в сгенерированном коде, заданном как одно из значений в этой таблице.
Значение | Описание |
---|---|
'CBuiltIn' |
Это значение является значением по умолчанию. Генератор кода использует встроенные типы данных C. |
'CoderTypeDefs' | Генератор кода использует предопределенные типы данных от rtwtypes.h |
DeepLearningConfig
— Configuration для генерации кода глубокого обученияcoder.MklDNNConfig
| объект coder.ARMNEONConfig
Объект 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++
.
Описание
Описание объекта 'class CodeConfig: C code generation configuration.'
(значение по умолчанию) | вектор символовОписание объекта, заданное как вектор символов.
DynamicMemoryAllocation
— Режим динамического выделения памяти'Threshold'
(значение по умолчанию) | 'AllVariableSizeArrays'
| 'Off'
Режим динамического выделения памяти, заданный как одно из значений в этой таблице.
Значение | Описание |
---|---|
'Threshold' |
Это значение является значением по умолчанию. Генератор кода выделяет память динамически на куче для массивов переменного размера, размер которых (в байтах) больше, чем или равен |
'AllVariableSizeArrays' | Генератор кода динамически выделяет память для всех массивов переменного размера на куче. |
'Off' |
Генератор кода статически выделяет память для массивов переменного размера на стеке. |
Неограниченные массивы переменного размера требуют динамического выделения памяти.
Зависимости:
EnableVariableSizing
включает этот параметр.
Установка этого DynamicMemoryAllocation
к 'Threshold'
включает параметр DynamicMemoryAllocationThreshold
.
DynamicMemoryAllocationThreshold
— Порог размера для динамического выделения памяти массивов переменного размера65536
(значение по умолчанию) | положительное целое числоПорог размера для динамического выделения памяти массивов переменного размера, заданных как положительное целое число. Генератор кода использует динамическое выделение памяти для массивов переменного размера, размер которых (в байтах) больше, чем или равен порогу.
Зависимость:
Установка DynamicMemoryAllocation
к 'Threshold'
включает этот параметр.
EnableAutoExtrinsicCalls
— Автоматические внешние вызовы функцииtrue
(значение по умолчанию) | false
Автоматические внешние вызовы функции, заданные как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Генератор кода обрабатывает некоторые общие функции визуализации как внешние функции. Вы не должны объявлять эти функции как внешние при помощи |
false | Генератор кода не обрабатывает общие функции визуализации как внешние функции, если вы не объявляете их как внешних при помощи coder.extrinsic . |
Некоторыми общими функциями визуализации является plot
, disp
и figure
. Смотрите Внешние Функции.
EnableMemcpy
— оптимизация memcpy
true
(значение по умолчанию) | false
Оптимизация memcpy
, заданная как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Если возможно, генератор кода использует оптимизацию |
false |
Генератор кода не использует оптимизацию |
EnableOpenMP
— распараллеливание parfor
- циклыtrue
(значение по умолчанию) | false
Распараллеливание parfor
- циклы, заданные как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Если возможно, генератор кода пользуется библиотекой OpenMP, чтобы произвести итерации цикла, которые запускаются параллельно. |
false |
Генератор кода обрабатывает |
Смотрите parfor
.
Использование библиотеки OpenMP не совместимо со своевременной (JIT) компиляцией. Если EnableJIT
и EnableOpenMP
является true
, генератор кода использует JIT-компиляцию и обрабатывает parfor
- циклы как for
- циклы.
EnableRuntimeRecursion
— Поддержка рекурсии во время выполненияtrue
(значение по умолчанию) | false
Поддержка рекурсии во время выполнения, заданная как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Рекурсивные функции позволены в сгенерированном коде. |
false |
Рекурсивные функции не позволены в сгенерированном коде. |
Некоторые стандарты кодирования, такие как MISRA®, не позволяют рекурсию. Чтобы увеличить вероятность генерации кода, который совместим с MISRA C®, устанавливает EnableRuntimeRecursion
на false
.
Если ваш код MATLAB требует рекурсии во время выполнения, и EnableRuntimeRecursion
является false
, сбои генерации кода.
Смотрите генерацию кода для рекурсивных функций.
EnableVariableSizing
— Поддержка массивов переменного размераtrue
(значение по умолчанию) | false
Поддержка массивов переменного размера, заданная как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Массивы переменного размера позволены для генерации кода. |
false |
Массивы переменного размера не позволены для генерации кода. |
Зависимость:
Включает Dynamic memory allocation
.
FilePartitionMethod
— Режим разделения файла'MapMFileToCFile'
(значение по умолчанию) | 'SingleFile'
Режим разделения файла, заданный как одно из значений в этой таблице.
Значение | Описание |
---|---|
'MapMFileToCFile' |
Это значение является значением по умолчанию. Генератор кода производит отдельные файлы C/C++ для каждого файла языка MATLAB. |
'SingleFile' | Генератор кода производит один файл для функций C/C++, которые сопоставляют с вашими функциями точки входа MATLAB. Генератор кода производит отдельные файлы C/C++ для служебных функций. |
GenCodeOnly
— Генерация только исходного кодаfalse
(значение по умолчанию) | true
Генерация только исходного кода, заданного как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Это значение является значением по умолчанию. Генератор кода производит исходный код C/C++ и создает объектный код. |
true |
Генератор кода производит исходный код C/C++, но не вызывает сделать команду или создает объектный код. Когда вы выполняете итерации между изменением кода MATLAB, и генерация кода C/C++, генерируя только код может сэкономить время. |
GenerateComments
— Комментарии в сгенерированном коде true
(значение по умолчанию) | false
Комментарии в сгенерированном коде, заданном как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Генератор кода помещает комментарии в сгенерированный код. |
false | Генератор кода не помещает комментарии в сгенерированный код. |
GenerateExampleMain
— Пример C/C++ основная генерация файла'GenerateCodeOnly'
(значение по умолчанию) | 'DoNotGenerate'
| 'GenerateCodeAndCompile'
Пример C/C++ основная генерация файла, заданная как одно из значений в этой таблице.
Значение | Описание |
---|---|
'GenerateCodeOnly' |
Это значение является значением по умолчанию. Генератор кода генерирует пример C/C++ основная функция, но не компилирует его. |
'DoNotGenerate' |
Генератор кода не генерирует пример C/C++ основная функция. |
'GenerateCodeAndCompile' |
Генератор кода генерирует пример C/C++ основная функция и компилирует его, чтобы создать тестовый исполняемый файл. Этот исполняемый файл не возвращает выходной параметр. Если параметром |
Основная функция примера является шаблоном, чтобы помочь вам записать C/C++ основную функцию, которая вызывает сгенерированный код C/C++. Смотрите Включают Сгенерированный код Используя Пример Основная Функция.
GenerateMakefile
— Генерация make-файлаtrue
(значение по умолчанию) | false
Генерация make-файла во время процесса сборки, заданного как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Генератор кода генерирует make-файл во время процесса сборки. |
false | Генератор кода не генерирует make-файл во время процесса сборки. Задайте инструкции для обработки постгенерации кода, включая компиляцию и соединение, в команде постгенерации кода. Смотрите Индивидуальную настройку Процесса сборки. |
GenerateNonFiniteFilesIfUsed
— Сгенерируйте файлы поддержки для неличных данных, только если неличные данные используютсяtrue
(значение по умолчанию) | false
Генерация файлов поддержки для неличных данных, заданных как одно из значений в этой таблице.
Значение | Описание |
---|---|
true | Это значение является значением по умолчанию. Генератор кода производит файлы поддержки для неличных данных ( |
false | Генератор кода всегда производит файлы поддержки для неличных данных ( |
Зависимость:
Установка SupportNonFinite
к true
включает этот параметр.
GenerateReport
— Отчет генерации кодаfalse
(значение по умолчанию) | верныйОтчет генерации кода, заданный как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Это значение является значением по умолчанию. Генератор кода представляет отчет, только если сообщения об ошибке или предупреждающие сообщения происходят, или если вы устанавливаете |
true | Генератор кода представляет отчет генерации кода. |
Hardware
— Объект, который задает аппаратную плату coder.Hardware
Объект, который задает аппаратную плату. Чтобы создать объект 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
, установленном на нем, этот параметр возвращается к своему значению по умолчанию. Значением по умолчанию является []
.
HardwareImplementation
— Объект аппаратной реализацииcoder.HardwareImplementation
.Объект аппаратной реализации, который задает специфичные для оборудования параметры конфигурации для генерации кода C/C++. coder.config
создает объект coder.CodeConfig
с набором свойств HardwareImplementation
к объекту coder.HardwareImplementation
со значениями параметров по умолчанию для хоста - компьютера MATLAB.
HighlightPotentialRowMajorIssues
— Потенциальные главные строкой проблемы размещенияtrue
(значение по умолчанию) | false
Отображение потенциальных главных строкой проблем эффективности размещения, заданных как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Отчет генерации кода отображает потенциальные проблемы эффективности из-за главного строкой размещения. (Это значение является значением по умолчанию.) |
false | Отчет генерации кода не отображает проблемы, связанные с размещением массивов. |
InitFltsAndDblsToZero
— Присвоение плавания и дважды обнуляет с memset true
(значение по умолчанию) | false
Присвоение плавания и дважды обнуляет с memset
, заданным как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Если возможно, генератор кода использует оптимизацию |
false |
Генератор кода не использует оптимизацию |
InlineStackLimit
— Сложите предел размера для встроенных функцийСложите предел размера для встроенных функций, заданных как положительное целое число. Предел размера стека определяет количество стекового пространства, выделенного для локальных переменных встроенной функции.
Определение предела для стекового пространства ограничивает объем встраивания позволенного. Для исключительных функций выпущено стековое пространство для переменных, локальных для функции, когда функция возвращается. Однако для встроенных функций, стековое пространство остается занятым локальными переменными, даже когда функция возвращается.
Эта возможность особенно важна для встраиваемых процессоров, где размер стека может быть ограничен.
Смотрите, что управление встраивает.
InlineThreshold
— Функциональный порог размера для встраиванияФункциональный порог размера для встраивания, заданный как положительное целое число.
Если другие условия не предотвращают встраивание, генератор кода встраивает функции, которые меньше, чем порог.
Функциональный размер измеряется как отвлеченное число инструкций, не фактических инструкций MATLAB или инструкций в целевом процессоре. Получить поведение встраивания, которое вы хотите, эксперимент с порогом. Например, если пороговые результаты по умолчанию во встраивании больших функций и генерации больших сумм кода С, настройте порог, пока вы не будете удовлетворены размером сгенерированного кода.
Смотрите, что управление встраивает.
InlineThresholdMax
— Максимальный размер функций после встраиванияМаксимальный размер функций после встраивания, заданного как положительное целое число. Если после встраивания размер функции вызова превышает InlineThresholdMax
, то генератор кода не встраивает вызванную функцию.
Функциональный размер измеряется как отвлеченное число инструкций, не фактических инструкций MATLAB или инструкций в целевом процессоре. Получить поведение встраивания, которое вы хотите, эксперимент с порогом. Например, если пороговые результаты по умолчанию во встраивании больших функций и генерации больших сумм кода С, настройте порог, пока вы не будете удовлетворены размером сгенерированного кода.
Смотрите, что управление встраивает.
LaunchReport
— Автоматический открытый из отчета генерации кодаfalse
(значение по умолчанию) | верныйАвтоматический открытый из отчета генерации кода, заданного как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Это значение является значением по умолчанию. Если ошибки или предупреждения происходят, или если |
true | Генератор кода производит и открывает отчет генерации кода. |
LoopUnrollThreshold
— Порог на количестве итераций, которое определяет, развернуть ли автоматически for
- циклЦиклы с меньшим количеством итераций, чем этот порог являются кандидатами на автоматическое разворачивание генератором кода. Этот порог применяется ко всему for
- циклы в вашем коде MATLAB. Для отдельного for
- цикл, директива coder.unroll
, помещенная сразу, прежде чем, цикл более приоритетен по сравнению с оптимизацией развертывания цикла. Порог может также примениться к некоторому for
- циклы, произведенные во время генерации кода.
Смотрите разворачивают циклы for.
MATLABSourceComments
— Включение исходного кода MATLAB как комментарии в сгенерированном коде false
(значение по умолчанию) | true
Включение исходного кода MATLAB как комментарии в сгенерированном коде, заданном как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Это значение является значением по умолчанию. Генератор кода не вставляет исходный код MATLAB как комментарии в сгенерированном коде. Генератор кода не включает подпись функции MATLAB в функциональный баннер. |
true | Генератор кода вставляет исходный код MATLAB как комментарии в сгенерированном коде. Тег трассируемости сразу предшествует каждой строке исходного кода. Тег трассируемости помогает вам определить местоположение соответствующего исходного кода MATLAB. Смотрите Трассировку Сгенерированный Код C/C++ к Исходному коду MATLAB. Если у вас есть Embedded Coder в отчете генерации кода, тег трассируемости соединяется с исходным кодом. Генератор кода также включает подпись функции MATLAB в функциональный баннер. |
Зависимость:
GenerateComments
включает этот параметр.
Смотрите Трассировку Сгенерированный Код C/C++ к Исходному коду MATLAB.
MaxIdLength
— Максимальное количество символов в сгенерированных идентификаторах 31
(значение по умолчанию) | положительное целое числоМаксимальное количество символов в сгенерированных идентификаторах, заданных как положительное целое число в области значений [31, 256]. Это свойство применяется к сгенерированной функции, введите определение и имена переменных. Чтобы избежать усечения идентификаторов целевым компилятором C, задайте значение, которое совпадает с максимальной длиной идентификатора целевого компилятора C.
Это свойство не применяется к экспортируемым идентификаторам, таким как сгенерированные имена для функций точки входа или emxArray API-функций. Если длина экспортируемого идентификатора превышает максимальную длину идентификатора целевого компилятора C, целевой компилятор C обрезает экспортируемый идентификатор.
MemcpyThreshold
— Минимальный размер для memcpy
или оптимизации memset
Минимальный размер, в байтах, для memcpy или memset оптимизации, заданной как положительное целое число.
Чтобы оптимизировать сгенерированный код, который копирует последовательные элементы массива, генератор кода пытается заменить код на вызов memcpy
. Чтобы оптимизировать сгенерированный код, который присваивает литеральную константу последовательным элементам массива, генератор кода пытается заменить код на вызов memset
.
Количество байтов является количеством элементов массива, чтобы скопировать или присвоить умноженный на количество байтов, требуемых для типа данных C/C++.
Если число элементов, чтобы скопировать или присвоить является переменным (не известный во время компиляции), генератор кода игнорирует свойство MemcpyThreshold
.
MultiInstanceCode
— Мультиэкземпляр, повторно используемый кодfalse
(значение по умолчанию) | true
Мультиэкземпляр, повторно используемый код, заданный как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Это значение является значением по умолчанию. Генератор кода не производит мультиэкземпляр, повторно используемый код. |
true |
Генератор кода производит допускающий повторное использование, код мультиэкземпляра, который повторно используем. |
Имя
Имя объекта'MexCodeConfig'
(значение по умолчанию) | вектор символовИмя объекта, заданное как вектор символов.
'OutputType'
Выведите, чтобы создать из сгенерированного кода C/C++'LIB'
| 'DLL'
| 'EXE'
Выведите, чтобы создать из сгенерированного кода C/C++, заданного как одно из значений в этой таблице.
Значение | Описание |
---|---|
'LIB' | Статическая библиотека |
'DLL' | Динамически подключаемая библиотека |
'EXE' | Исполняемая программа |
PassStructByReference
— Передайте структуры ссылкойtrue
(значение по умолчанию) | false
Передайте структуры в отношении функций точки входа, заданных как одно из значений в этой таблице.
Значение | Описание |
---|---|
true |
Это значение является значением по умолчанию. Сгенерированный код передает структуры ссылкой, которая уменьшает использование памяти и время выполнения путем минимизации количества копий параметров на контурах функции точки входа. ПримечаниеФункция точки входа, которая пишет в поле параметра структуры, перезаписывает входное значение.
|
false | Сгенерированный код передает структуры значением. |
Этот параметр применяется только к функциям точки входа.
Смотрите аргументы структуры передачи ссылкой или значением в сгенерированном коде.
PostCodeGenCommand
— Команда, чтобы настроить обработку сборки''
(значение по умолчанию) | вектор символовКоманда, чтобы настроить сборку, обрабатывающую после генерации MEX-функции с codegen
, заданным как вектор символов.
Смотрите индивидуальную настройку процесса сборки.
PreserveArrayDimensions
— N-мерная индексацияfalse
(значение по умолчанию) | true
Генерация кода, который использует N-мерную индексацию, заданную как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Сгенерируйте код, который использует одномерную индексацию. (Это значение является значением по умолчанию.) |
true | Сгенерируйте код, который использует N-мерную индексацию. |
Смотрите генерируют код, который использует n-мерную индексацию.
PreserveVariableNames
— Имена переменных, чтобы сохранить в сгенерированном коде'None'
(значение по умолчанию) | 'UserNames'
| 'All'
Имена переменных, чтобы сохранить в сгенерированном коде, заданном как одно из значений в этой таблице.
Значение | Описание |
---|---|
'None' |
Это значение является значением по умолчанию. Генератор кода не должен сохранять имена переменных. Это может снова использовать любые переменные, которые удовлетворяют требования для переменного повторного использования. Если ваш код использует большие структуры или массивы, установка |
'UserNames' |
Генератор кода сохраняет имена, которые соответствуют переменным, которые вы задаете в коде MATLAB. Это не заменяет ваше имя переменной на другое имя и не использует ваше имя для другой переменной. Чтобы улучшить удобочитаемость, установите Установка |
'All' |
Сохраните все имена переменных. Это значение параметров отключает переменное повторное использование. Используйте его только для тестирования или отладки, не для производственного кода. |
Смотрите имена переменных заповедника в сгенерированном коде.
ReportInfoVarName
— Имя переменных, содержащих генерацию кода, сообщает информацию''
(значение по умолчанию) | вектор символовИмя переменной, в которую вы экспортируете информацию о генерации кода, заданной как вектор символов. Генератор кода создает эту переменную в основном рабочем пространстве MATLAB. Эта переменная содержит информацию о настройках генерации кода, входных файлах, сгенерированных файлах и сообщениях генерации кода.
Смотрите, что Генерация Кода доступа Сообщает информацию Программно и кодер. Свойства ReportInfo.
ReportPotentialDifferences
— Создание отчетов разностей потенциаловtrue
(значение по умолчанию) | false
Создание отчетов разности потенциалов, заданное как одно из значений в этой таблице:
Значение | Описание |
---|---|
true | Генератор кода сообщает о потенциальных различиях в поведении между сгенерированным кодом и кодом MATLAB. Разности потенциалов перечислены на вкладке отчета генерации кода. Разность потенциалов является различием, которое происходит во время выполнения только при определенных обстоятельствах. |
false | Генератор кода не сообщает о разностях потенциалов. |
Смотрите, что разности потенциалов сообщают.
ReservedNameArray
— Имена, которые генератор кода не может использовать для функций или переменных''
(значение по умолчанию) | вектор символовИмена, которые генератор кода не может использовать для функций или переменных, заданных как вектор символов.
RowMajor
— Размещение главного массива строкиfalse
(значение по умолчанию) | true
Генерация кода, который использует размещение главного массива строки, заданное как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Сгенерируйте код, который использует размещение главного массива столбца. (Это значение является значением по умолчанию.) |
true | Сгенерируйте код, который использует размещение главного массива строки. |
Смотрите генерируют код, который использует размещение главного массива строки.
RuntimeChecks
— Обнаружение ошибки времени выполнения и сообщающий в сгенерированном кодеfalse
(значение по умолчанию) | true
Обнаружение ошибки времени выполнения и сообщающий в сгенерированном коде, заданном как одно из значений в этой таблице.
Значение | Описание |
---|---|
false |
Это значение является значением по умолчанию. Сгенерированный код не проверяет ошибки в таком как за пределы индексация массива. |
true |
Сгенерированный код проверяет ошибки в таком как за пределы индексация массива. Программное обеспечение сообщения об ошибке использует Сообщения об ошибке находятся на английском языке. |
Смотрите обнаружение ошибки времени выполнения и сообщающий в автономном коде C/C++.
SaturateOnIntegerOverflow
— Поддержка целочисленного переполненияtrue
(значение по умолчанию) | false
Поддержка целочисленного переполнения, заданная как одно из значений в этой таблице.
Значение | Описание |
---|---|
true | Это значение является значением по умолчанию. Генератор кода производит код, чтобы обработать целочисленное переполнение. Переполнение насыщает или к минимальному или к максимальному значению, которое может представлять тип данных. |
false | Генератор кода не производит код, чтобы обработать целочисленное переполнение. Не устанавливайте |
Этот параметр применяет только к MATLAB встроенные целочисленные типы. Это не применяется, удваивается, одиночные игры или типы данных с фиксированной точкой.
Смотрите отключают поддержку Integer Overflow или Nonfinites.
StackUsageMax
— Максимальное использование стека на приложение200000
(значение по умолчанию) | положительное целое числоМаксимальное использование стека на приложение, в байтах, заданных как положительное целое число. Установите предел, который ниже, чем доступный размер стека. В противном случае переполнение стека этапа выполнения может произойти. Компилятор C обнаруживает и сообщает о переполнениях стека.
Смотрите отключают поддержку Integer Overflow или Nonfinites.
SupportNonFinite
— Поддержка неличных значенийtrue
(значение по умолчанию) | false
Поддержка неличных значений, заданных как одно из значений в этой таблице.
Значение | Описание |
---|---|
true | Это значение является значением по умолчанию. Если Если |
false |
Генератор кода не производит код, чтобы поддержать неличные значения. |
Смотрите отключают поддержку Integer Overflow или Nonfinites.
TargetLang
— Язык, чтобы использовать в сгенерированном коде'C'
(значение по умолчанию) | 'C++'
Язык, чтобы использовать в сгенерированном коде, заданном как 'C'
или 'C++'
. Если вы задаете C++, генератор кода переносит код С в .cpp файлы так, чтобы можно было использовать компилятор C++ и интерфейс с внешними приложениями C++. Это не генерирует классы C++.
Зависимость: Если DeepLearningConfig
установлен, codegen
устанавливает TargetLang
на C++
.
TargetLangStandard
— Стандартная математическая библиотека, чтобы использовать для сгенерированного кода'C89/C90 (ANSI)'
| 'C99 (ISO)'
| 'C++03 (ISO)'
Стандартная математическая библиотека, чтобы использовать для сгенерированного кода, заданного как один из этих векторов символов:
'C89/C90 (ANSI)'
'C99 (ISO)'
'C++03 (ISO)'
Генератор кода пользуется стандартной математической библиотекой для вызовов математических операций. Стандартная математическая библиотека по умолчанию зависит от языка, который вы выбираете. Для C библиотекой по умолчанию является 'C99 (ISO)'
. Для C++ библиотекой по умолчанию является 'C++03 (ISO)'
.
Toolchain
— Набор инструментальных средств, чтобы использовать для создания C/C++ библиотечную или исполняемую программу'Automatically locate an installed toolchain'
(значение по умолчанию) | вектор символовНабор инструментальных средств, чтобы использовать для создания C/C++ библиотечную или исполняемую программу, заданную как вектор символов. Список доступных наборов инструментальных средств зависит от платформы хоста - компьютера и может включать пользовательские наборы инструментальных средств, которые вы добавили. Если вы не задаете набор инструментальных средств, генератор кода определяет местоположение установленного набора инструментальных средств.
Примечание:
Предположим, что вы создаете объект coder.CodeConfig
cfg
в сеансе работы с MATLAB и используете его в другом сеансе работы с MATLAB. Если хосту - компьютеру MATLAB для второго сеанса не задали набор инструментальных средств в свойстве cfg.Toolchain
, установленном на нем, этот параметр возвращается к своему значению по умолчанию. Значением по умолчанию является 'Automatically locate an installed toolchain'
.
Verbose
— Отображение успеха генерации кодаtrue
Отображение успеха генерации кода, заданное как одно из значений в этой таблице.
Значение | Описание |
---|---|
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
.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.