openworld_radio_twin.rt#
Sionna-compatible loader extended with geographic scene compilation.
Functions
|
Antennas registered inside a scene, placed as Sionna-ready records. |
|
Load a native Sionna scene from a file, an empty scene, or WGS84 coordinates. |
|
Compile asynchronously, then load the native scene on the caller's event-loop thread. |
|
Return a native Mitsuba mesh following terrain at a constant AGL height. |
|
Return the absolute ENU position expected by Sionna's radio devices. |
|
Restore the scene's public WGS84-to-ENU transform. |
|
Return the canonical directory registered for a native Sionna scene. |
|
Sample local terrain elevation in metres at an ENU position. |
- openworld_radio_twin.rt.antennas(scene_or_path, *, source='auto', operator=None, radio=None, channel=None, defaults=None)[source]#
Antennas registered inside a scene, placed as Sionna-ready records.
sourceis"auto"(the regional register that covers the scene centre, else OpenCelliD when it is configured),"none", or a source identifier such as"anfr","opencellid"or"local".operatortakes a PLMN such as"208-01"or an operator name, andradioa technology such as"LTE".A Sionna run simulates one downlink channel. The result’s
channelslists the downlink ranges the scene’s antennas register.channel=(low_mhz, high_mhz)keeps the antennas that register a downlink range containing it, at their own power. Setscene.frequency = result.channel.centre_hzandscene.bandwidth = result.channel.bandwidth_hz; the antenna array stays the scene-widescene.tx_array.Each record’s
position(scene coordinates) andorientation(Sionna’s rotation angles) go directly intosionna.rt.Transmitter;power_dbmgives its power. A value the source does not provide takes a default and is marked"default"in the record’sbasis. The defaults are Sionna’s own where Sionna defines one:transmit power: 44 dBm,
sionna.rt.constants.DEFAULT_TRANSMIT_POWER_DBM;azimuth and downtilt: Sionna’s zero orientation, a horizontal boresight towards east (compass azimuth 90 degrees);
height above ground: 25 m, the OWRT transmitter default, since Sionna has none.
defaultschanges any of them, addssectors(one antenna per azimuth for sites without a direction) or setsroof_clearance_m: an antenna that would sit inside a building of the scene is raised this far above its roof and marked"adjusted". The result is also recorded under the scene’santennas/.- Return type:
- openworld_radio_twin.rt.load_scene(filename=None, merge_shapes=True, merge_shapes_exclude_regex=None, remove_duplicate_vertices=False, *, latitude=None, longitude=None, radius_m=None, cache_dir=None, buildings='auto', building_source='auto', terrain='elevation', material_profile='itu', terrain_resolution_m=5.0, device='auto', **sionna_options)[source]#
Load a native Sionna scene from a file, an empty scene, or WGS84 coordinates.
- async openworld_radio_twin.rt.load_scene_async(*, latitude, longitude, radius_m, cache_dir=None, buildings='auto', building_source='auto', terrain='elevation', material_profile='itu', terrain_resolution_m=5.0, device='auto', merge_shapes=True, merge_shapes_exclude_regex=None, remove_duplicate_vertices=False, **sionna_options)[source]#
Compile asynchronously, then load the native scene on the caller’s event-loop thread.
- openworld_radio_twin.rt.measurement_surface(scene_or_path, *, cell_size=(10.0, 10.0), height=1.5)[source]#
Return a native Mitsuba mesh following terrain at a constant AGL height.
- openworld_radio_twin.rt.position(scene_or_path, *, latitude, longitude, height_agl)[source]#
Return the absolute ENU position expected by Sionna’s radio devices.
- openworld_radio_twin.rt.scene_frame(scene_or_path)[source]#
Restore the scene’s public WGS84-to-ENU transform.
- Return type: