pre6GReferenceSignalConfig
R2026bDescription
Add-On Required: This feature requires the 6G Exploration Library for 5G Toolbox add-on.
The pre6GReferenceSignalConfig object enables you to create reference signal
(RS) configuration parameters for 6G research and prototyping. The object defines
time-frequency locations, code-division multiplexing (CDM) structure, and ports for
resource element (RE) mapping, without 5G-specific restrictions.
Creation
Description
creates an
RS configuration object with default properties.rs = pre6GReferenceSignalConfig
also specifies writable properties using one or more name-value arguments. For
example, rs = pre6GReferenceSignalConfig(PropertyName=Value)FrequencyDomainCDM=8 specifies a frequency-domain
orthogonal cover code (OCC) of length 8. Unspecified properties take their default
values.
Properties
Physical resource block (PRB) allocation of the RSs, specified as a vector of nonnegative integers.
Data Types: double
Scrambling sequence initialization value, specified as [] or
an integer in the range [0, 231 – 1]. When you use the
default value, [], the function uses this value
to initialize the pseudo-random binary sequence (PRBS) generator for scrambling
the codeword bits. If you use the default value, pre6GReferenceSignal[], the
function initializes the PRBS generator using the NCellID property of its carrier
input object instead. How the function uses this value depends on the Modulation property:
"pi/2-BPSK","BPSK", or"QPSK"— The value initializes the pseudo-random binary sequence (PRBS) generator."low-papr-type1"— The value modulo 30 is the sequence group number. The function does not apply group hopping or sequence hopping."low-papr-type2"— The value is the sequence initialization, and the value modulo 30 is the sequence group number.
Since R2026b
RS sequence type, specified as one of these values:
"pi/2-BPSK","BPSK", or"QPSK"— Modulated with the specified modulation scheme."low-papr-type1"— Type 1 low peak-to-average power ratio (low-PAPR) sequence, as defined in TS 38.211 Section 5.2.2 [1]. 5G uses this sequence type for the PUSCH DM-RS with transform precoding and for the SRS."low-papr-type2"— Type 2 low-PAPR sequence, as defined in TS 38.211 Section 5.2.3 [1]. 5G uses this sequence type for the PUSCH DM-RS with Release 16 transform precoding.
When you specify this property as "low-papr-type1", the RS
ports within each frequency-domain CDM (FD-CDM) group use different cyclic shifts
of the same sequence instead of orthogonal cover codes (OCCs). The CyclicShifts property specifies the cyclic shifts. In this case,
the TimeDomainCDM property must be 1.
For low-PAPR sequences, when the number of RS subcarriers in each OFDM symbol
of an FD-CDM group, NSC, is less than 36
and not a multiple of 6, TS 38.211 does not define a sequence. In this case, the
sequence the pre6GReferenceSignal function uses depends on the low-PAPR type:
For type 1, the function uses the first NSC elements of the type 1 low-PAPR sequence of length 6⌈NSC/6⌉.
For type 2, the function uses the discrete Fourier transform (DFT) of a pi/2-BPSK modulated PRBS of length NSC, normalized by √NSC.
Data Types: char | string
Length of frequency-domain OCC, specified as a positive integer. The value must be a power of 2.
Frequency-domain locations of RS REs, specified as a matrix of nonnegative integers. The size of the matrix is N-by-FG, where:
N is an integer multiple of the
FrequencyDomainCDMpropertyFG is the number of frequency-domain CDM groups.
The subcarrier locations span the smallest whole number of resource blocks
(RBs) that contains them, and this pattern repeats across the carrier. If the
PRBSet property includes any RB of a repetition, it must include
all RBs of that repetition.
Since R2026b
Frequency-domain CDM weights, specified as [] or an
F-by-F matrix, where F
is the value of the FrequencyDomainCDM property. Each row of the matrix is the
frequency-domain OCC for one port within an FD-CDM group. The elements can be
complex.
When you use the default value, [], the object uses built-in
OCCs with elements equal to ±1. To view the frequency-domain OCC that each port
uses, see the w_f column of the CDMTable property.
This property does not apply when you set Modulation to "low-papr-type1".
Data Types: double | single
Complex Number Support: Yes
Length of time-domain OCC, specified as a positive integer. The value must be
a power of 2. When the Modulation property is "low-papr-type1", the
value must be 1.
Time-domain locations of RS REs, specified as a matrix of nonnegative integers. The size of the matrix is M-by-TG, where:
M is an integer multiple of the
TimeDomainCDMproperty value.TG is the number of time-domain CDM groups.
Since R2026b
Time-domain CDM weights, specified as [] or a
T-by-T matrix, where T
is the value of the TimeDomainCDM property. Each row of the matrix is the time-domain
OCC for one port within a time-domain CDM (TD-CDM) group. The elements can be
complex.
When you use the default value, [], the object uses built-in
OCCs with elements equal to ±1. To view the time-domain OCC that each port uses,
see the w_t column of the CDMTable property.
This property does not apply when you set Modulation to "low-papr-type1".
Data Types: double | single
Complex Number Support: Yes
Since R2026b
Cyclic shift indices for low-PAPR type 1 sequences, specified as
[] or an F-by-M matrix
of integers in the range [0, F – 1], where:
F is the value of the
FrequencyDomainCDMproperty.M is the number of OFDM symbols in each TD-CDM group, equal to the number of rows of the
SymbolLocationsproperty.
Element (i, j) is the cyclic shift index nCS for the ith port within an FD-CDM group in the jth OFDM symbol of each TD-CDM group. The elements in each column must be unique. The corresponding cyclic shift is α = 2πnCS/F.
When you use the default value, [], the cyclic shift indices
in the first OFDM symbol are 0, 1, …, F – 1. In each subsequent
OFDM symbol, the cyclic shift index of each port decreases by 1, modulo
F. To view the cyclic shift indices that each port uses, see
the CyclicShiftsTable property.
This property applies only when the Modulation property is "low-papr-type1".
Data Types: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64
Set of RS ports to use, specified as a nonnegative integer or a vector of
nonnegative integers. The total number of available ports is
P=FrequencyDomainCDM×TimeDomainCDM×FG×TG, where
FG is the number of frequency-domain CDM groups and
TG is the number of time-domain CDM groups. The elements of
PortSet must be in the range [0,
P–1].
Option to enable frequency-domain spectral shaping (FDSS), specified as one of these values.
0(false) — Thefunction does not apply FDSS to its output symbols.pre6GReferenceSignal1(true) — Thepre6GReferenceSignalfunction applies FDSS using theFDSSCoefficientsproperty.
Data Types: double | logical
FDSS filter coefficients, specified as a row vector of real values. The vector
defines time-domain finite impulse response (FIR) filter taps. During RS symbol
generation, the function converts these
taps to a frequency-domain filter and applies spectral shaping across the
allocated subcarriers.pre6GReferenceSignal
This property applies only when you specify the FDSS
property as 1 (true).
Data Types: double
This property is read-only.
CDM lengths, represented as a row vector of positive integers. The vector has
two elements. The first element represents the frequency domain and is equal to
FrequencyDomainCDM, which you can set with a name-value argument.
The second element represents the time domain and is equal to TimeDomainCDM, which you can also set with a name-value
argument.
Data Types: double
This property is read-only.
Number of CDM groups, represented as a row vector of positive integers. The
vector has two elements. The first element represents the frequency domain and is
equal to FG, the number of columns in the SubcarrierLocations property, which you can set with a name-value
argument. The second element represents the time domain and is equal to
TG, the number of columns in the SymbolLocations property, which you can also set with a name-value
argument.
Data Types: double
This property is read-only.
CDM parameter table, represented as a table. The size of the table is p-by-5, where p is the total number of RS ports. The five columns are:
p— 0-based port indexFD-CDM group— 0-based FD-CDM group indexTD-CDM group— 0-based TD-CDM group indexw_f— Frequency-domain CDM weight vector. The vector length is equal toFrequencyDomainCDM. When theFrequencyWeightsproperty is[], the entries are ±1. Otherwise, the vector is a row ofFrequencyWeightsand the entries can be complex.w_t— Time-domain CDM weight vector. The vector length is equal toTimeDomainCDM. When theTimeWeightsproperty is[], the entries are ±1. Otherwise, the vector is a row ofTimeWeightsand the entries can be complex.
When the Modulation property is "low-papr-type1", the RS
does not use OCCs, so w_f and w_t are
1 in each row. In this case, the ports within an FD-CDM
group use different cyclic shifts instead. For more information, see the CyclicShiftsTable property.
The table is empty if the configuration contains conflicting property
values, such as a FrequencyWeights matrix whose size does not match the FrequencyDomainCDM property.
Data Types: table
Since R2026b
This property is read-only.
Cyclic shift parameter table, represented as a table. The size of the table is p-by-5, where p is the total number of RS ports. The five columns are:
p— 0-based port indexFD-CDM group— 0-based FD-CDM group indexTD-CDM group— 0-based TD-CDM group indexOFDM symbol— 0-based OFDM symbol indices of the TD-CDM group, represented as a vector of length M, where M is the number of rows of theSymbolLocationspropertyCyclic shift— Cyclic shift index for each OFDM symbol in theOFDM symbolcolumn, represented as a vector of length M
The table is empty if the configuration contains conflicting property values,
such as a CyclicShifts matrix whose size does not match the FrequencyDomainCDM and SymbolLocations properties.
This property applies only when the Modulation property is "low-papr-type1".
Data Types: table
Examples
Create a pre-6G carrier configuration object with default parameters.
carrier = pre6GCarrierConfig;
Create a reference signal configuration object. Specify physical resource blocks 10–19.
rs = pre6GReferenceSignalConfig(PRBSet=10:19);
Get 1-based reference signal indices for the reference signal configuration.
rsInd = pre6GReferenceSignalIndices(carrier,rs);
Create a data channel configuration object. Specify the same physical resource blocks as before. Use the reference signal indices as reserved REs in the data channel. You must subtract 1 because the reserved REs are 0-based in accordance with 5G.
ch = pre6GPhysicalChannelConfig(PRBSet=10:19, ...
ReservedRE = rsInd-1);Get 0-based data indices for the physical channel configuration.
dataInd = pre6GPhysicalChannelIndices(carrier,ch);
Verify that there is no overlap between the two sets of indices.
intersect(dataInd(:),rsInd(:))
ans = 0×1 empty uint32 column vector
Low-PAPR Type 1 Sequence with Custom Cyclic Shifts
Create a carrier configuration object and an RS configuration object. Configure the RS to use a type 1 low-PAPR sequence on every second subcarrier in the last four OFDM symbols of the slot. Use a frequency-domain CDM length of 4 so that four ports share the same resource elements (REs).
carrier = pre6GCarrierConfig;
rs = pre6GReferenceSignalConfig;
rs.Modulation = "low-papr-type1";
rs.FrequencyDomainCDM = 4;
rs.SubcarrierLocations = (0:2:10).';
rs.SymbolLocations = (10:13).';
rs.PortSet = 0:3;Specify the cyclic shift index of each port (rows) in each OFDM symbol (columns).
rs.CyclicShifts = [0 2 1 3; 1 3 2 0; 2 0 3 1; 3 1 0 2];
Display the cyclic shift index that each port uses in each OFDM symbol.
rs.CyclicShiftsTable
ans = 4×5 table
p FD-CDM group TD-CDM group OFDM symbol Cyclic shift
_ ____________ ____________ ____________________ ________________
0 0 0 10 11 12 13 0 2 1 3
1 0 0 10 11 12 13 1 3 2 0
2 0 0 10 11 12 13 2 0 3 1
3 0 0 10 11 12 13 3 1 0 2
Get insights using Copilot
Because the ports use cyclic shifts instead of orthogonal cover codes (OCCs), the frequency-domain and time-domain CDM weights are 1 for every port.
rs.CDMTable
ans = 4×5 table
p FD-CDM group TD-CDM group w_f w_t
_ ____________ ____________ ___ ___
0 0 0 1 1
1 0 0 1 1
2 0 0 1 1
3 0 0 1 1
Get insights using Copilot
Generate the RS symbols. The output contains 1248 symbols (312 subcarriers in each of 4 OFDM symbols) for each port.
sym = pre6GReferenceSignal(carrier,rs); disp(size(sym))
1248 4
Confirm that the symbols have constant amplitude.
disp([min(abs(sym(:))) max(abs(sym(:)))])
1.0000 1.0000
Confirm that the ports are mutually orthogonal.
C = abs(sym'*sym)/size(sym,1); disp(round(C,6))
1 0 0 0
0 1 0 0
0 0 1 0
0 0 0 1
Custom Complex Frequency-Domain CDM Weights
Configure an RS with the same port structure as the 5G NR Release 18 enhanced PUSCH DM-RS for configuration type 1 with double-symbol DM-RS. This configuration supports up to 16 ports. Use two FD-CDM groups, each on every second subcarrier, and a pair of adjacent OFDM symbols. Use a frequency-domain CDM length of 4 and a time-domain CDM length of 2.
rs = pre6GReferenceSignalConfig; rs.FrequencyDomainCDM = 4; rs.SubcarrierLocations = [(0:2:10).' (1:2:11).']; rs.TimeDomainCDM = 2; rs.SymbolLocations = [2; 3]; rs.PortSet = 0:15;
By default, the frequency-domain OCCs have elements equal to 1 or -1. Specify the frequency-domain OCCs that the enhanced PUSCH DM-RS uses instead. Each row of the matrix is the frequency-domain OCC for one port within an FD-CDM group. The last two rows are complex.
rs.FrequencyWeights = [1 1 1 1; 1 -1 1 -1; 1 1j -1 -1j; 1 -1j -1 1j];
Display the CDM weights that each port uses. Ports 8 to 15 use the complex frequency-domain OCCs. The time-domain OCCs use the default values.
rs.CDMTable
ans = 16×5 table
p FD-CDM group TD-CDM group w_f w_t
__ ____________ ____________ ___________________________________________ _______
0 0 0 1+0i 1+0i 1+0i 1+0i 1 1
1 0 0 1+0i -1+0i 1+0i -1+0i 1 1
2 1 0 1+0i 1+0i 1+0i 1+0i 1 1
3 1 0 1+0i -1+0i 1+0i -1+0i 1 1
4 0 0 1+0i 1+0i 1+0i 1+0i 1 -1
5 0 0 1+0i -1+0i 1+0i -1+0i 1 -1
6 1 0 1+0i 1+0i 1+0i 1+0i 1 -1
7 1 0 1+0i -1+0i 1+0i -1+0i 1 -1
8 0 0 1+0i 0+1i -1+0i 0-1i 1 1
9 0 0 1+0i 0-1i -1+0i 0+1i 1 1
10 1 0 1+0i 0+1i -1+0i 0-1i 1 1
11 1 0 1+0i 0-1i -1+0i 0+1i 1 1
12 0 0 1+0i 0+1i -1+0i 0-1i 1 -1
13 0 0 1+0i 0-1i -1+0i 0+1i 1 -1
14 1 0 1+0i 0+1i -1+0i 0-1i 1 -1
15 1 0 1+0i 0-1i -1+0i 0+1i 1 -1
Get insights using Copilot
Generate the RS symbols and indices, and map them to a resource grid. Confirm that the ports are mutually orthogonal.
sym = pre6GReferenceSignal(carrier,rs); ind = pre6GReferenceSignalIndices(carrier,rs); grid = pre6GResourceGrid(carrier,numel(rs.PortSet)); grid(ind) = sym; grid = reshape(grid,[],numel(rs.PortSet)); C = abs(grid'*grid)/size(sym,1); disp(round(C,6))
1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0
0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1
References
[1] 3GPP TS 38.211. “NR; Physical channels and modulation.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.
Extended Capabilities
The
pre6GReferenceSignalConfig function fully supports GPU arrays.
To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more
information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).
Version History
Introduced in R2026aYou can now specify the RS sequence type, including low-PAPR sequences, by using the
Modulation property. You can specify custom frequency-domain and
time-domain CDM weights by using the FrequencyWeights and TimeWeights properties. For low-PAPR type 1 sequences, you can specify
the cyclic shifts of the RS ports by using the CyclicShifts property.
To apply frequency-domain spectral shaping (FDSS), specify the FDSS property
as 1 (true). To set your own filter coefficients
for FDSS, specify the FDSSCoefficients
property.
See Also
Functions
Objects
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)