ビルド構成

出力ファイルの名前、場所、種類、言語などのビルド設定の構成

バイナリコードを生成するビルドプロセスを制御および設定するには、多くのパラメーターや設定があります。これらの設定は、出力ビルドの種類 (MEX、lib、dll または exe) および C と C++ 言語などの属性を制御します。他のビルド設定により、可読性、パフォーマンスおよび外部コードの統合などの特定のニーズに応じて、ビルド出力をカスタマイズできます。アプリまたはコマンドラインでコード生成構成オブジェクトのビルドオプションを変更できます。coder.config を使用して、構成オブジェクトを作成できます。open を使用して、編集アプリでオブジェクトを開きます。追加のビルドファイルおよびフラグを関数コード内から指定するには、coder.updateBuildInfo を使用します。

関数

すべて展開する

コード生成オプションとビルド構成オプションの指定

`coder.config`	コード生成構成オブジェクトを作成する
`coder.updateBuildInfo`	`RTW.BuildInfo` ビルド情報オブジェクトの更新

ターゲットオブジェクトのデータの作成と管理

`target.add`	ターゲットオブジェクトを内部データベースに追加
`target.clear`	Clear all target objects from internal database (R2023a 以降)
`target.create`	ターゲットオブジェクトを作成
`target.export`	ターゲットオブジェクトのデータをエクスポート
`target.get`	ターゲットオブジェクトを内部データベースから取得
`target.remove`	内部データベースからのターゲットオブジェクトの削除
`target.update`	Update target objects in internal database (R2023a 以降)
`target.upgrade`	ハードウェアデバイスの既存の定義のアップグレード

ビルド情報オブジェクトへのフラグ、定義、ファイル、パスの追加

`addCompileFlags`	Add compiler options to build information
`addDefines`	Add preprocessor macro definitions to build information
`addIncludeFiles`	Add include files to build information
`addIncludePaths`	Add include paths to build information
`addLinkFlags`	Add link options to build information
`addLinkObjects`	Add link objects to build information
`addNonBuildFiles`	Add nonbuild-related files to build information
`addPreincludeFiles`	Add preinclude files to build information (R2024a 以降)
`addSourceFiles`	Add source files to build information
`addSourcePaths`	Add source paths to build information
`addUndefines`	Add undefine preprocessor directives to build information (R2024a 以降)
`removeIncludePaths`	Remove include paths from build information (R2023b 以降)
`removeSourceFiles`	Remove source files from build information object (R2021b 以降)
`removeUndefines`	Remove undefine preprocessor macros from build information (R2024a 以降)

ビルド情報オブジェクトでの引数とファイルの検索

`findBuildArg`	Find a specific build argument in build information
`findIncludeFiles`	Find and add include (header) files to build information

ビルド情報オブジェクトからのフラグ、定義、ファイル、パスの取得

`getBuildArgs`	Get build arguments from build information
`getCompileFlags`	Get compiler options from build information
`getDefines`	Get preprocessor macro definitions from build information
`getFullFileList`	Get list of files from build information
`getIncludeFiles`	Get include files from build information
`getIncludePaths`	Get include paths from build information
`getLinkFlags`	Get link options from build information
`getNonBuildFiles`	Get nonbuild-related files from build information
`getPreincludeFiles`	Get preinclude files from build information (R2024a 以降)
`getSourceFiles`	Get source files from build information
`getSourcePaths`	Get source paths from build information
`getUndefines`	From build information, get preprocessor macros to undefine (R2024a 以降)

ビルド情報オブジェクトでの出力オプションの設定

setTargetProvidesMain Disable inclusion of code generator provided (generated or static) main.c source file during build

ビルド情報オブジェクトでのファイルパス、拡張子、区切りの更新

`updateFilePathsAndExtensions`	Update files in build information with missing paths and file extensions
`updateFileSeparator`	Update file separator character for file lists in build information

コード構成設定

すべて展開する

出力

ビルドタイプ	生成された C/C++ コードからビルドする出力
言語	Language to use in generated code
言語標準	Language standard to use for the generated code
カスタム出力ファイル	Name of code generation output file
コード生成のみ	ソースコードのみの生成
検証モード	Code verification mode
ビルドフォルダー	Folder type for files generated during build process
ビルドフォルダーのパス	Folder path for files generated during build process
作業フォルダー	Current working folder type for build process
作業フォルダーのパス	Current working folder path for build process

