openworld_radio_twin.antennas#
Antennas of a compiled scene: acquired from a source, selected, placed and recorded.
The Python loader, the web service and dataset generation all call
scene_antennas(), so a scene’s antennas are the same wherever they are requested.
Each result is also written into the scene directory under antennas/ as the record of
what the scene’s transmitters were taken from; the compiled geometry does not change.
A Sionna run simulates one downlink channel: scene.frequency is its centre and
scene.bandwidth its width. A channel is a downlink range an antenna registers, and an
antenna transmits on it when it registers a downlink range that contains it, at its own
power.
Functions
|
Antennas inside a square on the map, completed with defaults but not placed. |
|
A channel given as a range, a |
|
The distinct downlink and TDD ranges the antennas register, lowest first, each with the antennas that transmit on it. |
|
Read records written by |
|
|
|
Acquire, place and select the antennas inside a compiled scene, and record them. |
|
Keep the antennas of one operator (PLMN or name) and radio technology. |
|
Keep the antennas that transmit on |
|
Operators, radios and downlink channels present among |
|
A placed antenna as a transmitter of a simulation request, with its provenance. |
|
Write the selection into |
|
Persist a dataset scene's selected source records, before any placement, with the channels its radio maps draw from. |
Classes
|
Selected antennas of a scene or map area, with the operators and radios it holds; |
- class openworld_radio_twin.antennas.SceneAntennas(result, operators, radios, defaults, record)[source]#
Bases:
objectSelected antennas of a scene or map area, with the operators and radios it holds;
recordis the file written into a compiled scene, None for a map area.-
result:
AntennaQueryResult#
-
operators:
list[AntennaOperator]#
-
defaults:
AntennaDefaults#
-
result:
- openworld_radio_twin.antennas.select_antennas(result, *, operator=None, radio=None)[source]#
Keep the antennas of one operator (PLMN or name) and radio technology.
- Return type:
- openworld_radio_twin.antennas.downlink_channels(antennas)[source]#
The distinct downlink and TDD ranges the antennas register, lowest first, each with the antennas that transmit on it.
- openworld_radio_twin.antennas.summarize_antennas(antennas)[source]#
Operators, radios and downlink channels present among
antennas.
- openworld_radio_twin.antennas.as_channel(value)[source]#
A channel given as a range, a
{"low_mhz", "high_mhz"}mapping or(low, high).- Return type:
- openworld_radio_twin.antennas.select_channel(result, channel)[source]#
Keep the antennas that transmit on
channel: those registering a downlink or TDD range that contains it, whatever operator or technology, at their own power. An antenna that registers no frequencies, as with OpenCelliD, is assumed to transmit on it and is counted in a warning.- Return type:
- openworld_radio_twin.antennas.transmitter_config(antenna, *, frequency_ghz, antenna_pattern)[source]#
A placed antenna as a transmitter of a simulation request, with its provenance.
- Return type:
- openworld_radio_twin.antennas.write_antenna_record(directory, result, query)[source]#
Write the selection into
antennas/and list it inscene_info.json.- Return type:
- openworld_radio_twin.antennas.write_antenna_source(path, result, query, channels)[source]#
Persist a dataset scene’s selected source records, before any placement, with the channels its radio maps draw from.
- Return type:
- openworld_radio_twin.antennas.load_antenna_source(path)[source]#
Read records written by
write_antenna_source(), with the query that chose them and the channels of the scene’s radio maps.- Return type:
tuple[AntennaQueryResult,dict[str,object],list[ChannelRange]]
- async openworld_radio_twin.antennas.scene_antennas(directory, provider, *, source='auto', operator=None, radio=None, channel=None, defaults=None)[source]#
Acquire, place and select the antennas inside a compiled scene, and record them.
- Return type:
- async openworld_radio_twin.antennas.area_antennas(provider, latitude, longitude, radius_m, *, source='auto', operator=None, radio=None, channel=None, defaults=None)[source]#
Antennas inside a square on the map, completed with defaults but not placed.
Placement needs the terrain and buildings of a compiled scene; this view needs neither, so the explorer can show a source’s antennas before a scene exists. Nothing is recorded.
- Return type:
- async openworld_radio_twin.antennas.load_scene_antennas(directory, *, settings=None, provider=None, **selection)[source]#
scene_antennas()with a provider of its own when the caller has none.- Return type: