Magnitude-Angle to Complex

振幅信号と位相角信号の両方またはどちらか一方を複素信号に変換

• 

×

ライブラリ:
Simulink / Math Operations
HDL Coder / HDL Floating Point Operations

説明

サポートされている演算

Magnitude-Angle to Complex ブロックは、振幅入力と位相角入力を複素数出力に変換します。角度の入力は、rad 単位でなければなりません。

2 つのブロック入力があるときには、ブロックは入力次元の次の組み合わせをサポートします。

• 同じ次元の 2 つの入力

• 一方のスカラー入力ともう一方の n 次元配列

このブロック入力が配列である場合、出力は複素信号の配列になります。大きさ入力のベクトルの要素は、対応する複素数出力要素の大きさにマップされます。同様に、角度の入力ベクトルの要素は、対応する複素数の出力要素の角度にマップされます。ある入力がスカラーの場合、その入力はすべての複素数出力信号の対応する成分 (大きさまたは角度) にマップされます。

CORDIC 近似に対する範囲外入力の影響

CORDIC 近似法[1]を使用する場合、位相角のブロック入力には次の制限があります。

• 符号付き固定小数点型の場合、入力角度は範囲 [–2π, 2π) rad の範囲内に収まらなければなりません。

• 符号なし固定小数点型の場合、入力角度は範囲 [0, 2π) rad の範囲内に収まらなければなりません。

次の表は、範囲外入力の影響をまとめています。

ブロックの使用法	範囲外入力の影響
シミュレーション モード	エラーが表示されます。
生成コード	未定義の動作が発生します。

CORDIC 近似を使用する場合は、Magnitude-Angle to Complex ブロックに対して必ず範囲内入力を使用します。生成コードまたはアクセラレータ モードで未定義の動作に依存するのを防ぎます。

例

振幅と位相角からの複素数信号の作成

この例では、Magnitude-Angle to Complex ブロックを使用して複素数値信号を作成する方法を示します。

モデルを開く

端子

入力

|u| — 振幅

スカラー | ベクトル | 行列

振幅。実数値のスカラー、ベクトル、または行列として指定します。

依存関係

• この端子を有効にするには、[入力] を [振幅と角度] に設定します。

制限

• 片方の入力が浮動小数点データ型をもつ場合、もう一方の入力も同じデータ型を使用しなければなりません。たとえば、両方の信号は double または single でなければなりません。

• 固定小数点データ型は、[近似法] を [CORDIC] に設定したときにのみサポートされます。片方の入力が固定小数点データ型をもつ場合、もう一方の入力も同じ固定小数点データ型をもたなければなりません。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

∠u — ラジアン位相角

スカラー | ベクトル | 行列

ラジアン位相角。実数値のスカラー、ベクトル、または行列として指定します。CORDIC 近似を計算するには、入力角は次の範囲になければなりません。

• [–2π, 2π) rad (符号付き固定小数点型の場合)

• [0, 2π) rad (符号なし固定小数点型の場合)

詳細については、CORDIC 近似に対する範囲外入力の影響を参照してください。

依存関係

• この端子を有効にするには、[入力] を [振幅と角度] に設定します。

制限

• 片方の入力が浮動小数点データ型をもつ場合、もう一方の入力も同じデータ型を使用しなければなりません。たとえば、両方の信号は double または single でなければなりません。

• 固定小数点データ型は、[近似法] を [CORDIC] に設定したときにのみサポートされます。片方の入力が固定小数点データ型をもつ場合、もう一方の入力も固定小数点データ型をもたなければなりません。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

Port_1 — 振幅またはラジアン位相角

スカラー | ベクトル | 行列

振幅、またはラジアン位相角。実数値のスカラー、ベクトル、または行列として指定します。

• [入力] を [振幅] に設定する場合、振幅を入力端子に指定し、角度をダイアログ ボックスで指定します。

• [入力] を [角度] に設定する場合、角度を入力端子に指定し、振幅をダイアログ ボックスで指定します。

依存関係

この端子を有効にするには、[入力] を [振幅] または [角度] に設定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fixed point

出力

Port_1 — 複素信号

スカラー | ベクトル | 行列

複素信号。指定する振幅および位相角から形成されます。

