# antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system architecture

> Architecture diagram of the GitHub repository antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system
- Repository: https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system

## Overview

CryoNav AI is a polar-voyage navigation dashboard: operators advance a voyage through escalating ice hazards, inspect routes and predicted drift, and receive risk guidance or collision/success alerts. The frontend fetches scenario data from the FastAPI backend, with local scenario data available when the backend is offline. The backend serves scenario and detection capabilities; a separate prediction engine provides YOLO detection, physics-based drift forecasts, and visualization. The README documents capabilities not fully visible in the excerpts; those links are included only where documented or indexed.

Main entry points: [`cryonav-ai/src/App.jsx`](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/App.jsx) (Dashboard app), [`ICEBERG_TRAJECTORY_PREDICTION/main.py`](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/main.py) (Prediction pipeline), [`cryonav-ai/src/components/Map/MainMap.jsx`](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/components/Map/MainMap.jsx) (Voyage map), [`cryonav-backend/app/detection_models/iceberg_detection/detect_icebergs.py`](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/detection_models/iceberg_detection/detect_icebergs.py) (YOLO detection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Voyage dashboard"]
  node_app["Dashboard app<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_scenario_data["Scenario data"]
  node_mock_data["Offline data<br/>[mockData.js]"]
  node_map["Voyage map<br/>[MainMap.jsx]"]
  node_route_lines["Route layers<br/>[RouteLines.jsx]"]
  node_dashboard_panels["Risk and voyage panels"]
  node_alerts["Voyage alerts"]
end

subgraph group_backend["Scenario API"]
  node_backend_api["Navigation API<br/>[main.py]"]
  node_iceberg_service["Iceberg service<br/>[iceberg_service.py]"]
  node_yolo_detect["YOLO detection<br/>[detect_icebergs.py]"]
  node_model_loader["Model loader<br/>[model_loader.py]"]
end

subgraph group_prediction["Ice analysis"]
  node_prediction_pipeline["Prediction pipeline<br/>[main.py]"]
  node_detection_integration["Detection integration"]
  node_drift_physics["Drift forecast<br/>[drift_physics.py]"]
  node_visualization["Forecast visualization<br/>[visualization.py]"]
  node_prediction_api["Prediction API<br/>[api_server.py]"]
end

subgraph group_decision["Route guidance"]
  node_risk_calc["Risk calculator<br/>[riskCalculator.js]"]
end

node_operator(("Vessel operator"))
node_browser(("Browser"))
node_satellite_image["Satellite imagery"]

node_operator -->|"uses"| node_browser
node_browser -->|"opens"| node_app
node_app -->|"requests data"| node_api_client
node_app -->|"renders"| node_map
node_app -->|"renders"| node_dashboard_panels
node_app -->|"renders"| node_alerts
node_app -->|"uses offline data"| node_mock_data
node_api_client -->|"calls endpoints"| node_backend_api
node_map -->|"renders routes"| node_route_lines
node_map -->|"gets ship position"| node_scenario_data
node_dashboard_panels -->|"calculates risk"| node_risk_calc
node_backend_api -->|"gets icebergs"| node_iceberg_service
node_iceberg_service -->|"runs detection"| node_yolo_detect
node_yolo_detect -->|"loads model"| node_model_loader
node_satellite_image -.->|"provides imagery"| node_yolo_detect
node_prediction_pipeline -->|"detects icebergs"| node_detection_integration
node_prediction_pipeline -->|"forecasts drift"| node_drift_physics
node_prediction_pipeline -->|"visualizes results"| node_visualization
node_prediction_api -->|"uses detection"| node_detection_integration
node_prediction_api -->|"uses forecasts"| node_drift_physics

click node_app "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/App.jsx"
click node_api_client "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/services/api.js"
click node_scenario_data "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/services/scenarioDataRequirements.js"
click node_mock_data "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/services/mockData.js"
click node_map "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/components/Map/MainMap.jsx"
click node_route_lines "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/components/Map/RouteLines.jsx"
click node_dashboard_panels "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/tree/main/cryonav-ai/src/components/Panels"
click node_alerts "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/tree/main/cryonav-ai/src/components/Modals"
click node_risk_calc "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/utils/riskCalculator.js"
click node_backend_api "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/main.py"
click node_iceberg_service "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/services/iceberg_service.py"
click node_yolo_detect "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/detection_models/iceberg_detection/detect_icebergs.py"
click node_model_loader "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/detection_models/iceberg_detection/model_loader.py"
click node_prediction_pipeline "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/main.py"
click node_detection_integration "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/src/detection_integration.py"
click node_drift_physics "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/src/drift_physics.py"
click node_visualization "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/src/visualization.py"
click node_prediction_api "https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/api_server.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_api_client,node_scenario_data,node_mock_data,node_map,node_route_lines,node_dashboard_panels,node_alerts,node_browser toneBlue
class node_backend_api,node_iceberg_service,node_yolo_detect,node_model_loader toneAmber
class node_prediction_pipeline,node_detection_integration,node_drift_physics,node_visualization,node_prediction_api toneMint
class node_risk_calc toneRose
class node_operator,node_satellite_image toneIndigo
```

## Components

### Voyage dashboard

- [Dashboard app](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/App.jsx): `cryonav-ai/src/App.jsx`
- [API client](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/services/api.js): `cryonav-ai/src/services/api.js`
- [Scenario data](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/services/scenarioDataRequirements.js): `cryonav-ai/src/services/scenarioDataRequirements.js`
- [Offline data](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/services/mockData.js): `cryonav-ai/src/services/mockData.js`
- [Voyage map](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/components/Map/MainMap.jsx): `cryonav-ai/src/components/Map/MainMap.jsx`
- [Route layers](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/components/Map/RouteLines.jsx): `cryonav-ai/src/components/Map/RouteLines.jsx`
- [Risk and voyage panels](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/tree/main/cryonav-ai/src/components/Panels): `cryonav-ai/src/components/Panels`
- [Voyage alerts](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/tree/main/cryonav-ai/src/components/Modals): `cryonav-ai/src/components/Modals`

### Scenario API

- [Navigation API](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/main.py): `cryonav-backend/app/main.py`
- [Iceberg service](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/services/iceberg_service.py): `cryonav-backend/app/services/iceberg_service.py`
- [YOLO detection](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/detection_models/iceberg_detection/detect_icebergs.py): `cryonav-backend/app/detection_models/iceberg_detection/detect_icebergs.py`
- [Model loader](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-backend/app/detection_models/iceberg_detection/model_loader.py): `cryonav-backend/app/detection_models/iceberg_detection/model_loader.py`

### Ice analysis

- [Prediction pipeline](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/main.py): `ICEBERG_TRAJECTORY_PREDICTION/main.py`
- [Detection integration](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/src/detection_integration.py): `ICEBERG_TRAJECTORY_PREDICTION/src/detection_integration.py`
- [Drift forecast](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/src/drift_physics.py): `ICEBERG_TRAJECTORY_PREDICTION/src/drift_physics.py`
- [Forecast visualization](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/src/visualization.py): `ICEBERG_TRAJECTORY_PREDICTION/src/visualization.py`
- [Prediction API](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/ICEBERG_TRAJECTORY_PREDICTION/api_server.py): `ICEBERG_TRAJECTORY_PREDICTION/api_server.py`

### Route guidance

- [Risk calculator](https://github.com/antobenedict2006/cryonav-ai-enabled-antarctic-sea-ice-iceberg-trajectory-and-navigation-decision-support-system/blob/main/cryonav-ai/src/utils/riskCalculator.js): `cryonav-ai/src/utils/riskCalculator.js`

### Other components

- **Vessel operator**
- **Browser**
- **Satellite imagery**

## Connections

- Vessel operator → Browser: uses (evidence: `README.md`)
- Browser → Dashboard app: opens (evidence: `README.md`)
- Dashboard app → API client: requests data (evidence: `cryonav-ai/src/App.jsx`)
- Dashboard app → Voyage map: renders (evidence: `cryonav-ai/src/App.jsx`)
- Dashboard app → Risk and voyage panels: renders (evidence: `cryonav-ai/src/App.jsx`)
- Dashboard app → Voyage alerts: renders (evidence: `cryonav-ai/src/App.jsx`)
- Dashboard app → Offline data: uses offline data (evidence: `cryonav-ai/src/App.jsx`)
- API client → Navigation API: calls endpoints (evidence: `README.md`)
- Voyage map → Route layers: renders routes (evidence: `cryonav-ai/src/components/Map/MainMap.jsx`)
- Voyage map → Scenario data: gets ship position (evidence: `cryonav-ai/src/components/Map/MainMap.jsx`)
- Risk and voyage panels → Risk calculator: calculates risk (evidence: `cryonav-ai/src/components/Panels/RiskStatusPanel.jsx`)
- Navigation API → Iceberg service: gets icebergs (evidence: `cryonav-backend/app/main.py`)
- Iceberg service → YOLO detection: runs detection (evidence: `cryonav-backend/app/services/iceberg_service.py`)
- YOLO detection → Model loader: loads model (evidence: `cryonav-backend/app/detection_models/iceberg_detection/detect_icebergs.py`)
- Satellite imagery → YOLO detection: provides imagery
- Prediction pipeline → Detection integration: detects icebergs (evidence: `ICEBERG_TRAJECTORY_PREDICTION/main.py`)
- Prediction pipeline → Drift forecast: forecasts drift (evidence: `ICEBERG_TRAJECTORY_PREDICTION/main.py`)
- Prediction pipeline → Forecast visualization: visualizes results (evidence: `ICEBERG_TRAJECTORY_PREDICTION/main.py`)
- Prediction API → Detection integration: uses detection (evidence: `ICEBERG_TRAJECTORY_PREDICTION/api_server.py`)
- Prediction API → Drift forecast: uses forecasts (evidence: `ICEBERG_TRAJECTORY_PREDICTION/api_server.py`)
