Batch page#
The batch page at /batch defines one or more geographic scenes and expands each into
fixed or seeded-random radio maps with the same schema as the Python interface
(Planning and generation).
Sections#
- Identity and execution
Dataset name, random seed, continue-on-error, and Resume / extend for an existing dataset with higher radio map counts or scenes added at the end. The page does not set
site, so extend a dataset whose scenes have a site from Python.- Scene definitions
Add scene appends a scene. Each has a label, centre coordinates, radius, receiver height, voxel pitch, building source, buildings on or off, terrain on or off with mesh spacing, material profile, the empty scene mode, and its transmitters: sampled, or taken from an antenna source with an optional operator, radio and list of channels.
- Radio maps per scene
One radio map space for every scene of the request. Seeded random or Fixed strategy, radio map count, solver (preview or Sionna RT), transmitter count range and the ranges for frequency, power, height, offset radius, azimuth and downtilt; antenna patterns; the solver candidates for resolution, reflection depth and samples per transmitter; the association metric; the PNG previews switch, which adds the previews to the stored path gain of each radio map; and, for Sionna RT, the device and the geometry and propagation switches.
- Plan and generate
Build plan calls
POST /api/batches/planand shows, before anything is executed, the receiver-cell count, the initial ray budget and the first radio map names and solver seeds of each scene. Generate dataset callsPOST /api/batches; the page then pollsGET /api/batches/{job_id}and offers the manifest when the job completes.
Behaviour#
Radio maps run sequentially inside one job. Only one batch job runs at a time; a second request for the same dataset name is rejected while the first is queued or running.
A dataset name that already exists on disk is rejected unless resume is enabled.
Jobs and their status live in the service’s memory; the dataset itself is written under
OWRT_DATASET_ROOTand survives a restart.Sionna radio maps are refused up front when the runtime is not installed.