Skip to content

Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)

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.csv
new file mode 100644
index 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.md
new file mode 100644
index 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.