速度

Ctrl + C キーへの応答、およびグラフィックスの更新を有効にする	応答性チェック
外部呼び出しを維持	外部関数呼び出しのサポート
メモリの整合性をチェック	メモリの整合性チェック
整数オーバーフローで飽和	Integer overflow support
純粋な整数のみをサポート	浮動小数点コードの検出
非有限数のサポート	非有限値のサポート
ループ展開のしきい値	Threshold on the number of iterations that determines whether to automatically unroll a `for`-loop and a `parfor`-loop
エントリポイント関数の入力データを保持	エントリポイントの入力データが変更されないように保護するかどうか
可能な場合は OpenMP ライブラリを有効にする	Parallelization of `parfor`-loops
自動並列化を有効にする	`for` ループの自動並列化
CPU スレッドの最大数	並列 for ループを実行する CPU スレッドの最大数
ターゲットハードウェアの命令セット拡張を活用	SIMD instruction set for target hardware
FMA	Whether to use SIMD instructions for fused multiply add operations
ユーザー定義の MATLAB 関数に対するインライン手法	Control inlining between user-written functions
MathWorks 定義の MATLAB 関数に対するインライン手法	Control inlining between MathWorks functions
MathWorks 関数とユーザー関数の間の呼び出しに対するインライン手法	ユーザー記述関数と MathWorks 関数の間のインライン化を制御
リダクションの最適化	Generate SIMD code for reduction operations \| Parallelize for-loops performing reduction operations
ハードウェア SIMD アクセラレーション	Level of SIMD intrinsics

メモリ

グローバルなデータ同期モード	グローバルなデータ同期モード
可変サイズを有効化	可変サイズ配列のサポート
動的メモリ割り当てを有効化	可変サイズの配列に対する動的メモリ割り当てを有効化
動的メモリ割り当てしきい値	Size threshold for dynamic memory allocation of variable-size arrays
固定サイズの配列に対する動的メモリ割り当てを有効化	固定サイズの配列に対する動的メモリ割り当て
動的メモリ割り当てインターフェイス	Dynamically allocated array at generated function interface
配列のレイアウト	行優先の配列レイアウト
配列の次元を保持	N 次元のインデックス
最大スタック使用量	アプリケーションごとの最大スタック使用量
再呼び出し可能なコードを生成	マルチインスタンスの再呼び出し可能なコード
未使用のフィールドとプロパティを保持	生成された C/C++ コードにおける未使用のクラスプロパティまたは構造体フィールドの保持

コード外観

生成されたファイルの分割法	File partitioning mode
大きな定数の生成	大きな深層学習の定数をバイナリデータファイルに書き込むかどうか
大きな定数のしきい値	Threshold above which the code generator writes DNN constants to binary data files
コメントを含める	Comments in generated code
コメントスタイル	Comment style in the generated code
コメントを示す MATLAB ソースコード	Inclusion of MATLAB source code as comments in generated code
MATLAB ソースコードコメントの行番号	Include line numbers of MATLAB source code as comments in the generated code
MATLAB 関数のヘルプテキスト	関数バナー内の MATLAB 関数のヘルプテキスト
コメントとしての要件の概要	要件リンクをコメントとして含める
if-elseif-else のパターンを switch-case ステートメントに変換する	`if-elseif-else` パターンの `switch-case` ステートメントへの変換
関数の宣言で extern キーワードを保持する	関数宣言での `extern` キーワードの保持
固定小数点の演算および 2 のべき乗の乗算には符号付き左シフトを使用する	2 のべき乗での乗算の符号付きのビット単位左シフトへの置換
符号付き整数の右シフトを許可	生成コードの符号付きビット単位右シフト
かっこ	生成されたコードでのかっこのレベル
識別子の最大の長さ	Maximum number of characters in generated identifiers
ヘッダーガードスタイル	Style of preprocessor directive in generated code
インデントスタイル	生成されたコードの中かっこの配置スタイル
インデントサイズ	インデントレベル単位の文字数
列の制限	生成されたコードの改行の前の最大列数
データ型置換	Data type replacement in generated code
カスタムデータ型置換を有効化	Custom names for data types in generated code
外部ヘッダーファイルからカスタムの型をインポート	Whether to import type definition from external header files
ヘッダーファイル	External header files that contain custom type definitions
グローバル変数	グローバル変数識別子のカスタム識別子の形式
グローバルなタイプ	グローバルなタイプの識別子のカスタム識別子の形式
グローバルなタイプのフィールド名	グローバルなタイプの識別子のフィールド名に対するカスタム識別子の形式
ローカル関数	ローカル関数識別子のカスタム識別子の形式
ローカルな一時変数	ローカルな一時変数識別子のカスタム識別子の形式
定数のマクロ	定数マクロ識別子のカスタム識別子の形式
EMX 配列タイプ	EMX 配列型のカスタム識別子の形式
EMX 配列ユーティリティ関数	EMX 配列ユーティリティ関数のカスタム識別子の形式
生成されるソースファイルおよびヘッダーファイルの名前の形式	ファイル名のカスタマイズマクロ
コード生成テンプレートファイル	ファイルバナーおよび関数バナーのコード生成テンプレート
使用するコード形式ツールの選択	Formatting tool for generated code
clang 形式の構成ファイルの使用を制御	Control generation of `clang-format` file

