openworld_radio_twin.providers.opencellid#

OpenCelliD cells from a pinned local snapshot of the daily worldwide export.

OpenCelliD records logical cells, positioned at the centroid of crowdsourced measurements rather than at the antenna. The export gives no antenna height, azimuth, tilt, power or band, so placement fills those from the defaults. LTE cells that share an eNB (cellid >> 8) are merged into one site record at their sample-weighted mean; other radios stay one record per cell, because their cell identifiers do not encode a site the same way.

The query API cannot serve scenes: it allows 1,000 requests per user and day, returns at most 50 cells per page and rounds coordinates to three decimals. The adapter therefore downloads the worldwide export once (about 120 MB, cells observed in the last 18 months) with the user’s token and reads it locally afterwards. The token is used only for that download and is never recorded.

Functions

configured(settings)

A token allows the first download; an installed snapshot is enough afterwards.

read_export(path)

The export's cells as an index table, with or without a header line.

site_records(table, release)

Merge the cells of one LTE eNB into a site; keep other cells as they are.

snapshot_directory(settings)

Classes

OpenCellIdProvider(settings, client)

openworld_radio_twin.providers.opencellid.snapshot_directory(settings)[source]#
Return type:

Path

openworld_radio_twin.providers.opencellid.configured(settings)[source]#

A token allows the first download; an installed snapshot is enough afterwards.

Return type:

bool

openworld_radio_twin.providers.opencellid.read_export(path)[source]#

The export’s cells as an index table, with or without a header line.

Return type:

Table

openworld_radio_twin.providers.opencellid.site_records(table, release)[source]#

Merge the cells of one LTE eNB into a site; keep other cells as they are.

Return type:

list[AntennaFeature]

class openworld_radio_twin.providers.opencellid.OpenCellIdProvider(settings, client)[source]#

Bases: object

async snapshot(*, refresh=False)[source]#

The installed snapshot; downloads the export first when none is installed.

Return type:

Snapshot

async antennas(latitude, longitude, radius_m)[source]#
Return type:

AntennaQueryResult