Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)
Python acoustic-geolocationads-baircraft-trackingairplaneaudio-forensicsdoppler-effectdoppler-shiftgeolocationosintsignal-processing
Add 20 AeroSonicDB known-site audio candidates (#208)
Cinna Davis687d13d7c319
diff --git a/benchmarks/aerosonic-known-site-candidate-manifest-20261103.csv b/benchmarks/aerosonic-known-site-candidate-manifest-20261103.csvnew file mode 100644index 0000000..8e1516c--- /dev/null+++ b/benchmarks/aerosonic-known-site-candidate-manifest-20261103.csv@@ -0,0 +1,21 @@+case_id,filename,sha256,source_url,dataset_license,duration_s,ridge_records,proposal_groups,visual_review,scan_only,matching_or_geolocation+case-0001,aerosonic-known-site/clip-01.wav,36164d8f88d3a67da0efb2a9a8934a27f7991e3d1eddebe1757fc8eee30b823f,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,3,1,clear_descending_ridge,true,not_run+case-0003,aerosonic-known-site/clip-02.wav,f2ca127e7c42eee8fb2f1224d9bfff351234f3521bd2b6f7f00785ff32996e58,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,2,2,clear_descending_ridge,true,not_run+case-0004,aerosonic-known-site/clip-03.wav,eefe282d1875368fbcc7f27075c9fda565dcee325a4213c56d6b1b993c1aba41,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,4,4,clear_descending_ridge,true,not_run+case-0007,aerosonic-known-site/clip-04.wav,a9a36342a1ba974260da45adab5d0a5d35976b0f190dec803f829e57f000c964,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,3,3,clear_descending_ridge,true,not_run+case-0016,aerosonic-known-site/clip-05.wav,18d6ec2fd9f3e09bca4b4bc7f5eaa64105744315cc36c0ae358fdb87c796f66d,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,5,5,clear_descending_ridge,true,not_run+case-0021,aerosonic-known-site/clip-06.wav,bfad3d06f8049580b9df07ddb18f21aef80b6a5e63c237ab8630f2bc5d398a6a,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,4,4,clear_descending_ridge,true,not_run+case-0032,aerosonic-known-site/clip-07.wav,661e127c6f53a130f007ca79f8538fcffd175bd6b87d776b7b92786f46a01fa9,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,5,5,clear_descending_ridge,true,not_run+case-0048,aerosonic-known-site/clip-08.wav,391990e16f75d9190fcc3bf0db52b065d765e61faba1aabb9dea5a7c0040d31e,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,9,9,clear_descending_ridge,true,not_run+case-0052,aerosonic-known-site/clip-09.wav,6f9f7b8a4bd92b93d46958747fe1f55e3c29de6983fb4e12fbea2fba75f7a8a2,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,5,5,clear_descending_ridge,true,not_run+case-0055,aerosonic-known-site/clip-10.wav,296ad9da04ac7b42ce1dae91db2c760cdbd26c297bc584bf4a28d3990c3c69a3,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,1,1,clear_descending_ridge,true,not_run+case-0059,aerosonic-known-site/clip-11.wav,49d913cc535103d72cde4e57862a63752fc60916d52367adb6d467cf5e430f9e,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,4,4,clear_descending_ridge,true,not_run+case-0065,aerosonic-known-site/clip-12.wav,659ff9b77732e56df458ffa8df4f126691cdf7041357e73fea44bc1f0b4db9b0,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,2,2,clear_descending_ridge,true,not_run+case-0069,aerosonic-known-site/clip-13.wav,68fb0de261b3b2aff79704572104ea464460f29b1609314e52065d2b34b98a87,https://zenodo.org/records/10215080,CC BY-NC 4.0,24.0,2,2,clear_descending_ridge,true,not_run+case-0071,aerosonic-known-site/clip-14.wav,e68ff324e422ffb99ad2451a68b7103179f61ca4c3d9ce9a11cd05edd624b41a,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,1,1,clear_descending_ridge,true,not_run+case-0072,aerosonic-known-site/clip-15.wav,4884154bc784b257f40b71efb73bed1fcfb586abb524f109fb18443319869890,https://zenodo.org/records/10215080,CC BY-NC 4.0,22.0,1,1,clear_descending_ridge,true,not_run+case-0074,aerosonic-known-site/clip-16.wav,c4c62a84407d83a4b871cd85f7bf932566eee294bec5de8c43bf8aee138f6e92,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,1,1,clear_descending_ridge,true,not_run+case-0078,aerosonic-known-site/clip-17.wav,29e92b90fdeeb45c44682d09a6e60f8a37f45b985eab0b83ddd027dde71ac75a,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,5,5,clear_descending_ridge,true,not_run+case-0083,aerosonic-known-site/clip-18.wav,9cb3f5a87d6f184e62900c9ddc441065f37e736c139e3c48234fe7ac765451e3,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,2,2,clear_descending_ridge,true,not_run+case-0093,aerosonic-known-site/clip-19.wav,15d94546bc223f1e34a5172e6fd42295c235993da292136e066268a3e048dc5e,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,2,2,clear_descending_ridge,true,not_run+case-0100,aerosonic-known-site/clip-20.wav,11e08b8786e70e5b6be96504c97e85b5c5461388264a052fd9f8309f6430c4eb,https://zenodo.org/records/10215080,CC BY-NC 4.0,60.0,3,3,clear_descending_ridge,true,not_rundiff --git a/benchmarks/truth-separated/aerosonic-known-site-event-references-20261103.csv b/benchmarks/truth-separated/aerosonic-known-site-event-references-20261103.csvnew file mode 100644index 0000000..181f7af--- /dev/null+++ b/benchmarks/truth-separated/aerosonic-known-site-event-references-20261103.csv@@ -0,0 +1,21 @@+case_id,publisher_filename,aircraft_icao,publisher_recording_date,publisher_recording_time_label,timestamp_timezone,publisher_location_id,publisher_microphone_id,publisher_aircraft_class,source_truth_scope+case-0001,7C293D_2023-04-22_10-14-18_0_1.wav,7C293D,2023-04-22,10-14-18,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0003,7C6C96_2023-05-10_06-44-16_0_1.wav,7C6C96,2023-05-10,06-44-16,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0004,7C6C29_2022-12-08_12-33-42_0_0.wav,7C6C29,2022-12-08,12-33-42,not stated in published sample metadata,0,0,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0007,7C4877_2023-05-09_15-06-18_0_1.wav,7C4877,2023-05-09,15-06-18,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0016,7C7CD1_2022-12-08_18-05-05_0_0.wav,7C7CD1,2022-12-08,18-05-05,not stated in published sample metadata,0,0,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0021,7C6C9F_2022-12-12_14-26-30_0_1.wav,7C6C9F,2022-12-12,14-26-30,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0032,7C7701_2022-12-08_20-59-07_0_0.wav,7C7701,2022-12-08,20-59-07,not stated in published sample metadata,0,0,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0048,7C779B_2023-05-23_12-05-49_0_1.wav,7C779B,2023-05-23,12-05-49,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0052,7C6B2D_2022-12-08_19-27-54_0_0.wav,7C6B2D,2022-12-08,19-27-54,not stated in published sample metadata,0,0,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0055,7C7CD0_2023-05-09_12-42-55_2_1.wav,7C7CD0,2023-05-09,12-42-55,not stated in published sample metadata,2,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0059,7C7651_2022-12-15_14-56-58_0_1.wav,7C7651,2022-12-15,14-56-58,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0065,7C3929_2023-05-02_15-15-47_0_1.wav,7C3929,2023-05-02,15-15-47,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0069,7C3FCB_2023-04-25_18-11-43_0_1.wav,7C3FCB,2023-04-25,18-11-43,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0071,7C7BCF_2023-04-17_12-19-28_0_1.wav,7C7BCF,2023-04-17,12-19-28,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0072,7C7B5F_2023-04-25_15-28-41_0_1.wav,7C7B5F,2023-04-25,15-28-41,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0074,7C77D9_2023-03-01_13-29-31_1_1.wav,7C77D9,2023-03-01,13-29-31,not stated in published sample metadata,1,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0078,7C6BC8_2023-05-21_11-25-28_0_1.wav,7C6BC8,2023-05-21,11-25-28,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0083,7C6277_2023-04-22_11-33-28_0_1.wav,7C6277,2023-04-22,11-33-28,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0093,7C6B17_2022-12-15_23-10-13_0_1.wav,7C6B17,2022-12-15,23-10-13,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matched+case-0100,7C4A46_2023-05-02_14-50-03_0_1.wav,7C4A46,2023-05-02,14-50-03,not stated in published sample metadata,0,1,1,publisher-labeled aircraft clip; human-verified audible aircraft; not independently re-matcheddiff --git a/benchmarks/truth-separated/aerosonic-location-markers-20261103.csv b/benchmarks/truth-separated/aerosonic-location-markers-20261103.csvnew file mode 100644index 0000000..6323d80--- /dev/null+++ b/benchmarks/truth-separated/aerosonic-location-markers-20261103.csv@@ -0,0 +1,4 @@+publisher_location_id,latitude,longitude,reference_type,microphone_offset,source_url+0,-34.85364,138.67517,nearby_public_place,unquantified,https://zenodo.org/records/10215080/files/locations.json?download=1+1,-34.96092,138.51311,nearby_public_place,unquantified,https://zenodo.org/records/10215080/files/locations.json?download=1+2,-34.96428,138.51011,nearby_public_place,unquantified,https://zenodo.org/records/10215080/files/locations.json?download=1diff --git a/docs/REAL_AUDIO_CORPUS.md b/docs/REAL_AUDIO_CORPUS.mdindex 83cce24..1c418fa 100644--- a/docs/REAL_AUDIO_CORPUS.md+++ b/docs/REAL_AUDIO_CORPUS.md@@ -55,6 +55,27 @@ CC BY-NC 4.0; no media is copied into this repository. Its public coordinatesrefer to nearby public places rather than exact microphones, so these clips donot establish location truth for geolocation evaluation.+A follow-up review selected **20 known-site candidate clips** from that sample.+All 20 were publisher-labeled aircraft recordings, emitted at least one scanner+proposal, and were visually reviewed as having a clear descending tonal ridge.+They are linked in the [scanner-facing manifest](../benchmarks/aerosonic-known-site-candidate-manifest-20261103.csv);+publisher aircraft/date/time/site/microphone metadata and the approximate public+site markers are in separate [event-reference](../benchmarks/truth-separated/aerosonic-known-site-event-references-20261103.csv)+and [location-marker](../benchmarks/truth-separated/aerosonic-location-markers-20261103.csv)+tables. The scanner manifest contains no truth labels or coordinates. No flight+matching or geolocation was run on these clips.++The local audio hardlinks are at+`/home/cinna/.local/state/dopplergeist-benchmark-candidate-audio-20261103/aerosonic-known-site/`;+they are not redistributed in this repository. They can be reacquired from the+[AeroSonicDB v1.1.2 record](https://zenodo.org/records/10215080) under CC BY-NC+4.0. The source labels provide recording date/time strings, microphone IDs and+one of three site IDs, but the timezone is not stated. The three published+coordinates are nearby public-place markers with unquantified microphone offset.+This is a 20-clip known-site scanner candidate collection, not a 20-point+microphone ground-truth benchmark and not evidence of 100 m localization+accuracy.+## Publisher-documented aircraft scanner controlThe [DLR RECORD 139 scanner check](../benchmarks/dlr-record139-scanner-check-20261103.md)@@ -83,6 +104,13 @@ contains:coarse place. Aircraft identity, recording UTC and independence from editingare not established.+The separate [five-source unknown-exact-point shortlist](../benchmarks/real-candidates-unknown-point-v2-20261103.md)+contains real clips with visually plausible descending patterns and positive+scanner proposals. Their exact receiver coordinates and absolute recording times+are unverified; one is an edited compilation, and another may contain overlapping+harmonic groups from a single pass. This is candidate material, not five+validated unknown-location benchmark examples.+The Eclipse and YouTube candidates are real recordings and real moving-toneevidence, but the source of the tonal bands has not been confirmed as aircraft.The site coordinate is not a surveyed microphone coordinate. These clips are@@ -124,6 +152,14 @@ python scripts/export_youtube_survey_20261103.py \--output /tmp/youtube-expanded-scan-20261103.csv```+A separate fixed-seed sample of 200 videos, randomly selected without replacement+from the query-derived YouTube catalog, is being scanned in scanner-only mode.+It is a randomized sample of that catalog, not a representative sample of+YouTube. Its full audio, scan outcomes, no-proposal cases and acquisition failures+remain local while collection runs under+`/home/cinna/.local/state/dopplergeist-youtube-random-sample-20261103/youtube-only-200/`.+No flight matching or geolocation is run on this sample.+Source rights and continued online availability are not established by thissurvey. Retain failed downloads, ambiguous proposals and no-proposal excerpts inany future update.