Skip to content

Simulation Outputs

Every reporting interval the simulator exposes a PropagatorOutput snapshot via Propagator.get_output(). The CLI persists these snapshots as GeoTIFF rasters, GeoJSON isochrones, and metadata JSON; programmatic users can consume them directly (see the Programmatic Workflow).

All per-cell fields are 2D arrays with the same shape as the input rasters, aggregated across the stochastic realizations of the run.

Fields

Field Units Description
time seconds Simulation time of the snapshot, from simulation start.
fire_probability [0, 1] Fraction of realizations in which the cell has burned.
min_arrival_time seconds Earliest time the fire reached the cell across all realizations in which it burned. Cells never reached hold 0.
mean_arrival_time seconds Mean arrival time over the realizations in which the cell burned.
ros_mean m/min Mean rate of spread over realizations where the cell burned.
ros_max m/min Maximum rate of spread across realizations.
fli_mean kW/m Mean fireline intensity over realizations where the cell burned.
fli_max kW/m Maximum fireline intensity across realizations.
spotting_generation_probability [0, 1] Fraction of realizations in which the cell launched at least one ember (all zeros when spotting is disabled). See Fire Spotting.
spotting_receiving_probability [0, 1] Fraction of realizations in which the cell was hit by an ember (all zeros when spotting is disabled).
stats Aggregate statistics: number of active cells and burned-area mean and 50/75/90th percentiles.

Arrival Times

Arrival times record, per realization, the simulation time at which each cell ignited. They are useful to derive isochrone maps from a single realization ensemble, or to quantify the spread of arrival uncertainty:

output = sim.get_output()

# Earliest possible arrival (best-case warning time)
earliest = output.min_arrival_time

# Expected arrival where the fire is likely to reach
expected = output.mean_arrival_time

Both arrays are expressed in seconds from simulation start. min_arrival_time is the minimum over the realizations in which the cell burned, so cells with a low fire_probability can still carry a meaningful (if unlikely) early arrival time — combine it with fire_probability when communicating risk.

CLI Raster Products

When running through the CLI, each reporting interval writes one GeoTIFF per variable: fire_probability, min_arrival_time, mean_arrival_time, ros_mean, ros_max, fireline_intensity_mean, fireline_intensity_max, and — when spotting is enabled in the configuration — spotting_generation_probability and spotting_receiving_probability. See CLI Usage for invocation details.