Konfigurieren der Codegenerierung

Konfigurieren der Einstellungen für die Codegenerierung, z. B. Name, Speicherort, Typ und Sprache der Ausgabedatei

Zum Steuern und Konfigurieren des Codegenerierungsprozesses stehen zahlreiche Parameter und Einstellungen zur Verfügung. Diese Einstellungen steuern Attribute wie den Ausgabe-Build-Typ (MEX, lib, dll oder exe) und Verwendung der Sprache C oder C++. Mit anderen Konfigurationseinstellungen können Sie den generierten Code an bestimmte Anforderungen wie Lesbarkeit, Leistung und Integration von externem Code anpassen. Sie können die Konfigurationseinstellungen im Konfigurationsobjekt für die Codegenerierung über die App oder über die Befehlszeile ändern. Das Konfigurationsobjekt erstellen Sie mithilfe von coder.config. Öffnen Sie das Objekt in der Bearbeitungs-App mit open.

Funktionen

coder.config Create code generation configuration objects

Einstellungen für die Code-Konfiguration

alle erweitern

Ausgabe

Buildtype	Output to build from generated C/C++ code
Language	Language to use in generated code
Languagestandard	Language standard to use for the generated code
Custom outputfile	Name of code generation output file
Generate codeonly	Generation of only source code
Verificationmode	Code verification mode
Buildfolder	Folder type for files generated during build process
Build folderpath	Folder path for files generated during build process
Workingfolder	Current working folder type for build process
Working folderpath	Current working folder path for build process

Geschwindigkeit

Enable responsivenessto CTRL+C and graphics refreshing	Responsiveness checks
Keep extrinsiccalls	Extrinsic function call support
Check memoryintegrity	Memory integrity checking
Saturate on integeroverflow	Integer overflow support
Support onlypurely-integer numbers	Detection of floating-point code
Support nonfinitenumbers	Support for nonfinite values
Loop unrollingthreshold	Threshold on the number of iterations that determines whether to automatically unroll a `for`-loop and a `parfor`-loop
Preserve input datafor entry-point functions	Whether to protect entry-point input data from modification
Qualify C restrictfunction arguments	Annotate function declarations with the restrict keyword
Enable OpenMP libraryif possible	Parallelization of `parfor`-loops
Enable automaticparallelization	Automatic parallelization of `for` loops
Maximum number of CPUthreads	Maximale Anzahl von CPU-Threads zur Ausführung paralleler For-Schleifen
Leverage targethardware instruction set extensions	SIMD instruction set for target hardware
FMA	Whether to use SIMD instructions for fused multiply add operations
Inline strategy foruser written MATLAB functions	Control inlining between user-written functions
Inline strategy forMathWorks written MATLAB functions	Control inlining between MathWorks functions
Inline strategy forcalls between MathWorks functions and user functions	Control inlining between user-written functions and MathWorks functions
Optimizereductions	Generate SIMD code for reduction operations \| Parallelize for-loops performing reduction operations
Hardware SIMDacceleration	Level of SIMD intrinsics

Speicher

Global datasynchronization mode	Global data synchronization mode
Enablevariable-sizing	Variable-size array support
Enable dynamic memoryallocation	Enable dynamic memory allocation for fixed- and variable-size arrays
Dynamic memoryallocation threshold	Size threshold for dynamic memory allocation of variable-size arrays
Enable dynamic memoryallocation for fixed-sized arrays	Dynamic memory allocation for fixed-size arrays
Dynamic memoryallocation interface	Dynamically allocated array at generated function interface
Arraylayout	Row-major array layout
Preserve arraydimensions	N-dimensional indexing
Stack usagemax	Maximum stack usage per application
Generate re-entrantcode	Multi-instance, reentrant code
Preserve unusedfields and properties	Preserve unused class properties or structure fields in the generated C/C++ code

Erscheinungsbild des Code

