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 integrated real-data timings and complete HTTP replay outcomes
Cinna Davise509a49dd4cf
diff --git a/benchmarks/results/performance-ci-20261103.json b/benchmarks/results/performance-ci-20261103.jsonindex a8bc7aa..bd483e7 100644--- a/benchmarks/results/performance-ci-20261103.json+++ b/benchmarks/results/performance-ci-20261103.json@@ -212,5 +212,310 @@}]}+ },+ "integrated_main_recheck": {+ "workflow_url": "https://github.com/1337isnot1337/DOPPLERGEIST/actions/runs/41659297200",+ "job_id": 125997965084,+ "source_commit": "d6a0c860bd5a64797b3bde29bb1f74c689d0ed52",+ "upstream_main_commit": "6d3e3f74c5bf896458cc9016f17b42ce8334ffbd",+ "baseline_commit": "d7cc1dd2e8089768253492b3269dfae97b3ad1a4",+ "environment": {+ "runner": "ubuntu-latest",+ "os": "Ubuntu 26.04.1",+ "python": "3.12",+ "numpy": "2.5.4",+ "scipy": "1.18.1",+ "pandas": "3.1.0"+ },+ "tests": {+ "passed": 8,+ "seconds": 25.32,+ "files": [+ "tests/test_real_prepared_measurements.py",+ "tests/test_real_geometry_kinematics.py",+ "tests/test_real_batch_scalar_parity.py"+ ]+ },+ "repeats_per_source": 2,+ "order": [+ "baseline",+ "current",+ "current",+ "baseline"+ ],+ "workloads": {+ "clock_plus_minus_10_seconds": {+ "clock_half_width_seconds": 10,+ "identical_results": true,+ "medians": {+ "baseline": {+ "wall_seconds": 5.6771493924999845,+ "cpu_seconds": 5.674728616,+ "peak_rss_mib": 308.34765625+ },+ "current": {+ "wall_seconds": 4.0176339275,+ "cpu_seconds": 4.0153330055000005,+ "peak_rss_mib": 306.146484375+ }+ },+ "speedup": {+ "wall_seconds": 1.4130579079494754,+ "cpu_seconds": 1.4132647549349067+ },+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim",+ "runs": [+ {+ "source": "baseline",+ "repetition": 1,+ "wall_seconds": 5.7199138139999945,+ "cpu_seconds": 5.717348961000001,+ "load_seconds_excluded": 1.287874199000015,+ "operations": {+ "scalar_fit_calls": 2456,+ "acoustic_calls": 53,+ "scored_candidates": 1055+ },+ "peak_rss_mib": 308.234375,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ },+ {+ "source": "current",+ "repetition": 1,+ "wall_seconds": 4.006179503999988,+ "cpu_seconds": 4.003721131000001,+ "load_seconds_excluded": 1.2751494819999891,+ "operations": {+ "scalar_fit_calls": 31,+ "acoustic_calls": 53,+ "scored_candidates": 1055+ },+ "peak_rss_mib": 306.66015625,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ },+ {+ "source": "current",+ "repetition": 2,+ "wall_seconds": 4.029088351000013,+ "cpu_seconds": 4.02694488,+ "load_seconds_excluded": 1.2728110799999968,+ "operations": {+ "scalar_fit_calls": 31,+ "acoustic_calls": 53,+ "scored_candidates": 1055+ },+ "peak_rss_mib": 305.6328125,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ },+ {+ "source": "baseline",+ "repetition": 2,+ "wall_seconds": 5.6343849709999745,+ "cpu_seconds": 5.632108271,+ "load_seconds_excluded": 1.292043026000016,+ "operations": {+ "scalar_fit_calls": 2456,+ "acoustic_calls": 53,+ "scored_candidates": 1055+ },+ "peak_rss_mib": 308.4609375,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ }+ ]+ },+ "clock_plus_minus_120_seconds": {+ "clock_half_width_seconds": 120,+ "identical_results": true,+ "medians": {+ "baseline": {+ "wall_seconds": 69.49676050400001,+ "cpu_seconds": 69.48799816799999,+ "peak_rss_mib": 367.59765625+ },+ "current": {+ "wall_seconds": 25.036850319000024,+ "cpu_seconds": 25.031823208,+ "peak_rss_mib": 356.361328125+ }+ },+ "speedup": {+ "wall_seconds": 2.775778886662119,+ "cpu_seconds": 2.775986295148973+ },+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim",+ "runs": [+ {+ "source": "baseline",+ "repetition": 1,+ "wall_seconds": 69.56896296100001,+ "cpu_seconds": 69.559489628,+ "load_seconds_excluded": 1.3471314579999785,+ "operations": {+ "scalar_fit_calls": 65207,+ "acoustic_calls": 850,+ "scored_candidates": 3905+ },+ "peak_rss_mib": 367.90234375,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ },+ {+ "source": "current",+ "repetition": 1,+ "wall_seconds": 25.045435080999994,+ "cpu_seconds": 25.040473193,+ "load_seconds_excluded": 1.3714127860000076,+ "operations": {+ "scalar_fit_calls": 72,+ "acoustic_calls": 850,+ "scored_candidates": 3905+ },+ "peak_rss_mib": 355.9375,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ },+ {+ "source": "current",+ "repetition": 2,+ "wall_seconds": 25.028265557000054,+ "cpu_seconds": 25.023173223,+ "load_seconds_excluded": 1.351237885000046,+ "operations": {+ "scalar_fit_calls": 72,+ "acoustic_calls": 850,+ "scored_candidates": 3905+ },+ "peak_rss_mib": 356.78515625,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ },+ {+ "source": "baseline",+ "repetition": 2,+ "wall_seconds": 69.424558047,+ "cpu_seconds": 69.416506708,+ "load_seconds_excluded": 1.3432170009999709,+ "operations": {+ "scalar_fit_calls": 65207,+ "acoustic_calls": 850,+ "scored_candidates": 3905+ },+ "peak_rss_mib": 367.29296875,+ "peak_rss_scope": "Worker lifetime through scoring, including imports and input loading",+ "retained": 100,+ "independent_groups": 16,+ "scope": "Recorded-input computation comparison; source-informed receiver/clock, no accuracy claim"+ }+ ]+ }+ }+ },+ "http_integration": {+ "purpose": "Complete-recording application-path integration. These two different scopes are not a speed comparison or an independent accuracy test.",+ "audio_bytes": 42085293,+ "audio_sha256": "e1c13dafd8d1634bbf84df843c31771318e15a31ebb86dd165af7ee312ab80a0",+ "clock_provenance": "Source-informed historical fit, not an independently measured recording clock.",+ "runs": {+ "full_domain": {+ "source_commit": "3725e9d2027d979e579ba9c347fb688ebf0895c3",+ "request": {+ "schema_version": 1,+ "search": {+ "coverage": "conus"+ },+ "time_window": {+ "start_utc": "2026-09-08T20:17:20Z",+ "end_utc": "2026-09-08T20:17:40Z",+ "source": "user",+ "source_detail": "Source-informed development replay around the historical fitted recording start; not independently measured recording time."+ }+ },+ "elapsed_s": 900.1373765550002,+ "timeout_s": 900.0,+ "verification_passed": false,+ "full_pipeline_observed": false,+ "full_pipeline_requirements_met": false,+ "implementation_unchanged": true,+ "status": null,+ "reason_code": null,+ "candidate_count": null,+ "event_count": null,+ "error": "TimeoutError: HTTP verification exceeded its declared time budget",+ "supported_decision": false,+ "location_accuracy_evaluated": false,+ "timed_out": true,+ "preserved_job_status": "cancelled",+ "stages_verified": [],+ "pipeline_errors": [],+ "service_exit_code": 0,+ "forced_kill": false+ },+ "bounded_region": {+ "source_commit": "d6a0c860bd5a64797b3bde29bb1f74c689d0ed52",+ "request": {+ "schema_version": 1,+ "search": {+ "coverage": "conus",+ "bounds_wsen": [+ -73.545,+ 40.865,+ -73.505,+ 40.895+ ]+ },+ "time_window": {+ "start_utc": "2026-09-08T20:17:20Z",+ "end_utc": "2026-09-08T20:17:40Z",+ "source": "user",+ "source_detail": "Source-informed integration replay around the historical fitted recording start and benchmark receiver region; not independently measured recording time or a location-accuracy evaluation."+ }+ },+ "elapsed_s": 247.04089488099999,+ "timeout_s": 600,+ "verification_passed": true,+ "full_pipeline_observed": true,+ "full_pipeline_requirements_met": true,+ "implementation_unchanged": true,+ "status": "inconclusive",+ "reason_code": "search_incomplete",+ "candidate_count": 23,+ "event_count": 18,+ "error": null,+ "supported_decision": false,+ "location_accuracy_evaluated": false,+ "timed_out": false,+ "preserved_job_status": "inconclusive",+ "stages_verified": [+ "automatic_provenance",+ "intake",+ "discovery",+ "acquisition",+ "search",+ "refinement",+ "decision"+ ],+ "pipeline_errors": [],+ "service_exit_code": 0,+ "forced_kill": false+ }+ }}}diff --git a/docs/PERFORMANCE.md b/docs/PERFORMANCE.mdindex 8402bd9..9f9406c 100644--- a/docs/PERFORMANCE.md+++ b/docs/PERFORMANCE.md@@ -211,5 +211,41 @@ The GitHub runner used Python 3.12, NumPy 2.5.4, SciPy 1.18.1, and pandas 3.1.0[The CI measurement record](../benchmarks/results/performance-ci-20261103.json) preserves all eight runs and their source revisions.These ratios support the local result on a second environment without pooling timings from different machines.-The complete HTTP replay uses the entire 3,600.1845-second reference recording and an explicit source-informed clock.-Its regional flight coverage cannot establish an accepted independent location.+### Integration with current main++The tested integration commit is `d6a0c860bd5a64797b3bde29bb1f74c689d0ed52`.+It includes main `6d3e3f7`, with PR #210's configured workers and PR #213's association traversal optimization.+The fitter changes preserve those concurrent changes.++[The integrated CI run](https://github.com/1337isnot1337/DOPPLERGEIST/actions/runs/41659297200) passed all eight real-input tests and both complete-output comparisons.+It used two alternating pairs per workload and the same scalar-consistent baseline.+Broad-window median CPU time was **69.4880 → 25.0318 seconds (2.7760×)**.+Narrow-window median CPU time was **5.6747 → 4.0153 seconds (1.4133×)**.+The CI measurement record includes all eight integration runs separately from the earlier measurements.+Python 3.11 and 3.14 installation, compilation, CLI, and packaged-asset checks also passed.++### Complete-recording HTTP checks++The full-domain HTTP replay used the entire 3,600.1845-second reference recording and an explicit source-informed clock.+It completed intake, discovery, and acquisition, then reached its 900-second limit during adaptive geographic search.+Its source remained unchanged, and the service stopped cleanly.+It did not complete refinement or a scientific decision.+The partial job and timeout receipt remain available for inspection.++This timeout does not establish a complete-pipeline speedup.+The current search subdivides dense tiles that the older historical replay omitted after budget failures.+That older elapsed time is not a comparison for equal work.++A separate HTTP replay on the integrated source passed the complete application-path check in **247.04 seconds**.+It used the same complete recording and clock window, with explicit source-informed bounds `[-73.545, 40.865, -73.505, 40.895]`.+The bounds contain four actual 2 km grid points.+The operator retained the original search budgets, solver settings, 500 m refinement spacing, and three finalists.+Discovery produced 18 ridge records in 16 independent groups.+The verifier checked intake, discovery, acquisition, search, refinement, and decision, including 23 returned diagnostic candidates.+Search processed both tiles, four coarse points, and 40 refinement points without tile or refinement failures.+The verifier reported no pipeline-evidence errors, unchanged source files, and clean service shutdown.++The scientific result was **`inconclusive / search_incomplete`**.+Incomplete regional flight coverage and remaining search/model limitations still prevent an accepted location.+The bounded replay verifies the complete application path, not nationwide completion or a speed ratio against the timed-out run.+The CI measurement record preserves both HTTP outcomes and their separate source revisions.