openworld_radio_twin.providers.acma#

The ACMA Register of Radiocommunications Licences, Australia.

ACMA publishes the full register every day as one archive of linked CSV tables. The adapter keeps the transmitters of spectrum licences, which cover the public mobile networks and a few other area-wide systems such as NBN fixed wireless, and joins each to its site, licence and licensee. A record is one carrier at one antenna: transmitters registered several times with the same site, antenna, direction, height and frequency range, such as the branches of one MIMO antenna, become one record. The register gives the carrier’s frequency range, the antenna’s height, azimuth and transmitter power; the ranges are transmitter frequencies, so they are marked as downlink. Tilt is kept only as a source attribute, since the register leaves it empty or zero for almost all transmitters and does not define its sign.

The archive is downloaded once and converted to a local point index pinned by its date and SHA-256. Licensees who are natural persons are never recorded, as the ACMA licence requires.

Functions

antenna_records(table, release)

read_export(path)

One row per carrier at an antenna, and the archive's release date.

snapshot_directory(settings)

Classes

AcmaProvider(settings, client)

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

Path

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

One row per carrier at an antenna, and the archive’s release date.

Return type:

tuple[Table, dict[str, int], str]

openworld_radio_twin.providers.acma.antenna_records(table, release)[source]#
Return type:

list[AntennaFeature]

class openworld_radio_twin.providers.acma.AcmaProvider(settings, client)[source]#

Bases: object

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

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

Return type:

Snapshot

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

AntennaQueryResult