Waterline
What this page is, and what came before it

Waterline began as a plan for the Gemini 4 Argon hackathon in San Francisco on October 25, 2026. The build-day demo was written beforehand to guide a day of building with Google Antigravity and Gemini 4 Argon, and the thing to be built that day was this city-manager site. The build day didn't happen for Waterline, so the demo's descriptions of what Argon agents did are a plan, not results.

This page is the finished city-manager site, built afterwards with Claude Code. No AI model runs here: every number is computed in your browser from the public data listed under Method.

San Francisco · next two weeks

Do we need to do anything this week?

Loading NOAA data…
—
—Gauge right now vs prediction, ft (CO-OPS 9414290)
—30-day mean anomaly, ft: the El Niño / Kelvin-wave baseline
—Highest high in 15 days with the anomaly added, ft MLLW
—NWS rain forecast, next 7 days, inches (17th & Folsom)

Daily high tide and rain, 15 days

NOAA predicted high (official) + today's 30-day anomaly (derived: assumes it holds) NWS rain, inches (official, about 7 days out)

Thresholds are NOAA's for station 9414290 in ft above MLLW: NWS minor 7.04, NOS minor 7.71, NOS moderate 8.64, NOS major 9.91. The plaza in front of the Ferry Building sits near 10.2 ft (USGS lidar). Storm surge and wind setup are not in this chart: a storm adds to these numbers.

Where water collects

The 50 worst street low spots and the 500 drains that matter most

From a 5 m lidar bare-earth model. Drains are ranked by how deep the nearest street bowl gets and how much ground drains to the grate. Low spots are ranked by how much water the bowl holds, past 311 flooding reports within 150 m, and whether it's inside the city's 100-year flood zone. It ignores the pipe network, so it says where to look first, not how deep it will flood.

Low spots, worst first

#PlaceDepth mArea m²311 within 150 mSFPUC zone

Street drains by crew zone

NeighborhoodStreet drains in top 500

Download the 500 drains (CSV)

Prep list

What to do before the next high-tide window

Generated from the forecast above and the city data. It changes when NOAA's forecast changes.

Draft

A briefing you can edit and send yourself

Waterline never sends anything. This is text for a person to check, change and send through the city's own channels.

Method, sources, limits

How the numbers are made

Tide. NOAA CO-OPS high/low predictions for San Francisco (9414290), 15 days. The anomaly is the mean of observed minus predicted water level over the last 30 days, fetched live. Adding it to each future high assumes the anomaly holds; this October it has run near +1 ft because of the El Niño Kelvin wave.

Rain. National Weather Service gridpoint forecast for the cell over 17th & Folsom (MTR 85,105): quantitative precipitation, split by hour and summed per Pacific day.

Low spots and drains. USGS 3DEP lidar of San Francisco, resampled to a 5 m bare-earth model. Priority-flood fill finds the street bowls; D8 flow routing finds how much ground drains to each of the city's 23,835 inlets. Drains are scored by the depth of the nearest bowl (capped at 1.5 m) times the log of the area they collect. Low spots are scored by bowl volume, past 311 reports within 150 m and SFPUC 100-year zone membership, so they are not an independent check against either. The top 500 sit near 9.7 past 311 flooding reports each within 75 m, against 6.1 for all inlets. Drains in pits deeper than 2 m (underpasses, stairwells) are marked for a person to verify rather than sent to a street crew.

Limits. This is a screening model, not a hydraulic model like HEC-RAS: no pipes, no pumps, no backflow, no wind. It points at where to look first. It is not an official alert: follow AlertSF and the National Weather Service.

Sources