Update README.md
Browse files
README.md
CHANGED
|
@@ -3,32 +3,41 @@ license: mit
|
|
| 3 |
tags:
|
| 4 |
- aerospace
|
| 5 |
- physics-informed-neural-network
|
| 6 |
-
- pytorch
|
| 7 |
- pinn
|
|
|
|
| 8 |
- surrogate-model
|
|
|
|
| 9 |
library_name: pytorch
|
| 10 |
---
|
| 11 |
|
| 12 |
# 🚀 ALRITHM-Astro
|
| 13 |
|
| 14 |
-
**ALRITHM-Astro** is an AI-powered Aerospace Engineering Copilot designed to simulate rocket flight dynamics and predict Maximum Dynamic Pressure (Max Q).
|
| 15 |
|
| 16 |
-
🔗 **[Try the Live Demo Here](https://godela-web.vercel.app)** *(Hãy thay bằng link Vercel thực tế của bạn)*
|
| 17 |
|
| 18 |
## 🏛️ Powered by Alrithm
|
| 19 |
This project is fundamentally built upon and inspired by the vision of **[Alrithm](https://alrithmapi.vercel.app)**.
|
| 20 |
|
| 21 |
-
- **Data Source:** The machine learning models in this project were fine-tuned exclusively on the **`alr-aerospace-platform-0.2`** dataset, fetched via the official Alrithm API.
|
| 22 |
- **Philosophy:** Alrithm provides rigorously verified, high-fidelity aerospace data. ALRITHM-Astro serves as a demonstration of how developers can leverage Alrithm's verified data streams to build real-time, physics-informed AI applications.
|
| 23 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 24 |
## 🧠 Model Details
|
| 25 |
-
- **Architecture:** Multi-Layer Perceptron (MLP) with 256 hidden units.
|
| 26 |
- **Input Features:** 13 engineered physical features (e.g., Burnout Velocity, Thrust-to-Weight Ratio, Mass Ratio).
|
| 27 |
- **Output:** Maximum Dynamic Pressure (`max_q_kpa`).
|
| 28 |
- **Training:** 5-Fold Cross-Validation (Fine-tuned on Alrithm data).
|
| 29 |
|
| 30 |
## 🛠️ How to use this model
|
| 31 |
|
|
|
|
|
|
|
| 32 |
```python
|
| 33 |
import torch
|
| 34 |
import torch.nn as nn
|
|
@@ -45,8 +54,16 @@ class PureMLPModel_Deep(nn.Module):
|
|
| 45 |
def forward(self, x):
|
| 46 |
return self.net(x).squeeze(-1)
|
| 47 |
|
| 48 |
-
# Load model
|
| 49 |
-
checkpoint = torch.load("
|
|
|
|
|
|
|
| 50 |
model = PureMLPModel_Deep()
|
| 51 |
model.load_state_dict(checkpoint['model_state_dict'])
|
| 52 |
-
model.eval()
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 3 |
tags:
|
| 4 |
- aerospace
|
| 5 |
- physics-informed-neural-network
|
|
|
|
| 6 |
- pinn
|
| 7 |
+
- pytorch
|
| 8 |
- surrogate-model
|
| 9 |
+
- alrithm
|
| 10 |
library_name: pytorch
|
| 11 |
---
|
| 12 |
|
| 13 |
# 🚀 ALRITHM-Astro
|
| 14 |
|
| 15 |
+
**ALRITHM-Astro** is an AI-powered Aerospace Engineering Copilot designed to simulate rocket flight dynamics and predict Maximum Dynamic Pressure (Max Q). It combines a custom-trained Physics-Informed Neural Network (PINN) with a natural language interface.
|
| 16 |
|
| 17 |
+
🔗 **[Try the Live Demo Here](https://godela-web.vercel.app)** *(Hãy nhớ thay bằng link Vercel thực tế của bạn)*
|
| 18 |
|
| 19 |
## 🏛️ Powered by Alrithm
|
| 20 |
This project is fundamentally built upon and inspired by the vision of **[Alrithm](https://alrithmapi.vercel.app)**.
|
| 21 |
|
| 22 |
+
- **Data Source:** The machine learning models in this project were fine-tuned exclusively on the **`alr-aerospace-platform-0.2`** dataset, fetched via the official Alrithm API (`https://alrithmapi.vercel.app/api/v1/models`).
|
| 23 |
- **Philosophy:** Alrithm provides rigorously verified, high-fidelity aerospace data. ALRITHM-Astro serves as a demonstration of how developers can leverage Alrithm's verified data streams to build real-time, physics-informed AI applications.
|
| 24 |
|
| 25 |
+
## ✨ Features
|
| 26 |
+
- **Natural Language Processing:** Understands complex aerospace queries using Groq's LLMs (`openai/gpt-oss-120b`).
|
| 27 |
+
- **Physics-Informed Prediction:** Calculates Max Q with high precision using a custom PyTorch Neural Network trained on Alrithm's verified aerospace data.
|
| 28 |
+
- **Interactive 3D Visualization:** Renders the rocket's 3D trajectory in real-time using Plotly.js.
|
| 29 |
+
- **Full-Stack Architecture:** FastAPI backend (Render) + Vanilla JS frontend (Vercel).
|
| 30 |
+
|
| 31 |
## 🧠 Model Details
|
| 32 |
+
- **Architecture:** Multi-Layer Perceptron (MLP) with 256 hidden units and SiLU activation.
|
| 33 |
- **Input Features:** 13 engineered physical features (e.g., Burnout Velocity, Thrust-to-Weight Ratio, Mass Ratio).
|
| 34 |
- **Output:** Maximum Dynamic Pressure (`max_q_kpa`).
|
| 35 |
- **Training:** 5-Fold Cross-Validation (Fine-tuned on Alrithm data).
|
| 36 |
|
| 37 |
## 🛠️ How to use this model
|
| 38 |
|
| 39 |
+
You can load this model directly using PyTorch:
|
| 40 |
+
|
| 41 |
```python
|
| 42 |
import torch
|
| 43 |
import torch.nn as nn
|
|
|
|
| 54 |
def forward(self, x):
|
| 55 |
return self.net(x).squeeze(-1)
|
| 56 |
|
| 57 |
+
# 1. Load the ALRITHM-Astro model weights
|
| 58 |
+
checkpoint = torch.load("alrithm_astro_model.pth", map_location="cpu")
|
| 59 |
+
|
| 60 |
+
# 2. Initialize the architecture and load weights
|
| 61 |
model = PureMLPModel_Deep()
|
| 62 |
model.load_state_dict(checkpoint['model_state_dict'])
|
| 63 |
+
model.eval()
|
| 64 |
+
|
| 65 |
+
# 3. Retrieve the scalers for data normalization
|
| 66 |
+
scaler_x = checkpoint['scaler_x']
|
| 67 |
+
scaler_y = checkpoint['scaler_y']
|
| 68 |
+
|
| 69 |
+
print("✅ ALRITHM-Astro model loaded successfully!")
|