← All engines

HeatShield

Heat stressHeatShield v1.0

HeatShield scores physiological heat stress from apparent temperature, wet-bulb temperature (with a hard dangerous-heat override), humidity–heat interaction, heat duration and the vulnerable local-solar-time window.

Run HeatShield

Live mode uses keyless open providers; demo mode is deterministic and offline. Missing data lowers confidence — it never fakes a value.

Score formula

HeatShield = 0.30·apparent_temperature_risk + 0.25·wet_bulb_risk + 0.20·humidity_heat_stress + 0.15·duration_of_heat + 0.10·vulnerable_time_window
30%apparent_temperature_risk
25%wet_bulb_risk
20%humidity_heat_stress
15%duration_of_heat
10%vulnerable_time_window

Required inputs

  • temperature 2 m / apparent temperature (°C)
  • relative humidity (%)
  • wet-bulb temperature (°C, provider or Stull estimate)

Optional inputs

  • wind speed (km/h), cloud cover (%)
  • UV index
  • heat duration (hours ≥ 32 °C apparent, next 24 h)

Missing optional inputs drop their formula term (weights renormalize) and reduce confidence — the engine never crashes or invents data.

Decision modes

normal
Normal

No elevated heat stress indicated.

heat_watch
Heat watch

Elevated heat load — hydrate and pace outdoor work.

heat_stress
Heat stress

Sustained heat stress — limit exertion during peak hours.

dangerous_heat
Dangerous heat

Wet-bulb/apparent temperatures approach physiological limits.

insufficient_data
Insufficient data

Not enough thermal data to assess heat stress.

Limitations

Model card

HeatShield is a self-built TerraSentinel engine: external providers supply live environmental variables; the score, mode, confidence, explanation and actions above are computed by this project’s own documented model. Provider risk indexes are used only as benchmark references and never as the output. API: GET /api/engines/heatshield/run?lat=&lon=

TerraSentinel is a decision-support tool and does not replace official emergency services, government warnings, or professional environmental management decisions.