SHORE dashboard
Live portal for the Shellfish Hardening & Organismal Resilience Experimentation Center (Roberts Lab, UW).
Published at https://robertslab.github.io/shore-line/.
| Widget | Source | Refresh |
|---|
| Live Tankcams | gannet v1_web/webcam/latest.jpg and v1_web/webcam_02/latest.jpg (Last-Modified header), plus live HLS video from v1_web/webcam_03/stream.m3u8 (native HLS, else hls.js; hls.js needs gannet to send CORS headers) → data/webcam.json | site rebuild every ~10 min; page re-polls every 60 s |
| Puget Sound water temp | NOAA CO-OPS (Tacoma 9446484, fallback Port Townsend) → data/field-water.json + assets/water-banner.svg | every rebuild |
| Water-quality reports + per-tank readings | genefish RSS (Jesse Lowe) → data/reports.json | every rebuild |
| Facility temperatures | data/tanks.json (setpoint); one card, the Seneye Tank (Left Blue), live from a seneye → seneye-data branch → data/seneye.json; plus one card per DS18B20 probe on the ESP32 hubs, from Gannet's raw CSVs (SHORE_temps/data/raw/<hub>/) → data/shore-temps.json (names in tanks.json → probes) | seneye every 15 min; probes every rebuild |
| Research from SHORE | data/research.json (hand-curated) | — |
How it works
A static site (index.html, css/, js/) with no build step.
.github/workflows/site.yml runs every 10 minutes. It fetches the live sources with the stdlib-only scripts in scripts/, writes the results into _site/, and deploys to GitHub Pages. Fetched data is not committed. If a source is down, the script republishes the copy that is currently live and marks it with an error, and the status dot for that feed turns amber or red.
Seneye (Left Blue tank)
The Seneye Web Server sits on a private UW address (172.25.149.26), which GitHub can't reach. So scripts/collect_seneye.py runs on a machine inside the network. It decodes the SWS WebSocket state, which has no JSON API, and keeps a 14-day series. scripts/seneye_publish.sh force-pushes that file as a single commit on the seneye-data branch. The site build mirrors it from the SENEYE_URL repo variable.
- Currently runs on: sr320's Mac, via launchd every 15 min. It only collects while that Mac is on and on the UW network. Log:
/tmp/shore-seneye.log.
- Install / update (after editing either script):
scripts/install_seneye_agent.sh
- Uninstall:
launchctl unload ~/Library/LaunchAgents/com.robertslab.shore-seneye.plist
- Moving to gannet later: run
seneye_publish.sh from cron there. Alternatively, write the JSON to a web-served path and point SENEYE_URL at it.
- Device limits: the SWS allows one WebSocket client at a time, so the collector retries if someone has the device's page open. When the chemical slide is missing or expired, the device reports pH/NH₃ as 0. The collector publishes
null for those instead.
Common edits
- Feature a paper: add an object to
items in data/research.json (featured: true puts it in the top cards, max 3). Remove the placeholder entry once there's a real one.
- Tank list / setpoints: edit
data/tanks.json. Set status to anything other than placeholder and fill latest / series when a logger feed exists.
- Change feeds: env vars
WEBCAM_URL, REPORTS_FEED, SITE_LABEL.
Run locally
python3 scripts/update_webcam.py && python3 scripts/update_reports.py && python3 scripts/update_field_water.py
python3 -m http.server 8320
Then open http://localhost:8320. update_field_water.py --demo uses synthetic data when you have no network.
See PLAN.md for the roadmap.