Generated filepartitioning method	File partitioning mode
Large constantgeneration	Whether to write large deep learning constants to binary data files
Large constantthreshold	Threshold above which the code generator writes DNN constants to binary data files
Includecomments	Comments in generated code
Commentstyle	Comment style in the generated code
MATLAB source code ascomments	Inclusion of MATLAB source code as comments in generated code
MATLAB source codecomment line numbers	Include line numbers of MATLAB source code as comments in the generated code
MATLAB function helptext	MATLAB function help text in function banner
Requirement summariesas comments	Include requirements links as comments
Convertif-elseif-else patterns to switch-case statements	Conversion of `if-elseif-else` patterns to `switch-case` statements
Preserve externkeyword in function declarations	Preservation of the `extern` keyword in function declarations
Use signed shift leftfor fixed-point operations and multiplication by powers of 2	Replacement of multiplications by powers of two with signed left bitwise shifts
Allow right shifts onsigned integers	Signed right bitwise shifts in generated code
Parentheses	Parenthesization level in the generated code
Maximum identifierlength	Maximum number of characters in generated identifiers
Header guardstyle	Style of preprocessor directive in generated code
Indentstyle	Style for placement of braces in the generated code
Indentsize	Number of characters per indentation level
Columnlimit	Maximum number of columns before a line break in the generated code
Data typereplacement	Data type replacement in generated code
Enable custom datatype replacement	Custom names for data types in generated code
Import custom typesfrom external header files	Whether to import type definition from external header files
Headerfiles	External header files that contain custom type definitions
Globalvariables	Custom identifier format for global variable identifiers
Globaltypes	Custom identifier format for global type identifiers
Field name of globaltypes	Custom identifier format for field names in global type identifiers
Localfunctions	Custom identifier format for local function identifiers
Local temporaryvariables	Custom identifier format for local temporary variable identifiers
Constantmacros	Custom identifier format for constant macro identifiers
EMX arraytypes	Custom identifier format for EMX array types
EMX array utilityfunctions	Custom identifier format for EMX array utility functions
Generated source andheader file name format	File name customization macro
Code generationtemplate file	Code generation template for file and function banners
Select code formattool to use	Formatting tool for generated code
Control use of clangformat configuration	Control generation of `clang-format` file

Fehlersuche

Enable C/C++ compilerdebug mode	Debugging-Modus des C Compilers
Generate run-timeerror checks	Run-time error detection and reporting in generated code
Show verbose compileroutput	Anzeige des Fortschritts bei der Codegenerierung
Always create areport	Code generation report
Report differencesfrom MATLAB	Potential differences reporting
Highlight potentialdata type issues	Highlighting of potential data type issues in the code generation report
Highlight potentialrow-major issues	Potential row-major layout issues
Highlight potentialissues resulting from implicit expansion	Highlight potential implicit expansion issues
Highlight potentialissues in use of coder.loop functions	Highlight potential loop control issues
Generate static codemetrics report	Static code metrics report
Generate codereplacements report	Code replacement report
Automatically launcha report if one is generated	Automatic open of code generation report
Export reportinformation to variable	Name of variable containing code generation report information
Enable source-leveldebugging for SIL or PIL	Debugging of generated code during a SIL or PIL execution
Check constantinputs	Constant input checking mode for a SIL or PIL execution
Synchronize globaldata	Global data synchronization mode for a SIL or PIL execution
Enable entry pointexecution profiling	Execution time profiling during a SIL or PIL execution
Enable functionexecution profiling	Execution time profiling of functions called within entry-point functions during a SIL or PIL execution
Specify profilingsave options	Collection and storage of execution-time measurements
Enable entry pointstack profiling	Stack usage profiling during a SIL or PIL execution
Enable C/C++ codecoverage	Analysis of C/C++ code coverage
Enable executionprofiling	Instrumentation for profiling

Benutzerdefinierter Code

