coder.config

コード生成構成オブジェクトを作成する

構文

config_obj = coder.config

config_obj = coder.config(build_type)

config_obj = coder.config(build_type,'ecoder',ecoder_flag)

config_obj = coder.config(numeric_conversion_type)

説明

coder.config 関数を使用して、MEX コード生成、スタンドアロン コード生成、固定小数点変換、および単精度変換用の構成オブジェクトを作成します。構成オブジェクトのプロパティを変更して、可読性、パフォーマンス、ハードウェア要件、カスタム ライブラリの使用などのプロジェクトの要件に応じて生成されたコードをカスタマイズします。

config_obj = coder.config は、MEX 関数を生成するときに codegen で使用する coder.MexCodeConfig コード生成構成オブジェクトを作成します。coder.MexCodeConfig オブジェクトは codegen コマンドの -config オプションで使用します。

config_obj = coder.config(build_type) は、MEX 関数またはスタンドアロン コード (スタティック ライブラリ、ダイナミック リンク ライブラリまたは実行可能プログラム) を生成するときに codegen で使用するコード生成構成オブジェクトを作成します。このコード生成構成オブジェクトは codegen コマンドの -config オプションで使用します。

config_obj = coder.config(build_type,'ecoder',ecoder_flag) は、ecoder_flag が true か false かに応じて coder.EmbeddedCodeConfig オブジェクトまたは coder.CodeConfig オブジェクトを作成します。build_type は 'lib'、'dll'、または 'exe' です。以下の機能を使用するには、フラグを true に設定します。

• ソフトウェアインザループ (SIL) およびプロセッサインザループ (PIL) の実行によるコード検証。

• コードのトレースまたは双方向のトレーサビリティ。

• ハードウェア固有の最適化およびカスタム置換ライブラリ。

• 生成コードの外観をカスタマイズする。

MATLAB コードからのコード生成のための Embedded Coder 機能 (Embedded Coder)を参照してください。

config_obj = coder.config(numeric_conversion_type) は、codegen で使用する次の構成オブジェクトを作成します。

• 浮動小数点の MATLAB^® コードから固定小数点の MATLAB コードまたは C/C++ コードを生成する場合は coder.FixPtConfig。codegen コマンドの -float2fixed オプションで使用します。

• 倍精度の MATLAB コードから単精度の MATLAB コードを生成する場合は coder.SingleConfig (Fixed-Point Designer)。codegen コマンドの -double2single オプションで使用します。

固定小数点の変換や単精度の変換には Fixed-Point Designer™ が必要です。

メモ

関数 coder.config を使用してコード構成オブジェクトを作成した後、そのプロパティをコマンド ラインからプログラムで変更するか、構成パラメーター ダイアログ ボックスを使用して対話的に変更できます。Specify Code Configuration Parameters Interactivelyを参照してください。

例

MATLAB 関数からの MEX 関数の生成

コード生成に適した MATLAB 関数から MEX 関数を生成し、コード生成レポートを有効にします。

開区間 (0,1) 上の標準一様分布からランダムなスカラー値を生成する MATLAB 関数 coderand を作成します。

function r = coderand() %#codegen
% The directive %#codegen declares that the function
% is intended for code generation
r = rand();

コード生成構成オブジェクトを作成して、MEX 関数を生成します。

cfg = coder.config % or cfg = coder.config('mex')

コード生成レポートを開きます。

cfg.GenerateReport = true;

-config オプションを使用して構成オブジェクトを指定する MEX 関数を現在のフォルダーに生成します。

% Generate a MEX function and code generation report
codegen -config cfg coderand

スタンドアロン C スタティック/ダイナミック ライブラリまたはスタンドアロン C 実行可能ファイルの生成

スタンドアロン C スタティック ライブラリ用のコード生成構成オブジェクトを作成します。

cfg = coder.config('lib')
% Returns a coder.EmbeddedCodeConfig object if the Embedded 
% Coder product is installed. 
% Otherwise, returns a coder.CodeConfig object.

コード生成構成オブジェクトを作成して、スタンドアロン C ダイナミック ライブラリを生成します。

cfg = coder.config('dll')
% Returns a coder.EmbeddedCodeConfig object if the Embedded 
% Coder product is installed. 
% Otherwise, returns a coder.CodeConfig object.

