このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

comm.PhaseFrequencyOffset

位相と周波数オフセットを入力信号に適用

説明

PhaseFrequencyOffset オブジェクトは、入力信号に位相と周波数のオフセットを適用します。

位相と周波数オフセットは次により入力信号に適用します。

1. comm.PhaseFrequencyOffset オブジェクトを作成し、そのプロパティを設定します。

2. 関数と同様に、引数を指定してオブジェクトを呼び出します。

System object の機能の詳細については、System object とはを参照してください。

作成

構文

pfo = comm.PhaseFrequencyOffset

pfo = comm.PhaseFrequencyOffset(Name=Value)

説明

pfo = comm.PhaseFrequencyOffset は、位相/周波数オフセット System object™ を作成します。このオブジェクトは、入力信号に位相と周波数のオフセットを適用します。

pfo = comm.PhaseFrequencyOffset(Name=Value) は、指定されたそれぞれのプロパティを指定された値に設定して、位相/周波数オフセット オブジェクトを作成します。たとえば、SampleRate=20 はサンプル レートを 20 Hz に設定します。(Name1=Value1,...,NameN=ValueN) のように、追加の名前と値のペアの引数を任意の順番で指定できます。

プロパティ

特に指定がない限り、プロパティは "調整不可能" です。つまり、オブジェクトの呼び出し後に値を変更することはできません。オブジェクトは呼び出すとロックされ、ロックを解除するには関数 release を使用します。

プロパティが "調整可能" の場合、その値をいつでも変更できます。

プロパティ値の変更の詳細については、System object を使用した MATLAB でのシステム設計を参照してください。

PhaseOffset — 位相オフセット

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

位相オフセット (度単位)。数値スカラー、M 行 1 列または 1 行 N 列の数値ベクトル、あるいは M 行 N 列の数値行列として指定します。詳細については、相互に依存するプロパティ入力の次元を参照してください。

調整可能: Yes

データ型: double

FrequencyOffsetSource — 周波数オフセットのソース

"Property" (既定値) | "Input port"

周波数オフセットのソース。次のいずれかの値として指定します。

• "Property" — FrequencyOffset プロパティを使用して周波数オフセットを指定します。

• "Input port" — 入力引数 fOffset で周波数オフセットを指定します。

FrequencyOffset — 周波数オフセット

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

周波数オフセット (Hz 単位)。数値スカラー、数値の行ベクトルまたは列ベクトル、あるいは数値行列として指定します。

詳細については、相互に依存するプロパティ入力の次元を参照してください。

調整可能: Yes

依存関係

このプロパティを有効にするには、FrequencyOffsetSource プロパティを "Property" に設定します。

データ型: double

SampleRate — サンプル レート

1 (既定値) | 正のスカラー

入力信号のサンプル レート (Hz 単位)。正のスカラーとして指定します。

データ型: double

使用法

構文

y = pfo(x)

y = pfo(x,fOffset)

説明

y = pfo(x) は、位相と周波数のオフセットを入力信号 x に適用します。この構文を使用するには、FrequencyOffsetSource を "Property" に設定します。

y = pfo(x,fOffset) は、x に適用する周波数オフセットを指定します。この構文を使用するには、FrequencyOffsetSource を "Input port" に設定します。

入力引数

x — 入力信号

スカラー | 行ベクトルまたは列ベクトル | 行列

入力信号。数値スカラー、数値の行ベクトルまたは列ベクトル、あるいは数値行列として指定します。詳細については、相互に依存するプロパティ入力の次元を参照してください。

データ型: single | double

fOffset — Frequency offset

スカラー | 行ベクトルまたは列ベクトル | 行列

周波数オフセット (Hz 単位)。数値スカラー、数値の行ベクトルまたは列ベクトル、あるいは数値行列として指定します。詳細については、FrequencyOffset プロパティの説明と相互に依存するプロパティ入力の次元を参照してください。

依存関係

この入力を有効にするには、FrequencyOffsetSource プロパティを "Input port" に設定します。

データ型: single | double

出力引数

y — 出力信号

スカラー | 行ベクトルまたは列ベクトル | 行列

出力信号。x と同じ次元およびデータ型で返されます。

データ型: single | double

オブジェクト関数

