Engee documentation

Phase/ Frequency Offset

Applies phase and frequency offsets to a complex base signal.

blockType: PhaseFrequencyOffset

Path in the library:

/Communication Systems/RF Impairments and Components/Phase/ Frequency Offset

Description

Block Phase/ Frequency Offset applies phase and frequency offsets to a complex base signal.

Ports

Output

# Out — The output signal
scalar | vector | the matrix

Details

The output signal returned as a scalar, vector, or matrix. The output signal has the same dimension and the same data type as the input signal.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Complex numbers support

Yes

Input

# In — The input signal
scalar | vector | the matrix

Details

A complex input signal specified as a scalar, vector, or matrix. The port is unnamed until the parameter is enabled. Frequency offset from port.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Complex numbers support

Yes

# Frq — frequency offset
scalar

Details

The frequency offset is defined as a scalar, a vector with the same number of rows or columns as the input signal, or a matrix with the same dimensions as the input signal.

Dependencies

To use this port, check the box Frequency offset from port.

Data types

Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool

Complex numbers support

No

Parameters

Main

# Phase offset (deg) — phase shift
Scalar / array of real numbers

Details

The phase offset in degrees, specified as a scalar, vector, or matrix.

If Phase offset (deg) and Frequency offset (Hz) if they are not scalar, then they must have the same size.

Default value

0

Program usage name

PhaseOff

Tunable

No

Evaluatable

Yes

# Frequency offset from port — adding a port for setting the frequency offset
Logical

Details

Select the checkbox to display the Frq port.

  • The flag is checked — the Frq port is displayed on the block icon. The frequency offset is set by the signal on this port.

  • The checkbox is not checked — the Frq port is hidden. The frequency offset is set by the parameter Frequency offset (Hz).

Default value

false (switched off)

Program usage name

FreqOffFromPort

Tunable

No

Evaluatable

No

# Frequency offset (Hz) — frequency offset
Scalar / array of real numbers

Details

The frequency offset in Hz, defined as a scalar, a vector with the same number of rows or columns as the input signal, or a matrix with the same dimensions as the input signal.

If Phase offset (deg) and Frequency offset (Hz) if they are not scalar, then they must have the same size.

Dependencies

To use this option, uncheck the box. Frequency offset from port.

Default value

0

Program usage name

FreqOff

Tunable

No

Evaluatable

Yes

Algorithms

If the input signal is , then the output signal has the form

,

where

  • — frequency offset;

  • — phase shift.

The output signal in discrete time has the form:

and

,

where , and — the interval between the calculation steps.