openworld_radio_twin.artifacts#

Functions

build_artifact_bundle(request, result, data, ...)

Build a portable single-scene version of the reference/package layout.

display_sample_factor(cell_size_m, rows, columns)

Display samples per cell side: enough to be DISPLAY_SAMPLE_M apart, within the cap.

render_radio_map_png(data, metric, ...[, ...])

Render a metric north up for the explorer, one pixel per solver cell.

validate_artifact_tree(root, data)

Fail export when the portable tree diverges from the declared contract.

write_packed_path_gain(root, data)

Write the path gain of a dataset radio map, packed as uint16 dB values.

write_radio_arrays(root, data)

Write the linear float32 metric arrays and the serving-transmitter array.

write_radio_images(root, data, building_mask)

Write the north-up PNGs of every metric and of the serving transmitter.

openworld_radio_twin.artifacts.display_sample_factor(cell_size_m, rows, columns)[source]#

Display samples per cell side: enough to be DISPLAY_SAMPLE_M apart, within the cap.

Return type:

int

openworld_radio_twin.artifacts.render_radio_map_png(data, metric, building_mask, *, mask_buildings, fine_building_mask=None)[source]#

Render a metric north up for the explorer, one pixel per solver cell.

fine_building_mask marks the receiver points inside buildings on samples an integer factor finer than the cells, north up. When it is given, buildings are masked and the metric is continuous, the image is drawn on those samples instead: colours are interpolated between cell centres, cells whose receiver lies inside a building take the colours of the drawn cells around them, and the samples inside buildings stay transparent.

Return type:

bytes

openworld_radio_twin.artifacts.write_radio_arrays(root, data)[source]#

Write the linear float32 metric arrays and the serving-transmitter array.

Return type:

None

openworld_radio_twin.artifacts.write_packed_path_gain(root, data)[source]#

Write the path gain of a dataset radio map, packed as uint16 dB values.

Return type:

None

openworld_radio_twin.artifacts.write_radio_images(root, data, building_mask)[source]#

Write the north-up PNGs of every metric and of the serving transmitter.

Return type:

dict[str, object]

openworld_radio_twin.artifacts.validate_artifact_tree(root, data)[source]#

Fail export when the portable tree diverges from the declared contract.

Return type:

None

openworld_radio_twin.artifacts.build_artifact_bundle(request, result, data, building_mask, environment=None)[source]#

Build a portable single-scene version of the reference/package layout.

Return type:

bytes