-c | ソース コードのみを生成します。make コマンドを呼び出したり、オブジェクト コードをビルドしたりしないでください。たとえば、関数 foo のスタティック C/C++ ライブラリを生成し、ソース コードのみを生成するには、以下のコマンドを使用します。 このコマンドは MATLAB Coder アプリの既定のビルド タイプ ([ソース コード] ) を複製します。 |
-config:dll | 既定の構成パラメーターを使用して、C/C++ ダイナミック ライブラリを生成します。 |
-config:exe | 既定の構成パラメーターを使用して、C/C++ 実行可能ファイルを生成します。 |
-config:lib | 既定の構成パラメーターを使用して、C/C++ スタティック ライブラリを生成します。 |
-config:mex | 既定の構成パラメーターを使用して、MEX 関数を生成します。 |
-config:single | 既定の構成パラメーターを使用して、単精度 MATLAB コードを生成します。 Fixed-Point Designer が必要です。 |
-config config_object | コード生成パラメーターを含む構成オブジェクトを指定します。config_object は次のいずれか 1 つの構成オブジェクトです。
coder.CodeConfig — Embedded Coder® が使用できない場合に、スタンドアロン C/C++ ライブラリまたは実行可能ファイルを生成するパラメーター。
% Configuration object for a dynamic linked library
cfg = coder.config('dll')
% Configuration object for an executable
cfg = coder.config('exe')
% Configuration object for a static standalone library
cfg = coder.config('lib')
coder.EmbeddedCodeConfig — Embedded Coder が使用可能な場合に、スタンドアロン C/C++ ライブラリまたは実行可能ファイルを生成するパラメーター。
% Configuration object for a dynamic linked library
ec_cfg = coder.config('dll')
% Configuration object for an executable
ec_cfg = coder.config('exe')
% Configuration object for a static standalone library
ec_cfg = coder.config('lib')
coder.MexCodeConfig — MEX コードを生成するパラメーター。
mex_cfg = coder.config
% or
mex_cfg = coder.config('mex')
詳細については、ビルド設定の構成を参照してください。 |
-d out_folder | 生成されたファイルを out_folder で指定された絶対パスまたは相対パスに保存します。out_folder に次を含めてはなりません。
out_folder で指定されたフォルダーが存在しない場合、codegen がそのフォルダーを作成します。 フォルダーの場所を指定しない場合、codegen は既定のフォルダー内にファイルを生成します。 target は以下のいずれかです。
fcn_name は、(アルファベット順で) コマンド ラインの先頭にある MATLAB 関数の名前です。 フォルダー名にはアスタリスク (*)、疑問符 (?)、ドル記号 ($) およびシャープ記号 (#) は使用できません。 メモ codegen は、同じコードに対して同じタイプの出力を生成するたびに、以前のビルドからファイルを削除します。以前のビルドのファイルを保持する場合は、新しいビルドを開始する前に、保持するファイルを別の場所にコピーしてください。
|
-double2single double2single_cfg_name | coder.SingleConfig オブジェクト double2single_cfg_name で指定された設定を使用して、単精度 MATLAB コードを生成します。codegen は codegen/fcn_name /single フォルダーにファイルを生成します。
fcn_name は、エントリポイント関数の名前です。
-config オプションと共に使用すると、単精度 C/C++ コードも生成します。codegen は単精度ファイルを codegen/target /folder_name フォルダーに生成します。
target は以下のいずれかです。
folder_name は fcn_name と singlesuffix の連結です。
singlesuffix は coder.SingleConfig プロパティ OutputFileNameSuffix が指定する接尾辞です。このフォルダーの単精度ファイルにも接尾辞があります。
詳細については、単精度 MATLAB コードの生成を参照してください。このオプションを使用するには、Fixed-Point Designer を所有していなければなりません。 |
-float2fixed float2fixed_cfg_name | -config オプションと共に使用すると、浮動小数点から固定小数点への変換の構成オブジェクト float2fixed_cfg_name で指定された設定を使用して、固定小数点の C/C++ コードを生成します。
codegen はファイルを codegen/target /fcn_name _fixpt フォルダーに生成します。target は以下のようになります。
fcn_name は、エントリポイント関数の名前です。 -config オプションを指定せずに使用すると、浮動小数点から固定小数点への変換の構成オブジェクト float2fixed_cfg_name で指定された設定を使用して、固定小数点の MATLAB コードを生成します。codegen はファイルを codegen/fcn_name /fixpt フォルダーに生成します。
float2fixed_cfg_name の TestBenchName プロパティを設定しなければなりません。たとえば、次のようにします。
fixptcfg.TestBenchName = 'myadd_test'; このコマンドは、myadd_test が浮動小数点から固定小数点に変換する構成オブジェクト fixptcfg のテスト ファイルであることを指定します。詳細については、MATLAB コードの固定小数点 C コードへの変換を参照してください。このオプションを使用するには、Fixed-Point Designer を所有していなければなりません。 |
-g | C コンパイラでデバッグ オプションを使用するかどうかを指定します。デバッグ モードを有効にすると、C コンパイラで一部の最適化が無効になります。コンパイルは速くなりますが、実行は遅くなります。 |
-globals global_values | グローバル変数の名前と初期値は MATLAB ファイルで指定します。 global_values はグローバル変数の名前と初期値の cell 配列です。global_values の形式は次のとおりです。
{g1, init1, g2, init2, ..., gn, initn} gn は文字ベクトルとして指定されるグローバル変数の名前です。initn は初期値です。以下に例を示します。
あるいは、次の形式を使用します。 -globals {global_var, {type, initial_value}} type は型オブジェクトです。型オブジェクトを作成するには、coder.typeof を使用します。グローバル変数の cell 配列の場合、この形式を使用しなければなりません。
codegen でコードを生成する前に、グローバル変数を初期化します。-globals オプションを使用してグローバル変数に初期値を提供しない場合、codegen は MATLAB グローバル ワークスペース内の変数をチェックします。初期値を指定しないと codegen はエラーを生成します。
MATLAB Coder と MATLAB は、それぞれ独自のグローバル データのコピーをもちます。これらの 2 つが情報をやり取りするときは、それぞれのグローバル データを同期して一貫性を保持します。データを同期しないと、グローバル変数は異なるものになる場合があります。 グローバル変数の定数値を指定するには、coder.Constant を使用します。以下に例を示します。 -globals {'g', coder.Constant(v)} これは g が定数値 v をもつグローバル変数であることを指定します。詳細については、グローバル データのためのコード生成を参照してください。 |
-gpuprofile | GPU パフォーマンス アナライザーを使用して、生成されたコードの GPU プロファイリングを有効にします。 GPU パフォーマンス アナライザーは、MEX 関数または生成されたコード内の CPU および GPU アクティビティに関するメトリクスを収集するソフトウェアインザループ (SIL) を実行します。GPU パフォーマンス アナライザーは、生成された CUDA® コードのパフォーマンスのボトルネックを可視化、特定、および軽減するために使用できる時系列順のタイムライン プロットを含むレポートを提供します。 単一のコマンドで CUDA コードを生成およびプロファイルするには、-gpuprofile オプションと -test オプションの両方を指定して codegen を実行します。 GPU プロファイリングには、GPU Coder™ 製品が必要です。MEX 以外のターゲットをプロファイルするには、Embedded Coder 製品も必要です。 詳細については、GPU パフォーマンス アナライザー (GPU Coder)を参照してください。 |
-I include_path | include_path をコード生成パスの先頭に追加します。codegen が MATLAB 関数およびカスタムの C/C++ ファイルを探すときは、最初にコード生成パスを検索します。クラスについては、コード生成パスを検索しません。クラスは MATLAB の検索パス上になければなりません。詳細については、パスとファイル構造の設定を参照してください。
パスに非 7 ビット ASCII 文字 (日本語など) が含まれている場合、codegen はこのパス上でファイルを検出できない場合があります。 複数のパスを含めるには、含める各パスの前に -I を使用します。スペースを含むパスは一重引用符で囲みます。次に例を示します。 -I C:\Project -I 'C:\Custom Files'
|
-jit | MEX 関数の生成には Just-In-Time (JIT) コンパイルを使用します。JIT コンパイルは MEX 関数の生成を高速化できます。このオプションは MEX 関数の生成に対してのみ適用されます。このオプションは、カスタム コードや OpenMP ライブラリの使用など、特定のコード生成機能やオプションと互換性がありません。 |
-lang:c | 生成コードで使用する言語を C として指定します。 ターゲット言語を指定しない場合、コード ジェネレーターは C コードを生成します。 |
-lang:c++ | 生成コードで使用する言語を C++ として指定します。 |
-launchreport | コード生成レポートを生成して開きます。このオプションを指定しない場合、codegen は、エラー メッセージまたは警告メッセージの発生時、あるいは -report オプションが指定されているときに限り、レポートを生成します。 |
-o output_file_name | 基本名 output_file_name と以下の拡張子をもつ MEX 関数、C/C++ ライブラリまたは C/C++ 実行可能ファイルを生成します。
.a または .lib (C/C++ スタティック ライブラリの場合)
.exe または拡張子なし (C/C++ 実行可能ファイルの場合)
.dll (Microsoft® Windows® システムの C/C++ ダイナミック ライブラリの場合) .so (Linux® システムの C/C++ ダイナミック ライブラリの場合)
.dylib (Mac システムの C/C++ ダイナミック ライブラリの場合)
生成された MEX 関数用のプラットフォーム依存の拡張子
output_file_name は、ファイル名にすることも、既存のパスを含めることもできます。output_file_name にはスペースを使用しないでください。スペースを使用すると、オペレーティング システムの構成によっては、コード生成時にエラーが発生する可能性があります。
MEX 関数の場合、output_file_name は有効な MATLAB 関数名でなければなりません。 ライブラリと実行可能ファイルの出力ファイル名を指定しない場合、基本名は fcn_1 になります。fcn_1 は、コマンド ラインで最初に指定されている MATLAB 関数の名前です。MEX 関数の場合、基本名は fcn_1_mex になります。元の MATLAB 関数と MEX 関数を実行して結果を比較できます。 |
-O optimization_option | optimization_option の値に基づいて、生成されたコードを最適化します。
enable:inline — 関数インライン化を有効にします。
disable:inline — 関数インライン化を無効にします。関数インライン化の詳細については、生成コードのパフォーマンスと可読性を微調整するためのインライン化の制御を参照してください。
enable:openmp — 使用可能な場合は OpenMP ライブラリを使用します。OpenMP ライブラリを使用すると、parfor ループ用に codegen が生成する MEX 関数または C/C++ コードを、複数のスレッドで実行できます。
disable:openmp — OpenMP ライブラリを無効にします。OpenMP を無効にすると、codegen は parfor ループを for ループとして処理し、単一のスレッドで実行される MEX 関数または C/C++ コードを生成します。parfor ループのコンパイルの制御を参照してください。
最適化を行うたびにコマンド ラインで -O を 1 回ずつ指定します。 これを指定しない場合、codegen はインライン化と OpenMP を使用して最適化します。 |
-package zip_file_name | 生成されたスタンドアロン コードとその依存関係を、zip_file_name という名前の ZIP 圧縮ファイルにパッケージ化します。その後、この ZIP ファイルを使用して、コード ファイルを他の開発環境に移動、解凍、およびリビルドできます。 このパッケージ化機能は、関数 packNGo でも提供されます。 |
-preservearraydims | N 次元インデックスを使用するコードを生成します。詳細については、N 次元インデックスを使用するコードの生成を参照してください。 |
-profile | MATLAB プロファイラーを使用して、生成された MEX 関数のプロファイリングを有効にします。詳細については、MATLAB プロファイラーを使用した MEX 関数のプロファイリングを参照してください。 このオプションは、GPU Coder を使用した CUDA コード生成ではサポートされていません。生成された CUDA コードをプロファイルするには、-gpuprofile オプションを使用します。 |
-report | コード生成レポートを作成します。このオプションを指定しない場合、codegen は、エラー メッセージまたは警告メッセージの発生時、あるいは -launchreport オプションが指定されているときに限り、レポートを生成します。 Embedded Coder がある場合、このオプションによりコード置換レポートの作成も有効になります。 |
-reportinfo info | コード生成に関する情報をベースの MATLAB ワークスペースの変数 info にエクスポートします。コード生成レポートの情報へのプログラムによるアクセスを参照してください。 |
-rowmajor | 行優先の配列レイアウトを使用するコードを生成します。列優先のレイアウトが既定です。詳細については、行優先の配列レイアウトを使用するコードの生成を参照してください。 |
-silent | コード生成が警告なしで正常に実行された場合に、レポートの生成時も含め、すべてのメッセージを非表示にします。 警告およびエラー メッセージは表示されます。 |
-singleC | 単精度 C/C++ コードを生成します。詳細については、コマンド ラインでの単精度の C コードの生成を参照してください。 このオプションを使用するには、Fixed-Point Designer を所有していなければなりません。 |
-std:c89/c90 | 生成されたコードに C89/90 (ANSI) 言語標準を使用します。 |
-std:c99 | 生成されたコードに C99 (ISO) 言語標準を使用します。 |
-std:c++03 | 生成されたコードに C++03 (ISO) 言語標準を使用します。このライブラリは、C++ コードを生成する場合にのみ使用できます。 |
-std:c++11 | 生成されたコードに C++11 (ISO) 言語標準を使用します。このライブラリは、C++ コードを生成する場合にのみ使用できます。 |
-test test_file | 元の MATLAB 関数の呼び出しを MEX 関数の呼び出しに置き換えて test_file を実行します。このオプションの使用と coder.runTest の実行は同じです。 このオプションは MEX 関数を生成する場合、または VerificationMode を 'SIL' または 'PIL' に設定した構成オブジェクトを使用する場合にのみサポートされます。VerificationMode パラメーターをもつ構成オブジェクトを作成するには、Embedded Coder 製品が必要です。 |
-toproject project_file_name | codegen コマンドを project_file_name という名前の等価の MATLAB Coder プロジェクト ファイルに変換します。その後、codegen コマンドをもう一度使用するか MATLAB Coder アプリを使用して、プロジェクト ファイルからコードを生成することができます。
-toproject オプションを使用して、不完全な codegen コマンドをプロジェクト ファイルに変換することもできます。たとえば、構成オブジェクト cfg に格納されているコード生成パラメーターのみが含まれるプロジェクト ファイル myProjectTemplate.prj を作成するには、次を実行します。 この場合、myProjectTemplate.prj にはエントリポイント関数または入力型の指定は含まれません。そのため、このプロジェクト ファイルからコードを生成することはできません。MATLAB Coder アプリで myProjectTemplate.prj を開いて、コード生成に使用できる完全なプロジェクト ファイルを作成するためのテンプレートとして使用できます。-toproject project_file_name オプションを指定して codegen を実行しても、コードは生成されません。プロジェクト ファイルが作成されるだけです。
codegen コマンドの等価な MATLAB Coder プロジェクトへの変換を参照してください。 |
-v | 詳細モードを有効にして、コード生成のステータスとターゲットのビルド ログ メッセージを表示します。 |
-? | codegen コマンドのヘルプを表示します。
|