How saptarshi-adhikari/polaris works
POLARIS is a browser-based polar-navigation digital twin: operators inspect simulated or real maritime conditions, evaluate routes around dynamic ice hazards, and view navigation guidance on a map or radar display. The README documents the main simulation-to-navigation flow, asynchronous pathfinding, route comparison, and optional forecasting service; sampled code also confirms real-data mode and expert-review persistence. Several backend and UI connections are documented but not represented by sampled call sites, so those links are omitted where ownership is uncertain.
Main entry points: aiNavigator.js AI Navigator · main.js App Loop · modeManager.js Mode Manager · vectorField.js Drift Physics
Components 22
Digital Twin
- App Loop
src/js/main.js - Drift Physics
src/js/simulation/vectorField.js - Vessel Model
src/js/simulation/ship.js - Iceberg Model
src/js/simulation/iceberg.js - Map And Radar
src/js/render/canvasRenderer.js - UI Controls
src/js/ui/uiController.js
Environment Data
- Mode Manager
src/js/geo/modeManager.js - Demo Data
src/js/data/DemoDataProvider.js - Real Data
src/js/data/RealDataProvider.js - Antarctic Data
src/js/data/antarcticDataManager.js - Historical Replay
src/js/providers/realReplayEngine.js
Navigation Intelligence
- AI Navigator
src/js/ai/aiNavigator.js - Route Planner
src/js/ai/routePlannerCore.js - Route Worker
src/js/ai/routeWorker.js - Route Scoring
src/js/ai/decisionEngine.js - Route Comparison
src/js/ui/routeComparisonUI.js
Forecast Service
- Forecast API
backend/main.py - Forecast Models
backend/ml_api.py
Expert Review
- Review API
backend/review_api.py - Review Manager
backend/polaris_review_manager.py
Other components
- Operator
- Domain Reviewer
Connections 21
- Operator → UI Controls: operates
- UI Controls → App Loop: controls
- App Loop → Drift Physics: updates
- App Loop → AI Navigator: coordinates
- App Loop → Map And Radar: renders
- Drift Physics → Vessel Model: drives motion
- Drift Physics → Iceberg Model: drives drift
- Mode Manager → Demo Data: selects provider
- Mode Manager → Real Data: selects provider
- Mode Manager → Map And Radar: initializes map
- Real Data → Antarctic Data: reads samples
- Historical Replay → Real Data: reads observations
- AI Navigator → Route Planner: plans routes
- AI Navigator → Route Worker: dispatches search
- Route Worker → AI Navigator: returns waypoints
- AI Navigator → Route Scoring: scores candidates
- AI Navigator → Route Comparison: supplies options
- AI Navigator → Forecast API: requests forecasts
- Forecast API → Forecast Models: serves forecasts
- Domain Reviewer → Review API: submits annotations
- Review API → Review Manager: manages reviews