デバッグ

C/C++ コンパイラのデバッグモードを有効にする	C コンパイラのデバッグモード
実行時エラーチェックの生成	Run-time error detection and reporting in generated code
詳細なコンパイラ出力を表示	Code generation progress display
常にレポートを作成	コード生成レポート
MATLAB との相違点をレポート	Potential differences reporting
潜在的なデータ型の問題を強調表示	コード生成レポートでの潜在的なデータ型の問題の強調表示
潜在的な行優先の問題を強調表示	行優先のレイアウトによる潜在的な問題
暗黙的な拡張によって生じる潜在的な問題を強調表示	Highlight potential implicit expansion issues
coder.loop 関数を使用する際の潜在的な問題を強調表示	Highlight potential loop control issues
静的コードメトリクスレポートの生成	静的コードメトリクスレポート
コード置換レポートの生成	Code replacement report
レポート生成時の自動起動	コード生成レポートを自動的に開く
レポート情報を変数にエクスポート	コード生成レポートの情報を格納する変数の名前
SIL または PIL でソースレベルデバッグを有効にする	SIL または PIL 実行時の生成コードのデバッグ
定数入力をチェック	SIL または PIL 実行の定数入力チェック
グローバルデータを同期	SIL または PIL 実行のグローバルなデータ同期モード
エントリポイント実行プロファイリングを有効にする	SIL または PIL 実行時の実行時間プロファイリング
関数実行プロファイリングを有効にする	SIL または PIL 実行時のエントリポイント関数内で呼び出される関数の実行時間プロファイリング
プロファイリング保存オプションの指定	実行時間の測定の収集と格納
エントリポイントスタックプロファイリングを有効にする	SIL または PIL 実行時のスタック使用量プロファイリング
C/C++ コードカバレッジを有効にする	C/C++ コードカバレッジの解析
実行プロファイリングを有効にする	Instrumentation for profiling

カスタムコード

コード置換ライブラリ	生成コードのコード置換ライブラリ
組み込み FFTW ライブラリの使用	Generate code that uses the FFTW library shipped with MATLAB
カスタム FFT ライブラリのコールバック	Callback class for FFTW library calls
カスタム BLAS ライブラリのコールバック	BLAS コールバッククラス
カスタム LAPACK ライブラリのコールバック	LAPACK コールバッククラス
プリコンパイルされたライブラリの使用	Whether to use precompiled libraries in generated code
ソースファイル	生成された `.c` または `.cpp` ファイルの最上部付近に表示されるコード
ヘッダーファイル	生成された C/C++ ヘッダーファイルの最上部に表示されるカスタムコード
初期化関数	生成された初期化関数に含めるカスタムコード
終了関数	生成された終了関数に表示されるコード
追加インクルードディレクトリ	Include folders to add to include path for compiling generated code
追加ソースファイル	Source files to compile and link with the generated code
追加ライブラリ	Static library files to link with the generated code
コード生成後のコマンド	ビルドプロセスをカスタマイズするコマンド
予約名	Names that code generator must not use for functions or variables

