Engee documentation

Phase-Coded Waveform

Phase-code manipulated signal generator.

phase coded waveform

Description

The Phase-Coded Waveform unit generates a phase-coded manipulated pulse signal with a specified code interval (chip) duration, pulse repetition frequency (PRF) and phase code type. The signal at the block output is an integer number of pulses or a sequence of samples.

Ports

Input

FreqOffset - frequency offset
scalar

Frequency offset specified as a scalar value.

*Example: 2e3

Dependencies

To use this port, set the Source of Frequency Offset parameters to Input port.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Output

Y - pulse signal
`complex vector

A signal at the block output specified as a complex vector.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

PRF - pulse repetition frequency
positive scalar

Pulse repetition rate specified as a positive scalar value.

Dependencies

To use this port, set the Output signal format parameter to `Pulses' and then select the checkbox for the Enable PRF output parameter.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Coeff - coefficients of the matched filter
vector | matrix

Coefficients of the matched filter given as a vector or matrix.

Dependencies

To use this port, select the Enable Matched Filter Coefficients Output checkbox.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64, Bool.

Parameters

Sample rate (Hz) - sampling rate
1e6 (by default) | positive scalar

The sampling frequency of the signal as a positive scalar. The unit of measurement is Hz.

The ratio of Sample rate (Hz) to the Pulse repetition frequency must be an integer.

This restriction is equivalent to requiring that the pulse repetition interval (PRI) be an integer multiple of the sampling step :

Usage in program code

Block parameters

SampleRate

Values

positive scalar

By default

1e6

Phase code - type of phase code
Frank (By default)

The type of code used for phase modulation, specified as one of the following types:

  • Barker.

  • `Frank

  • P1

  • P2

  • P3

  • P4

  • `Px

  • `Zadoff-Chu

*For example: P2

Chip width (s) - chip code interval length
1e-5 s (by default) | positive scalar

The duration of each chip code interval in the phase-encoded form of the signal, specified as a positive scalar. This constraint ensures that the pulse duration is shorter than the pulse period:

  • The product of Chip width (s), Number of chips, and Pulse repetition frequency (Hz) must be less than or equal to one. This restriction is equivalent to requiring the pulse length to be less than the pulse repetition interval.

  • The product of Sample rate (Hz) and Chip width (s) must be an integer. This constraint ensures that the chip width is an integer multiple of the sampling step :

Number of chips - number of code intervals or number of chips
4 (by default) | positive scalar

Number of code intervals in phase-encoded form of the signal, specified as a positive integer. The product of the parameters Chip width (s), Number of chips and Pulse repetition frequency (Hz) must be less than or equal to one. This constraint ensures that the chip duration was an integer multiple of the sampling step :

The table shows additional limits on the number of code intervals (number of chips) for different types of codes:

If the Phase code parameters are…​ Then the Number of chips parameters must be…​

Frank, P1, or Px

Full Square

P2

An even number that is a complete square

Barker

2, 3, 4, 5, 7, 11, or 13

Zadoff-Chu sequence index - sequence index for the Zadoff-Chu code type
1 (by default) | positive integer

The sequence index for the Zadoff-Chu code type, specified as a positive integer. The values of the parameters Zadoff-Chu sequence index and Number of chips should be relatively simple.

Dependencies

To use this parameter, set Phase Code to Zadoff-Chu.

Pulse repetition frequency (Hz) - pulse repetition frequency
1e4 Hz (By default) | positive scalar

Pulse repetition frequency (PRF) specified as a scalar or string vector. The pulse repetition interval (PRI) is the inverse of the pulse repetition frequency (PRF).

The Pulse repetition frequency (Hz) must meet the following constraints:

  • The product of Pulse width (s) and Pulse repetition frequency (Hz) must be less than or equal to one:

This constraint ensures that the pulse width is less than the pulse repetition period. For a phase encoded signal, the pulse width is equal to the product of the duration of one chip by the number of chips.

The ratio of Sample rate (Hz) to Pulse repetition frequency (Hz) should be

to *Pulse repetition frequency (Hz)* must be an integer:

This constraint is equivalent to requiring that the number of samples in the pulse period be an integer.

Usage in program code

Block parameters

PRF

Values

positive scalar

By default

1e4

Source of Frequency Offset - frequency offset setting
Property (By default) | Input port

Frequency offset set as Property or Input port:

  • If Property is set, the offset is determined by the value of the Frequency Offset parameters.

  • If Input port is set, the offset is determined by the port value FreqOffset.

Usage in program code

Block parameters

FrequencyOffsetSource

Values

Property | Input port

By default

Property

*Frequency Offset (Hz) - frequency offset
0 (By default) | scalar

Frequency offset set as a scalar.

*Example: 2e3

Dependencies

To use this parameter, set the Source of Frequency Offset parameter to Property.

Usage in program code

Block parameters

FrequencyOffset

Values

scalar

By default

0

Output signal format - output signal format
Pulses (by default) | Samples

Output signal format as Pulses or Samples:

  • If you set this parameter to Pulses, the block output consists of a number of pulses. The number of pulses is the value of the Number of pulses in output parameter.

  • If you set this parameter to Samples, the block output consists of multiple samples. The number of samples is the value of the Number of samples in output parameter.

Usage in program code

Block parameters

OutputSignalFormat Pulses Samples

Values

Pulses | Samples

By default

Pulses

Number of samples in output - number of samples of the output signal
100 (By default) | positive number

The number of samples of the output signal specified as a positive integer.

*Example: 1000

Dependencies

To use this parameter, set the Output signal format parameters to Samples.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Usage in program code

Block parameters

NumberOfSamplesInOutport

Values

positive number

By default

100

Number of pulses in output - number of pulses of the output signal
1 (By default) | positive number

The number of pulses of the output signal set as a positive integer.

Dependencies

To use this parameter, set the Output signal format parameters to Pulses.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Usage in program code

Block parameters

NumberOfPulsesInOutport

Values

positive number

By default

1

Enable PRF Output - enable PRF output
off (by default) | on

Select the checkbox to enable the PRF output port.

Dependencies

To use this parameter, set the Output signal format parameters to Pulses.

Usage in program code

Block parameters

EnablePRFOutport

Values

disabled | enabled

By default

off

Enable Matched Filter Coefficients Output - enable output of matched filter coefficients
disabled (by default) | enabled

Tick the checkbox to enable the Coeff output port.

Usage in program code

Block parameter

EnableMatchedFilterCoefficientsOutport

Values

disabled | enabled

By default

off