nrOFDMInfo

Get OFDM information

Syntax

info = nrOFDMInfo(carrier)

info = nrOFDMInfo(nrb,scs)

info = nrOFDMInfo(nrb,scs,'cyclicPrefix',cpl)

info = nrOFDMInfo(___,Name,Value)

Description

info = nrOFDMInfo(carrier) provides dimensional information relevant to orthogonal frequency-division multiplexing (OFDM) modulation for the specified carrier configuration parameters.

info = nrOFDMInfo(nrb,scs) provides OFDM information for nrb, the specified number of resource blocks, and subcarrier spacing scs.

info = nrOFDMInfo(nrb,scs,'cyclicPrefix',cpl) specifies cyclic prefix length cpl in addition to the input arguments from the previous syntax.

info = nrOFDMInfo(___,Name,Value) specifies options by using one or more name-value pair arguments in addition to any combination of input arguments from the previous syntaxes.

Examples

Generate OFDM Modulated Waveform

Generate a waveform by performing OFDM modulation of a resource array that contains sounding reference signals (SRSs). The resource array spans an entire frame.

Set carrier configuration parameters, specifying a subcarrier spacing of 30 kHz and 24 resource blocks (RBs) in the carrier resource array.

carrier = nrCarrierConfig('SubcarrierSpacing',30,'NSizeGrid',24);

Configure SRS parameters, setting the slot periodicity to 2 and the offset to zero.

srs = nrSRSConfig('SRSPeriod',[2 0]);

Get OFDM information for the specified carrier configuration.

info = nrOFDMInfo(carrier);

Produce the frame resource array by creating and concatenating individual slot resource arrays.

grid = [];
for nslot = 0:(info.SlotsPerFrame - 1)
    carrier.NSlot = nslot;
    slotGrid = nrResourceGrid(carrier);
    ind = nrSRSIndices(carrier,srs);
    sym = nrSRS(carrier,srs);
    slotGrid(ind) = sym;
    grid = [grid slotGrid];
end

Perform OFDM modulation on the resource array for the specified carrier configuration.

[waveform,info] = nrOFDMModulate(carrier,grid);

Get OFDM Information for Extended Cyclic Prefix

Set carrier configuration parameters, specifying a subcarrier spacing of 60 kHz and extended cyclic prefix.

scs = 60;
cpl = 'Extended';

Set the number of resource blocks to 150.

Generate and display OFDM information.

nrb = 150;
info = nrOFDMInfo(nrb,scs,'CyclicPrefix',cpl)

info = struct with fields:
                   Nfft: 4096
             SampleRate: 245760000
    CyclicPrefixLengths: [1x48 double]
          SymbolLengths: [1x48 double]
              Windowing: 116
           SymbolPhases: [1x48 double]
         SymbolsPerSlot: 12
       SlotsPerSubframe: 4
          SlotsPerFrame: 40

Get OFDM Information for Specified Sample Rate

Set carrier configuration parameters, specifying 106 RBs in the carrier resource array.

carrier = nrCarrierConfig('NSizeGrid',106);

Generate and display OFDM information for the specified sample rate.

sr = 1e8;
info = nrOFDMInfo(carrier,'SampleRate',sr)

info = struct with fields:
                   Nfft: 3200
             SampleRate: 100000000
    CyclicPrefixLengths: [1x14 double]
          SymbolLengths: [1x14 double]
              Windowing: 112
           SymbolPhases: [0 0 0 0 0 0 0 0 0 0 0 0 0 0]
         SymbolsPerSlot: 14
       SlotsPerSubframe: 1
          SlotsPerFrame: 10

Input Arguments

carrier — Carrier configuration parameters

nrCarrierConfig object

Carrier configuration parameters for a specific OFDM numerology, specified as an nrCarrierConfig object. The function uses only these properties of this input.

NSizeGrid — Number of RBs in carrier resource grid

52 (default) | integer from 1 to 275

Number of RBs in the carrier resource grid, specified as an integer from 1 to 275. The default value of 52 corresponds to the maximum number of RBs of a 10 MHz carrier with 15 kHz SCS.

Data Types: double

SubcarrierSpacing — Subcarrier spacing in kHz

15 (default) | 30 | 60 | 120 | 240

Subcarrier spacing in kHz, for all channels and reference signals of the carrier, specified as 15, 30, 60, 120, or 240.

Data Types: double

CyclicPrefix — Cyclic prefix length

'normal' (default) | 'extended'

Cyclic prefix length, specified as one of these options.

• 'normal' — Use this value to specify normal cyclic prefix. This option corresponds to 14 OFDM symbols in a slot.

• 'extended' — Use this value to specify extended cyclic prefix. This option corresponds to 12 OFDM symbols in a slot. For the numerologies specified in TS 38.211 Section 4.2, extended cyclic prefix length applies for only 60 kHz subcarrier spacing.

Data Types: char | string

nrb — Number of resource blocks

integer from 1 to 275

Number of resource blocks, specified as an integer from 1 to 275.

Data Types: double

scs — Subcarrier spacing

15 | 30 | 60 | 120 | 240

Subcarrier spacing, in kHz, specified as 15, 30, 60, 120, or 240.