ハードウェア

ハードウェアボード	Name of hardware board
製品デバイスの詳細: デバイスベンダー	Manufacturer of production hardware
製品デバイスの詳細: デバイスタイプ	Type of production hardware
製品デバイスの詳細: char	C の `char` データ型のビット長
製品デバイスの詳細: short	C の `short` データ型のビット長
製品デバイスの詳細: int	C の `int` データ型のビット長
製品デバイスの詳細: long	C の `long` データ型のビット長
製品デバイスの詳細: long long	Length in bits of the C `long long` data type
製品デバイスの詳細: float	C の浮動小数点データ型のビット長
製品デバイスの詳細: double	C の `double` データ型のビット長
製品デバイスの詳細: マシンワード	Microprocessor native word size
製品デバイスの詳細: ポインター	Length in bits of pointer data
製品デバイスの詳細: size_t	`size_t` データのビット長
製品デバイスの詳細: ptrdiff_t	`ptrdiff_t` データのビット長
製品デバイスの詳細: バイト順	データワードの最初のバイトの意味
製品デバイスの詳細: 算術シフトとして符号付き整数を右にシフト	符号付き整数の右シフトを算術右シフトとして実装
製品デバイスの詳細: long long を有効にする	long long データ型のサポート
製品デバイスの詳細: 最大 Atomic 整数サイズ	Largest atomic integer size for production hardware
製品デバイスの詳細: 最大 Atomic 浮動小数点サイズ	Largest atomic floating-point size for production hardware
製品デバイスの詳細: 符号付き整数の除算の丸め	2 つの符号付き整数の除算の丸め
ターゲットデバイスの詳細: デバイスベンダー	Manufacturer of test hardware
ターゲットデバイスの詳細: デバイスタイプ	Type of test hardware
テストデバイスの詳細: char	Length in bits of the C `char` data type
テストデバイスの詳細: short	Length in bits of the C `short` data type
テストデバイスの詳細: int	Length in bits of the C `int` data type
テストデバイスの詳細: long	Length in bits of the C `long` data type
テストデバイスの詳細: long long	Length in bits of the C `long long` data type
テストデバイスの詳細: float	C の浮動小数点データ型のビット長
テストデバイスの詳細: double	C の `double` データ型のビット長
テストデバイスの詳細: マシンワード	Microprocessor native word size
テストデバイスの詳細: ポインター	Length in bits of pointer data
テストデバイスの詳細: size_t	`size_t` データのビット長
テストデバイスの詳細: ptrdiff_t	Length in bits of `ptrdiff_t` data
テストデバイスの詳細: バイト順	Significance of the first byte of a data word
テストデバイスの詳細: 算術シフトとして符号付き整数を右にシフト	符号付き整数の右シフトを算術右シフトとして実装
テストデバイスの詳細: long long を有効にする	long long データ型のサポート
テストデバイスの詳細: 最大 Atomic 整数サイズ	Largest atomic integer size for test hardware
テストデバイスの詳細: 最大 Atomic 浮動小数点サイズ	Largest atomic floating-point size for test hardware
テストデバイスの詳細: 符号付き整数の除算の丸め	2 つの符号付き整数の除算の丸め
ツールチェーン	Toolchain to use for building a C/C++ library or executable program
カスタムツールチェーンオプション	Custom settings for tools in selected toolchain
ビルド構成	Compiler optimization or debug settings for toolchain
テストハードウェアを製品ハードウェアと同じにする	Equivalence of production and target hardware characteristics

C++ 言語機能

C++ 名前空間	Namespace name for generated C++ code
インターフェイススタイル	Interface style for generated C++ code
C++ インターフェイスクラス名	Interface class name for generated C++ code
MATLAB 名前空間から C++ 名前空間を生成	MATLAB 名前空間に対応する C++ 名前空間の生成
MathWorks コードの名前空間	Place C++ code generated for MathWorks code in a separate namespace
MATLAB クラスから C++ クラスを生成	MATLAB クラスに対応する C++ クラスの生成
MATLAB 列挙から C++ enum クラスを生成	Whether to generate C++ enumeration classes for MATLAB enumerations

