Engee documentation

PUSCH PT-RS

PUSCH phase tracking reference signals (PT-RS).

pusch pt rs

Description

The block PUSCH PT-RS generates Phase-tracking reference signals (PT-RS) symbols for the physical uplink common channel (PUSCH), in accordance with section 6.4.1.2.1 of the standard [1].

Ports

Output

# OUT_1 — output matrix of PT-RS symbols
matrix

Details

A matrix of PT-RS symbols whose size depends on the transmission and precoding scheme.

Data types

ComplexF64.

Complex numbers support

No

Parameters

Carrier

# Physical layer cell identity — cell identifier
Real number

Details

The identification number of a physical layer cell, specified as an integer from 0 to 1007.

Default value

1

Program usage name

NCellID

Tunable

No

Evaluatable

Yes

# Number of RBs in carrier resource grid — number of resource blocks
Real number

Details

The number of resource blocks (RB - Resource Blocks) in the carrier resource grid.

Default value

52

Program usage name

NSizeGrid

Tunable

No

Evaluatable

Yes

# Start of carrier resource grid relative to CRB 0 — start of the carrier resource grid relative to CRB 0
Real number

Details

Parameters that indicates from which Resource Block (RB) the carrier resource grid starts if CRB 0 is taken as the start (zero point).

CRB 0 (Carrier Resource Block 0) is the base, counted as the first resource block, against which all addressing of the grid takes place.

Default value

0

Program usage name

NStartGrid

Tunable

No

Evaluatable

Yes

# Subcarrier spacing (kHz) — subcarrier spacing in kHz
15 | 30 | 60 | 120

Details

Subcarrier spacing in kHz for all channels and carrier reference signals.

Selectable values: 15 or 30 for FR1, 60 or 120 for FR2.

Values

15 | 30 | 60 | 120

Default value

15

Program usage name

SubcarrierSpacing

Tunable

No

Evaluatable

No

PUSCH

# Transform precoding — inclusion of pre-coding with conversion
Logical

Details

If this checkbox is selected, a data processing method is applied that is used to improve the spatial and frequency redundancy of the channel. This method uses pre-processing that transforms the data before it is modulated and transmitted through the antennas. It includes steps such as spectral and spatial transform to reduce interference and improve channel performance.

If this box is unchecked, standard data coding and modulation is used without applying complex transformations.

Default value

false (switched off)

Program usage name

TransformPrecoding

Tunable

No

Evaluatable

No

# PUSCH transmission scheme — PUSCH transfer scheme
nonCodebook | codebook

Details

PUSCH transmission diagram.

Values

nonCodebook | codebook

Default value

nonCodebook

Program usage name

TransmissionScheme

Tunable

No

Evaluatable

No

# Number of transmission layers — number of transmission layers
1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

Details

A parameter in a communication system that indicates the number of independent data streams (or "transmission layers") that can be transmitted simultaneously over a physical channel, such as a PUSCH (Physical Uplink Shared Channel) or PDSCH (Physical Downlink Shared Channel) in LTE or 5G networks.

Values

1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

Default value

1

Program usage name

NumLayers

Tunable

No

Evaluatable

No

# Mapping type — PUSCH display type
A | B

Details

A parameter in modern communication systems such as LTE and 5G that determines how logical or physical resources are assigned (or mapped) to data on a channel. Options to select:

  • A is the standard mapping type in which each logical resource (e.g., a symbol in the time or frequency domain) is mapped to specific physical resources. Type A is used for conventional mapping schemes where each logical channel group is mapped to fixed resources.

  • B is a more flexible scheme where resources can be reallocated dynamically depending on the channel state and system requirements. It allows the system to adapt to changes in link conditions.

Values

A | B

Default value

A

Program usage name

MappingType

Tunable

No

Evaluatable

No

# OFDM symbol allocation — distribution of OFDM symbols for PUSCH within a slot

Details

OFDM symbol allocation refers to the process of assigning time and frequency resources in a system using the multi-channel transmission method commonly used in LTE and 5G.

Default value

[0 14]

Program usage name

SymbolAllocation

Tunable

No

Evaluatable

Yes

# PRB allocation — physical resource block allocation

Details

Physical resource blocks (PRB) allocated to the PUSCH in the Bandwidth part (BWP).

Default value

0:51

Program usage name

PRBSet

Tunable

No

Evaluatable

Yes

# Radio network temporary identifier — temporary network identifier
Real number

Details

A temporary radio network identifier specified as an integer from 0 to 65535.

Default value

1

Program usage name

RNTI

Tunable

No

Evaluatable

Yes

# Enable or disable PT-RS — usage of phase change tracking signals
Logical

Details