Data Types: double

cpl — Cyclic prefix length

'normal' (default) | 'extended'

Cyclic prefix length, specified as one of these options:

• 'normal' — Use this value to specify normal cyclic prefix. This option corresponds to 14 OFDM symbols in a slot.

• 'extended' — Use this value to specify extended cyclic prefix. This option corresponds to 12 OFDM symbols in a slot. For the numerologies specified in TS 38.211 Section 4.2, the extended cyclic prefix length only applies to 60 kHz subcarrier spacing.

Data Types: char | string

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'SampleRate','1e9' specifies a sample rate of 1×10⁹ Hz.

'Nfft' — Number of FFT points

integer greater than 127 (default depends on other input values) | []

Number of fast Fourier transform (FFT) points, specified as the comma-separated pair consisting of 'Nfft' and either a nonnegative integer greater than 127, or []. The value you specify must result in integer-valued cyclic prefix lengths and a maximum occupancy, defined as the value of (12 × N_RB)/Nfft, where N_RB is the number of resource blocks, of 100%.

If you do not specify this input, or if you specify 'Nfft',[], the function sets a default value satisfying these conditions.

• The value of this input is an integer power of 2.

• The maximum occupancy is 85%.

• The minimum value of this input is 128.

Data Types: double

'SampleRate' — Waveform sample rate

positive scalar (default depends on other input values) | []

Waveform sample rate, specified as the comma-separated pair consisting of 'SampleRate' and either a positive scalar or [].

If you do not specify this input, or if you specify 'SampleRate',[], then the function sets this input to the value of N_fft × SCS.

• N_fft is the value of the 'Nfft' input.

• SCS is the subcarrier spacing specified in the SubcarrierSpacing property of the config input for the first function syntax, or the scs input for the other syntaxes.

Data Types: double

'Windowing' — Number of time-domain samples for OFDM symbol windowing and overlapping

nonnegative integer (default depends other input values) | []

Number of time-domain samples over which the function applies raised cosine windowing and overlapping of OFDM symbols, specified as the comma-separated pair consisting of 'Windowing' and either a nonnegative integer or [].

If you do not specify this input, or if you specify 'Windowing',[], the function sets this input to the maximum value E that does not impact error vector magnitude (EVM) tests, as specified in Annexes F.5.3 and F.5.4 of TS 38.101-1 [1], Annexes F.5.3 and F.5.4 of TS 38.101-2, [2], and Annexes B.5.2 and C.5.2 of TS 38.104 [3]. E is equal to value of floor((N_CP − W) × info.Nfft ⁄ N_{FFT, nominal}), where N_CP, W, and N_{FFT, nominal} are the values in the table columns labeled "Cyclic prefix length", "EVM window length", and "FFT size", respectively.

Data Types: double

'CarrierFrequency' — Carrier frequency

0 (default) | nonnegative scalar

Carrier frequency, in Hz, specified as the comma-separated pair consisting of 'CarrierFrequency' and a nonnegative scalar. This input corresponds to f₀, defined in Section 5.4 of [4].

Data Types: double

Output Arguments

info — OFDM information

structure

OFDM information, returned as a structure containing these fields.

Fields	Values	Description
Nfft	Positive integer	Number of FFT points
SampleRate	Positive scalar	Waveform sample rate
CyclicPrefixLengths	1-by-N vector of positive integers, where N is the number of OFDM symbols in a subframe.	Cyclic prefix lengths of each OFDM symbol, in samples
SymbolLengths	1-by-N vector of positive integers	OFDM symbol lengths, in samples
Windowing	Positive integer	Number of time-domain samples over which the function applies raised cosine windowing and overlapping of OFDM symbols
SymbolPhases	1-by-N vector of numbers in the interval [-π, π]	Phase compensation of each OFDM symbol, in radians The nrOFDMModulate function applies this compensation during modulation to account for phase terms per OFDM symbol, as specified in Section 5.4 of [4]. The nrOFDMDemodulate function inverts this phase compensation during demodulation.
SymbolsPerSlot	Positive integer	Number of OFDM symbols in a slot
SlotsPerSubframe	Positive integer	Number of slots in a 1 ms subframe
SlotsPerFrame	Positive integer	Number of slots in a 10 ms frame

Data Types: struct

References

[1] 3GPP TS 38.101-1. “NR; User Equipment (UE) radio transmission and reception; Part 1: Range 1 Standalone.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[2] 3GPP TS 38.101-2. “NR; User Equipment (UE) radio transmission and reception; Part 2: Range 2 Standalone.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[3] 3GPP TS 38.104. “NR; Base Station (BS) radio transmission and reception.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

[4] 3GPP TS 38.211. “NR; Physical channels and modulation.” 3rd Generation Partnership Project; Technical Specification Group Radio Access Network.

Extended Capabilities

C/C++ Code Generation

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

The nrb, scs, and cpl inputs must be constants. For example, to specify an extended cyclic prefix, include {coder.Constant('CyclicPrefix'),coder.Constant('extended')} in the -args value of the codegen function. For more information, see the coder.Constant (MATLAB Coder) class.

The 'SampleRate' name-value-pair argument cannot be used with function syntaxes that use the carrier input.