詳細設定

キャストモード	データ型のキャストレベル
定数畳み込みのタイムアウト	定数畳み込みによって実行される命令の最大数
コンパイル時の再帰限界値	コンパイル時の再帰による関数の特殊化の最大数
初期化関数を自動的に実行	Automatically run the initialize function
初期化関数が必要	初期化関数の生成
終了関数が必要	終了関数の生成
既知の MISRA 違反について正当化のコメントを生成	既知の MISRA/AUTOSAR 違反を抑制する注釈を追加
main の例の生成	C/C++ main ファイルの生成例
変数名の保持	Variable names to preserve in the generated code
終端のセミコロンなしの式をエコー	式をエコー
makefile の生成	makefile の生成
外部呼び出しを自動的に導入	自動的な外部関数呼び出し
配列のインデックスを簡略化する	強度低減の最適化
ベクトルの代入に対する memcpy の使用	Whether to enable `memcpy` optimization
memcpy しきい値 (バイト)	Minimum size for `memcpy` or `memset` optimization
float と double を 0.0 に初期化するために memset を使用	Assignment of float and double zero with memset
定数入力	定数入力チェックモード
MEX のビルドタイプに JIT コンパイルを使用	Just-In-Time (JIT) コンパイルモード
非有限サポートファイルを生成 (使用されている場合)	Generate support files for nonfinite data only if nonfinite data is used
エントリポイント関数に構造体を参照で渡す	Pass structures by reference
switch の default ケースを常に生成する	すべての switch ステートメントの default ケース
コードのトレーサビリティを有効にする	コード生成レポートのトレーサビリティ
Embedded Coder 機能の使用	Whether to use Embedded Coder features
暗黙的な拡張を有効にする	生成コードでの暗黙的な拡張機能
自動並列化のレポートを有効にする	`for` ループの自動並列化のレポート作成
実行時の再帰を有効にする	Run-time recursion support
動的な配列データをキャッシュ	Dynamic array optimization
SIL/PIL の詳細	SIL または PIL 実行時の通信の I/O 情報の表示
SIL/PIL プロファイリングメトリクス	PMU metric

オブジェクト

`coder.MexCodeConfig`	MATLAB からの MEX 関数生成用構成パラメーター
`coder.CodeConfig`	MATLAB コードから C/C++ コードを生成するための構成パラメーター
`coder.EmbeddedCodeConfig`	Embedded Coder で MATLAB コードから C/C++ コードを生成するための構成パラメーター
`coder.HardwareImplementation`	MATLAB コードから C/C++ コードを生成するためのハードウェア固有の構成パラメーター
`coder.hardware`	MATLAB コードから C/C++ コード生成用ハードウェアボード構成オブジェクトを作成します。
`coder.ReplacementTypes`	C/C++ コード生成における MATLAB 組み込みデータ型のカスタム名を指定する構成パラメーター。
`RTW.BuildInfo`	生成されたコードのコンパイルとリンクに関する情報を提供する

クラス

`coder.ExternalDependency`	外部コードへのインターフェイス
`target.Alias`	ターゲットオブジェクトの代替識別子を作成
`target.CMake`	Specify CMake installation for building generated code (R2022b 以降)
`target.CMakeBuilder`	Configure how CMake builds generated code (R2022b 以降)
`target.CMakeBuildType`	Describe CMake build type or build configuration (R2022b 以降)
`target.CMakeCacheEntry`	Configure a CMake cache entry (R2022b 以降)
`target.EnvironmentConfiguration`	Configure system environment for toolchain (R2022b 以降)
`target.HardwareComponentSupport`	Describe support for a hardware component (R2022b 以降)
`target.LanguageImplementation`	C および C++ コンパイラの実装の詳細を提供
`target.Object`	ターゲットタイプの基底クラス
`target.Processor`	ターゲットプロセッサ情報の提供
`target.Toolchain`	Capture high-level information about toolchain (R2022b 以降)

名前空間

target ターゲットハードウェアとビルドツールの情報の管理

トピック