Skip to content

feat(tracking): add 3D ENU alpha-beta kinematic filter and ADS-B dead-reckoning extrapolator - #17

Merged
ATLURI0001 merged 1 commit into
mainfrom
feat/alpha-beta-kinematic-track-filter
Nov 18, 2026
Merged

ATLURI0001 merged 1 commit into
mainfrom
feat/alpha-beta-kinematic-track-filter

Conversation

@ATLURI0001

Copy link
Copy Markdown
Owner

1. Functional Contract Changes

  • Local Tangent-Plane Projection (geodeticToLocalEnu, localEnuToGeodetic):
    • Transforms geodetic WGS-84 coordinates (lat, lon, altitudeM) into metric East-North-Up offsets relative to track origin with anti-meridian wrap handling ($\Delta\lambda \in [-180^\circ, 180^\circ]$).
  • 3D Alpha-Beta Kinematic Filter (AlphaBetaTrackFilter):
    • Smooths asynchronous ADS-B position and velocity fixes in ENU space via linear predictor-corrector updates:
      $$x_k = \hat{x}{k|k-1} + \alpha r_k, \qquad v_k = v{k-1} + \frac{\beta}{\Delta t} r_k$$
    • Bootstraps velocity cleanly from the first two valid fixes before switching into steady-state $\alpha$-$\beta$ filtering.
  • Bounded Dead-Reckoning Extrapolation (predictAt):
    • Projects current velocity forward up to maxExtrapolationSec, outputting geodetic coordinates, ground speed (m/s), climb rate (m/s), true heading (deg), and a stale flag when the horizon cap is exceeded.

2. Kinematic Gating & Input Sanitization Matrix

Failure Mode Detection Rule Filter Action
ADS-B Multipath / Teleportation Implied horizontal speed $> \text{maxSpeedMps}$ Rejected with reason: 'kinematic_outlier'; increments rejectedOutliers
Out-of-Order Feed Packet $\Delta t \le 0$ Rejected with reason: 'non_monotonic_timestamp'; state untouched
Invalid Geodetic Fix Non-finite or lat ∉ [-90,90] / lon ∉ [-180,180] Rejected with reason: 'invalid_coordinates'
Feed Drop / Stale Horizon $t_{\text{target}} - t_{\text{last}} > \text{maxExtrapolationSec}$ Clamps extrapolation to cap and sets stale: true

3. Verification & Test Suite

  • Added src/trackFilter.test.mjs validating anti-meridian ENU round-trips, climbing cruise velocity convergence, forward dead-reckoning, staleness capping, and outlier/non-monotonic rejection.
  • Executed node --test src/trackFilter.test.mjs src/cockpitMath.test.mjs: 49/49 tests passed in 159.2ms.

@ATLURI0001
ATLURI0001 merged commit 8db7906 into main Nov 18, 2026
0 of 3 checks passed
@ATLURI0001
ATLURI0001 deleted the feat/alpha-beta-kinematic-track-filter branch November 18, 2026 05:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant