SPARK Documentation

AUTHOR: SPARK Engineering Team
PUBLISHED: July 17, 2026

---

Welcome

Welcome to the technical documentation for the SPARK Hybrid-Electric Flight Simulator.

This reference guide is designed for Project Managers, Engineers, and Developers to validate the assumptions, physical constants, and mathematical logic driving the application’s results.

The Simulation Dependency Map

Before diving into the math, use the interactive map below to explore how user inputs, physics constants, and hardware sizing cascade into the final financial outputs.

Drag the background to pan, scroll to zoom, and hover over any node to trace its exact path.

graph TD
    %% User Inputs
    subgraph UI[User Inputs]
        A[Flight Distance & Route]
        B[Aircraft Archetype]
        C[Battery Chemistry]
        D[Economic Parameters]
    end

    %% Physical Engine
    subgraph PE[Physics & Mission Engine]
        E[Aerodynamic Sizing]
        F[Mass & Weight Limits]
        G[Power Requirements]
        H[Flight Profile Integration]
    end

    %% Hardware Sizing
    subgraph HW[Hardware Sizing]
        I[Battery Pack Capacity]
        J[Thermal Constraints]
        K[Hybrid Power Split]
    end

    %% Economic Engine
    subgraph EC[Financial Engine]
        L[Direct Operating Costs]
        M[Capital & Leasing]
        N[Carbon Taxes]
        O[Revenue & Profitability]
    end

    %% Connections
    A --> H
    B --> E
    B --> F
    C --> I
    C --> J
    D --> L
    D --> M
    D --> N

    E --> G
    F --> G
    G --> H
    H --> K
    K --> I

    I --> M
    H --> L
    H --> N

    L --> O
    M --> O
    N --> O

    %% Styling
    classDef inputs fill:#e1f5fe,stroke:#0277bd,stroke-width:2px;
    classDef physics fill:#fff3e0,stroke:#e65100,stroke-width:2px;
    classDef hardware fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px;
    classDef finance fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px;

    class A,B,C,D inputs;
    class E,F,G,H physics;
    class I,J,K hardware;
    class L,M,N,O finance;

How this guide is structured

• Chapters 1 to 4 detail the physical and mathematical engines (aerodynamics, weather, battery constraints).
• Chapters 5 and 7 explain the economic translation of these physical constraints into Euros.
• Chapter 6 details the algorithmic logic used to find the optimal flight strategy.