Enable or disable usage of PT-RS (Phase Tracking Reference Signal) on the Physical Uplink Shared Channel (PUSCH) in 5G NR. If this checkbox is selected, PT-RS is used to improve signal quality. If unchecked, PT-RS is not used, which can reduce reliability in high phase noise environments.

Default value

true (switched on)

Program usage name

EnablePTRS

Tunable

No

Evaluatable

No

# Frequency hopping — frequency switching
neither | intraSlot | interSlot

Details

Options for selection:

  • neither - data transmission is performed in the same frequency range.

  • intraSlot - frequency changes within one slot. Useful at high speeds of User equipment (UE) as it reduces the effect of Doppler shift.

  • interSlot - the frequency varies between slots. This helps to reduce interference and make the transmission more immune to interference.

Values

neither | intraSlot | interSlot

Default value

neither

Program usage name

FrequencyHopping

Tunable

No

Evaluatable

No

PUSCHDMRS

# DM-RS configuration type — DM-RS configuration type
1 | 2

Details

DM-RS Configuration Type. If the checkbox is selected Transform precoding*then the value *DM-RS configuration type must be set to 1.

Values

1 | 2

Default value

1

Program usage name

DMRSConfigurationType

Tunable

No

Evaluatable

No

# DM-RS scrambling identity for DFT-s-OFDM — DM-RS encryption identifier

Details

DM-RS encryption identifier.

Default value

[]

Program usage name

NRSID

Tunable

No

Evaluatable

Yes

# Position of first DM-RS OFDM symbol for mapping type A — position of the first DM-RS OFDM symbol in the slot
2 | 3

Details

The position of the first DM-RS OFDM symbol in the slot.

Values

2 | 3

Default value

2

Program usage name

DMRSTypeAPosition

Tunable

No

Evaluatable

No

# Number of consecutive front-loaded DM-RS OFDM symbols — DM-RS length
1 | 2

Details

DM-RS Length. If the parameters Frequency hopping is set to intraSlot, then the value of Number of consecutive front-loaded DM-RS OFDM symbols must be equal to 1.

Values

1 | 2

Default value

1

Program usage name

DMRSLength

Tunable

No

Evaluatable

No

# DM-RS OFDM symbol locations — DM-RS symbol arrangement
[] | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13

Details

DM-RS symbol arrangement.

Values

[] | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13

Default value

[]

Program usage name

CustomSymbolSet

Tunable

No

Evaluatable

No

# DM-RS scrambling initialization for CP-OFDM — Initialisation of DM-RS scrambling
0 | 1

Details

Initialising DM-RS scrambling.

Dependencies

To use this parameters, clear the checkbox Transform precoding.

Values

0 | 1

Default value

0

Program usage name

NSCID

Tunable

No

Evaluatable

No

PUSCHPTRS

# Number of PT-RS samples — number of PT-RS samples
2 | 4

Details

Number of PT-RS samples.

Dependencies

To use this parameters, select the checkbox Transform precoding.

Values

2 | 4

Default value

2

Program usage name

NumPTRSSamples

Tunable

No

Evaluatable

No

# Number of PT-RS groups — number of PT-RS groups
2 | 4 | 8

Details

Number of PT-RS groups.

Dependencies

To use this parameter, select the checkbox Transform precoding.

Values

2 | 4 | 8

Default value

2

Program usage name

NumPTRSGroups

Tunable

No

Evaluatable

No

# PT-RS antenna port set — install the PT-RS antenna port

Details

Install the PT-RS antenna port.

Dependencies

To use this parameters, uncheck the check box Transform precoding.

Default value

[]

Program usage name

PTRSPortSet

Tunable

No

Evaluatable

Yes

# PT-RS scrambling identity — PT-RS scrambling identifier

Details

PT-RS scrambling identifier.

Dependencies

To use this parameter, select the checkbox Transform precoding.

Default value

[]

Program usage name

NID

Tunable

No

Evaluatable

Yes

# PT-RS time density — PT-RS time density
1 | 2 | 4

Details

PT-RS temporal density.

Values

1 | 2 | 4

Default value

1

Program usage name

TimeDensity

Tunable

No

Evaluatable

No

# PT-RS frequency density — PT-RS frequency density
2 | 4

Details

PT-RS frequency density.

Dependencies

To use this parameter, clear the check box Transform precoding.

Values

2 | 4

Default value

2

Program usage name

FrequencyDensity

Tunable

No

Evaluatable

No

# Resource element offset — subcarrier offset
00 | 01 | 10 | 11

Details

Subcarrier offset.

Dependencies

To use this parameter, uncheck the box. Transform precoding.

Values

00 | 01 | 10 | 11

Default value

00

Program usage name

REOffset

Tunable

No

Evaluatable

No

References

  1. 3GPP TS 38.211. "NR; Physical channels and modulation." 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

  2. Glossary: Standard 5G