comm.PhaseFrequencyOffset

Apply phase and frequency offsets to input signal

Description

The PhaseFrequencyOffset object applies phase and frequency offsets to an incoming signal.

To apply phase and frequency offsets to the input signal:

1. Create the comm.PhaseFrequencyOffset object and set its properties.

2. Call the object with arguments, as if it were a function.

To learn more about how System objects work, see What Are System Objects?

Creation

Syntax

pfo = comm.PhaseFrequencyOffset

pfo = comm.PhaseFrequencyOffset(Name=Value)

Description

pfo = comm.PhaseFrequencyOffset creates a phase and frequency offset System object™. This object applies phase and frequency offsets to an input signal.

pfo = comm.PhaseFrequencyOffset(Name=Value) creates a phase and frequency offset object with each specified property set to the specified value. For example, SampleRate=20 sets a sample rate of 20 Hz. You can specify additional name-value pair arguments in any order as (Name1=Value1,...,NameN=ValueN).

Properties

Unless otherwise indicated, properties are nontunable, which means you cannot change their values after calling the object. Objects lock when you call them, and the release function unlocks them.

If a property is tunable, you can change its value at any time.

For more information on changing property values, see System Design in MATLAB Using System Objects.

PhaseOffset — Phase offset

0 (default) | scalar | row or column vector | matrix

Phase offset in degrees, specified as numeric scalar, an M-by-1 or 1-by-N numeric vector, or an M-by-N numeric matrix. For more information, see Interdependent Property-Input Dimensions.

Tunable: Yes

Data Types: double

FrequencyOffsetSource — Frequency offset source

"Property" (default) | "Input port"

Frequency offset source, specified as one of these values

• "Property" — Specify the frequency offset using the FrequencyOffset property.

• "Input port" — Specify the frequency offset in the fOffset input argument.

FrequencyOffset — Frequency offset

0 (default) | scalar | row or column vector | matrix

Frequency offset in Hz, specified as a numeric scalar, a numeric row or column vector, or a numeric matrix.

For more information, see Interdependent Property-Input Dimensions.

Tunable: Yes

Dependency

To enable this property, set the FrequencyOffsetSource property to "Property".

Data Types: double

SampleRate — Sample rate

1 (default) | positive scalar

Sample rate of the input signal in Hz, specified as a positive scalar.

Data Types: double

Usage

Syntax

y = pfo(x)

y = pfo(x,fOffset)

Description

y = pfo(x) applies phase and frequency offsets to input signal x. To use this syntax, set the FrequencyOffsetSource to "Property".

y = pfo(x,fOffset) specifies the frequency offset to apply to x. To use this syntax, set the FrequencyOffsetSource to "Input port".

Input Arguments

x — Input signal

scalar | row or column vector | matrix

Input signal, specified as a numeric scalar, a numeric row or column vector, or a numeric matrix. For more information, see Interdependent Property-Input Dimensions.

Data Types: single | double

fOffset — Frequency offset

scalar | row or column vector | matrix

Frequency offset in Hz, specified as a numeric scalar, a numeric row or column vector, or a numeric matrix. For more information, see the description of the FrequencyOffset property and Interdependent Property-Input Dimensions.

Dependency

To enable this input, set the FrequencyOffsetSource property to "Input port".

Data Types: single | double

Output Arguments

y — Output signal

scalar | row or column vector | matrix

Output signal, returned with the same dimensions and data type as x.

Data Types: single | double

Object Functions

To use an object function, specify the System object as the first input argument. For example, to release system resources of a System object named obj, use this syntax:

release(obj)

Common to All System Objects

step	Run System object algorithm
release	Release resources and allow changes to System object property values and input characteristics
reset	Reset internal states of System object

Examples

Introduce Phase Offset to 16-QAM Signal

Introduce a phase offset to a 16-QAM signal and view its effect on the constellation.

Create a phase frequency offset System object™, setting the phase offset to 30 degrees.

pfo = comm.PhaseFrequencyOffset(PhaseOffset=30);

Generate random symbols and apply 16-QAM modulation.

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

Plot the 16-QAM constellation.

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

Introduce a phase offset and plot the offset constellation.

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

More About

Interdependent Property-Input Dimensions

This table outlines the interdependency of property-to-input argument dimensions.

Number of Dimensions	Data I/O Dimension	Frame Size	Number of Channels	Frequency/Phase Offset Property Dimension	Frequency Offset Input Argument Dimension
Any	Scalar	1	1	Scalar	Scalar
2	M-by-1	M	1	M-by-1 1-by-M 1-by-1	M M-by-1 1 1-by-1
2	1-by-N	1	N	N-by-1 1-by-N 1-by-1	N 1-by-N 1 1-by-1
2	M-by-N	M	N	M-by-N N-by-1 1-by-N M-by-1 1-by-M 1-by-1	M-by-N N 1-by-N 1 1-by-1 M M-by-1

For example:

• When you specify a scalar offset property, the object applies the same offset to all elements of the input signal

• When you specify a 2-by-1 offset property for a 2-by-3 input signal (one offset value per sample), the object applies the same sample offset across the three channels.

• When you specify a 1-by-3 offset property for a 2-by-3 input signal (one offset value per channel), the same channel offset is applied across the two samples of a channel.

• When you specify a 2-by-3 offset property for a 2-by-3 input signal (one offset value per sample for each channel), the offsets are applied element-wise to the input signal.

Algorithms

If the input signal is u(t), then the output signal is

$$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{,}$$

where f(t) is the frequency offset, and φ(t) is the phase offset.

The discrete-time output is given by

$$\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}$$

where i > 0, and Δt is the sample time.

Extended Capabilities

C/C++ Code Generation

Generate C and C++ code using MATLAB® Coder™.

Usage notes and limitations:

See System Objects in MATLAB Code Generation (MATLAB Coder).

Version History

Introduced in R2012a