Helio-SolarSail 🚀

Helio-SolarSail (heliosail-rx) is an advanced, high-performance interplanetary solar sail simulation and trajectory analysis engine featuring a full Python physics backend and an interactive browser-based visualization dashboard.

Features

• Advanced Physics Engine: Accurately simulates solar radiation pressure, orbital mechanics (including N-body gravity assists, atmospheric drag, solar cycles, and CMEs), structural sail dynamics, and thermal modeling.
• Hybrid Propulsion: Supports pure solar sails (flat-plate or gossamer) as well as hybrid concepts utilizing integrated Ion Thrusters.
• Persistent Mission Storage: All completed simulation trajectories and telemetry points are permanently saved to a local SQLite database (heliosail.sqlite) to guard against data loss.
• Interactive Web Dashboard: An elegant frontend (app.js and index.html) providing real-time mission queue management, live 3D Orbital Trajectory plots (via Plotly), and detailed 2D Ecliptic Plane rendering.
• Heliocentric Accuracy: Define missions starting exactly from Earth at 1 AU, or transfer directly to Mercury, Venus, Mars, the Jovian system, and beyond, with plot resolutions up to 10,000 steps for complete orbit visualization.

Getting Started

Prerequisites

• Python 3.9+
• A modern web browser (Edge, Chrome, Firefox)

Installation

1. Clone the repository:

   git clone https://github.com/SahilKhutey/Helio-SolarSail.git
   cd Helio-SolarSail/heliosail-rx

2. Install backend dependencies (if applicable):

   pip install fastapi uvicorn pydantic

   (Note: The core engine heavily utilizes the Python Standard Library and asyncio for simulation processing).

Running the Application

Windows Users (Easiest) Simply double-click the Launch-Heliosail.bat script inside the repository, or its generated shortcut Heliosail.lnk on your Desktop! It will automatically spawn the Uvicorn simulation API in the background and pop open the dashboard in your default browser.

Manual Start

1. Start the backend kernel:

   python -m uvicorn api.server:app

2. Open the UI: Navigate to http://127.0.0.1:8000 in your web browser.

Generating Mission Data

The repository includes a mass-generation script to help populate your analytics dashboard with 100 diverse interplanetary scenarios (various orbits, sail sizes, and architectures).

To run the generation suite:

python generate_100_missions.py

Wait a few minutes while the process pool calculates the non-linear physics trajectories and saves the orbital records directly to the SQL database.

---

Developed for advanced trajectory design and mission planning evaluation.