Code replacementlibrary	Code replacement library for generated code
Use built-in FFTWlibrary	Generate code that uses the FFTW library shipped with MATLAB
Custom FFT librarycallback	Callback class for FFTW library calls
Custom BLAS librarycallback	BLAS callback class
Custom LAPACK librarycallback	LAPACK callback class
Use precompiledlibraries	Whether to use precompiled libraries in generated code
Sourcefile	Code to appear near the top of generated `.c` or `.cpp` files
Headerfile	Custom code that appears at top of generated C/C++ header files
Initializefunction	Custom code to include in the generated initialize function
Terminatefunction	Code that appears in the generated terminate function
Additional includedirectories	Include folders to add to include path for compiling generated code
Additional sourcefiles	Source files to compile and link with the generated code
Additionallibraries	Static library files to link with the generated code
Post-code-generationcommand	Befehl zur Anpassung der Build-Verarbeitung
Reservednames	Names that code generator must not use for functions or variables

Hardware

Hardwareboard	Name of hardware board
Production DeviceDetails: Device vendor	Manufacturer of production hardware
Production DeviceDetails: Device type	Type of production hardware
Production DeviceDetails: char	Length in bits of the C `char` data type
Production DeviceDetails: short	Length in bits of the C `short` data type
Production DeviceDetails: int	Length in bits of the C `int` data type
Production DeviceDetails: long	Length in bits of the C `long` data type
Production DeviceDetails: long long	Length in bits of the C `long long` data type
Production DeviceDetails: float	Length in bits of the C floating-point data type
Production DeviceDetails: double	Length in bits of the C `double` data type
Production DeviceDetails: machine word	Microprocessor native word size
Production DeviceDetails: pointer	Length in bits of pointer data
Production DeviceDetails: size_t	Length in bits of `size_t` data
Production DeviceDetails: ptrdiff_t	Length in bits of `ptrdiff_t` data
Production DeviceDetails: Byte ordering	Significance of the first byte of a data word
Production DeviceDetails: Shift right on a signed integer as an arithmetic shift	Implementation of signed integer right shift as arithmetic right shift
Production DeviceDetails: Enable long long	Long long data type support
Production DeviceDetails: Largest atomic integer size	Largest atomic integer size for production hardware
Production DeviceDetails: Largest atomic floating-point size	Largest atomic floating-point size for production hardware
Production DeviceDetails: Signed integer division rounds to	Rounding for division of two signed integers
Target DeviceDetails: Device vendor	Manufacturer of test hardware
Target DeviceDetails: Device type	Type of test hardware
Test Device Details:char	Length in bits of the C `char` data type
Test Device Details:short	Length in bits of the C `short` data type
Test Device Details:int	Length in bits of the C `int` data type
Test Device Details:long	Length in bits of the C `long` data type
Test Device Details:long long	Length in bits of the C `long long` data type
Test Device Details:float	Length in bits of the C floating-point data type
Test Device Details:double	Length in bits of the C `double` data type
Test Device Details:machine word	Microprocessor native word size
Test Device Details:pointer	Length in bits of pointer data
Test Device Details:size_t	Length in bits of `size_t` data
Test Device Details:ptrdiff_t	Length in bits of `ptrdiff_t` data
Test Device Details:Byte ordering	Significance of the first byte of a data word
Test Device Details:Shift right on a signed integer as an arithmetic shift	Implementierung der Rechtsverschiebung vorzeichenbehafteter Ganzzahlen als arithmetische Rechtsverschiebung
Test Device Details:Enable long long	Long long data type support
Test Device Details:Largest atomic integer size	Largest atomic integer size for test hardware
Test Device Details:Largest atomic floating-point size	Largest atomic floating-point size for test hardware
Test Device Details:Signed integer division rounds to	Rounding for division of two signed integers
Toolchain	Toolchain to use for building a C/C++ library or executable program
Custom ToolchainOptions	Custom settings for tools in selected toolchain
Buildconfiguration	Compiler optimization or debug settings for toolchain
Test Hardware is thesame as production hardware	Equivalence of production and target hardware characteristics

