Skip to content

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

feat(#146): add real Livermore scanner-only corpus (#247)

Cinna Davis431827422142
diff --git a/benchmarks/truth-separated/zenodo-livermore-annotations-v1.csv b/benchmarks/truth-separated/zenodo-livermore-annotations-v1.csv
new file mode 100644
index 0000000..812fb3f
--- /dev/null
+++ b/benchmarks/truth-separated/zenodo-livermore-annotations-v1.csv
@@ -0,0 +1,41 @@
+clip_id,source_sha256,case_id,category,audio_relative_path,frequency_trace_relative_path,track_file,annotation_start_utc,annotation_end_utc,annotation_point_count,audio_duration_s,exact_recorder_coordinates_published,use_as_localization_truth,source_record
+sha256-27629dee59acf487,27629dee59acf4877ac3094f9b6db46189b1f6572bf2ceecff06360caaee49bd,N373DF_R06,V_constant_H_constant,V_constant_H_constant/N373DF_R06/audio.wav,V_constant_H_constant/N373DF_R06/frequency_vs_time_used.csv,N373DF-track-EGM96.kml,2026-05-13T20:03:45.776Z,2026-05-13T20:04:25.370Z,108,49.938354,no,no,https://zenodo.org/records/23424278
+sha256-cfd03401b5f89102,cfd03401b5f891020d76c12000a7552be0c549f65b8e67dc571f06258f0178ac,N394FX_R20,V_constant_H_constant,V_constant_H_constant/N394FX_R20/audio.wav,V_constant_H_constant/N394FX_R20/frequency_vs_time_used.csv,N394FX-track-EGM96.kml,2026-05-16T20:12:29.429Z,2026-05-16T20:13:19.956Z,235,60.526667,no,no,https://zenodo.org/records/23424278
+sha256-f0a78abf7fb124e0,f0a78abf7fb124e0688ce82d0eb6410475b840188209b5e07dc21519c8bfa3df,N4040_R12,V_constant_H_constant,V_constant_H_constant/N4040_R12/audio.wav,V_constant_H_constant/N4040_R12/frequency_vs_time_used.csv,N4040-track-EGM96.kml,2026-05-17T23:27:47.016Z,2026-05-17T23:29:08.936Z,429,91.920042,no,no,https://zenodo.org/records/23424278
+sha256-c28412b7c3de34b0,c28412b7c3de34b006b40bf6fe005ba042145ee4d480547a0647091e531a5b3b,N413AK_R49,V_constant_H_constant,V_constant_H_constant/N413AK_R49/audio.wav,V_constant_H_constant/N413AK_R49/frequency_vs_time_used.csv,N413AK-track-EGM96.kml,2026-05-16T21:37:57.562Z,2026-05-16T21:39:20.783Z,381,93.220354,no,no,https://zenodo.org/records/23424278
+sha256-e47eb35b076a9fbe,e47eb35b076a9fbeb4983498221f6853d1d0cc9d8af7259a430557a100bed293,N757AH_R41,V_constant_H_constant,V_constant_H_constant/N757AH_R41/audio.wav,V_constant_H_constant/N757AH_R41/frequency_vs_time_used.csv,N757AH-track-EGM96.kml,2026-05-12T20:02:01.786Z,2026-05-12T20:02:29.093Z,123,56.439917,no,no,https://zenodo.org/records/23424278
+sha256-c0366b111fbf8287,c0366b111fbf82877bcaba53aa53a99602f9f5512513bc996e629aa04633d37e,N784MB_R04,V_constant_H_constant,V_constant_H_constant/N784MB_R04/audio.wav,V_constant_H_constant/N784MB_R04/frequency_vs_time_used.csv,N784MB-track-EGM96.kml,2026-05-14T17:41:37.239Z,2026-05-14T17:42:52.471Z,403,85.232687,no,no,https://zenodo.org/records/23424278
+sha256-8d23e3aa36ad4398,8d23e3aa36ad439801fcbec6ef3f7f80647ed70d3b9ed11157539e72e771b38b,N788BM_R03,V_constant_H_constant,V_constant_H_constant/N788BM_R03/audio.wav,V_constant_H_constant/N788BM_R03/frequency_vs_time_used.csv,N788BM-track-EGM96.kml,2026-05-17T19:29:49.139Z,2026-05-17T19:30:47.165Z,341,68.026667,no,no,https://zenodo.org/records/23424278
+sha256-81da035ff6af575f,81da035ff6af575fcaded1a4dfc3162bb6377a033c0d840af490eba47a879998,N916KT_R22,V_constant_H_constant,V_constant_H_constant/N916KT_R22/audio.wav,V_constant_H_constant/N916KT_R22/frequency_vs_time_used.csv,N916KT-track-EGM96.kml,2026-05-16T17:13:07.900Z,2026-05-16T17:14:15.331Z,309,77.430792,no,no,https://zenodo.org/records/23424278
+sha256-ec5ff2e4d78d6852,ec5ff2e4d78d68521c7f65fcf030c7b49131c18cb3c018900e61cf06382bcdf7,N172EL_R35,V_constant_H_varying,V_constant_H_varying/N172EL_R35/audio.wav,V_constant_H_varying/N172EL_R35/frequency_vs_time_used.csv,N172EL-track-EGM96.kml,2026-05-17T18:28:01.950Z,2026-05-17T18:30:04.365Z,582,132.415604,no,no,https://zenodo.org/records/23424278
+sha256-e71592a17f8b1d82,e71592a17f8b1d82746f3915af9810066afefb54810443efe99fd0e081606319,N248LF_R14,V_constant_H_varying,V_constant_H_varying/N248LF_R14/audio.wav,V_constant_H_varying/N248LF_R14/frequency_vs_time_used.csv,N248LF-track-EGM96.kml,2026-05-17T16:50:59.707Z,2026-05-17T16:53:21.628Z,476,151.920396,no,no,https://zenodo.org/records/23424278
+sha256-b04a46541d3adf35,b04a46541d3adf35419faf1e15ca5f02cfd93b4f99f2c3d5cd25dce5531066c8,N310MG_R23,V_constant_H_varying,V_constant_H_varying/N310MG_R23/audio.wav,V_constant_H_varying/N310MG_R23/frequency_vs_time_used.csv,N310MG-track-EGM96.kml,2026-05-16T17:04:17.370Z,2026-05-16T17:05:08.268Z,244,60.898187,no,no,https://zenodo.org/records/23424278
+sha256-a5e4bad00fc13828,a5e4bad00fc1382824218e92f0da9ffb97223e5dfcccd35cf22bf0e354b72c8f,N4004R_R19,V_constant_H_varying,V_constant_H_varying/N4004R_R19/audio.wav,V_constant_H_varying/N4004R_R19/frequency_vs_time_used.csv,N4004R-track-EGM96.kml,2026-05-16T23:56:04.031Z,2026-05-16T23:57:35.611Z,360,101.579542,no,no,https://zenodo.org/records/23424278
+sha256-7202a8a433276507,7202a8a4332765074c85af28ade258f41170f62e5356c4bf866f5775d25d1429,N413AK_R05,V_constant_H_varying,V_constant_H_varying/N413AK_R05/audio.wav,V_constant_H_varying/N413AK_R05/frequency_vs_time_used.csv,N413AK-track-EGM96.kml,2026-05-16T20:50:59.108Z,2026-05-16T20:53:12.484Z,608,143.375479,no,no,https://zenodo.org/records/23424278
+sha256-fe241d8839128daf,fe241d8839128daf85de79606f0663333c6c32a40d50ab5043f32d36586440ac,N413AK_R16,V_constant_H_varying,V_constant_H_varying/N413AK_R16/audio.wav,V_constant_H_varying/N413AK_R16/frequency_vs_time_used.csv,N413AK-track-EGM96_2.kml,2026-05-17T21:46:38.493Z,2026-05-17T21:48:55.539Z,419,147.045375,no,no,https://zenodo.org/records/23424278
+sha256-02d2acc40e897b4b,02d2acc40e897b4b3a83c05f2ec89af4c10f0ccb17a1ea0a8fa7f1530e72eb39,N500MG_R17,V_constant_H_varying,V_constant_H_varying/N500MG_R17/audio.wav,V_constant_H_varying/N500MG_R17/frequency_vs_time_used.csv,N500MG-track-EGM96.kml,2026-05-17T21:01:30.227Z,2026-05-17T21:02:34.227Z,346,74.000042,no,no,https://zenodo.org/records/23424278
+sha256-427a7575ec97a84f,427a7575ec97a84feb8fe81f7fb8b1cff5a122e79223fba11d5327c0ba9e1179,N563FX_R21,V_constant_H_varying,V_constant_H_varying/N563FX_R21/audio.wav,V_constant_H_varying/N563FX_R21/frequency_vs_time_used.csv,N563FX-track-EGM96.kml,2026-05-16T18:24:01.340Z,2026-05-16T18:26:00.969Z,642,129.62925,no,no,https://zenodo.org/records/23424278
+sha256-8edaf3c4a5a6f437,8edaf3c4a5a6f4370b979842bc38b3755a3930f8befa017795991d3d8224a657,N61NG_R37,V_constant_H_varying,V_constant_H_varying/N61NG_R37/audio.wav,V_constant_H_varying/N61NG_R37/frequency_vs_time_used.csv,N61NG-track-EGM96.kml,2026-05-17T20:57:43.069Z,2026-05-17T20:58:50.995Z,365,77.925375,no,no,https://zenodo.org/records/23424278
+sha256-2002081930df3f5b,2002081930df3f5b6e6ea9a6e6ce97fe65a712c9e02fe720f12f2f45e0602e81,N621KS_R18,V_constant_H_varying,V_constant_H_varying/N621KS_R18/audio.wav,V_constant_H_varying/N621KS_R18/frequency_vs_time_used.csv,N621KS-track-EGM96.kml,2026-05-17T23:21:46.568Z,2026-05-17T23:22:41.181Z,269,64.613333,no,no,https://zenodo.org/records/23424278
+sha256-46b7905f230dc5cc,46b7905f230dc5cc8dc0e9485a88ab2b3b544737d62c20b96b34ea2d460b84c9,N67WL_R59,V_constant_H_varying,V_constant_H_varying/N67WL_R59/audio.wav,V_constant_H_varying/N67WL_R59/frequency_vs_time_used.csv,N67WL-track-EGM96.kml,2026-05-17T17:01:52.838Z,2026-05-17T17:03:49.124Z,485,181.456187,no,no,https://zenodo.org/records/23424278
+sha256-520153c1e15d1ebf,520153c1e15d1ebf75cb713ca3fb158ecd73594a5dd8a6490b1baee4e2a98036,N759NC_R46,V_constant_H_varying,V_constant_H_varying/N759NC_R46/audio.wav,V_constant_H_varying/N759NC_R46/frequency_vs_time_used.csv,N759NC-track-EGM96.kml,2026-05-14T17:26:08.539Z,2026-05-14T17:27:33.803Z,440,95.263688,no,no,https://zenodo.org/records/23424278
+sha256-9a800515b85817e0,9a800515b85817e09b418ff125a3d71723fd9922b978a317017bf5098ed77c0b,N795MM_R13,V_constant_H_varying,V_constant_H_varying/N795MM_R13/audio.wav,V_constant_H_varying/N795MM_R13/frequency_vs_time_used.csv,N795MM-track-EGM96.kml,2026-05-17T21:44:40.904Z,2026-05-17T21:45:48.829Z,306,77.925333,no,no,https://zenodo.org/records/23424278
+sha256-9164e2702d0e24b9,9164e2702d0e24b9620f4511a1ee21758a7d501cb00867dd04089ca0b846e30f,N7PG_R60,V_constant_H_varying,V_constant_H_varying/N7PG_R60/audio.wav,V_constant_H_varying/N7PG_R60/frequency_vs_time_used.csv,N7PG-track-EGM96.kml,2026-05-17T17:29:29.814Z,2026-05-17T17:31:12.353Z,553,112.539375,no,no,https://zenodo.org/records/23424278
+sha256-7b34ab4933a7c419,7b34ab4933a7c4193f9e668d42fa4d7cb94a0b754b25eb84ebddbca227419b7a,N7RR_R30,V_constant_H_varying,V_constant_H_varying/N7RR_R30/audio.wav,V_constant_H_varying/N7RR_R30/frequency_vs_time_used.csv,N7RR-track-EGM96.kml,2026-05-16T17:19:51.927Z,2026-05-16T17:21:30.937Z,514,109.009938,no,no,https://zenodo.org/records/23424278
+sha256-a06237f42d5789ff,a06237f42d5789ff0b868e636b45f86974f61c4318f6ddb01865129245111ee5,N8085W_R27,V_constant_H_varying,V_constant_H_varying/N8085W_R27/audio.wav,V_constant_H_varying/N8085W_R27/frequency_vs_time_used.csv,N8085W-track-EGM96.kml,2026-05-16T18:49:46.675Z,2026-05-16T18:50:50.762Z,276,74.087083,no,no,https://zenodo.org/records/23424278
+sha256-a19c78d9d147a6e8,a19c78d9d147a6e8b4b2c495bd344787363875ea411e3af21b59490517832495,N86LP_R01,V_constant_H_varying,V_constant_H_varying/N86LP_R01/audio.wav,V_constant_H_varying/N86LP_R01/frequency_vs_time_used.csv,N86LP-track-EGM96.kml,2026-05-17T22:20:14.579Z,2026-05-17T22:21:55.784Z,531,114.448021,no,no,https://zenodo.org/records/23424278
+sha256-676e3cb4e3494176,676e3cb4e34941760a1f3df031d551e0aa7e1d69d4e9085a05a91e2029a87c19,N913TC_R15,V_constant_H_varying,V_constant_H_varying/N913TC_R15/audio.wav,V_constant_H_varying/N913TC_R15/frequency_vs_time_used.csv,N913TC-track-EGM96.kml,2026-05-17T18:31:42.818Z,2026-05-17T18:33:11.240Z,322,98.421646,no,no,https://zenodo.org/records/23424278
+sha256-7834bad6d620df21,7834bad6d620df2143b396325fd861d6581d5ad25dd9bcfa997eb953d13a65f5,N9393T_R02,V_constant_H_varying,V_constant_H_varying/N9393T_R02/audio.wav,V_constant_H_varying/N9393T_R02/frequency_vs_time_used.csv,N9393T-track-EGM96.kml,2026-05-17T22:03:07.336Z,2026-05-17T22:05:14.824Z,748,137.488,no,no,https://zenodo.org/records/23424278
+sha256-3cfa0ca3a58db714,3cfa0ca3a58db714074487004ca3b7505ab9ee4e4882b7efbfdf62f8d7f1a426,N958JX_R50,V_constant_H_varying,V_constant_H_varying/N958JX_R50/audio.wav,V_constant_H_varying/N958JX_R50/frequency_vs_time_used.csv,N958JX-track-EGM96.kml,2026-05-16T18:31:24.748Z,2026-05-16T18:32:02.086Z,130,47.33775,no,no,https://zenodo.org/records/23424278
+sha256-032ff198c6c85997,032ff198c6c85997758a2893641d7a87cb21d9f4bb847dd261cca8fd67df2ae8,N456CS_R38,V_varying_H_constant,V_varying_H_constant/N456CS_R38/audio.wav,V_varying_H_constant/N456CS_R38/frequency_vs_time_used.csv,N456CS-track-EGM96.kml,2026-05-17T21:54:12.979Z,2026-05-17T21:56:02.205Z,541,119.226667,no,no,https://zenodo.org/records/23424278
+sha256-d2e839c8a95f5382,d2e839c8a95f53824cabb294748aaf63f5714a2add6a414c4f8cdd4c4db9e293,N60RS_R11,V_varying_H_constant,V_varying_H_constant/N60RS_R11/audio.wav,V_varying_H_constant/N60RS_R11/frequency_vs_time_used.csv,N60RS-track-EGM96.kml,2026-05-17T20:46:18.867Z,2026-05-17T20:47:40.957Z,451,92.090667,no,no,https://zenodo.org/records/23424278
+sha256-0fdf8b328b9e02ff,0fdf8b328b9e02ff83144b634f5a6ced115cac4672b89557e1aae3151ab7612d,N748SP_R36,V_varying_H_constant,V_varying_H_constant/N748SP_R36/audio.wav,V_varying_H_constant/N748SP_R36/frequency_vs_time_used.csv,N748SP-track-EGM96.kml,2026-05-17T20:06:48.691Z,2026-05-17T20:07:47.059Z,295,68.368021,no,no,https://zenodo.org/records/23424278
+sha256-c732dff1b1914289,c732dff1b19142894931fcd87febdb70a18daa472c316e5c6f36ac6dfe3debc1,N814SR_R07,V_varying_H_constant,V_varying_H_constant/N814SR_R07/audio.wav,V_varying_H_constant/N814SR_R07/frequency_vs_time_used.csv,N814SR-track-EGM96.kml,2026-05-12T20:22:20.291Z,2026-05-12T20:23:14.533Z,147,64.241833,no,no,https://zenodo.org/records/23424278
+sha256-e9e57696eb1d1a80,e9e57696eb1d1a80eaf4688f4bce068398afcf6f9bb8732d72dba8833837255e,N1387U_R44,V_varying_H_varying,V_varying_H_varying/N1387U_R44/audio.wav,V_varying_H_varying/N1387U_R44/frequency_vs_time_used.csv,N1387U-track-EGM96.kml,2026-05-09T22:36:12.851Z,2026-05-09T22:36:49.203Z,358,41.774354,no,no,https://zenodo.org/records/23424278
+sha256-56aef7ec190822a0,56aef7ec190822a03f78764d5d91d22c1f8181e4b672a453c04c899d2cb0a0c9,N231DT_R57,V_varying_H_varying,V_varying_H_varying/N231DT_R57/audio.wav,V_varying_H_varying/N231DT_R57/frequency_vs_time_used.csv,N231DT-track-EGM96.kml,2026-05-17T17:40:05.112Z,2026-05-17T17:41:15.143Z,322,80.031437,no,no,https://zenodo.org/records/23424278
+sha256-bea85232822bb070,bea85232822bb0702e9af8c825934aa27cf04bbb0665db8e15ceae87f552e690,N2933A_R08,V_varying_H_varying,V_varying_H_varying/N2933A_R08/audio.wav,V_varying_H_varying/N2933A_R08/frequency_vs_time_used.csv,N2933A-track-EGM96.kml,2026-05-09T22:50:14.021Z,2026-05-09T22:50:52.933Z,107,48.912021,no,no,https://zenodo.org/records/23424278
+sha256-70dc6c4edc47d56c,70dc6c4edc47d56c85c8d24ae6ac34a640bfaa5bbf23a908f2dd2244d7534e06,N3012N_R40,V_varying_H_varying,V_varying_H_varying/N3012N_R40/audio.wav,V_varying_H_varying/N3012N_R40/frequency_vs_time_used.csv,N3012N-track-EGM96.kml,2026-05-16T16:38:23.331Z,2026-05-16T16:39:33.177Z,272,79.845667,no,no,https://zenodo.org/records/23424278
+sha256-e9ba69a70a8a2c2e,e9ba69a70a8a2c2eb79c06094e9c250c7490af738871ed03b52ba1bd809e94a2,N451EE_R45,V_varying_H_varying,V_varying_H_varying/N451EE_R45/audio.wav,V_varying_H_varying/N451EE_R45/frequency_vs_time_used.csv,N451EE-track-EGM96.kml,2026-05-09T21:09:16.676Z,2026-05-09T21:09:48.591Z,184,40.647688,no,no,https://zenodo.org/records/23424278
+sha256-10b83e163e84784d,10b83e163e84784d5d9952857160fb17d30dc6a1687c6fa159c0d54c3078323d,N451EE_R51,V_varying_H_varying,V_varying_H_varying/N451EE_R51/audio.wav,V_varying_H_varying/N451EE_R51/frequency_vs_time_used.csv,N451EE-track-EGM96.kml,2026-05-13T20:43:26.966Z,2026-05-13T20:44:03.189Z,170,46.223146,no,no,https://zenodo.org/records/23424278
+sha256-2f374f6244cfe5da,2f374f6244cfe5dad8a200b427e392a4c64540d4cb0bc4a621e34aac229c3ea4,N662EZ_R48,V_varying_H_varying,V_varying_H_varying/N662EZ_R48/audio.wav,V_varying_H_varying/N662EZ_R48/frequency_vs_time_used.csv,N662EZ-track-EGM96.kml,2026-05-13T23:31:05.963Z,2026-05-13T23:32:41.443Z,340,105.4805,no,no,https://zenodo.org/records/23424278
+sha256-87ccca3294b374e3,87ccca3294b374e3a8c4ae7362c5d67c3cfa12bdf4ddaa576a06d07ff60be8c2,N9658K_R24,V_varying_H_varying,V_varying_H_varying/N9658K_R24/audio.wav,V_varying_H_varying/N9658K_R24/frequency_vs_time_used.csv,N9658K-track-EGM96.kml,2026-05-14T17:49:34.639Z,2026-05-14T17:51:09.005Z,217,104.365958,no,no,https://zenodo.org/records/23424278
diff --git a/benchmarks/zenodo-livermore-scanner-v1/summary.csv b/benchmarks/zenodo-livermore-scanner-v1/summary.csv
new file mode 100644
index 0000000..323f066
--- /dev/null
+++ b/benchmarks/zenodo-livermore-scanner-v1/summary.csv
@@ -0,0 +1,41 @@
+clip_id,source_sha256,duration_s,sample_rate_hz,channels,status,proposal_count,harmonic_group_count,aircraft_identity_confirmed
+sha256-27629dee59acf487,27629dee59acf4877ac3094f9b6db46189b1f6572bf2ceecff06360caaee49bd,49.9385,4000,1,no_proposals,0,0,False
+sha256-cfd03401b5f89102,cfd03401b5f891020d76c12000a7552be0c549f65b8e67dc571f06258f0178ac,60.52675,4000,1,proposals,2,2,False
+sha256-f0a78abf7fb124e0,f0a78abf7fb124e0688ce82d0eb6410475b840188209b5e07dc21519c8bfa3df,91.92,4000,1,proposals,1,1,False
+sha256-c28412b7c3de34b0,c28412b7c3de34b006b40bf6fe005ba042145ee4d480547a0647091e531a5b3b,93.2205,4000,1,proposals,1,1,False
+sha256-e47eb35b076a9fbe,e47eb35b076a9fbeb4983498221f6853d1d0cc9d8af7259a430557a100bed293,56.44,4000,1,proposals,1,1,False
+sha256-c0366b111fbf8287,c0366b111fbf82877bcaba53aa53a99602f9f5512513bc996e629aa04633d37e,85.23275,4000,1,proposals,9,1,False
+sha256-8d23e3aa36ad4398,8d23e3aa36ad439801fcbec6ef3f7f80647ed70d3b9ed11157539e72e771b38b,68.02675,4000,1,proposals,2,2,False
+sha256-81da035ff6af575f,81da035ff6af575fcaded1a4dfc3162bb6377a033c0d840af490eba47a879998,77.43075,4000,1,proposals,8,2,False
+sha256-ec5ff2e4d78d6852,ec5ff2e4d78d68521c7f65fcf030c7b49131c18cb3c018900e61cf06382bcdf7,132.41575,4000,1,proposals,4,4,False
+sha256-e71592a17f8b1d82,e71592a17f8b1d82746f3915af9810066afefb54810443efe99fd0e081606319,151.9205,4000,1,proposals,3,2,False
+sha256-b04a46541d3adf35,b04a46541d3adf35419faf1e15ca5f02cfd93b4f99f2c3d5cd25dce5531066c8,60.89825,4000,1,proposals,3,2,False
+sha256-a5e4bad00fc13828,a5e4bad00fc1382824218e92f0da9ffb97223e5dfcccd35cf22bf0e354b72c8f,101.5795,4000,1,proposals,8,5,False
+sha256-7202a8a433276507,7202a8a4332765074c85af28ade258f41170f62e5356c4bf866f5775d25d1429,143.3755,4000,1,proposals,14,6,False
+sha256-fe241d8839128daf,fe241d8839128daf85de79606f0663333c6c32a40d50ab5043f32d36586440ac,147.0455,4000,1,proposals,4,3,False
+sha256-02d2acc40e897b4b,02d2acc40e897b4b3a83c05f2ec89af4c10f0ccb17a1ea0a8fa7f1530e72eb39,74.0,4000,1,proposals,3,2,False
+sha256-427a7575ec97a84f,427a7575ec97a84feb8fe81f7fb8b1cff5a122e79223fba11d5327c0ba9e1179,129.62925,4000,1,proposals,28,27,False
+sha256-8edaf3c4a5a6f437,8edaf3c4a5a6f4370b979842bc38b3755a3930f8befa017795991d3d8224a657,77.9255,4000,1,proposals,6,6,False
+sha256-2002081930df3f5b,2002081930df3f5b6e6ea9a6e6ce97fe65a712c9e02fe720f12f2f45e0602e81,64.6135,4000,1,proposals,5,5,False
+sha256-46b7905f230dc5cc,46b7905f230dc5cc8dc0e9485a88ab2b3b544737d62c20b96b34ea2d460b84c9,181.45625,4000,1,proposals,7,5,False
+sha256-520153c1e15d1ebf,520153c1e15d1ebf75cb713ca3fb158ecd73594a5dd8a6490b1baee4e2a98036,95.26375,4000,1,proposals,5,3,False
+sha256-9a800515b85817e0,9a800515b85817e09b418ff125a3d71723fd9922b978a317017bf5098ed77c0b,77.9255,4000,1,proposals,4,4,False
+sha256-9164e2702d0e24b9,9164e2702d0e24b9620f4511a1ee21758a7d501cb00867dd04089ca0b846e30f,112.5395,4000,1,proposals,5,5,False
+sha256-7b34ab4933a7c419,7b34ab4933a7c4193f9e668d42fa4d7cb94a0b754b25eb84ebddbca227419b7a,109.01,4000,1,proposals,8,4,False
+sha256-a06237f42d5789ff,a06237f42d5789ff0b868e636b45f86974f61c4318f6ddb01865129245111ee5,74.08725,4000,1,proposals,2,1,False
+sha256-a19c78d9d147a6e8,a19c78d9d147a6e8b4b2c495bd344787363875ea411e3af21b59490517832495,114.448,4000,1,proposals,6,6,False
+sha256-676e3cb4e3494176,676e3cb4e34941760a1f3df031d551e0aa7e1d69d4e9085a05a91e2029a87c19,98.42175,4000,1,proposals,2,2,False
+sha256-7834bad6d620df21,7834bad6d620df2143b396325fd861d6581d5ad25dd9bcfa997eb953d13a65f5,137.488,4000,1,proposals,5,3,False
+sha256-3cfa0ca3a58db714,3cfa0ca3a58db714074487004ca3b7505ab9ee4e4882b7efbfdf62f8d7f1a426,47.33775,4000,1,no_proposals,0,0,False
+sha256-032ff198c6c85997,032ff198c6c85997758a2893641d7a87cb21d9f4bb847dd261cca8fd67df2ae8,119.22675,4000,1,proposals,3,3,False
+sha256-d2e839c8a95f5382,d2e839c8a95f53824cabb294748aaf63f5714a2add6a414c4f8cdd4c4db9e293,92.09075,4000,1,proposals,20,18,False
+sha256-0fdf8b328b9e02ff,0fdf8b328b9e02ff83144b634f5a6ced115cac4672b89557e1aae3151ab7612d,68.368,4000,1,proposals,3,3,False
+sha256-c732dff1b1914289,c732dff1b19142894931fcd87febdb70a18daa472c316e5c6f36ac6dfe3debc1,64.242,4000,1,proposals,1,1,False
+sha256-e9e57696eb1d1a80,e9e57696eb1d1a80eaf4688f4bce068398afcf6f9bb8732d72dba8833837255e,41.7745,4000,1,no_proposals,0,0,False
+sha256-56aef7ec190822a0,56aef7ec190822a03f78764d5d91d22c1f8181e4b672a453c04c899d2cb0a0c9,80.0315,4000,1,proposals,1,1,False
+sha256-bea85232822bb070,bea85232822bb0702e9af8c825934aa27cf04bbb0665db8e15ceae87f552e690,48.912,4000,1,proposals,3,2,False
+sha256-70dc6c4edc47d56c,70dc6c4edc47d56c85c8d24ae6ac34a640bfaa5bbf23a908f2dd2244d7534e06,79.84575,4000,1,proposals,2,1,False
+sha256-e9ba69a70a8a2c2e,e9ba69a70a8a2c2eb79c06094e9c250c7490af738871ed03b52ba1bd809e94a2,40.64775,4000,1,proposals,1,1,False
+sha256-10b83e163e84784d,10b83e163e84784d5d9952857160fb17d30dc6a1687c6fa159c0d54c3078323d,46.22325,4000,1,no_proposals,0,0,False
+sha256-2f374f6244cfe5da,2f374f6244cfe5dad8a200b427e392a4c64540d4cb0bc4a621e34aac229c3ea4,105.4805,4000,1,proposals,2,2,False
+sha256-87ccca3294b374e3,87ccca3294b374e3a8c4ae7362c5d67c3cfa12bdf4ddaa576a06d07ff60be8c2,104.366,4000,1,no_proposals,0,0,False
diff --git a/docs/LIVERMORE_AUDIO_SCANNER.md b/docs/LIVERMORE_AUDIO_SCANNER.md
new file mode 100644
index 0000000..118a154
--- /dev/null
+++ b/docs/LIVERMORE_AUDIO_SCANNER.md
@@ -0,0 +1,25 @@
+# Real Livermore audio scanner run
+
+This run applies automatic whole-recording intake and Doppler-event discovery to the 40 real WAV recordings in the public [Zenodo Livermore aircraft dataset](https://zenodo.org/records/23424278). The record includes frequency-versus-time annotations and ADS-B KML tracks and is published under CC BY 4.0. The media remain outside this repository.
+
+## Blind scan
+
+All 40 `audio.wav` files were selected by walking the extracted record in sorted path order. Before intake, each WAV was given an opaque name derived from its SHA-256. The scanner received audio only; it was not given the case IDs, frequency traces, KML tracks, UTC metadata, coordinates, or flight labels. The run used `intake_recording` and the default `DiscoverySettings` from production source revision `3e38642`, with no historical-flight matching or geolocation.
+
+Run command:
+
+```bash
+PYTHONPATH=src python scripts/scan_zenodo_audio_corpus.py \
+ --audio-root /path/to/zenodo-23424278/extracted \
+ --output-dir /path/to/zenodo-23424278/scanner-v1
+```
+
+The output directory must be empty. The compact result table `benchmarks/zenodo-livermore-scanner-v1/summary.csv` records each opaque clip hash, proposal status, ridge count, harmonic-group count, and audio metadata. Full ridge JSON stays in the local run output instead of bloating the repository. `benchmarks/truth-separated/zenodo-livermore-annotations-v1.csv` maps opaque hashes to the publisher's case IDs, annotation files, and linked track names after scanning.
+
+## Outcome
+
+The scan completed all 40 recordings (3,605.33 seconds total). Thirty-five produced at least one moving-tone proposal and five produced none. The outputs contain 182 ridge proposals grouped into 137 harmonic groups. These counts describe scanner output only; proposal presence does not establish an aircraft source, and a no-proposal result is a scanner miss relative to a candidate dataset, not proof that the recording has no aircraft sound.
+
+The separate source map exists only to preserve provenance and enable later review against the publisher's frequency annotations. Its UTC and track fields were not scanner inputs. Exact recorder coordinates are not published in this record, so this is a real-audio scanner corpus, not a known-location localization benchmark. Do not count it toward the project's 20 known-location / 5 unknown-location acceptance target.
+
+Source audio was used for discovery and remains local; it is not committed. No synthetic data was used or committed. No flight matching, location search, or threshold tuning was run. Local per-clip JSONs retain the discovered ridges and settings.
diff --git a/scripts/scan_zenodo_audio_corpus.py b/scripts/scan_zenodo_audio_corpus.py
new file mode 100644
index 0000000..46c75bd
--- /dev/null
+++ b/scripts/scan_zenodo_audio_corpus.py
@@ -0,0 +1,103 @@
+"""Blind whole-recording Doppler scan for public Zenodo WAV corpora.
+
+This runner reads audio files only. It deliberately accepts no time, location,
+flight-track, or event-label inputs and performs no matching or geolocation.
+"""
+import argparse
+import csv
+import hashlib
+import json
+from pathlib import Path
+
+from dopplergeist.discovery import DiscoverySettings, discover_events
+from dopplergeist.intake import intake_recording
+
+
+def _sha256(path):
+ digest = hashlib.sha256()
+ with Path(path).open("rb") as stream:
+ for block in iter(lambda: stream.read(1024 * 1024), b""):
+ digest.update(block)
+ return digest.hexdigest()
+
+
+def scan(audio_root, output_dir):
+ audio_root = Path(audio_root).resolve()
+ output_dir = Path(output_dir).resolve()
+ if not audio_root.is_dir():
+ raise ValueError("audio_root must be a directory")
+ if output_dir.exists() and any(output_dir.iterdir()):
+ raise FileExistsError("Output directory must be new or empty")
+ output_dir.mkdir(parents=True, exist_ok=True)
+ blind_inputs = output_dir / "blind-inputs"
+ blind_inputs.mkdir()
+ scan_root = output_dir / "scans"
+ scan_root.mkdir()
+
+ sources = sorted(path for path in audio_root.rglob("*.wav")
+ if "__MACOSX" not in path.parts and not path.name.startswith("._"))
+ if not sources:
+ raise ValueError("No WAV files found")
+
+ settings = DiscoverySettings()
+ rows = []
+ for source in sources:
+ digest = _sha256(source)
+ clip_id = f"sha256-{digest[:16]}"
+ blind_audio = blind_inputs / f"{clip_id}.wav"
+ if not blind_audio.exists():
+ blind_audio.symlink_to(source)
+ recording = intake_recording(blind_audio, output_dir / "intake" / clip_id)
+ events = discover_events(recording, settings=settings, plot_summary=False,
+ plot_event_details=False)
+ groups = sorted({event["harmonic_group_id"] for event in events})
+ result = {
+ "clip_id": clip_id,
+ "source_sha256": digest,
+ "duration_s": recording.metadata["duration_s"],
+ "sample_rate_hz": recording.metadata["sample_rate_hz"],
+ "channels": recording.metadata["channels"],
+ "time_window_used": False,
+ "flight_data_used": False,
+ "location_data_used": False,
+ "status": "proposals" if events else "no_proposals",
+ "proposal_count": len(events),
+ "harmonic_group_count": len(groups),
+ "aircraft_identity_confirmed": False,
+ "settings": settings.__dict__,
+ "events": events,
+ }
+ (scan_root / f"{clip_id}.json").write_text(
+ json.dumps(result, indent=2, allow_nan=False) + "\n")
+ rows.append({key: result[key] for key in (
+ "clip_id", "source_sha256", "duration_s", "sample_rate_hz", "channels",
+ "status", "proposal_count", "harmonic_group_count", "aircraft_identity_confirmed")})
+ print(clip_id, result["status"], len(events), len(groups), flush=True)
+
+ with (output_dir / "summary.csv").open("w", newline="") as stream:
+ writer = csv.DictWriter(stream, fieldnames=list(rows[0]))
+ writer.writeheader()
+ writer.writerows(rows)
+ metadata = {
+ "source": "https://zenodo.org/records/23424278",
+ "scope": "whole-recording audio intake and acoustic Doppler proposals only",
+ "selection": "all WAV files under audio_root, sorted by relative path",
+ "ground_truth_inputs_used": False,
+ "flight_matching_or_geolocation_run": False,
+ "settings": settings.__dict__,
+ "clip_count": len(rows),
+ }
+ (output_dir / "scan-manifest.json").write_text(
+ json.dumps(metadata, indent=2, allow_nan=False) + "\n")
+
+
+def main():
+ parser = argparse.ArgumentParser(description=__doc__)
+ parser.add_argument("--audio-root", type=Path, required=True)
+ parser.add_argument("--output-dir", type=Path, required=True)
+ args = parser.parse_args()
+ scan(args.audio_root, args.output_dir)
+
+
+if __name__ == "__main__":
+ main()