Maritime Awareness / Drift Simulation

SeaCommons live drift overview

SeaCommons combines distress intake, weather context and drift projection in one clear operational view. The simulation shows how a reported position can evolve into 6 h, 12 h and 24 h search areas for rescue, monitoring and forensic review.

operational demo FastAPI + React OpenDrift signed forensic records
time / drift spread
t0 distress signal
sar intercept asset
x predicted intercept
6h cone / advisory
12h search spread
24h max envelope
wind / 18 kn / 072deg
current / 0.8 kn / 118deg
waves / 1.8 m / sea state moderate
sar / ets recalculating
wind

18 kn

direction

ENE

waves

1.8 m

current

0.8 kn

livedistress call active
liveweather stream updating
livedrift model recalculating
livesearch cones refreshed

What It Does

SeaCommons receives structured distress events from webhooks, Telegram, Twilio WhatsApp or SMS, ingests vessel and shipboard data, and renders a common operational picture locally in the browser. It is built for crews, operators, NGOs, watchdog organisations, security researchers and field teams that need immediate visibility without adding another opaque dependency to the chain.

The platform links observation, decision support and evidence. A single event can trigger drift computation, weather-derived survival context, anomaly escalation, vessel-state overlays and a signed forensic packet that preserves timing, context and computational output. The same substrate can support humanitarian SAR, maritime monitoring and selected defensive or conflict-adjacent tooling.

Core Capabilities

Distress Ingestion

Receives structured signals from webhook partners, Telegram, Twilio WhatsApp and SMS, then normalizes them into a reviewable internal event model.

Drift Projection

Runs Lagrangian particle trajectories through OpenDrift Leeway with per-vessel object-type mapping (rubber boat, life raft, fishing vessel, wooden boat). 6 h / 12 h / 24 h uncertainty cones via convex hull. IAMSAR ellipse output: roadmap.

Anomaly Correlation

Correlates seismic, infrasound, ionospheric, ADS-B, AIS and other signals into escalated threat states rather than isolated alerts.

Ionosphere + Ballistic

Monitors Kp and TEC perturbations through the ionospheric layer, flags `ballistic_candidate` events and contributes to `ballistic_confirmed` classification when correlated with infrasound or seismic evidence.

Vessel Intelligence

Maintains a vessel registry, shipboard event aggregation and chokepoint counts, supporting both open-water awareness and onboard read-only integration.

Threat Monitoring

Provides a base layer for monitoring spoofing, jamming, dark traffic, chokepoint pressure and other signatures relevant to hostile or strategically sensitive environments.

Weather + Probability

Combines Open-Meteo and CMEMS data with survival and interception logic so operators can score urgency and likely rescue windows.

Forensic Logging

Signs and hashes incidents so the operational record remains auditable, exportable and legally legible after the event.

How It Works

01 / ingest

A signal enters from operator input, Twilio, Telegram, webhook, AIS, NMEA or background sensor threads.

02 / classify

The backend validates the payload, enriches context and routes it into drift, anomaly, weather, vessel or probability workflows.

03 / render

The common operational picture updates with vessels, weather grids, drift cones, alerts, logs and scenario replays in a local browser UI.

04 / preserve

A signed packet and append-only event record preserve the operational chain beyond the live moment and into later review.

Why It Matters

Most maritime software assumes stable connectivity, fixed institutional infrastructure and a narrow operating model. SeaCommons is being shaped for the opposite condition: intermittent access, distributed actors, multi-sensor ambiguity, partial shipboard integration and the need to preserve evidence while still acting in real time. That makes it relevant not only to SAR, but also to border violence documentation, strategic maritime observation and defensive monitoring around contested routes or infrastructure.

Operational Context

The Red Sea and Strait of Hormuz — two of the world's most critical energy chokepoints — have seen sustained armed incidents since 2023. The Central Mediterranean remains the world's deadliest migration corridor, with systematic documentation of pushbacks and duty-to-rescue failures. In all three zones, the gap between what happened and what can be proven in a court or tribunal is measured in the quality of technical evidence.

SeaCommons produces reproducible, signed, time-stamped drift reconstructions. This is not an operational command system — it is a decision-support and evidence platform designed for actors who need to work with maritime data without being absorbed into the surveillance architectures they are trying to document. Deployment, permitted uses and governance are detailed in the technical documentation.

Ionosphere and Ballistic Layer

SeaCommons is not limited to maritime drift. In the current `seacommons` repository there is an ionospheric anomaly layer that tracks planetary Kp and TEC perturbations, using Madrigal-style vertical TEC baselines to detect anomalous disturbances. When a TEC spike exceeds threshold while geomagnetic conditions remain relatively quiet, the detector can classify the event as `ballistic_candidate` rather than a generic atmospheric anomaly.

That signal is then useful inside correlation, not on its own. The correlation engine upgrades threats to `ballistic_confirmed` when ionospheric evidence aligns with infrasound or seismic channels at sufficient confidence. In parallel, the drift stack also includes a `BallisticTerminal` solver for terminal-phase trajectory estimation, impact point projection and fragment radius output. So the ballistic aspect in SeaCommons is already present as both sensing logic and terminal modelling logic, even if the current page has so far foregrounded the maritime side more heavily.

Current Runtime

The current `seacommons` build is not just a drift simulator. It now includes `core/api/routes` for alerts, drift, anomaly, forensic, ingest, integrations, vessels, probability and weather, plus dedicated modules for sensors, chokepoints, ionosphere and shipboard event routing.

The frontend runtime is a React + Vite watch interface with map layers for AIS, weather, drift, forensic output, GNSS and ionosphere, while the backend also exposes ballistic terminal modelling and multi-sensor threat correlation paths for scenarios beyond SAR alone.

Documentation

The live dashboard runs in your browser as a single-page React application backed by FastAPI. Select a point on the map, choose vessel type and persons on board, and launch a run. The backend returns a projected track plus 6 h, 12 h and 24 h search cones over the base map.

Full documentation covers architecture, API reference, drift methodology, forensic packet schema, simulation scenarios, ethics and governance framework, and geopolitical deployment context. Deployment is Docker Compose, single-server, air-gapped capable.