C++ Sprachfunktionen

C++namespace	Namespace name for generated C++ code
Interfacestyle	Interface style for generated C++ code
C++ interface classname	Interface class name for generated C++ code
Generate C++namespaces from MATLAB namespaces	Generate C++ namespaces for MATLAB namespaces
Namespace forMathWorks code	Place C++ code generated for MathWorks code in a separate namespace
Generate C++ classesfrom MATLAB classes	Generate C++ classes for MATLAB classes
Generate C++ enumclass from MATLAB enumeration	Whether to generate C++ enumeration classes for MATLAB enumerations

Erweitert

Castingmode	Data type casting level
Constant foldingtimeout	Maximum number of instructions to be executed by the constant folder
Compile-timerecursion limit	Maximum number of function specializations for compile-time recursion
Automatically run theinitialize function	Automatically run the initialize function
Initialize functionrequired	Initialize function generation
Terminate functionrequired	Terminate function generation
Generatejustification comments for known MISRA violations	Add annotations to suppress known MISRA/AUTOSAR violations
Generate examplemain	Example C/C++ main file generation
Preserve variablenames	Variable names to preserve in the generated code
Echo expressionswithout terminating semicolons	Expression echoing
Generatemakefile	Makefile generation
Automaticallyintroduce extrinsic calls	Automatic extrinsic function calls
Simplify arrayindexing	Strength reduction optimization
Use memcpy for vectorassignment	Whether to enable `memcpy` optimization
Memcpy threshold(bytes)	Minimum size for `memcpy` or `memset` optimization
Use memset toinitialize floats and doubles to 0.0	Assignment of float and double zero with memset
Constantinputs	Constant input checking mode
Use JIT compilationfor build type of MEX	Just-in-time (JIT) compilation mode
Generate nonfinitesupport files if used	Generate support files for nonfinite data only if nonfinite data is used
Pass structures byreference to entry-point functions	Pass structures by reference
Always generate adefault case for switch	Default case for all switch statements
Enable codetraceability	Traceability in code generation report
Use Embedded Coderfeatures	Whether to use Embedded Coder features
Enable implicitexpansion	Implicit expansion capabilities in generated code
Enable automaticparallelization reporting	Reporting for automatic parallelization of `for` loops
Enable run-timerecursion	Run-time recursion support
Cache dynamic arraydata	Dynamic array optimization
SIL/PILVerbosity	Display communication I/O information during SIL or PIL execution
SIL/PIL profilingmetrics	PMU metric

Objekte

`coder.MexCodeConfig`	Configuration parameters for MEX function generation from MATLAB code
`coder.CodeConfig`	Configuration parameters for C/C++ code generation from MATLAB code
`coder.EmbeddedCodeConfig`	Configuration parameters for C/C++ code generation from MATLAB code with Embedded Coder
`coder.HardwareImplementation`	Hardware-specific configuration parameters for C/C++ code generation from MATLAB code
`coder.hardware`	Create hardware board configuration object for C/C++ code generation from MATLAB code
`coder.ReplacementTypes`	Configuration parameter to specify custom names for MATLAB built-in data types in C/C++ code generation

Themen

Grundlagen der Build-Konfiguration

Configure Code Generation and Build Settings
Configure code generation and build configuration parameters at the command line or in the MATLAB^® Coder™ app.
Paths and File Infrastructure Setup
Specify location of custom code.
Build Process Support for File and Folder Names
Troubleshoot build process errors that occur when file system issues prevent file processing.
Share Build Configuration Settings
Export project settings to a code generation configuration object or import the settings into a project.
Specify Code Configuration Parameters Interactively
Configure the code generation process by using the Code Generation Settings dialog box.

Spezifische Build-Optionen

Understand and Control Partitioning of the Generated Code
Understand how file partitioning method and inlining settings interact to control the partitioning of the generated code.
Change Language Standard Used for Code Generation
The code generator uses the language standard that you specify in the build settings.