このブロック入力が配列である場合、出力は複素信号の配列になります。大きさ入力のベクトルの要素は、対応する複素数出力要素の大きさにマップされます。同様に、角度の入力ベクトルの要素は、対応する複素数の出力要素の角度にマップされます。ある入力がスカラーの場合、その入力はすべての複素数出力信号の対応する成分 (大きさまたは角度) にマップされます。

データ型: single | double | fixed point

パラメーター

入力 — 入力のタイプ

振幅 (既定値) | 角度 | 振幅と角度

入力の種類 大きさ入力、角度の入力、またはこれらの両方。

プログラムでの使用

ブロック パラメーター: Input

型: 文字ベクトル

値: 'Magnitude' | 'Angle' | 'Magnitude and angle'

既定の設定: 'Magnitude and angle'

角度 — 出力の位相角

0 (既定値) | 実数値のスカラー、ベクトル、または行列

rad 単位の出力信号の定数位相角CORDIC 近似を計算するには、入力角は次の範囲になければなりません。

• [–2π, 2π) rad (符号付き固定小数点型の場合)

• [0, 2π) rad (符号なし固定小数点型の場合)

詳細については、CORDIC 近似に対する範囲外入力の影響を参照してください。

依存関係

このパラメーターを有効にするには、[入力] を [振幅] に設定します。

プログラムでの使用

ブロック パラメーター: ConstantPart

型: 文字ベクトル

値: 定数スカラー

既定の設定: '0'

振幅 — 出力の振幅

0 (既定値) | 実数値のスカラー、ベクトル、または行列

出力信号の定数振幅。実数値のスカラー、ベクトル、または行列として指定します。

依存関係

このパラメーターを有効にするには、[入力] を [角度] に設定します。

プログラムでの使用

ブロック パラメーター: ConstantPart

型: 文字ベクトル

値: 実数値のスカラー、ベクトル、または行列

既定の設定: '0'

近似法 — CORDIC またはなし

なし (既定値) | CORDIC

出力を計算するための近似のタイプを指定します。

近似法	サポートされるデータ型	このメソッドを使用できる場合
なし (既定の設定)	浮動小数点	既定のテイラー級数アルゴリズムを使用する必要がある場合。
CORDIC	浮動小数点と固定小数点	高速の近似計算が必要な場合。

CORDIC 近似を使用するときは、入力角度について以下のガイドラインに従ってください。

• 符号付き固定小数点型の場合、入力角度は範囲 [–2π, 2π) rad の範囲内に収まらなければなりません。

• 符号なし固定小数点型の場合、入力角度は範囲 [0, 2π) rad の範囲内に収まらなければなりません。

ブロックは次のデータ型伝播規則を使用します。

大きさ入力のデータ型	近似法	複素数出力のデータ型
浮動小数点	なし または CORDIC	入力と同じ
符号付き、固定小数点	CORDIC	fixdt(1, WL + 2, FL) ここで、WL と FL は大きさの語長と小数部の長さ
符号なし、固定小数点	CORDIC	fixdt(1, WL + 3, FL) ここで、WL と FL は大きさの語長と小数部の長さ

プログラムでの使用

ブロック パラメーター: ApproximationMethod

型: 文字ベクトル

値: 'None' | 'CORDIC'

既定の設定: 'None'

反復回数 — CORDIC アルゴリズムの反復回数

11 (既定値) | 固定小数点入力の語長以下の正の整数

CORDIC アルゴリズムを実行する反復回数取りうる値の範囲は入力のデータ型によって異なります。

ブロック入力のデータ型	指定できる値
浮動小数点	正の整数
固定小数点	大きさ入力の語長または位相角入力の語長を超えない正の整数、どちらか小さいほう

依存関係

このパラメーターを有効にするには、[近似法] を [CORDIC] に設定します。

プログラムでの使用

ブロック パラメーター: NumberOfIterations

型: 文字ベクトル

値: 固定小数点入力の語長以下の正の整数

既定の設定: '11'

ゲイン ファクターの逆数による出力のスケール — 複素数出力の実数部および虚数部のスケーリング

on (既定値) | off

このチェック ボックスを選択すると、複素数出力の実数部および虚数部を (1/CORDIC gain) 倍にスケーリングできます。この値は、指定する反復の数によって異なります。反復の数が増えると、値は 1.647 に近づきます。

このチェック ボックスは既定で選択されており、複素数出力の数値的により正確な結果である X + iY になります。ただし、出力をスケーリングすることによって、2 つの余分な乗算、X 用と Y 用が追加されます。

