このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。
Code Replacement Tool
コード置換ライブラリの内容の作成、変更、および検証
説明
コード置換ツールは、カスタム コード置換ライブラリを作成して管理するために使用できるグラフィカル インターフェイスです。ライブラリ内でコード置換テーブルを作成、インポート、操作、および検証できます。このツールでは、カスタマイズ ファイルを生成してコード置換ライブラリをコード ジェネレーターに登録することもできます。ツールを開いたときにテーブル名を指定すると、ツールにはそのテーブルの内容のみが表示されます。
その他
ツールの表示は、テーブルとテーブル エントリ情報を示す次の 3 つのペインで構成されます。
左のペインにはコード置換テーブルがリストされます。
中央のペインには使用可能なテーブルがリストされるか、左のペインでテーブルを選択した場合は、そのテーブル内のテーブル エントリがリストされます。
右のペインにはテーブルまたはテーブル エントリの詳細がリストされます。テーブルを選択すると、右のペインにテーブルのプロパティ (変更可能なテーブル名、テーブル バージョン、およびテーブル内のエントリ合計数) が表示されます。テーブル エントリを選択すると、右のペインにそのエントリのマッピングとビルド情報が表示されます。
Code Replacement Tool を開く
コマンド プロンプトで、crtool
と入力します。
例
ツールで既存のテーブルを開く
この例では、コード置換ツールでコード置換テーブル my_lookup_replacement_table
を開く方法を示します。このテーブルはGenerate Code by Using Lookup Table Code Replacement Libraryで使用します。
crtool('my_lookup_replacement_table')
関連する例
パラメーター
Name
— テーブル エントリの名前 (読み取り専用)
文字ベクトル
置換対象の関数または演算の概念名。算術演算、関数、BLAS 演算、CBLAS 演算、正味の勾配の固定小数点演算、セマフォまたはミューテックス エントリ、カスタマイズ エントリの名前を指定できます。
Implementation
— 置換関数の名前
文字ベクトル
実装 (置換) 関数の名前。
NumIn
— 入力引数の数 (読み取り専用)。
スカラー整数
入力引数の数。
Inn
Type
— 概念入力引数のデータ型
文字ベクトル
n
Type概念入力引数のデータ型。
Outn
Type
— 概念出力引数のデータ型
文字ベクトル
n
Type概念出力引数のデータ型。
Priority
— エントリの一致の優先順位
100 (既定値) | 0 ~ 100 の範囲の整数
エントリの一致の優先順位。選択されたコード置換ライブラリ内の同じ名前の他のエントリおよび概念引数リストを基準に優先順位が付けられます。優先順位の値は 0 から 100 の範囲で、最も優先順位が高いのは 0 です。既定の設定は 100 です。ライブラリで関数または演算子に 2 つの実装が提供されている場合、優先順位が高い方の実装が低い方よりも優先されます。
関数/演算
— テーブル エントリの名前
文字ベクトル
置換対象の関数または演算の概念名。算術演算、関数、BLAS 演算、CBLAS 演算、正味の勾配の固定小数点演算、セマフォまたはミューテックス エントリ、カスタマイズ エントリの名前を指定できます。
アルゴリズム
— 計算または近似アルゴリズム
指定なし (既定値) | オプションは関数または演算によって異なります。
置換対象の関数または演算に対して構成された計算または近似アルゴリズム。たとえば、次を構成できます。
[ニュートン・ラフソン]
計算方法を使用する Reciprocal Sqrt ブロック。[関数] が
[sin]
、[cos]
、[sincos]
、または[atan2]
に設定され、近似法[CORDIC]
または[ルックアップ]
を使用する Trigonometric Function ブロック。演算前または演算後にキャスト アルゴリズムを使用する加算または減算演算。
概念引数
— 概念引数名
yn | uN
置換対象の関数または演算の入力引数および出力引数の名前。概念引数は、コード ジェネレーターにとって既知の命名規則 (y1
, u1
, u2
, ...) とデータ型を観察します。
データ型 (概念)
— 概念引数のデータ型
double (既定値) | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | boolean | void | logical | fixdt(1,16) | fixdt(1,16,0) | fixdt(1,16,2^0,0)
置換対象の関数または演算の選択した入力引数または出力引数のデータ型。概念引数は、コード ジェネレーターにとって既知のデータ型を観察します。
複素数 (概念)
— 概念引数の実数/複素数
オフ (既定値) | 選択
置換対象の関数または演算の選択した入力引数または出力引数が実数と複素数のどちらであるか。
引数タイプ
— 概念引数タイプ
スカラー (既定値) | 行列
置換対象の関数または演算の選択した入力引数または出力引数がスカラー値と行列のどちらであるか。[Matrix]
を選択すると、範囲の次元を指定するパラメーター、MATLAB コードの置換用のパラメーター、配列レイアウトが表示されます。
下限範囲
— 行列の次元の下限範囲
[2 2] (既定値)
行列の次元の下限範囲を指定するベクトル。
上限範囲
— 行列の次元の上限範囲
[2 2] (既定値)
行列の次元の上限範囲を指定するベクトル。
エントリでサポートされている配列のレイアウト
— 配列ストレージのレイアウト
列優先 (既定値) | 行優先 | 列および行
配列要素がメモリに格納される順序。行優先のレイアウトにより特定のアルゴリズムのパフォーマンスが向上し、行優先レイアウトを使用する外部コードまたはデータとの統合が容易になります。
概念引数と実装引数のタイプを同じにする
— データ型の整合性
選択 (既定値) | オフ
実装引数のデータ型を概念引数の型と同じにするかどうか。たとえば、ほとんどの ANSI-C 関数は double
データで機能し、それを返します。関数または演算の概念表現を、引数および戻り値を指定する実装表現にマッピングする場合は、このチェック ボックスをオフにします。たとえば、関数 sin
の概念表現を、引数および single
(single
sin
(single
)) 型の戻り値を指定する実装表現にマッピングする場合はチェック ボックスをオフにします。
名前
— 置換関数の名前
文字ベクトル
置換関数の名前。
C++ 名前空間
— 置換関数の名前空間
文字ベクトル
置換関数の名前空間。
関数は void を返す
— 関数は void を返す
選択 (既定値) | オフ
実装関数が void
を返すかどうか。
関数の引数
— 置換引数名
yn | uN
置換関数の入力引数と出力引数の名前。
データ型 (置換)
— 置換引数のデータ型
double (既定値) | single | int8 | uint8 | int16 | uint16 | int32 | uint32 | int64 | uint64 | boolean | void | 整数 | size_t | long | ulong | long long | ulong long | char
置換関数の選択した入力引数または出力引数のデータ型。
I/O タイプ
— 置換引数の I/O タイプ
出力 | 入力
置換関数の選択した引数が入力引数と出力引数のどちらであるか。
Const
— 置換関数 Const
オフ (既定値) | 選択
const
型修飾子を置換関数の選択した引数に適用するかどうか。
ポインター
— ポインター置換引数
オフ (既定値) | 選択
置換関数の選択した引数がポインターかどうか。
複素数 (置換)
— 置換引数の実数/複素数
オフ (既定値) | 選択
置換関数の選択した入力引数または出力引数が実数と複素数のどちらであるか。
整数飽和モード
— 飽和モード
未指定の飽和 (既定値) | オーバーフロー時にラップ | オーバーフローで飽和
置換関数でサポートされる飽和モード。
丸めモード
— 丸めモード
未指定の丸め (既定値) | 負方向 | 正方向 | ゼロ方向 | 最も近い整数への丸め | MATLAB® 最も近い整数への丸め | 最も簡潔 | conv
置換関数でサポートされる丸めモード。
式の入力を許可
— 式の入力
選択 (既定値) | オフ
置換関数が式の入力を受け入れるかどうか。このパラメーターを選択すると、コード ジェネレーターは式の入力の代わりに一時変数を挿入するのではなく、式の入力を生成されたコードに統合します。
関数で内部またはグローバル状態を変更
— 状態の変更
オフ (既定値) | 選択
置換関数が内部またはグローバル状態を表す変数を変更するかどうか。
実装ヘッダー ファイル
— 置換関数のヘッダー ファイル
文字ベクトル
置換関数のヘッダー ファイル (my_rep_func.h
など)。
実装ソース ファイル
— 置換関数のソース ファイル
文字ベクトル
置換関数のソース ファイル (my_rep_func.c
など)。
追加のヘッダー ファイル/インクルード パス
— 追加のヘッダー ファイルの名前とパス
文字ベクトル
置換関数に含める追加のヘッダー ファイルの名前とパス (support_files.h
と matlab\customization\mylib\include
など)。
追加のソース ファイル/パス
— 追加のソース ファイルの名前とパス
文字ベクトル
置換関数に含める追加のソース ファイルの名前とパス (support_files.c
と matlab\customization\mylib\src
など)。
追加のオブジェクト ファイル/パス
— リンク オブジェクト ファイルの名前とパス
文字ベクトル
置換関数で使用するリンク オブジェクト ファイルの名前とパス (support_files.o
と matlab\customization\mylib\bin
など)。
追加のリンク フラグ
— 使用するリンク フラグ
文字ベクトル
置換関数で使用するリンク フラグ (-MD -Gy
など)。
追加のコンパイラ フラグ
— 使用するコンパイル フラグ
文字ベクトル
置換関数で使用するコンパイル フラグ (-Zi -Wall
など)。
ファイルをビルド ディレクトリにコピー
— ファイルをビルド フォルダーにコピー
オフ (既定値) | 選択
コード ジェネレーターがビルド プロセスを開始する前にファイルを外部フォルダーからビルド フォルダーにコピーするかどうか。
プログラムでの使用
crtool(table)
crtool(table)
はコード置換ツールを開いて table
の内容を表示します。ここで table
は、コード置換テーブルを定義する MATLAB ファイルに名前を指定する文字ベクトルです。ファイルは現在のフォルダーまたは MATLAB パス上になければなりません。
バージョン履歴
R2014b で導入
MATLAB コマンド
次の MATLAB コマンドに対応するリンクがクリックされました。
コマンドを MATLAB コマンド ウィンドウに入力して実行してください。Web ブラウザーは MATLAB コマンドをサポートしていません。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)