Overview

The Optikal Physics Suite is a comprehensive simulation framework for Free-Space Optical (FSO) communications. It includes optical beam propagation, atmospheric modeling, orbital mechanics, and ML-based weather prediction.

Architecture

• Backend: Python 3.8-3.11, FastAPI, async SQLAlchemy
• Database: PostgreSQL + pgvector (Cloud SQL)
• Dashboard: React 18 + Three.js (3D beam visualization)
• Physics Engines: 6 containerized engines (Drake, FEniCSx, GNU Radio, OpenEMS, OpenFOAM, WRF)
• Deployment: GCP Cloud Run (optikal-api)

Key Features

• Optical beam propagation and atmospheric modeling
• Orbital mechanics and space environment simulation
• ML-based weather prediction (LSTM)
• GPU acceleration (CUDA/OpenCL/CPU fallback)
• Multi-site distributed simulation
• 799+ tests (71% coverage)
• JWT auth, multi-tenant support

Build Commands

pip install -r requirements.txt && pip install -e .
pytest                          # Fast tests
pytest -m slow                  # Physics simulations
cd api && uvicorn main:app
cd dashboard && npm run dev