System-Level Scenarios#

The scenario classes hold the versioned TR 38.901 parameter tables and the topology-dependent state used by the system-level channel generators. They do not generate channel impulse responses themselves. The complete UMi, UMa, RMa, InH, and InF channel models construct the corresponding scenario object internally, so most users should instantiate those channel classes instead.

The lower-level scenario API is useful when working directly with components such as LSPGenerator or RaysGenerator. In particular, InFScenario stores the selected factory sub-scenario, hall and clutter geometry, versioned LoS/NLoS parameters, and the topology state used internally by InF.

RMaScenario additionally owns the mutually exclusive indoor and in-car UT states required by Table 7.2-3. If in_car is omitted on its first topology call, non-indoor UTs are interpreted as in-car. The ordinary-window car penetration model is the default; the optional metallized-window mean from Section 7.4.3.2 can be selected when constructing RMa or RMaScenario.

For InF-SL, InF-DL, InF-SH, and InF-DH, omitted hall and clutter parameters use the calibration assumptions in Table 7.8-7 of [TR38901V1920]. Table 7.8-7 does not define an InF-HH calibration layout. The InF-HH defaults exposed by InF and InFScenario are therefore implementation assumptions; pass explicit hall and clutter values when modelling a specific InF-HH deployment.

SystemLevelScenario(carrier_frequency, ...)

Base class for setting up the scenario for system level 3GPP channel simulation.

UMiScenario(carrier_frequency, o2i_model, ...)

3GPP TR 38.901 urban microcell (UMi) channel model scenario.

UMaScenario(carrier_frequency, o2i_model, ...)

3GPP TR 38.901 urban macrocell (UMa) channel model scenario.

RMaScenario(carrier_frequency, ut_array, ...)

3GPP TR 38.901 rural macrocell (RMa) channel model scenario.

InHScenario(carrier_frequency, ...[, ...])

3GPP TR 38.901 indoor hotspot (InH) channel model scenario.

InFScenario(carrier_frequency, ...[, ...])

3GPP TR 38.901 indoor factory (InF) channel model scenario.

Lower-Level Generators#

The following public components support custom assembly of the TR 38.901 generation steps. The high-level channel classes configure and call them automatically.

LSPGenerator(scenario)

Sample large scale parameters (LSP) and pathloss given a channel scenario, e.g., UMa, UMi, RMa, InH, or InF

RaysGenerator(scenario[, ...])

Sample rays according to a given channel scenario and large scale parameters (LSP).

Topology(velocities, moving_end, los_aoa, ...)

Class for conveniently storing the network topology information required for sampling channel impulse responses

ChannelCoefficientsGenerator(...[, ...])

Sample channel impulse responses according to LSPs rays