オブジェクト関数を使用するには、System object を最初の入力引数として指定します。たとえば、obj という名前の System object のシステム リソースを解放するには、次の構文を使用します。

release(obj)

すべての System object に共通

step	System object のアルゴリズムの実行
release	リソースを解放し、System object のプロパティ値と入力特性の変更を可能にします。
reset	System object の内部状態のリセット

例

16-QAM 信号への位相オフセットの導入

16-QAM 信号に位相オフセットを導入し、コンスタレーションへの影響を確認します。

位相周波数オフセット System object™ を作成し、位相オフセットを 30 度に設定します。

pfo = comm.PhaseFrequencyOffset(PhaseOffset=30);

ランダムなシンボルを生成して 16-QAM 変調を適用します。

M = 16;
data = (0:M-1)';
x = qammod(data,M);

16-QAM コンスタレーションをプロットします。

scatterplot(x);
title("Original Constellation")
xlim([-5 5])
ylim([-5 5])

位相オフセットを導入し、オフセットのコンスタレーションをプロットします。

y = pfo(x);
scatterplot(y);
title("Constellation After Phase Offset")
xlim([-5 5])
ylim([-5 5])

詳細

相互に依存するプロパティ入力の次元

次の表はプロパティと入力引数間の次元の相互依存性を示しています。

次元数	データ I/O 次元	フレーム サイズ	チャネル数	周波数/位相オフセット プロパティ次元	周波数オフセット入力引数次元
任意	スカラー	1	1	スカラー	スカラー
2	M 行 1 列	M	1	M 行 1 列 1 行 M 列 1 行 1 列	M M 行 1 列 1 1 行 1 列
2	1 行 N 列	1	N	N 行 1 列 1 行 N 列 1 行 1 列	N 1 行 N 列 1 1 行 1 列
2	M 行 N 列	M	N	M 行 N 列 N 行 1 列 1 行 N 列 M 行 1 列 1 行 M 列 1 行 1 列	M 行 N 列 N 1 行 N 列 1 1 行 1 列 M M 行 1 列

次に例を示します。

• スカラー オフセット プロパティを指定すると、オブジェクトは入力信号のすべての要素に同じオフセットを適用します。

• 2 行 3 列の入力信号に 2 行 1 列のオフセット プロパティを指定すると (サンプルごとに 1 つのオフセット値)、オブジェクトは 3 つのチャネルにわたって同じサンプル オフセットを適用します。

• 2 行 3 列の入力信号に 1 行 3 列のオフセット プロパティを指定すると (チャネルごとに 1 つのオフセット値)、同一のチャネル オフセットが 1 つのチャネルの 2 つのサンプルにわたって適用されます。

• 2 行 3 列の入力信号に 2 行 3 列のオフセット プロパティを指定すると (各チャネルのサンプルごとに 1 つのオフセット値)、オフセットは要素単位で入力信号に適用されます。

アルゴリズム

入力信号が u(t) の場合、出力信号は次のとおりです。

$$y(t)=u(t)\cdot \left(\cos \left(2\pi {\displaystyle {\int }_0^{t}f\left(\tau \right)d\tau +\phi (t)}\right)+j\sin \left(2\pi {\displaystyle {\int }_0^{t}f\left(\tau \right)d\tau +\phi (t)}\right)\right)\text{,}$$

ここで、f(t) は周波数オフセットで、φ(t) は位相オフセットです。

離散時間出力は、次で与えられます。

$$\begin{array}{l}y(0)=u(0)\left(\cos \left(\phi (0)\right)+j\sin \left(\phi (0)\right)\right)\text{ and }\\ y(i)=u(i)\left(\cos \left(2\pi {\displaystyle \sum _{n=0}^{i-1}f\left(n\right)\Delta t}+\phi (i)\right)+j\sin \left(2\pi {\displaystyle \sum _{n=0}^{i-1}f\left(n\right)\Delta t}+\phi (i)\right)\right)\text{,}\end{array}$$

ここでは i > 0 であり、Δt はサンプル時間です。

拡張機能

C/C++ コード生成

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

使用上の注意および制限:

MATLAB コード生成における System object (MATLAB Coder)を参照してください。

バージョン履歴

R2012a で導入

参考

comm.ThermalNoise | comm.PhaseNoise | comm.MemorylessNonlinearity | frequencyOffset