InHScenario#

class sionna.phy.channel.tr38901.InHScenario(carrier_frequency: float, indoor_scenario: str, ut_array: sionna.phy.channel.tr38901.antenna.PanelArray | sionna.phy.channel.tr38901.antenna.HandheldUTArray, bs_array: sionna.phy.channel.tr38901.antenna.PanelArray | sionna.phy.channel.tr38901.antenna.HandheldUTArray, direction: str, enable_pathloss: bool = True, enable_shadow_fading: bool = True, precision: str | None = None, device: str | None = None, spec_version: str = '19.2')[source]#

Bases: sionna.phy.channel.tr38901.system_level_scenario.SystemLevelScenario

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

This scenario implements the indoor-office model from Section 7 of [TR38901V1920]. The indoor_scenario parameter selects the open-office or mixed-office line-of-sight probability from Table 7.4.2-1. All other pathloss and fast-fading parameters are identical for the two variants.

Parameters:

carrier_frequency (float) – Carrier frequency [Hz]
indoor_scenario (str) – Indoor-office line-of-sight probability model. Must be "open" or "mixed".
ut_array (sionna.phy.channel.tr38901.antenna.PanelArray | sionna.phy.channel.tr38901.antenna.HandheldUTArray) – Antenna array used by UTs. This can be a PanelArray or HandheldUTArray.
bs_array (sionna.phy.channel.tr38901.antenna.PanelArray | sionna.phy.channel.tr38901.antenna.HandheldUTArray) – Antenna array used by base stations. This can be a PanelArray or HandheldUTArray.
direction (str) – Link direction. Must be "uplink" or "downlink".
enable_pathloss (bool) – If True, apply pathloss. Otherwise doesn’t. Defaults to True.
enable_shadow_fading (bool) – If True, apply shadow fading. Otherwise doesn’t. Defaults to True.
precision (str | None) – Precision used for internal calculations and outputs. If set to None, precision is used.
device (str | None) – Device for computation (e.g., "cpu", "cuda:0"). If None, device is used.
spec_version (str) – Version of the TR 38.901 parameter tables to use. Supported values are "16.1" and "19.2". Defaults to "19.2".

Methods

clip_carrier_frequency_lsp(fc: torch.Tensor) → torch.Tensor[source]#

Clip the carrier frequency fc in GHz for LSP calculation.

For InH, Table 7.5-6 of [TR38901V1920] specifies that frequencies below 6 GHz use 6 GHz for frequency-dependent LSP values.

Parameters:: fc (torch.Tensor) – Carrier frequency [GHz]
Outputs:: fc_clipped – Clipped carrier frequency used for LSP computation

Attributes

property indoor_links_can_be_los: bool#: Allow indoor-office links to be LoS or NLoS.

property indoor_links_use_o2i_zenith_model: bool#: Use ordinary InH LoS/NLoS zenith-angle generation for indoor links.

property indoor_scenario: str#: Indoor-office line-of-sight probability model.

property los_parameter_filepath: str#: Path of the configuration file for LoS scenario

property los_probability: torch.Tensor#

Probability of each BS-UT link to be LoS.

Computed from the indoor open-office or mixed-office formulas in Table 7.4.2-1 of [TR38901V1920].

Shape [batch size, num_bs, num_ut]

property max_2d_in: torch.Tensor#: Maximum indoor 2D distance for indoor UTs [m]

property min_2d_in: torch.Tensor#: Minimum indoor 2D distance for indoor UTs [m]

property nlos_parameter_filepath: str#: Path of the configuration file for NLoS scenario

property o2i_parameter_filepath: str#: Path of the unused O2I configuration file

property o2i_pathloss_enabled: bool#: Disable outdoor-to-indoor penetration loss for InH links.

property rays_per_cluster: int#: Number of rays per cluster

property use_indoor_lsp_params: bool#: Do not switch indoor InH links to O2I LSP parameters.