Skip to content

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

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.json
index 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.md
index 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.