コード生成構成オブジェクトを作成して、スタンドアロン C 実行可能ファイルを生成します。

cfg = coder.config('exe')
% Returns a coder.EmbeddedCodeConfig object if the Embedded 
% Coder product is installed. 
% Otherwise, returns a coder.CodeConfig object.

Embedded Coder のインストールを含む coder.CodeConfig オブジェクトの作成

システムに Embedded Coder^® 製品がインストールされている場合でも coder.CodeConfig オブジェクトを作成します。

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

Embedded Coder なしで coder.EmbeddedCodeConfig オブジェクトを作成します。

cfg = coder.config('lib','ecoder',true)

数値変換構成オブジェクトの作成

coder.FixPtConfig オブジェクトを作成します。

fixptcfg = coder.config('fixpt');

coder.SingleConfig (Fixed-Point Designer) オブジェクトを作成します。

scfg = coder.config('single');

入力引数

build_type — 作成するコード生成オブジェクトのタイプ

'mex' | 'lib' | 'dll' | 'exe'

構成オブジェクトのタイプ	生成コード	コード生成構成オブジェクト (Embedded Coder のインストールあり)	コード生成構成オブジェクト (Embedded Coder のインストールなし)
'mex'	MEX 関数	coder.MexCodeConfig	coder.MexCodeConfig
'lib'	スタティック ライブラリ	coder.EmbeddedCodeConfig	coder.CodeConfig
'dll'	ダイナミック ライブラリ	coder.EmbeddedCodeConfig	coder.CodeConfig
'exe'	実行可能ファイル	coder.EmbeddedCodeConfig	coder.CodeConfig

例: coder.config('mex');

データ型: char | string

numeric_conversion_type — 数値変換オブジェクトのタイプ

'fixpt' | 'single'

'fixpt'	浮動小数点の MATLAB コードから固定小数点の MATLAB コードまたは C/C++ コードを生成する場合に codegen で使用する coder.FixptConfig 構成オブジェクトを作成します。
'single'	倍精度の MATLAB コードから単精度の MATLAB コードを生成する場合に codegen で使用する coder.SingleConfig 構成オブジェクトを作成します。

例: coder.config('fixpt');

データ型: char | string

ecoder_flag — Embedded Coder コード構成オブジェクトのフラグ

false | true

true	以下の機能の使用を許可するには、Embedded Coder の有無に関係なく、coder.EmbeddedCodeConfig 構成オブジェクトを作成します。 ソフトウェアインザループ (SIL) およびプロセッサインザループ (PIL) の実行によるコード検証。 コードのトレースまたは双方向のトレーサビリティ。 ハードウェア固有の最適化およびカスタム置換ライブラリ。 生成コードの外観のカスタマイズ。 MATLAB コードからのコード生成のための Embedded Coder 機能 (Embedded Coder)を参照してください。 build_type は、'lib'、'dll'、または 'exe' でなければなりません。 ただし、coder.EmbeddedCodeConfig オブジェクトを使用したコード生成には Embedded Coder 製品が必要です。
false	Embedded Coder 製品がインストールされている場合でも coder.CodeConfig 構成オブジェクトを作成します。build_type は 'lib'、'dll'、または 'exe' でなければなりません。

例: coder.config('lib','ecoder',false);

データ型: logical

出力引数

config_obj — コード生成構成のハンドル

coder.CodeConfig | coder.MexCodeConfig | coder.EmbeddedCodeConfig | coder.FixPtConfig | coder.SingleConfig

MATLAB Coder™ コード生成構成オブジェクトのハンドル。

代替方法

関数 coder を使用して MATLAB Coder アプリを開き、MATLAB Coder プロジェクトを作成します。このアプリは、MATLAB ファイルの追加、入力パラメーターの定義およびビルド パラメーターの指定を行うためのユーザー インターフェイスを提供します。

バージョン履歴

R2011a で導入

参考

coder.CodeConfig | coder.EmbeddedCodeConfig | coder.MexCodeConfig | coder.FixPtConfig | codegen | coder.SingleConfig (Fixed-Point Designer)

トピック

• MATLAB アルゴリズムを高速化するための MEX 関数の生成
• コマンド ラインでの C コードの生成
• MATLAB コードの固定小数点 C コードへの変換
• コマンド ラインでの単精度の C コードの生成
• Specify Code Configuration Parameters Interactively