Technical Documentation & Methodology
Aeroway documents its calculation models against published aeronautical, physics, engineering, and regulatory reference sources where applicable. We establish clear boundaries between theoretical mathematical physics, standardized aviation authority procedures, and practical pilot rules-of-thumb.
00 //Calculation Engine Architecture & Reproducibility
Aeroway combines statically generated documentation with client-side interactive calculation execution. The engineering design emphasizes reproducibility, transparent assumptions, and explicit source traceability:
Aeronautical calculations execute directly in the user’s browser via modular, tested TypeScript functions. Input parameters remain local on the client device.
Each calculation engine specifies its physical assumptions, valid operating ranges (e.g. subsonic vs. supersonic, standard lapse validity), and out-of-domain edge cases.
Internal calculation pipelines operate in canonical units without intermediate rounding, applying display formatting only at the presentation layer.
Calculation modules are accompanied by unit test suites asserting numerical outputs against published authority benchmarks and textbook examples.
Note: Reproducibility and structured test suites ensure mathematical consistency, but do not equate to regulatory certification or safety-critical airworthiness approval.
01 //The Four Mathematical Exactness Classes
Exact Mathematical Model
exact_modelExact within the stated mathematical model and assumptions (e.g. 2D vector wind triangle, runway crosswind trigonometry, scalar time-speed-distance). Represents theoretical kinematic physics, while real-world conditions remain subject to atmospheric turbulence and sensor variability.
Standardized Reference Method
standardized_referenceImplementation follows a codified civil aviation procedure or standardized international atmospheric table (e.g. ICAO Doc 7488 geopotential lapse, TERPS departure gradient calculations).
Engineering Approximation
engineering_approximationA simplified empirical relationship intentionally used for pilot-facing convenience where full thermodynamic modeling is impractical without airborne sensor suites (e.g. 120 × (OAT - ISA) for density altitude, 2.5°C spread for cloud base). Never represented as exact.
Screening Estimate
screening_estimateRough order-of-magnitude estimation intended solely for educational and preliminary planning checks. Must never be used in place of approved aircraft flight manuals or official operational procedures.
02 //Unit Conventions & Precision Boundary
1. Internal Canonical Precision: All calculation engines execute on native double-precision floating point numbers without premature intermediate rounding.
2. Presentation Boundary Rounding: Rounding is applied solely at the UI presentation boundary according to physical significance (e.g. 1 decimal for crosswinds, whole feet for pressure altitude).
3. Explicit Unit Labels: Every input and output explicitly declares its unit of measurement. Silent conversions or implicit assumptions are avoided.
03 //Aviation Safety Language Standard
Aeroway UI components use conservative, factual terminology:
- "Estimated value"
- "Calculated component"
- "Reference value under selected assumptions"
- "Verify against applicable AFM/POH"
- "Safe to fly"
- "Approved for flight"
- "Legal to depart"
- "Within aircraft limits" (without AFM data)
04 //Multi-Jurisdictional Regulatory Framework (FAA · EASA · ICAO)
A core principle of the Aeroway architecture is strict regulatory isolation. We never assume United States FAA rules apply universally to pilots operating in Europe, the United Kingdom, Canada, or under international ICAO Annex standards.
Whenever a regulatory calculation mode is activated (e.g. minimum fuel reserves or cloud distance minimums), the receiving engine visibly identifies the governing rule: e.g. FAA 14 CFR § 91.151 versus EASA Part-NCO.OP.125.
Altimetry and weather modules support both U.S. customary units (inHg) and European/ICAO standard units (hPa / millibars) with exact 33.8639 hPa/inHg conversion factors.
Safety notices cite both 14 CFR § 91.3 and EASA NCO.GEN.105, reminding aviators across all jurisdictions that digital calculators never supersede Pilot-in-Command authority or approved Aircraft Flight Manual (AFM/POH) limitations.
05 //Engine-Specific Validation & Numerical Tolerance Matrix
Universal numerical tolerances (e.g. 10-4) are physically invalid across differing aviation scales. Aeroway defines and tests calculation tolerances on a per-engine basis against codified standard benchmarks:
| Calculation Engine | Model Nature | Canonical Unit | Operating Scale | Allowed Tolerance | Benchmark Reference |
|---|---|---|---|---|---|
| Density Altitude | Standardized Reference | Feet (ft) | -2,000 to +25,000 ft | ±1.0 ft | ICAO Doc 7488/3 Table C |
| Pressure Altitude | Standardized Reference | Feet (ft) | -1,000 to +15,000 ft | ±1.0 ft | NOAA / US 1976 Table 4 |
| True Airspeed (Subsonic) | Derived Aerodynamic | Knots (kt) | 40 to 450 kt | ±0.1 kt | ISO 2533 / NASA Pitot Spec |
| Mach Number | Exact Thermodynamic | Mach (M) | 0.100 to 0.999 M | ±0.001 M | ICAO Doc 7488 Section 2 |
| Crosswind / Headwind | Exact Trigonometric | Knots (kt) | 0 to 150 kt | ±0.1 kt | Analytical sin/cos Trig |
| Wind Correction Angle | Exact Kinematic | Degrees (°) / kt | WCA: ±90°, GS: 0-600 kt | ±0.1° / ±0.1 kt | Planar Wind Vector Triangle |
| Cold Temperature Altimetry | Standardized Reference | Feet (ft) | 0 to 5,000 ft HAA | ±1.0 ft | ICAO Doc 8168 Cold Table |
| Climb Gradient | Exact Kinematic | ft/NM / % | 0 to 2,000 ft/NM | ±0.1 ft/NM | FAA Order 8260.3G (TERPS) |
| Weight & Balance | Exact Rigid-Body Statics | Inches (in) / lb-in | CG: 50-250 in, M: 10³-10⁶ | ±0.01 in | FAA-H-8083-1B Moments |
| Fuel Burn & Reserves | Derived Operational | Gallons / Pounds | 1.0 to 1,000.0 gal | ±0.1 gal / ±0.1% | Scalar Rate x Time |
| Takeoff / Landing Distance | Educational / Reference | Feet (ft) | 500 to 10,000 ft | Reference Model Only | FAA AC 91-79B / CAP 778 |
| Cloud Base (AGL) | Empirical Approximation | Feet (ft) | 0 to 15,000 ft AGL | ±50 ft (Approximation) | FAA-H-8083-28 (2.5°C Spread) |