依存関係

このパラメーターを有効にするには、[近似法] を [CORDIC] に設定します。

プログラムでの使用

ブロック パラメーター: ScaleReciprocalGainFactor

型: 文字ベクトル

値: 'on' | 'off'

既定の設定: 'on'

サンプル時間 — -1 以外のサンプル時間値

-1 (既定値) | スカラー | ベクトル

サンプル時間を -1 以外の値として指定します。詳細については、サンプル時間の指定を参照してください。

依存関係

このパラメーターは、明示的に -1 以外の値に設定されていない限り表示されません。詳細は、サンプル時間が推奨されないブロックを参照してください。

プログラムでの使用

ブロック パラメーター: SampleTime

型: string スカラーまたは文字ベクトル

既定の設定: "-1"

ブロックの特性

データ型	double | single
直達	はい
多次元信号	はい
可変サイズの信号	はい
ゼロクロッシング検出	いいえ

詳細

CORDIC

CORDIC は、COordinate Rotation DIgital Computer の略語です。ギブンス回転に基づく CORDIC アルゴリズムは、Shift-Add 反復演算のみを必要とするため、ハードウェア効率が最も優れたアルゴリズムの 1 つです (参考文献を参照)。CORDIC アルゴリズムは、明示的な乗数を必要としません。CORDIC を使用すると、正弦関数、余弦関数、逆正弦関数、逆余弦関数、逆正接関数、ベクトル振幅関数などのさまざまな関数を計算できます。また、このアルゴリズムは除算、平方根、双曲線、対数などの関数にも使用できます。

CORDIC の反復数を増やすと、結果の精度が高まりますが、それにより計算量が増加しレイテンシが増えます。

参照

[1] Volder, Jack E., “The CORDIC Trigonometric Computing Technique.” IRE Transactions on Electronic Computers EC-8 (1959); 330–334.

[2] Andraka, Ray “A Survey of CORDIC Algorithm for FPGA Based Computers.” Proceedings of the 1998 ACM/SIGDA Sixth International Symposium on Field Programmable Gate Arrays. Feb. 22–24 (1998): 191–200.

[3] Walther, J.S., “A Unified Algorithm for Elementary Functions,” Proceedings of the Spring Joint Computer Conference, May 18-20, 1971: 379–386.

[4] Schelin, Charles W., “Calculator Function Approximation,” The American Mathematical Monthly 90, no. 5 (1983): 317–325.

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

HDL コード生成

HDL Coder™ を使用して FPGA 設計および ASIC 設計のための Verilog および VHDL のコードを生成します。

HDL Coder™ には、HDL の実装および合成されたロジックに影響する追加のコンフィギュレーション オプションがあります。

HDL アーキテクチャ

このブロックには、生成されたコードで追加のレイテンシを導入するマルチサイクル実装があります。追加されたレイテンシを確認するには、生成されたモデルまたは検証モデルを表示します。生成されたモデルと検証モデル (HDL Coder)を参照してください。

追加のレイテンシをもつブロックの場合、[近似法] は [CORDIC] です。追加サイクルの反復回数は +1 です。

HDL ブロック プロパティ

ConstrainedOutputPipeline	既存の遅延を設計内で移動することによって出力に配置するレジスタの数。分散型パイプラインではこれらのレジスタは再分散されません。既定の設定は 0 です。詳細については、ConstrainedOutputPipeline (HDL Coder)を参照してください。
InputPipeline	生成されたコードに挿入する入力パイプライン ステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は 0 です。詳細については、InputPipeline (HDL Coder)を参照してください。
OutputPipeline	生成されたコードに挿入する出力パイプライン ステージ数。分散型パイプラインと制約付き出力パイプラインでは、これらのレジスタを移動できます。既定の設定は 0 です。詳細については、OutputPipeline (HDL Coder)を参照してください。

制限

Magnitude-Angle to Complex ブロックは、浮動小数点データ型の HDL コード生成のみをサポートします。

固定小数点の変換

Fixed-Point Designer™ を使用して固定小数点システムの設計とシミュレーションを行います。

Magnitude-Angle to Complex ブロックは、[近似法] を [CORDIC] に設定した場合、固定小数点データ型および整数データ型をサポートします。

バージョン履歴

R2006a より前に導入

参考

Complex to Magnitude-Angle | Complex to Real-Imag | Real-Imag to Complex

トピック

• 複素数信号