diff --git a/CoolCity-Hackathon-Report.pdf b/CoolCity-Hackathon-Report.pdf index 5bc619e..099b1d1 100644 Binary files a/CoolCity-Hackathon-Report.pdf and b/CoolCity-Hackathon-Report.pdf differ diff --git a/main.md b/main.md index e765240..a29fbfd 100644 --- a/main.md +++ b/main.md @@ -3,11 +3,11 @@ **Author:** Noel Sabia (ORCID 0009-0008-3064-7573) **Affiliation:** — **Date:** 14 November 2026 -**Prototype:** https://pulse.noelsabia.dev · **Cool City route:** `/cool` · **DOI:** TBD +**Prototype:** https://pulse.noelsabia.dev · **Cool City:** live at https://pulse.noelsabia.dev/cool (`/cool/stage`, `/cool/city`; image v1.3-cool, commit `d908c32`) · **DOI:** not assigned ## Abstract -Heat is a measurable public-health threat, and Heilbronn already knows where its cool places are, but not how a person reaches them. Cool City is a public heat-safe route built on the existing eight-sensor pulse. A weather-aware global model forecasts the relative footfall index, reaching MAE 3.32, WAPE 27.5%, and R² 0.777 on a 28-day holdout versus 5.40, 44.7%, and 0.462 for a seasonal-naive baseline. On a clear 35.0 °C day (14 August 2026), the route layer combines OpenStreetMap walkable ways, the city tree cadastre, and solar geometry to model three routes from Stadtgalerie to Marktplatz: shortest 359.5 m / 4.8 min, shaded 732.3 m / 9.8 min, and accessible 438.2 m / 5.8 min. At 16:00 the accessible route is recommended for Ruth: 43.8% modeled shade, 3.3 direct-sun minutes, no ramp, and water and benches. The shaded route has a higher shade share (50.0%) but, being twice as long, more direct sun (4.9 min); shade share alone is misleading. A relative socio-spatial screening index ranks the eight 300 m catchments with weights 0.40 footfall, 0.30 shade deficit, 0.20 access deficit, and 0.10 vulnerability; Hagenbuchersee 2 ranks first (0.6471). Vulnerability is the 17.26% 65+ share of Heilbronn Innenstadt (31.12.2016) and is constant across all eight, so it does not differentiate them. Shade is modeled, the screening index is relative rather than a measured heat map, and the pulse is estimated devices, not people. +Heat is a measurable public-health threat, and Heilbronn already knows where its cool places are, but not how a person reaches them. Cool City is a public heat-safe route built on the existing eight-sensor pulse. A weather-aware global model forecasts the relative footfall index, reaching MAE 3.32, WAPE 27.5%, and R² 0.777 on a 28-day holdout versus 5.40, 44.7%, and 0.462 for a seasonal-naive baseline. On a clear 35.0 °C day (14 August 2026), the route layer combines OpenStreetMap walkable ways, the city tree cadastre, and solar geometry to model three routes from Stadtgalerie to Marktplatz: shortest 359.5 m / 4.8 min, shaded 732.3 m / 9.8 min, and accessible 438.2 m / 5.8 min. The route UI is live at https://pulse.noelsabia.dev/cool (`/cool`, `/cool/stage`, `/cool/city`; image v1.3-cool). At 16:00 the accessible route is recommended for Ruth: 43.8% modeled shade, 3.3 direct-sun minutes, no ramp, and water and benches. The shaded route has a higher shade share (50.0%) but, being twice as long, more direct sun (4.9 min); shade share alone is misleading. A relative socio-spatial screening index ranks the eight 300 m catchments with weights 0.40 footfall, 0.30 shade deficit, 0.20 access deficit, and 0.10 vulnerability; Hagenbuchersee 2 ranks first (0.6471). Vulnerability is the 17.26% 65+ share of Heilbronn Innenstadt (31.12.2016) and is constant across all eight, so it does not differentiate them. Shade is modeled, the screening index is relative rather than a measured heat map, and the pulse is estimated devices, not people. ## 1. Problem @@ -116,7 +116,9 @@ The existing staffing plan remains a separate module. The same forecast schedule **City-level screening.** The eight catchments score from 0.6471 (Hagenbuchersee 2) to 0.2660 (Density 01). Ranks 1 and 2 are a co-priority (0.0165 apart, 2.5%), and the top-3 set is stable under the tested weight variants. The sensitivity analysis shows the screening is not decision-grade for individual positions 2–3 under shade-heavy weights, but the top-3 priority set is stable. This is a **relative socio-spatial screening index over eight inner-city catchments**, not a citywide neighbourhood ranking and not a measured heat map. -**System metrics.** The inherited SSE path was measured at **120/120 connections opened and closed, zero errors, p95 event 331 ms, p95 scenario 646 ms, presenter POST 49.60 ms, over 4m57.9s** on v1.1. The Cool City route page and vote endpoint are new: their latency, vote tally accuracy, and stage behavior are **TBD**. The retail plan module’s cold generation is 19 ms; that number belongs to the retail module, not the route layer. +**System metrics.** The inherited SSE path was measured at **120/120 connections opened and closed, zero errors, p95 event 331 ms, p95 scenario 646 ms, presenter POST 49.60 ms, over 4m57.9s** on v1.1. The retail plan module’s cold generation is 19 ms; that number belongs to the retail module, not the route layer. + +**Live deployment.** The Cool City UI is live at **https://pulse.noelsabia.dev/cool** (commit `d908c32`, image v1.3-cool). Ten requests per endpoint from one presenter machine through Cloudflare gave `/cool` **median 291 ms, p95 431 ms**; `/cool/stage` **median 146 ms, p95 179 ms**; and `/cool/city` **median 140 ms, p95 165 ms**. The vote endpoint accepted **20/20 POSTs with 201**, with **median 100 ms and p95 382 ms**; the tally was exactly **6 shortest / 7 shaded / 7 accessible**; a duplicate session returned **200** and did not double-count; reset cleared to **0**. This is a **single-client, Cloudflare-mediated measurement, not a concurrency or load test**. The inherited SSE metrics above are a separate path and are not combined with these numbers. **Comprehension test plan.** A small task-based test with older adults and caregivers will ask participants to (1) choose a route for Ruth at 16:00, (2) explain why it is cooler or more accessible, (3) compare the 10:00 and 16:00 recommendations, and (4) find water, benches, and step-free access. The sample, recruitment, and results are **TBD**; this is a plan, not a completed study. @@ -125,14 +127,14 @@ The existing staffing plan remains a separate module. The same forecast schedule | Route | Shade 43.8–50.0%, direct sun 2.7–4.9 min at 16:00, detour 0 to +103.7%, stops, steps | Measured on frozen bundle | | Screening | Score 0.2660–0.6471; top-3 stable; ranks 1–2 co-priority; vulnerability constant | Ranked; sensitivity run | | System | SSE 120/120, p95 event 331 ms, p95 scenario 646 ms, presenter 49.60 ms | Measured on inherited v1.1 path | -| Vote / route page | Open success, tally accuracy, route render latency | TBD | +| Live UI / vote | `/cool` 291/431 ms; `/cool/stage` 146/179 ms; `/cool/city` 140/165 ms (median/p95); vote 20/20 201, 100/382 ms, tally 6/7/7 | Measured; single client via Cloudflare | | Comprehension | Task success, explanation quality, route preference | Plan only; TBD | *Table 4. Evaluation status. Shade is modeled; the screening index is relative and socio-spatial; no temperature or causal claim is made.* ## 5. Privacy and limits -Cool City uses aggregate device counts only. It does not store MAC addresses or PII, does not require accounts, and does not upload a visitor’s location. The audience vote is aggregate; a random session ID in local storage is enough. A production deployment needs a DPIA and a documented legal basis before collecting MAC-derived counts, with the city as controller and a legal review before launch. The existing index is estimated devices, not people; device penetration is unknown; the 0.7 factor is unvalidated; and only 28.2% of 15-minute slots in the 18 June panel have all eight sensors. +Cool City uses aggregate device counts only. It does not store MAC addresses or PII, does not require accounts, and does not upload a visitor’s location. The audience vote is aggregate; a random session ID in local storage is enough. A production deployment needs a DPIA and a documented legal basis before collecting MAC-derived counts, with the city as controller and a legal review before launch. The existing index is estimated devices, not people; device penetration is unknown; the 0.7 factor is unvalidated; and only 28.2% of 15-minute slots in the 18 June panel have all eight sensors. The live latency figures come from a single presenter machine through Cloudflare, not a concurrency or load test. The route layer has its own limits. Shade is modeled from buildings and tree crowns, not measured with radiometers. **445 of 854 main building footprints use type-default heights** (the 12 m default alone covers 314), tree heights are inferred from crown diameter, the model is 2D in plan view, and clear-sky geometry ignores clouds, awnings, facade reflections, and indoor shade. The bundle flags the **42.6% shade / 5.6 direct-sun minutes for the shaded route at 14:00** as its least-certain value. OSM is a 14 November 2026 snapshot, not an official city dataset; benches, water, toilets, and kerb tags may be incomplete; step-free status comes from tags, not a field survey; the accessible route’s last 34 m is cobblestone; and the Deutschhof courtyard is an out-and-back. The route metrics are suitable for comparing options, not for safety or medical advice. @@ -146,13 +148,10 @@ The next step is a city-owned public trust: the city controls the route and scre | Item | Why it is TBD | Next step | |---|---|---| -| `/cool` route deployment | The bundle is frozen, but the live page and its fallback were not verified for this paper | Verify the deployed `/cool` page, failure state, and data version | -| Vote / route-page latency | New endpoint not measured | Run the same k6/SSE protocol; report open success, tally accuracy, and p95 | | Comprehension test | Plan only; no participants yet | Recruit older adults/caregivers with the city; publish tasks and results | | Field verification of tags and surfaces | Step-free status, kerb/ramp, water, bench, and toilet tags are OSM-based, not surveyed; the accessible route’s last 34 m is cobblestone | Walk all three routes; check the 15% ramp, the tunnel, and the toilet tags | | Field validation of modeled shade | Clear-sky 2D geometry with default building heights and inferred tree heights | Radiometer transects on the same routes; compare modeled and measured direct sun | | Production licence for city-map layers | The official cool-place, toilet, and water layers have no explicit open-data licence | Confirm permission with the city before production | -| DOI | Event draft has no DOI yet | Mint on Zenodo after the event | *Table 5. Open items. These are deliberately not filled with plausible-looking numbers.*