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 |
|
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 |
|
Australia |
Site position, antenna height, azimuth, transmitter power, licensee, each carrier’s frequency range |
ACMA licence to use the register |
Antennebureau mobile antenna installations |
|
Netherlands |
Position to 15 m, height above ground, technology |
CC0 1.0 |
UKE base-station permits |
|
Poland |
Station position, operator, technology, band |
CC BY 4.0 |
OpenCelliD |
|
Worldwide |
Estimated cell position (centroid of crowdsourced measurements), operator code, radio |
CC BY-SA 4.0 |
Local antenna file |
|
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.
channelslists 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. Anoperatororradioselection 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 asbandwidth_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_supportedtells 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 |
|
every source |
none: a record without a position is dropped |
Height above ground |
|
ANFR, ACMA, Antennebureau, local files |
25 m, the OWRT transmitter default; Sionna has none |
Azimuth |
|
ANFR, ACMA, local files |
Sionna’s zero orientation: boresight towards east (compass 90°) |
Downtilt |
|
local files |
Sionna’s zero orientation: horizontal boresight (0°) |
Transmit power |
|
ACMA, local files |
44 dBm, |
Velocity |
|
none |
zero, Sionna’s default |
Every filled value is marked
"default"in the record’sbasis, 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.defaultsreplaces any entry:owrt.antennas(scene, defaults={"power_dbm": 43, "downtilt_deg": 6}).POST /api/antennastakes the same object, with either ascene_id(placed in that scene) orlatitude,longitudeandradius_m(completed with the defaults but not placed, for viewing before a scene exists), and achannelas{"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 withdefaults={"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)”.