Antennas#

A compiled scene holds geometry. Its transmitters can be placed by hand, sampled for a dataset, or taken from an antenna source: a register of radio installations or a crowdsourced cell database. Antenna sources work like building sources: one registry, location-based routing with auto, explicit identifiers that never fall back to another source, and plugins that add sources without changes to OWRT.

Source

ID

Coverage

Gives

Licence

ANFR installations > 5 W

anfr

France, overseas regions and collectivities

Support position, height above ground, azimuth of directional antennas, operator, registered bands

Licence Ouverte 2.0

ACMA Register of Radiocommunications Licences

acma

Australia

Site position, antenna height, azimuth, transmitter power, licensee, each carrier’s frequency range

ACMA licence to use the register

Antennebureau mobile antenna installations

antennebureau

Netherlands

Position to 15 m, height above ground, technology

CC0 1.0

UKE base-station permits

uke

Poland

Station position, operator, technology, band

CC BY 4.0

OpenCelliD

opencellid

Worldwide

Estimated cell position (centroid of crowdsourced measurements), operator code, radio

CC BY-SA 4.0

Local antenna file

local

The file’s extent

What the file gives

The file’s own

auto selects the register of the country that holds the scene centre: ANFR in France, the Antennebureau list in the Netherlands and the UKE permits in Poland. Elsewhere it selects OpenCelliD when a token or an installed snapshot makes it available, and otherwise no antennas. The ACMA register is selected by its ID, acma; Antenna-source plugins gives the rule. The list of sources auto may use is OWRT_AUTOMATIC_ANTENNA_SOURCES, a JSON list (default ["anfr", "antennebureau", "uke", "opencellid"]). An explicit register outside its country fails instead of returning no antennas.

From a Python scene#

owrt.antennas returns the antennas inside a compiled scene as records that go straight into native Sionna transmitters. Its channels lists the downlink channels they register; with channel, it keeps the antennas that transmit on that channel. The channel’s centre and width become the scene’s carrier and noise bandwidth; the antenna array stays a scene-wide Sionna setting.

from openworld_radio_twin import rt as owrt

scene = owrt.load_scene(latitude=48.8719, longitude=2.3316, radius_m=300)
import sionna.rt as rt

for channel in owrt.antennas(scene).channels:
    print(channel.low_mhz, channel.high_mhz, channel.labels, channel.antenna_count)

found = owrt.antennas(scene, channel=(1805, 1825))
scene.frequency = found.channel.centre_hz    # 1815 MHz
scene.bandwidth = found.channel.bandwidth_hz  # 20 MHz, for the thermal noise
scene.tx_array = rt.PlanarArray(num_rows=8, num_cols=2, pattern="tr38901", polarization="V")
scene.rx_array = rt.PlanarArray(num_rows=1, num_cols=1, pattern="iso", polarization="V")
for antenna in found.antennas:
    scene.add(rt.Transmitter(
        name=antenna.feature_id,
        position=antenna.position,        # scene coordinates, terrain included
        orientation=antenna.orientation,  # Sionna's (alpha, beta, gamma)
        power_dbm=antenna.power_dbm,      # its power inside the channel
    ))
print(found.provider, found.release, found.license)

operator takes a PLMN code such as "208-01" or an operator name, and radio a technology ("GSM", "UMTS", "LTE", "NR"). Both filter antennas. Antennas they leave out that transmit on the selected channel are counted in a warning, since they would interfere.

Channels#

