openworld_radio_twin.spectrum#

Link direction of registered frequency ranges, from the 3GPP operating bands.

Registers list the frequency ranges an antenna is licensed for, often uplink and downlink together and without saying which is which. A radio map is a downlink product, so each range is classified against the operating bands of 3GPP TS 36.101 (E-UTRA) and TS 38.104 (NR), which also cover GSM and UMTS deployments in the same bands, and the railway GSM bands of TS 45.005.

The same frequencies are uplink in one region and downlink in another (band 1 uplink overlaps band 2 downlink), so a range is classified in two steps. The bands containing the range decide when they agree. When they disagree, another range of the same antenna at a band’s duplex spacing, its uplink or downlink partner, decides. A range whose bands all carry a downlink, TDD in one and downlink in another, is downlink. A range that neither step resolves, such as a typing error spanning uplink and downlink, stays unknown.

Functions

classify_ranges(ranges)

The link of each of one antenna's distinct registered ranges (low, high) in MHz.

Classes

OperatingBand(name, uplink, downlink)

A 3GPP operating band.

class openworld_radio_twin.spectrum.OperatingBand(name, uplink, downlink)[source]#

Bases: object

A 3GPP operating band. FDD bands have both links, TDD bands one shared range, supplementary downlink (SDL) bands a downlink only.

name: str#
property tdd: bool#
property duplex_spacing_mhz: float | None#
openworld_radio_twin.spectrum.classify_ranges(ranges)[source]#

The link of each of one antenna’s distinct registered ranges (low, high) in MHz.

Return type:

tuple[Literal['downlink', 'uplink', 'tdd', 'unknown'], ...]