HAAM product edition · What I breathed, next to the city
Air
I carry an Atmotube. HAAM Air joins those personal PM2.5 hours to ECMWF CAMS city background, with travel stays filling the gaps where GPS drops. Compare is PM2.5 only. Hours without a city background are omitted.

Target interaction specification
Air
Was the air around me different from the city background at the same place and hour?
Air may compare personal and ambient PM2.5 only when metric, place, and time align. Missing or unresolved matches must remain missing, every ambient value must expose its source and age, and the product must not turn an exposure difference into a medical conclusion.
Case-study thesis
What the finished product should prove.
This is the behavior to build toward. The implementation receipts below remain the record of what exists today.
The interaction problem is joining two imperfect worlds without hiding the gaps: a wearable that knows what was near the body and a city model that knows the background around a place.
State model
The interface has to make these states real.
If two states would look identical to the person, the implementation is not finished.
No personal data
The interface explains the required export and what will happen before asking for a file.
Parsing
Valid, rejected, duplicate, and outlier rows are counted visibly.
Place unresolved
An hour has a measurement but no trustworthy location, so comparison waits.
Matched
Personal and ambient PM2.5 share the same hour and place context, with both sources visible.
Unmatched
A personal hour has no ambient counterpart and remains visibly outside the comparison.
Stay corrected
A travel stay supplies location context for a GPS-less window and recomputes affected hours.
Source detail
The person can inspect raw personal value, ambient source, model or station, location basis, and timestamp.
Stale or failed
Unavailable ambient data, failed fetch, or stale background is represented directly rather than interpolated without disclosure.
Edge cases
The boring failures are part of the product.
- The wearable has PM2.5 but no GPS
- A flight or timezone change creates ambiguous local hours
- Indoor exposure is much higher than the outdoor city background
- The Atmotube export contains duplicates or outliers
- CAMS has no value for the hour
- A station and model disagree
- A travel stay is corrected after comparison was already viewed
Definition of done
The future case study needs these receipts.
- Clicking an compared hour reveals the personal measurement, place basis, ambient source, timestamp, and any filtering applied
- Hours without a valid ambient match are excluded or marked unmatched, never silently estimated
- Editing a travel stay visibly changes only the hours affected by that place correction
- The comparison remains PM2.5 to PM2.5 instead of mixing AQI systems
- No view converts a personal-versus-city difference into diagnosis, risk score, or treatment advice
compare metric
PM2.5Not AQI. The join skips hours without a city background.
city background
CAMSECMWF CAMS via Open-Meteo. Source labelled on the hour.
Atmotube export
CSVParser handles aliases and outliers. Fixture tests in air-core.
personal tool
Liveair.haam.co is the published web dashboard. Observed use is personal.
The job
Put my hour next to the city’s hour.
A wearable PM2.5 number without a matched city hour is hard to read. I wanted the two series on the same clock, with the source labelled, and with travel stays filling GPS-less windows.
The compare
Parse the CSV. Place the hours. Join the city. Read the gap.
01
Parse the export
Atmotube CSV aliases and outliers are handled in air-core. Fixture tests cover parse without live APIs.
02
Place the hours
GPS points fall into place boxes. Travel stays fill windows where the wearable has no fix.
03
Join the city
Each personal hour looks up CAMS background for that place. Hours without ambient are omitted from compare.
04
Read personal versus city
The dashboard shows the two PM2.5 series hour by hour, with CAMS or optional station labelled as the city source.
Design decisions
Decisions.
Metric
Compare stays on PM2.5.
AQI would have mixed pollutants and indexes. I kept one particle measure so personal and city hours are actually the same quantity.
Place
Stays interview the gaps GPS cannot fill.
Travel windows without a fix still need a city. The stays flow is how those hours get a place box instead of disappearing from the join.
Canonical surface
The web dashboard is the product.
Parser, places, and join live in air-core so the web app is not a one-off script. Expo and Streamlit are companions. OpenAQ station overlay is optional and not claimed as production-verified.
The working stack
Built with.
Core
air-core
CSV parse, place boxes, hourly join. pnpm test against fixtures.
Ambient
Open-Meteo CAMS
ECMWF city PM2.5 background. Optional OpenAQ overlay undocumented as production.
Account
Clerk + Supabase + Blob
Signed-in CSVs and stay windows on the live host. Secrets gitignored.
Host
air.haam.co
Published personal tool. Web is canonical.
In evidence
Evidence.
01Personal Atmotube hours sit next to CAMS city hours
02The join is tested without live APIs
03Travel stays can fill GPS-less gaps
04Hours without city background are omitted from compare
Where it stops
Personal use, one particle, no medical reading.
There is no medical interpretation and no live AQI compare. Observed use is personal, not a public multi-user study.
Expo and Streamlit are companions. Accessibility is not recorded in this pass. Do not call it a city-wide air-quality product.
HAAM’s role
I wanted my hours next to the city’s hours.
PM2.5-only compare, stays interview, HAAM chrome, air-core join, web app, and the live host wiring. Direct work, 2026.
Help improve this website?
Optional analytics. Google Analytics and Clarity load only if allowed; form, email, and chat content are excluded.