A register lists the frequency ranges each antenna is licensed for, uplink and downlink together, and one antenna often carries several systems: the ANFR register lists an Orange antenna near the Opéra with nine systems from LTE 700 to 5G NR 3500. A Sionna transmitter radiates one carrier, and a scene has one frequency, one noise bandwidth and one antenna array. A run therefore simulates one downlink channel, and a transmitter is an antenna transmitting on it.

  • Link direction. Each registered range is classified against the operating bands of 3GPP TS 36.101 and TS 38.104, and the railway GSM bands of TS 45.005, as downlink, uplink or TDD. The same frequencies are uplink in one region and downlink in another, so when the bands disagree, another range of the same antenna at a band’s duplex spacing decides. Ranges match bands within 0.15 MHz, since registers round to 0.1 MHz. A range neither step resolves, such as a typing error spanning uplink and downlink, has an unknown link and is ignored. A source that states the direction itself, as ACMA does for its transmitters, sets it on the band, and the classification is skipped.

  • Channels. channels lists each distinct downlink or TDD range in the scene, with the systems, operators and number of antennas on it. A channel of network sharing lists both operators.

  • Selection. channel=(low_mhz, high_mhz) keeps every antenna that registers a downlink or TDD range containing the channel, whatever operator or technology its record names, at its own power. A range that only overlaps the channel does not count. An operator or radio selection narrows the set. An antenna with no registered range, as with OpenCelliD, is assumed to transmit on the channel and is counted in a warning.

  • Noise. Sionna’s thermal noise is kTB with B = scene.bandwidth, 1 MHz by default. A simulation request takes it as bandwidth_mhz; the explorer and datasets set it to the channel’s width.

  • SINR. SINR counts every transmitter of the run as a co-channel interferer at full load. This fits LTE and NR; for GSM, whose cells use separate carriers inside a block, it overstates interference.

  • Frequency range. Sionna’s ITU ground material is defined from 1 to 10 GHz, so channels at 700, 800 and 900 MHz run only in the CPU preview. Each channel’s sionna_supported tells which.

Each call also writes its selection into the scene directory under antennas/, with the source identity, release and licence, and lists the file in scene_info.json. The compiled geometry does not change, and the scene cache key does not depend on antennas.

Values a source does not give#

Sionna needs a position, an orientation and a transmit power for every transmitter. Where the source does not record a value, OWRT uses the default below. Where Sionna defines a default, it is Sionna’s.

Value

Sionna parameter

Given by

Default when missing

Horizontal position

position (x, y)

every source

none: a record without a position is dropped

Height above ground

position (z)

ANFR, ACMA, Antennebureau, local files

25 m, the OWRT transmitter default; Sionna has none

Azimuth

orientation (alpha)

ANFR, ACMA, local files

Sionna’s zero orientation: boresight towards east (compass 90°)

Downtilt

orientation (beta)

local files

Sionna’s zero orientation: horizontal boresight (0°)

Transmit power

power_dbm

ACMA, local files

44 dBm, sionna.rt.constants.DEFAULT_TRANSMIT_POWER_DBM

Velocity

velocity

none

zero, Sionna’s default

  • Every filled value is marked "default" in the record’s basis, next to "source" (given by the source), "derived" (computed from source data, such as a centroid) and "user" (edited in the explorer). The result’s warnings count how many records received each default.

  • defaults replaces any entry: owrt.antennas(scene, defaults={"power_dbm": 43, "downtilt_deg": 6}). POST /api/antennas takes the same object, with either a scene_id (placed in that scene) or latitude, longitude and radius_m (completed with the defaults but not placed, for viewing before a scene exists), and a channel as {"low_mhz", "high_mhz"}. The explorer uses the defaults, and each transmitter can be edited afterwards; a dataset samples these values per radio map from its ranges instead.

  • An antenna without a registered azimuth points east under the default orientation. For a source without azimuths, use an isotropic array (pattern="iso"), or split each site into sectors with defaults={"sectors": (0, 120, 240)}.

  • These values follow Sionna and differ from the explorer’s defaults for a transmitter placed by hand (30 dBm, 6° downtilt).

Placement rules#

  • Boundary. Only antennas inside the scene square are kept; the result counts the others. Interference from sites beyond the boundary is not modelled.

  • Roofs. Register heights and building heights come from different sources. An antenna that would sit inside a building of the scene is raised to roof_clearance_m (default 1 m) above the roof and its height is marked "adjusted"; a transmitter enclosed by a building shell would produce an empty radio map.

  • Orientation. A compass azimuth θ and a downtilt β become Sionna’s angles (90° − θ, β, 0). The built-in Sionna engine uses the same conversion, so an antenna from a source gets the same Sionna orientation in Python, the explorer and datasets.

Snapshots and configuration#

The register adapters and OpenCelliD read local snapshots of the published exports, never the network, once installed. The first use downloads the export (ANFR about 66 MB, ACMA about 70 MB, Antennebureau about 13 MB, UKE about 16 MB, OpenCelliD about 120 MB), records its date and SHA-256, and builds a point index under OWRT_SOURCE_CACHE_ROOT (default .cache/sources under the checkout). Every record carries that release. Refreshing is explicit because it changes what later queries read. owrt sources list shows every building and antenna source with its installed snapshot, and owrt sources refresh replaces a source’s snapshot with its latest export:

owrt sources list
owrt sources refresh anfr
owrt sources refresh acma
owrt sources refresh opencellid

Using acma accepts ACMA’s licence to use the register, which ships in the archive as LICENCE.TXT; its credit line appears under Licences below.

OpenCelliD needs a free API token for the download, set as OWRT_OPENCELLID_TOKEN in the environment or in .env. The token is used for the download only and never recorded. Its query API is not used: it allows 1,000 requests a day, returns at most 50 cells per request and rounds coordinates to three decimals. The export may be downloaded twice a day per file.

A local file is set with OWRT_LOCAL_ANTENNAS: GeoJSON Point features, or CSV rows with id, latitude and longitude, and optionally site_id, operator, plmn, radio, height_agl_m, azimuth_deg, downtilt_deg, power_dbm and one band (band_label, band_low_mhz, band_high_mhz). Its SHA-256 enters the source identity.

What the sources can support#

The adapters keep each source’s meaning. ANFR lists authorised installations above 5 W: the adapter keeps antennas with a mobile emitter in service (GSM, UMTS, LTE, 5G NR) and drops those indoors, underground or in tunnels. It records no tilt, power or antenna pattern. OpenCelliD merges the LTE cells of one eNB into a site at their sample-weighted centroid; other radios stay one record per cell.

  • ACMA. The adapter keeps the transmitters of spectrum licences, which hold the public mobile networks and a few other area-wide systems such as NBN fixed wireless; the operator selection separates them. A record is one carrier at one antenna, and the register’s repeated registrations of one carrier, such as the branches of a MIMO antenna, become one record at their highest power. The ranges are transmitter frequencies and are marked as downlink. The register records a tilt for few transmitters and does not define its sign, so the tilt is kept only as a source attribute. Positions are in GDA94, within about 2 m of WGS84. Licensees who are natural persons are not recorded.

  • Antennebureau. The monthly list gives the position to 15 m, the antenna height and the technology of each installation above about 10 dBW, but no operator, frequency or direction. The adapter reads the newest month and joins the technologies at one position and height into one antenna. Without frequencies, the antennas are assumed on the selected channel.

  • UKE. The permit lists give the operator, the station and its position to a second of arc, and the band from the list’s name. The adapter joins a station’s lists into one antenna and registers each band as its whole downlink range in the European band plan, so the operators on a band share one channel; select an operator to separate them. Lists of GSM-R and of CDMA and LTE at 420/450 MHz are skipped. A permit does not guarantee a built station, and the lists name few Plus (Polkomtel) stations.

A comparison against ANFR LTE sites of the same operator (scripts/benchmarks/compare_opencellid_anfr.py, ANFR export of 2026-08-31, OpenCelliD export of 2026-09-23):

Area

OpenCelliD sites

Median error

Random-point baseline

ANFR sites with an estimate within 100 m

Paris, 1.5 km square

399

90 m

128 m

57%

Paris, 10 km square

3,854

149 m

175 m

31%

Lyon, 10 km square

949

200 m

319 m

16%

Rural Beauce, 20 km square

52

1.6 km

2.6 km

0%

In central Paris the OpenCelliD estimates are only somewhat closer to a registered site than random points. They place transmitters where cells were observed; they do not reproduce a network layout. ANFR lists no installations below 5 W, so small cells are missing from the reference.

Licences#

Each result carries its source’s attribution, licence and licence page, and datasets record them per scene and in their LICENSE.md (Dataset layout). Work derived from the ACMA register must carry the credit “Based on Australian Communications and Media Authority information”. The UKE lists are shared under CC BY 4.0 with the condition to state the date of the data, which each record carries as its release. Data adapted from OpenCelliD is shared under CC BY-SA 4.0: a dataset whose transmitters come from OpenCelliD carries that licence and the credit “Cell tower data from OpenCelliD (https://opencellid.org)”.