Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)
Python acoustic-geolocationads-baircraft-trackingairplaneaudio-forensicsdoppler-effectdoppler-shiftgeolocationosintsignal-processing
{
"config": {
"audio": "reference-recording.wav",
"tracks": [
"../adsb/2026-09-08/reference-region.parquet"
],
"type_database": "../adsb/2026-09-08/type-database.csv",
"max_track_gap_s": 30,
"terrain": {
"rasters": [
"../terrain/Copernicus_DSM_COG_10_N40_00_W074_00_DEM.tif"
],
"geoid_raster": "../terrain/us_nga_egm96_15.tif"
},
"grid": {
"bounds": [
-73.59,
40.83,
-73.47,
40.92
],
"spacing_m": 200,
"scoring_spacing_m": 100,
"refine_spacing_m": 25,
"refine_pairs": 5
},
"events": [
{
"start_s": 2100,
"end_s": 2280,
"band_hz": [
75,
190
],
"max_slope_hz_s": 4,
"max_up_slope_hz_s": 0.5,
"speed_range_mps": [
130,
154
],
"slant_range_m": [
4300,
7800
],
"f0_range_hz": [
110,
116
]
},
{
"start_s": 3040,
"end_s": 3125,
"band_hz": [
95,
185
],
"max_slope_hz_s": 4,
"max_up_slope_hz_s": 0.5,
"speed_range_mps": [
88,
110
],
"slant_range_m": [
1390,
4690
],
"f0_range_hz": [
126,
133
]
}
],
"filters": {
"offset_tolerance_s": 5,
"silence": {
"edge_margin_s": 100
}
},
"scoring": {
"mode": "brightness",
"time_sweep_s": 5,
"time_step_s": 0.5
}
},
"measured_events": [
{
"start_s": 2100,
"end_s": 2280,
"band_hz": [
75,
190
],
"max_slope_hz_s": 4,
"max_up_slope_hz_s": 0.5,
"speed_range_mps": [
130,
154
],
"slant_range_m": [
4300,
7800
],
"f0_range_hz": [
110,
116
],
"cpa_receive_s": 2155.715465159944
},
{
"start_s": 3040,
"end_s": 3125,
"band_hz": [
95,
185
],
"max_slope_hz_s": 4,
"max_up_slope_hz_s": 0.5,
"speed_range_mps": [
88,
110
],
"slant_range_m": [
1390,
4690
],
"f0_range_hz": [
126,
133
],
"cpa_receive_s": 3076.437754489226
}
],
"imports": [
{
"rows": 583176,
"segments": 3587,
"known_jets_excluded": [],
"altitude_basis_counts": {
"ellipsoidal": 580855,
"ellipsoidal_interpolated": 1729,
"barometric": 592
},
"unknown_types_retained": true,
"path": "/home/cinna/aircraft-audio-geolocation/data/source/../adsb/2026-09-08/reference-region.parquet"
}
],
"sources": [
{
"path": "/home/cinna/aircraft-audio-geolocation/data/source/reference-recording.wav",
"sha256": "262d9c4eba1c80657813c604140ba2afbbaabed2b3aebc833cba7cafdc005e9f"
},
{
"path": "/home/cinna/aircraft-audio-geolocation/data/adsb/2026-09-08/reference-region.parquet",
"sha256": "fa4e2b82849b3ea8c22ffbe50d4f8f00b7bb3727486307feeaab4821562718a0"
}
],
"implementation_sha256": "78b31eb9b6d9c87470f7d718beecb3ea5920a4688d59522d440e5accaa970817",
"coarse_filter_counts": {
"per_event_survivors": [
10262,
17428
],
"pairs_before_silence": 52,
"silence_rejected": 0,
"survivors": 52
},
"scoring_filter_counts": {
"per_event_survivors": [
1657,
2128
],
"pairs_before_silence": 209,
"silence_rejected": 0,
"survivors": 209
},
"ranked_points": 283,
"flight_combinations": 1,
"best": {
"score": 5.608620381268417,
"event_scores": [
2.62630103588047,
2.982319345387947
],
"f0_hz": [
112.4,
126.0
],
"recording_start_time_s": 1788898649.6620934,
"time_adjustment_s": -0.5,
"point_id": 41,
"lat": 40.87693175890468,
"lon": -73.52498229500986,
"elev_m": -31.25569725036621,
"x": 1861200.0,
"y": 2206325.0,
"flight_ids": [
"a1dfeb:1",
"ace391:3"
]
},
"elapsed_s": 103.08879212901229,
"scoring_time_is_locked": true,
"ground_truth_used_by_search": false
}