Skip to content

feat(cockpit): add geodesic destination coordinate projection and knots/kmh speed conversions - #7

Merged
ATLURI0001 merged 1 commit into
mainfrom
feat/cockpit-destination-coord-and-kmh-conversions
Nov 14, 2026
Merged

ATLURI0001 merged 1 commit into
mainfrom
feat/cockpit-destination-coord-and-kmh-conversions

Conversation

@ATLURI0001

Copy link
Copy Markdown
Owner

Contract & Sanitization Breakdown

1. Invariant & Contract Analysis

Cockpit telemetry computation and tactical projection require:

  • Forward geodesic destination point calculation (destinationCoordinate) to project aircraft and maritime waypoints based on current position, distance along a great-circle path, and initial bearing. Without explicit bounding, out-of-range latitude/longitude or negative distances produce NaN or invalid trigonometric domains (asin > 1.0).
  • Speed conversions between international knots and kilometers per hour (knotsToKmh, kmhToKnots), which must guard against negative speeds, non-finite values, and floating-point precision artifacts.

2. Sanitization Implementation

  • Geodesic Destination Point: Added destinationCoordinate(lat, lon, distanceM, bearingDeg):
    • Enforced strict coordinate range validation: lat in [-90, 90], lon in [-180, 180], and distanceM >= 0.
    • Clamped Math.asin domain arguments to [-1.0, 1.0] to eliminate floating-point precision domain errors.
    • Normalized resulting longitude into standard [-180, 180) range.
  • Speed Unit Conversions:
    • knotsToKmh: Converts knots to km/h using exact factor 1.852, returning null for non-finite or negative inputs.
    • kmhToKnots: Inverse conversion with guarded boundaries.

3. Verification & Test Suite

  • Executed node --test src/cockpitMath.test.mjs
  • Added comprehensive assertions for:
    • Destination point at 0 distance and along prime meridian.
    • Non-finite and out-of-bounds parameter guards.
    • Bidirectional knot <-> km/h conversions.
  • Result: 38 passed, 0 failed (138.4ms).

@ATLURI0001
ATLURI0001 merged commit 00514e0 into main Nov 14, 2026
0 of 3 checks passed
@ATLURI0001
ATLURI0001 deleted the feat/cockpit-destination-coord-and-kmh-conversions branch November 14, 2026 07:49
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