Skip to content

v1.0.0

Choose a tag to compare

@AlanBacker AlanBacker released this 03 Nov 19:53
· 4 commits to main since this release

First release of the audio fly-over geolocation skill: estimate where a recording was made from the Doppler curves of aircraft audible in the background, matched against ADS-B track history.

Downloads

File Language
audio-flyover-geolocation-en.skill English
audio-flyover-geolocation-zh-CN.skill 简体中文

Both packages share the same tested Python pipeline (scripts/); only the instructions and references are translated.

Claude Code: unzip into ~/.claude/skills/ (or copy skills/<lang>/audio-flyover-geolocation/ from this repo), then pip install numpy scipy matplotlib.
Claude apps: upload the .skill file in the Skills section of settings, with code execution enabled.

What's in it

  • Spectrogram → harmonic ridge tracing → Doppler fit (closest-approach time, speed, miss distance) with a split fit and clock-offset mask
  • ADS-B ingest for OpenSky / ADS-B Exchange / CSV exports, corridor → CPA → timing → silence search funnel
  • Joint scoring of two or more fly-overs with a shared clock offset, hill-climb refinement, a 0.9 confidence region and plateau / mirror / geometry warnings
  • Blind synthetic self-test (afg_cli.py selftest) and a report template

Self-test results (blind, synthetic)

Seed Two events ±2 s, turning pass ±2 s, straight pass
7 24 m 23 m mirror (flagged)
11 477 m (3° crossing, inside 849 m region) 35 m mirror (flagged)
23 46 m 79 m 162 m
42 31 m 86 m 206 m
101 53 m 48 m 213 m
2026 25 m 96 m 6 m

With ±30 s clock uncertainty and one pass, the result is a 2.1–4.8 km strip that contains the truth in every seed.

Real recordings are harder than synthetic ones: wind, reflections, engine-tone drift and incomplete ADS-B coverage all widen the region. See the README's limitations and responsible-use sections before relying on a result.