Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)
Python acoustic-geolocationads-baircraft-trackingairplaneaudio-forensicsdoppler-effectdoppler-shiftgeolocationosintsignal-processing
Record real site-named audio screening leads
Cinna Daviseb4b9ad0e79a
diff --git a/benchmarks/site-leads-real-scan-20261103.csv b/benchmarks/site-leads-real-scan-20261103.csvnew file mode 100644index 0000000..a13c356--- /dev/null+++ b/benchmarks/site-leads-real-scan-20261103.csv@@ -0,0 +1,30 @@+id,url,title,site_name,site_reference,location_basis,initial_status,retry_status,status,duration_s,proposal_groups,ridge_records,sha256,visual_assessment,review_evidence,initial_failure,latest_failure+k9UT7VaQkEU,https://www.youtube.com/watch?v=k9UT7VaQkEU,Plane Spotting At Gravelly Point Near DCA,gravelly-point,https://www.nps.gov/places/000/gravelly-point.htm,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,53acedda28271ad7acfb5491c3059ce2d6f4d4e7002258f9b2170d82804866bc,not_reviewed,,,+sSGHbSTOACY,https://www.youtube.com/watch?v=sSGHbSTOACY,A Secret Spot for Watching Airplanes Take Off | Gravelly Point | 4K,gravelly-point,https://www.nps.gov/places/000/gravelly-point.htm,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,1,1,0c4012b2ec35b235b1299f182e6d9cc951ac89e0b9c0e94382a67121ab80523b,ambiguous,Low-frequency descending proposal in complex noise; its physical source is not established.,,+t2U05D3cF3M,https://www.youtube.com/watch?v=t2U05D3cF3M,We Went Plane Watching at Gravelly Point Park in VA,gravelly-point,https://www.nps.gov/places/000/gravelly-point.htm,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,167.0135,0,0,ed4f730ce449ea958622982a2ab0759a00e146866a3e2255b79e766e587d34e1,not_reviewed,,,+_Eq5BqlECUk,https://www.youtube.com/watch?v=_Eq5BqlECUk,"Airplanes at Gravelly Point Park | Washington, D.C | Arlington Virginia, USA",gravelly-point,https://www.nps.gov/places/000/gravelly-point.htm,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,73.0135,0,0,448bc00e7d619a70ab98e708c0a57d58551b0eb8c30fe1286ddadee2ef9a5bc4,not_reviewed,,,+DyFAo59k2cg,https://www.youtube.com/watch?v=DyFAo59k2cg,A Special Spotting Day at Gravelly Point,gravelly-point,https://www.nps.gov/places/000/gravelly-point.htm,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,88.65375,0,0,8e28083947f55c11b1e980ed7f18c7e775e0619bb985be1bbab78f366caa5c41,not_reviewed,,,+V5mSVhz3Ry8,https://www.youtube.com/watch?v=V5mSVhz3Ry8,Spotting at LAX - In-N-Out on Sepulveda,lax-in-n-out,https://locations.in-n-out.com/117,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,0e87537b6d91815d91d170a6a514183f5ebfa7a3dfa46d0fc71f3b78fe010eeb,not_reviewed,,,+P5Xk61T4q5c,https://www.youtube.com/watch?v=P5Xk61T4q5c,LAX PLANE SPOTTING AT IN-N-OUT BURGER [4K VIDEO],lax-in-n-out,https://locations.in-n-out.com/117,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,113.0135,0,0,bc109dd8d716b12e85fab2b444c3f704290ea17373c09a7bc84e954e0359335d,not_reviewed,,,+L62WWUGK5nE,https://www.youtube.com/watch?v=L62WWUGK5nE,Planes Landing Right Above Us at Gravelly Point Park! ✈️🔥 | Washington DC Spotting,gravelly-point,https://www.nps.gov/places/000/gravelly-point.htm,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,4537fdb0685f3f6cf9001208ce5fbb2db244aaffabbfb86a085f548e73a5f5a1,not_reviewed,,,+-3w4h5Tgznc,https://www.youtube.com/watch?v=-3w4h5Tgznc,Los Angeles International Airport (Sepulveda In-and-Out) Plane Spotting KLAX Sept 2007,lax-in-n-out,https://locations.in-n-out.com/117,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,6a51b6d56a1a912ae4410c12e00930b40bc75e3c04e67d1bad1183727494dd2b,not_reviewed,,,+Ri8dQWcn9hc,https://www.youtube.com/watch?v=Ri8dQWcn9hc,LAX Sepulveda In N Out Burger Plane Spotting 엘에이 공항 인앤아웃버거 비행기 출사,lax-in-n-out,https://locations.in-n-out.com/117,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,13,13,39ecd9f5e7623ac90d3105216ec88c17e3d64d334d3981a0dfb8daf652d57a57,candidate_doppler_like,Multiple descending low-frequency traces around 60-80 s in a video titled at the LAX In-N-Out. Thirteen scanner groups may overlap; independent flyovers and aircraft attribution are not established.,,+OjQUdbSsdac,https://www.youtube.com/watch?v=OjQUdbSsdac,PLANE SPOTTING AT LAX IN-N-OUT BURGER,lax-in-n-out,https://locations.in-n-out.com/117,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,a363c5e72d5420183f04e7d30deb6398d583989f512e554debd70b1e20fe4221,not_reviewed,,,+2z8ApKPT9Xw,https://www.youtube.com/watch?v=2z8ApKPT9Xw,"Plane spotting from the Famous In N Out location at Los Angeles, California. ",lax-in-n-out,https://locations.in-n-out.com/117,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,310e1bb09f8054f3fc3c9f7fa9cae922c56823d1108bfadeaaae04a9d35941cf,not_reviewed,,,+tN8sgmxtcrY,https://www.youtube.com/watch?v=tN8sgmxtcrY,[4K Walk] The Ultimate SFO Plane Spotting Location: Bayfront Park 🛫,sfo-bayside,https://www.scc.ca.gov/webmaster/ftp/pdf/pub/sf_wheel_guidebook.pdf,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,426790ea4afc80a4491d2e4ab477bb3b33d7296c037edc9685d82594ac22766f,not_reviewed,,,+gEEwpMvSDnQ,https://www.youtube.com/watch?v=gEEwpMvSDnQ,SFO Plane Spotting Bayfront Park,sfo-bayside,https://www.scc.ca.gov/webmaster/ftp/pdf/pub/sf_wheel_guidebook.pdf,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,2,2,fbd8f6f694a49961ffcca0460e71a05f334b96bf42a5efb6740443878c61b3e6,candidate_doppler_like_edited,"Strong descending tonal arcs are visible, but abrupt transitions around 55 and 105 s suggest editing. Useful as scanner evidence; not a locked multi-event timing example without further verification.",,+E0a2OqFGVm4,https://www.youtube.com/watch?v=E0a2OqFGVm4,Morning Spotting from Bayfront Park at San Francisco International Airport | SFO,sfo-bayside,https://www.scc.ca.gov/webmaster/ftp/pdf/pub/sf_wheel_guidebook.pdf,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,1,1,0c90e1ab3520a69b6f82c76c2a4c0f4289ea8c97bd871073aecdefddee90ffac,ambiguous,Shallow descending trace around 600 Hz in noisy audio; origin unconfirmed.,,+4oPm7fOftLo,https://www.youtube.com/watch?v=4oPm7fOftLo,Logan Airport sporting at constitution beach,boston-constitution,https://www.mass.gov/locations/constitution-beach-park,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,0,0,776f0286a7e954da208f5277b18d911826951dad9b1b691cb1f750ed0a82cb7d,not_reviewed,,,+h0BxmAgQq2Q,https://www.youtube.com/watch?v=h0BxmAgQq2Q,"Constitution Beach in Boston, Massachusetts: The Best Hidden Spot for Airplane Spotting",boston-constitution,https://www.mass.gov/locations/constitution-beach-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,98.77775,0,0,8491d1097730747a8f45c3366762daa414a25bfeb77e08a4c1241a0f96056391,not_reviewed,,audio acquisition failed or timed out,+2zx-39fp-Q4,https://www.youtube.com/watch?v=2zx-39fp-Q4,Plane Spotting from Constitution Beach / Boston Massachusetts,boston-constitution,https://www.mass.gov/locations/constitution-beach-park,"uploader title claim, not surveyed microphone position",download_failed,download_failed,download_failed,,,,,not_reviewed,,audio acquisition failed or timed out,Video unavailable according to yt-dlp+ia8Im2k8Bto,https://www.youtube.com/watch?v=ia8Im2k8Bto,"Constitution Beach, East Boston - Tour, Review (Swim, Sunbathe & Plane Spotting At Logan Airport)",boston-constitution,https://www.mass.gov/locations/constitution-beach-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,0,0,137d7cdd43f5de8caca17e06b04c39bd80e5c1b65821513a5c0ba1e20f52b0f8,not_reviewed,,audio acquisition failed or timed out,+2fNstKw9bes,https://www.youtube.com/watch?v=2fNstKw9bes,RDU Observation Deck | Airport | North Carolina,rdu-park,https://www.rdu.com/services-and-amenities/observation-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,1,1,ca99f91bfb920a6e8a2b27450c7ca653ed1d695ca8c6c8012f7a63adaa5bbec3,ambiguous,Low-frequency trace in complex loud audio; source unverified.,audio acquisition failed or timed out,+rDwbmgEPEk0,https://www.youtube.com/watch?v=rDwbmgEPEk0,Raleigh-Durham Spotting From Observation Park,rdu-park,https://www.rdu.com/services-and-amenities/observation-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,0,0,a4c9e4173099e57d4803dc6e44ac8fa3e6f6af70c528046ffe2a834d7d34f78d,not_reviewed,,audio acquisition failed or timed out,+zZFUmxnIUDU,https://www.youtube.com/watch?v=zZFUmxnIUDU,RDU Observation Deck 9-11-2023,rdu-park,https://www.rdu.com/services-and-amenities/observation-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,0,0,b8dfca9e253d3856bf36300c2913b8f438d285c43d3f9abb48738712c03e0a39,not_reviewed,,audio acquisition failed or timed out,+Le-xFuXIuks,https://www.youtube.com/watch?v=Le-xFuXIuks,RDU Observation Deck 7-15-2023,rdu-park,https://www.rdu.com/services-and-amenities/observation-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,1,1,df678728eb82603855a923e38e025a989addee360a503203a7e1122c2853a891,ambiguous,Weak low-frequency trace in broadband noise; source unverified.,audio acquisition failed or timed out,+f6V_1ZanVpc,https://www.youtube.com/watch?v=f6V_1ZanVpc,RDU Observation Deck 4-11-2023 Randomness,rdu-park,https://www.rdu.com/services-and-amenities/observation-park,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,6,6,73e1a8d6a2541448815d13d55af88815872ad63675496611b9d58c5019301561,candidate_doppler_like_edited,"Several descending low-frequency tones around 20-55 s in a video titled at RDU Observation Deck; abrupt changes near 60 and 115 s suggest edits. Site position, exact clock, source identity and locked timing require independent verification.",audio acquisition failed or timed out,+Nwblp3G1tko,https://www.youtube.com/watch?v=Nwblp3G1tko,So Minnesota: Viewing area at MSP International Airport gives best views of takeoffs and landings,msp-overlook,https://www.mspairport.com/de/node/996,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,0,0,36441ee22d61e02a11a540f2034b801ba1d951cc5701c00279302cb714d6e540,not_reviewed,,audio acquisition failed or timed out,+5HHa1l_76Rk,https://www.youtube.com/watch?v=5HHa1l_76Rk,MSP Aircraft Viewing Area - Minneapolis–Saint Paul International Airport #aviation @MSPIntlAirport,msp-overlook,https://www.mspairport.com/de/node/996,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,180.0135,0,0,fa2a6e2f9b7c9c3fe68102511f9a5d503f83f01c3865d5628d8b3d102c32b123,not_reviewed,,audio acquisition failed or timed out,+LLgeYfpQCSk,https://www.youtube.com/watch?v=LLgeYfpQCSk,Watching planes land from Sunset Park in Las Vegas,las-vegas-sunset,https://www.clarkcountynv.gov/government/departments/parks___recreation/services/area_reservations/sunset-park-webpage,"uploader title claim, not surveyed microphone position",download_failed,scanned,scanned,137.973,0,0,82c98a531ce97de140733885d2e9e7d73a5836e65f583888aed86487679fdf93,not_reviewed,,audio acquisition failed or timed out,+XbKlg0IM-dw,https://www.youtube.com/watch?v=XbKlg0IM-dw,Plane Spotting at SFO International Airport(aka Bay Front Park),sfo-bayside,https://www.scc.ca.gov/webmaster/ftp/pdf/pub/sf_wheel_guidebook.pdf,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,1,1,34af3a5a4746f0d807f1c84b430771f8560e3fd9d800d385247cd2b3be631b35,ambiguous,Weak low-frequency trace amid substantial background sound; origin unconfirmed.,,+ZMAqWe-X2R0,https://www.youtube.com/watch?v=ZMAqWe-X2R0,"Runway 22 landings and takeoffs at Boston Logan airport, from Constitution Beach - April 1, 2023",boston-constitution,https://www.mass.gov/locations/constitution-beach-park,"uploader title claim, not surveyed microphone position",scanned,not_retried,scanned,180.0135,1,1,5e510fab6dbb737729495ea4e1d71b8a8b52f27f2c8fa0f1b38efc4dd917151c,ambiguous,Low-frequency descending trace amid broadband sound; origin unconfirmed.,,diff --git a/benchmarks/site-leads-real-scan-20261103.md b/benchmarks/site-leads-real-scan-20261103.mdnew file mode 100644index 0000000..1f422b0--- /dev/null+++ b/benchmarks/site-leads-real-scan-20261103.md@@ -0,0 +1,66 @@+# Real site-named video leads: scanner outcomes++These 29 videos were preselected from uploader descriptions naming locations+near airports. A title is a lead, not proof of the microphone's position: none+of these 29 cases has independently established recorder coordinates or a+recording-start UTC uncertainty. They are therefore **not yet verified+known-location clips** and are not a location-accuracy benchmark. The source+links and relevant site references are in the [case table](site-leads-real-scan-20261103.csv).++The initial W5 scanner-only run scanned 18 first-three-minute excerpts and+recorded 11 acquisition failures. The 11 failed IDs were subsequently retried+in a separate directory; ten scanned and one video was reported unavailable.+Across the final per-source outcomes:++| Outcome | Videos |+| --- | ---: |+| Scanner produced one or more moving-tone proposals | 9 |+| Scanner produced no proposal | 19 |+| Download failed | 1 |++A quick 0–1 kHz spectrogram review found three videos with plausible descending+traces and six with ambiguous proposals. Two of the three plausible examples+show abrupt audio changes consistent with edits, so their multiple event times+must not be treated as a locked recording clock without further evidence. One+LAX excerpt produced 13 scanner group IDs in a short interval; these are not+established as 13 independent aircraft. No-proposal means only that the+scanner found no qualifying trace in that excerpt. The videos were selected by+search queries and site titles, not at random, and do not establish a general+success or false-positive rate.++The table preserves both the initial and retry outcomes, video/source URLs,+site-name references, scanner counts, MP3 SHA-256 hashes and review notes. Two+IDs overlap a separate broad YouTube survey; do not double-count them when+combining samples. Original metadata, audio, scanner output and review plots+remain local in `/home/cinna/.local/state/dopplergeist-w5-youtube-survey-20261103/`+and `/home/cinna/.local/state/dopplergeist-w4-w5-retry-20261103/`. No media is+committed. Videos may be edited or unavailable; YouTube upload date is not+recording UTC.++For a new local scanner-only replay, build a source list from the published table+and use the existing collector. This downloads audio only and passes no known+flight IDs, location coordinates, event windows or frequency bands to discovery:++```sh+DG_SITE_ROOT=/path/to/new-site-scan+mkdir -p "$DG_SITE_ROOT"+python - "$DG_SITE_ROOT" <<'PY'+import csv, json, pathlib, sys+root = pathlib.Path(sys.argv[1])+with open('benchmarks/site-leads-real-scan-20261103.csv', newline='') as stream:+ rows = list(csv.DictReader(stream))+with (root / 'sources.jsonl').open('x') as output:+ for row in rows:+ source = {'id': 'yt-' + row['id'], 'source': 'youtube', 'url': row['url'],+ 'title': row['title'], 'category': 'site_named_aircraft',+ 'location_status': 'unresolved', 'recording_clock_status': 'not_established'}+ output.write(json.dumps(source) + '\n')+PY+PYTHONPATH=src python scripts/collect_audio_corpus.py run --root "$DG_SITE_ROOT" \+ --workers 2 --seconds 180 --download-timeout 120 --scan-timeout 180+```++The scanner inputs were selected without known flight IDs or search bounds; no+matching or geolocation was run on these recordings. Replaying a changed or+removed video may produce a different outcome. Respect each source's rights+and keep downloaded media local unless redistribution is authorized.