HeatWise

Plan outdoor practice and work around the heat, hour by hour.

See the plan HeatWise would have given a coach on the day Houston hit 109°F, built from that day's archived weather reports. A historical replay, not a forecast.

1. Where

2. What and who

UIL's WBGT map puts the Houston area and most of Texas in Class 3; parts of West Texas and the Panhandle are in lower classes. If you're not sure, check your district's heat plan.

How the math works

  1. Forecast: for U.S. places, hourly air temperature, humidity and wind come from the National Weather Service gridded forecast (api.weather.gov, the same grid behind the NWS heat index and WBGT forecasts); sunshine (solar radiation) and pressure come from Open-Meteo, because the NWS grid has none. Outside the U.S., or if the NWS does not answer, every input comes from Open-Meteo. Both are free with no key, and the plan says which source it used.
  2. WBGT in the sun (wet-bulb globe temperature, the heat-stress index used by OSHA, NIOSH, the military and Texas UIL) is estimated with the Liljegren et al. (2008) physics model: it solves the heat balance of a black globe and a wet wick using the sun's angle, sunshine, wind, humidity and temperature, then WBGT = 0.7·Tnwb + 0.2·Tg + 0.1·Ta. HeatWise's JavaScript port is tested against the open-source reference implementation (pywbgt) to within 0.05 °C. If sun or wind data are missing it falls back to the simpler Bureau of Meteorology formula WBGT ≈ 0.567·T + 0.393·e + 3.94.
  3. Texas UIL mode: the WBGT is compared with UIL's WBGT activity flags (Class 3: green < 82.0 °F, yellow 82.0–86.9, orange 87.0–90.0, red 90.1–92.0, black ≥ 92.1; Class 2 thresholds are 79.7 / 84.7 / 87.7 / 89.8 °F), and HeatWise shows UIL's practice limits for each flag.
  4. Work mode: effective WBGT = WBGT + clothing factor (OSHA/NIOSH: 0 to +11 °C), compared with the OSHA/NIOSH limit for the workload: light 28/30 °C, moderate 25/28, heavy 23/26, very heavy 21/25 (unacclimatized/acclimatized). HeatWise's ±2 °C bands around that limit are its own design choice.
  5. Safest window: among every run of consecutive allowed hours, pick the one whose worst hour is coolest (a minimax problem), solved in O(n) with a sliding-window maximum.
  6. Heat index (shade, shown for familiarity) uses the NWS Rothfusz regression.

Sources: UIL Heat Stress & Athletic Participation Plan · OSHA Heat Hazard Recognition · NIOSH Workplace Recommendations · OSHA First Aid · NWS Heat Cramps, Exhaustion, Stroke · Liljegren et al. 2008 · BoM Thermal Stress · NWS Heat Index · NWS API (api.weather.gov) · Weather data by Open-Meteo.com (CC BY 4.0)

HeatWise is a planning and screening tool, not medical advice. Forecasts are not on-site measurements; OSHA recommends a WBGT meter at the site for the most accurate assessment.

Validation: does HeatWise agree with the National Weather Service?