trails-cool/trails
1
1
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
trails/openspec/changes/elevation-profile-hardening/tasks.md
Ullrich Schäfer 5dd4968626 docs+openspec: prior-art research (Organic Maps, Endurain, wanderer) and 15 proposals 
Add docs/inspirations.md as the durable record of the 2026-07-05/06
prior-art research — per-project learnings with source paths, canonical
credit lines, and the changes each spawned — and extend the
acknowledgment lists in philosophy.md/architecture.md (Organic Maps,
Endurain, wanderer).

New OpenSpec changes (proposal/design/specs/tasks each):
- Organic Maps: elevation-profile-hardening, gpx-parser-robustness,
  hiking-time-estimate, poi-index, hiking-foot-profile
- Endurain: account-export, activity-duplicate-review,
  fit-parsing-hardening, activity-locations, self-hosting-guide,
  activity-privacy-controls
- wanderer: federation-hardening, link-share-tokens
- credits-page (user-visible acknowledgments)

Updated in-flight changes with wanderer prior-art sections:
route-federation, route-discovery.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-06 07:23:00 +02:00

2.1 KiB
Raw Blame History

1. Cleaning primitives

  • 1.1 Create packages/gpx/src/elevation-clean.ts with despike(points, opts?) — opposite-sign slope-outlier detection (default MAX_SLOPE_PERCENT = 100) with linear interpolation, operating per segment on { distance, elevation } sequences
  • 1.2 Add filteredTotals(points, opts?) to the same module — hysteresis accumulator (default NOISE_THRESHOLD_M = 5) returning { gain, loss, gainRaw, lossRaw } with the raw-fallback rule (filtered zero + raw non-zero → report raw)
  • 1.3 Add cumulativeFilteredTotals(points, opts?) returning per-point running filtered ascent/descent arrays (for per-day splits)
  • 1.4 Write elevation-clean.test.ts: isolated spike interpolated; steep monotonic climb untouched; no cross-segment interpolation; ±2 m jitter → 0 totals; multi-leg climb counted fully; near-flat raw fallback; cumulative arrays sum to totals

2. Wire into existing computations

  • 2.1 Update computeElevation in packages/gpx/src/parse.ts to despike per segment, then use filteredTotals; keep gain/loss/profile shape and expose gainRaw/lossRaw as additional fields (profile built from despiked data)
  • 2.2 Update elevationSeries in packages/gpx/src/elevation-series.ts to build from despiked points (despike per segment before flattening)
  • 2.3 Update compute-days.ts to build its cumulative ascent/descent arrays via cumulativeFilteredTotals over the despiked track
  • 2.4 Update/extend existing tests (parse.test.ts, elevation-series.test.ts, compute-days.test.ts) with a shared noisy-track fixture; assert chart series, totals, and day sums agree

3. Verification

  • 3.1 Confirm no consumer changes needed: typecheck journal + planner; spot-check gpx-save.server.ts, detail loaders, and planner computeDays usage compile and behave
  • 3.2 Manual sanity check: parse a real noisy activity GPX (e.g. an existing import fixture) and compare gain before/after — filtered value should drop noticeably and match the chart
  • 3.3 Run pnpm typecheck && pnpm lint && pnpm test and the journal/planner e2e suites