Paddling Out
Methodology

How the Paddle Score Works

The actual pipeline, the actual thresholds — nothing here is aspirational

The Score

Every spot gets a single number from 1.0 to 5.0, computed fresh when you load a forecast. Scores snap to half-point steps (3.0, 3.5, 4.0…) and are clamped to the 1–5 range. One question is being answered: how favorable are conditions for paddling right now?

4.5

Worth it

Union — Seattle, Washington

💨 Wind and gusts within limits 🌡️ Air and water in comfortable range

Example card — production styling.

ScoreVerdictMeaning
4.0 and upWorth itConditions are favorable for most paddlers.
3.0 – 3.5CarefulMixed conditions. Check the details before heading out.
Below 3.0Hard passConditions are poor. Postpone if possible.

Displays shade continuously through seven bands rather than three flat colours — a 4.5 is visibly better than a 4.0:

<2 2+ 2.5+ 3+ 3.5+ 4+ 4.5+

The exact colour stops the forecast pages use.

The score is a starting point, not a green light. A “Worth it” score does not mean conditions are safe for every paddler in every craft. Always apply your own judgment.

The 3-Day Heatmap

Forecast pages score every daylight hour (6 AM to 8 PM) for the next three days and blend them into one band per day, so you can pick your launch hour instead of just your day. This is not a mock-up — the component below is the forecast page’s heatmap, rendering a live 3-day outlook. Tap a bar to open an hour:

Fetching a live 3-day forecast…

Rendered by the production Heatmap component.

Data Sources

Weather comes from WeatherAPI.com — three feeds fetched in parallel for every score: current conditions, a 3-day hourly forecast with government weather alerts, and marine data (wave height, swell, water temperature) where the location has coverage.

Where a value is missing it is estimated conservatively or omitted — never silently defaulted to a flattering number.

The Pipeline

Each score passes through six stages, in this order:

StandardizeRaw feeds are normalized into the model’s units — MPH wind, °C temperatures, km visibility — with real values passed through, not defaults.
PredictA gradient-boosted regression model (scikit-learn GradientBoostingRegressor, served on Cloud Run) trained on paddler ratings paired with the weather at the time of each paddle produces the base score.
CalibrateBounded adjustments refine the base: water-temperature reality check, the next six forecast hours (improving or deteriorating trend), season, location profile, and wind-pattern analysis.
PenalizeHard safety rules subtract points for conditions the model should never be allowed to talk its way around — the full table is below.
Apply the lake’s offsetIf your ratings show the model runs hot or cold on a specific lake, that lake’s stored bias offset is added here.
Clamp & snapThe result is clamped to 1–5 and rounded to the nearest half point.

If the model service is unreachable, a rule-based fallback produces the score from the same inputs — starting at 3.0, rewarding calm wind (+0.8 under 5 mph) and comfortable temperatures (+0.3 for 18–30°C), and subtracting for strong wind (−1.2 over 20 mph), active warnings (−0.8), high UV and poor visibility. Fallback scores are marked with lower confidence.

Hard Limits

After calibration, safety rules subtract points the model is never allowed to argue back. Most are small nudges for gusts, waves, heat, UV, visibility and rain — but a few are worth calling out, because they can sink an otherwise perfect day on their own:

Crowd-Sourced Calibration Beta

This loop is in beta — ratings are being collected and validated now, and per-lake offsets are applied conservatively while the sample grows.

The model’s labels came from people, and its corrections do too. When paddlers rate a real session, that rating flows back into the system:

Anti-abuse, concretely: one rating per device fingerprint per spot per day, with a two-hour window to revise your own submission, plus IP-based daily rate limits. The fingerprint exists to stop ballot-stuffing, not to identify you — no account, no name, no email.

Safety — Read This

Wear a life jacket. Every time, every body of water, regardless of what the score says. A PFD (personal flotation device) is the single most effective thing you can do to stay safe on the water.

Limitations

The score is a decision aid, not a guarantee. Things we cannot measure or predict:

The Paddle Score supplements your judgment — it does not replace it. When in doubt, don't go out.

Terms of Use

By using Kaayko Paddling Out, you acknowledge and agree to the following: