🐺 FENRIR: Defence Simulation Dashboard

Real-time missile guidance and intercept simulation, visualised through physics, mathematics, and code.

FENRIR is an open-source, real-time missile guidance simulation dashboard built with Python and Streamlit. It visualises pursuit and intercept dynamics in an interactive, educational interface designed for research, analysis, and experimentation.

---

🚀 Features

• Proportional Navigation (PN) Intercept simulation with adjustable parameters
• Optional Evasive Target behaviour for testing guidance robustness
• Top-Down Trajectory view (live-updating)
• Telemetry charts for range, LOS rate, and acceleration over time
• Data export to CSV for analysis
• Real-time dashboard built entirely in Python using Streamlit
• Modular backend for future extensions (e.g., seeker models, autopilot lag, radar view)

---

🧠 Concept

FENRIR demonstrates how classical missile guidance laws behave in dynamic pursuit scenarios. The simulation integrates missile and target kinematics in real time, allowing you to adjust key parameters such as the navigation constant N, maximum acceleration, and time step to see their effects instantly.

The name FENRIR comes from Norse mythology, the wolf destined to break its chains, symbolising relentless pursuit and unstoppable motion.

---

🧩 Project Structure

Fenrir/
│
├── core/                  # Physics and entity definitions
│   ├── engine.py
│   ├── entities.py
│   ├── dynamics.py
│   └── guidance.py
│
├── services/              # Scenario definitions and helpers
│   ├── scenarios.py
│   └── ...
│
├── ui/                    # User interface (Streamlit app)
│   └── streamlit_app.py
│
├── run.py                 # Entry point for local testing
├── pyproject.toml         # Poetry project file
├── requirements.txt       # Deployment dependencies
└── README.md

---

💻 Getting Started

Prerequisites

• Python ≥ 3.10
• Git
• Either Poetry or pip
• Streamlit, Matplotlib, NumPy, Pandas

Windows tip: Use PowerShell as admin for installs.
macOS tip: If using Homebrew Python, prefer python3 and pip3.

Installation

Pick a folder you like, then:

git clone https://github.com/TheVenetianWolf/Fenrir.git
cd Fenrir

Install dependencies into a virtualenv Poetry manages for you

poetry install

Run Dashboard

poetry run streamlit run ui/streamlit_app.py

Then Open URL provided (Usually streamlit opens it automatically in your default web browser)

For pip and venv

# Create & activate a virtual environment
python -m venv .venv
# macOS/Linux:
source .venv/bin/activate
# Windows PowerShell:
# .\.venv\Scripts\Activate.ps1

# Install dependencies
pip install -r requirements.txt  # If present
# If not present, install the core deps:
# pip install streamlit numpy pandas matplotlib scipy

Run the app

streamlit run ui/streamlit_app.py

Contributing

Pull requests and ideas are welcome! Please fork the repository and submit a PR with clear commit messages. Discussions about physics modelling, simulation fidelity, or user experience are encouraged.

License

This project is released under the MIT License. See LICENSE file for details.

Citation

If you use FENRIR in research or teaching, please credit it as:

FENRIR: Open-Source Defense Simulation Dashboard, 2025
https://github.com/TheVenetianWolf/Fenrir

🐾 Acknowledgements

Inspired by classical missile guidance theory and the curiosity to visualise physics beautifully.