openworld_radio_twin.simulation.scene_builder#
Functions
|
|
|
The solid intervals of one building in the grid columns |
|
|
|
Reconstruct the solver environment from a persisted scene asset directory. |
|
Restore the scene metadata needed by geographic and derived-asset helpers. |
|
|
|
Return the stable shared path for one receiver-grid definition. |
|
Reuse the measurement surface at |
|
Sample buildings at the grid points |
|
East and north cell centres of a north-up |
|
Return compiled triangle elevation in the scene's local ENU frame. |
|
Convert a geographic TX position with AGL height to Sionna scene coordinates. |
|
Triangulate a simple polygon while retaining the legacy public helper. |
|
|
|
Write the receiver surface mesh, its arrays and its JSON record next to |
|
Write the sparse solid voxels and north-up receiver-height slice. |
Classes
|
|
|
|
|
|
|
Triangle mesh as Python lists or as |
|
|
|
- class openworld_radio_twin.simulation.scene_builder.Mesh(vertices, faces)[source]#
Bases:
objectTriangle mesh as Python lists or as
(n, 3)NumPy arrays; both serialize alike.
- class openworld_radio_twin.simulation.scene_builder.LocalBuilding(feature_id, exterior, holes, minimum_height_m, vertical_extent_m, terrain_anchor_m=0.0, anchor_surface_class=SurfaceClass.GROUND, native_vertices=(), native_triangles=(), native_surface_types=(), source_lod=None, source_vertical_datum=None, source_ground_elevation_m=None, parent_reference_elevation_m=None, parent_building_id=None, placement_rule='footprint_extrusion')[source]#
Bases:
object-
anchor_surface_class:
SurfaceClass= 0#
-
anchor_surface_class:
- openworld_radio_twin.simulation.scene_builder.localize_buildings(buildings, origin_longitude, origin_latitude, environment=None)[source]#
- Return type:
- class openworld_radio_twin.simulation.scene_builder.BuildingMeshAssets(index, feature_id, rooftop_path, wall_path, rooftop_triangles, wall_triangles)[source]#
Bases:
object
- class openworld_radio_twin.simulation.scene_builder.SceneAssets(directory, scene_xml_path, provenance_path, ground_path, terrain_paths, environment_metadata_path, height_map_path, building_assets, local_buildings, origin_longitude, origin_latitude, radius_m, height_map_pixel_size_m, triangle_count, environment, material_profile)[source]#
Bases:
object-
terrain_paths:
dict[SurfaceClass,Path]#
-
building_assets:
tuple[BuildingMeshAssets,...]#
-
local_buildings:
tuple[LocalBuilding,...]#
-
environment:
EnvironmentData|None#
-
terrain_paths:
- class openworld_radio_twin.simulation.scene_builder.VoxelAssets(directory, voxel_path, slice_path, scene_info_path, depth_array_path, depth_image_path, depth_preview_path, depth_info_path, pitch_m, slice_shape, grid)[source]#
Bases:
object
- class openworld_radio_twin.simulation.scene_builder.MeasurementSurfaceAssets(path, cell_shape, triangle_areas_m2, cell_centers)[source]#
Bases:
object
- openworld_radio_twin.simulation.scene_builder.geographic_to_local(longitude, latitude, origin_longitude, origin_latitude)[source]#
- openworld_radio_twin.simulation.scene_builder.triangulate_polygon(points)[source]#
Triangulate a simple polygon while retaining the legacy public helper.
- openworld_radio_twin.simulation.scene_builder.write_measurement_surface(path, assets, resolution_m, receiver_height_m)[source]#
Write the receiver surface mesh, its arrays and its JSON record next to
path.Each file goes through a temporary sibling and the JSON record is replaced last, so an interrupted run never leaves a partial file under a final name.
- Return type:
- openworld_radio_twin.simulation.scene_builder.prepare_measurement_surface(path, assets, resolution_m, receiver_height_m)[source]#
Reuse the measurement surface at
pathwhen its files match this grid, else write it.The files match when the record has the current schema, the axes equal the requested grid, the stored cell-centre heights equal those of the scene terrain at this receiver height, and the mesh has this grid’s header and every vertex height of the grid.
- Return type:
- openworld_radio_twin.simulation.scene_builder.terrain_elevation(assets, east_m, north_m)[source]#
Return compiled triangle elevation in the scene’s local ENU frame.
- Return type:
- openworld_radio_twin.simulation.scene_builder.transmitter_scene_position(assets, longitude, latitude, height_agl_m)[source]#
Convert a geographic TX position with AGL height to Sionna scene coordinates.
- openworld_radio_twin.simulation.scene_builder.measurement_surface_path(assets, resolution_m, receiver_height_m)[source]#
Return the stable shared path for one receiver-grid definition.
- Return type:
- openworld_radio_twin.simulation.scene_builder.load_environment_assets(directory)[source]#
Reconstruct the solver environment from a persisted scene asset directory.
- Return type:
- openworld_radio_twin.simulation.scene_builder.scene_cell_centers(radius_m, size)[source]#
East and north cell centres of a north-up
sizexsizegrid over the scene square.The cells have side
2 * radius_m / size; columns run west to east and rows north to south. Every scene raster and voxel product samples buildings at these centres.
- openworld_radio_twin.simulation.scene_builder.building_columns(building, east, north, environment=None)[source]#
The solid intervals of one building in the grid columns
eastxnorth.Returns
rows, columns, lower, upperwith one entry per interval. A native shell gives the intervals sampled from its triangles, placed at the building’s terrain anchor and measured above the ground under the column. An extruded footprint gives its nominalminimum_height_mtoroof_height_min each column whose centre lies inside it.
- openworld_radio_twin.simulation.scene_builder.rasterize_local_buildings(buildings, east, north, slice_height_agl_m, environment=None)[source]#
Sample buildings at the grid points
eastxnorth; rows follownorth.Returns the occupancy mask and the roof height above ground (NaN where there is no building). With
slice_height_agl_monly columns whose solid contains that height count; without it every building column counts (the vertical projection).
- openworld_radio_twin.simulation.scene_builder.build_scene_assets(directory, buildings, origin_longitude, origin_latitude, radius_m, environment=None, include_ground=True, material_profile='itu')[source]#
- Return type:
- openworld_radio_twin.simulation.scene_builder.load_scene_assets(directory)[source]#
Restore the scene metadata needed by geographic and derived-asset helpers.
- Return type: