CarrierConfig#

class sionna.phy.nr.CarrierConfig(**kwargs)[source]#

Bases: sionna.phy.nr.config.Config

Sets parameters for a specific OFDM numerology, as described in Section 4 [3GPPTS38211].

All configurable properties can be provided as keyword arguments during initialization or changed later.

Examples

>>> from sionna.phy.nr import CarrierConfig
>>> carrier_config = CarrierConfig(n_cell_id=41)
>>> carrier_config.subcarrier_spacing = 30

Methods

check_config() → None[source]#: Test if the configuration is valid.

Attributes

property cyclic_prefix: str#

‘normal’ (default) | ‘extended’ : Cyclic prefix length.

The option ‘normal’ corresponds to 14 OFDM symbols per slot, while ‘extended’ corresponds to 12 OFDM symbols. The latter option is only possible with a subcarrier_spacing of 60 kHz.

property cyclic_prefix_length: float#: float : Cyclic prefix length \(N_{\text{CP},l}^{\mu} \cdot T_{\text{c}}\) [s].

Note

In NR, the longer normal cyclic prefix applies only to specific OFDM symbols within a slot (see TS 38.211). Sionna exposes a single scalar duration for the whole slot: for normal CP, the extra \(16\kappa\) samples are included when slot_number is in \(\{0, 7\cdot 2^{\mu}\}\), and that one value is then used for every symbol. This is a deliberate waveform simplification, not a per-symbol CP model.

property frame_duration: float#: float, (default 10e-3) : Duration of a frame \(T_\text{f}\) [s].

property frame_number: int#: int, (default 0), [0,…,1023] : System frame number \(n_\text{f}\).

property kappa: float#: float, (default 64) : The constant \(\kappa = T_\text{s}/T_\text{c}\).

property mu: int#: int, (default 0) | 1 | 2 | 3 | 4 | 5 | 6 : Subcarrier spacing configuration, \(\Delta f = 2^\mu 15\) kHz.

property n_cell_id: int#: int, (default 1) | [0,…,1007] : Physical layer cell identity \(N_\text{ID}^\text{cell}\).

property n_size_grid: int#: int, (default 4) | [1,…,275] : Number of resource blocks in the carrier resource grid \(N^{\text{size},\mu}_{\text{grid},x}\).

property n_start_grid: int#: int, (default 0) | [0,…,2199] : Start of resource grid relative to common resource block (CRB) 0 \(N^{\text{start},\mu}_{\text{grid},x}\).

property num_slots_per_frame: int#

int, (default 10) | 20 | 40 | 80 | 160 | 320 | 640 : Number of slots per frame \(N_\text{slot}^{\text{frame},\mu}\).

Depends on the subcarrier_spacing.

property num_slots_per_subframe: int#

int, (default 1) | 2 | 4 | 8 | 16 | 32 | 64 : Number of slots per subframe \(N_\text{slot}^{\text{subframe},\mu}\).

Depends on the subcarrier_spacing.

property num_symbols_per_slot: int#

int, (default 14) | 12 : Number of OFDM symbols per slot \(N_\text{symb}^\text{slot}\).

Configured through the cyclic_prefix.

property slot_number: int#: int, (default 0), [0,…,num_slots_per_frame] : Slot number within a frame \(n^\mu_{s,f}\).

property sub_frame_duration: float#: float, (default 1e-3), read-only : Duration of a subframe \(T_\text{sf}\) [s].

property subcarrier_spacing: float#: float, (default 15) | 30 | 60 | 120 | 240 | 480 | 960 : Subcarrier spacing \(\Delta f\) [kHz].

property t_c: float#: float, (default 0.509e-9) : Sampling time \(T_\text{c}\) [s] for subcarrier spacing 480kHz.

property t_s: float#: float, (default 32.552e-9) : Sampling time \(T_\text{s}\) [s] for subcarrier spacing 15kHz.