Repository navigation
v1.0.0
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.