Values at risk

The structures, critical infrastructure, and people in a fire's path, assessed against a fire spread simulation.

/v1/fire-spread/simulations/{id}/values-at-risk - what a simulated fire reaches, and when.

A values-at-risk report overlays a fire spread simulation on Deepfire’s infrastructure layers. Every asset inside the simulated burn area, or within a small buffer of it, is reported with the hour the fire first reaches it.

Assets come in two forms:

Assets — individually named facilities such as hospitals, schools, fire stations, transmission lines and cell towers. Each one is listed with its distance from the ignition, first impact hour, and source attributes.
Aggregates — high-count layers such as building footprints, reported as counts and total footprint area per hour rather than one row per building.

Asset types

Category	`assetType`
Structures	`BUILDING`, `BUILDING_FEMA` (aggregates)
Healthcare	`HOSPITAL`, `NURSING_HOME`, `DIALYSIS_CENTER`, `VHA_MEDICAL_FACILITY`
Emergency Services	`FIRE_EMS_STATION`, `NATIONAL_SHELTER`, `LAW_ENFORCEMENT`, `LOCAL_EOC`, `STATE_EOC`, `PRISON`
Education	`PUBLIC_SCHOOL`, `PRIVATE_SCHOOL`, `COLLEGE_UNIVERSITY`, `CHILD_CARE_CENTER`
Energy	`TRANSMISSION_LINE`, `NATURAL_GAS_PIPELINE`, `HGL_PIPELINE`, `PETROLEUM_REFINERY`, `PETROLEUM_PRODUCT_TERMINAL`, `LNG_TERMINAL`, `LNG_STORAGE_FACILITY`
Communications	`CELLULAR_TOWER`, `ANTENNA_STRUCTURE`, `LAND_MOBILE_BROADCAST_TOWER`, `MICROWAVE_SERVICE_TOWER`
Transport	`AVIATION_FACILITY`
Water	`WASTEWATER_TREATMENT_PLANT`
Custom	Layers your organization has uploaded as custom data

Infrastructure coverage is currently the United States; structures are global where building footprints are available.

Example

Run a fire spread simulation, wait for COMPLETED, then request its values at risk:

curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.deepfire.co/v1/fire-spread/simulations/2f8a…/values-at-risk"

{
  "simulationId": "2f8a…",
  "durationHours": 12,
  "assets": [
    {
      "id": "8c1e0f6a-3b0d-4a8e-9a57-2f1d6b4c9e11",
      "assetType": "FIRE_EMS_STATION",
      "displayName": "Fire & EMS Stations",
      "category": "Emergency Services",
      "label": "Station 42",
      "distanceMeters": 3150.4,
      "firstImpactHour": 5,
      "burnProbability": 0.6,
      "geometry": { "type": "Point", "coordinates": [-105.4612, 39.0384] },
      "metadata": { "address": "1200 Pine Rd", "city": "Bailey", "state": "CO" }
    },
    {
      "id": "e2b7…",
      "assetType": "TRANSMISSION_LINE",
      "displayName": "Transmission Lines",
      "category": "Energy",
      "label": "Xcel Energy",
      "distanceMeters": 1820.0,
      "firstImpactHour": 2,
      "burnProbability": 0.9,
      "geometry": { "type": "LineString", "coordinates": [ … ] },
      "metadata": { "voltage": 230, "owner": "Xcel Energy", "status": "IN SERVICE" }
    }
  ],
  "aggregates": [
    {
      "assetType": "BUILDING",
      "displayName": "Structures",
      "category": "Structures",
      "impactedCount": 184,
      "totalAreaM2": 41230.5,
      "countByHour": { "1": 3, "2": 11, "3": 26, "4": 48, "5": 96 }
    }
  ]
}

Attributes

Assets

Field	Type	Notes
`id`	string (UUID)	Stable id of the asset
`assetType`	string	See Asset types
`displayName`	string	Human-readable layer name
`category`	string	Grouping, e.g. `Healthcare`, `Energy`
`label`	string	The asset’s own name, e.g. the hospital name or line owner; may be `null`
`distanceMeters`	number	Distance from the ignition
`firstImpactHour`	integer	Simulation hour the fire first reaches the asset; `null` if only within the buffer
`burnProbability`	number	0–1 share of ensemble members that reach the asset; `null` for single-member runs
`geometry`	GeoJSON	Point, line or polygon of the asset
`metadata`	object	Source attributes, varying by layer (e.g. `voltage`, `beds`, `address`)

Aggregates

Field	Type	Notes
`assetType`	string	`BUILDING` or `BUILDING_FEMA`
`impactedCount`	integer	Number of structures reached over the whole run
`totalAreaM2`	number	Combined footprint area of those structures
`countByHour`	object	Newly reached structures per simulation hour

Generate a values-at-risk report in the web app

Pick any fire and see the structures and people in its path.