Rogue waves are extreme ocean events — 2.2× or more the surrounding wave height — that build without warning and vanish without a trace. We detect them in real time from the mathematics of finite-time blow-up in supercritical defocusing, using a symplectic nonlinear-Schrödinger solver instead of heuristics.
The problem no statistical model can solve.
No install. No browser of heavy setup. Just press go.
< 2.2 σ is everyday, ≥ 2.2 σ is rogue territory, flags bless blow-up.What the knobs mean, and the equations behind them.
| Parameter | Meaning | Where |
|---|---|---|
p |
Nonlinear exponent in i∂tψ = −(β₂/2)∇²ψ + γ|ψ|p−1ψ. Supercritical (p > 5) admits finite-time blow-up. |
edu · blow-up |
β₂ |
Dispersion coefficient (m²/s in production, tuned by sea state). | solver |
γ |
Nonlinearity — JONSWAP spectrum peak in production, constant in edu. | prod + edu |
Hs |
Significant wave height (m). Drives amplitude A = Hs/4. |
production |
Tp |
Peak period (s). Sets deep-water ω₀ = 2π/Tp and wave number k₀ = ω₀²/g. |
production |
resolution |
Grid size (256→1024). More points, finer crests, slower run. | education |
speed |
Time integrator speed multiplier for the education view. | education |
seed |
Randomness for the random-sea field, so every run is reproducible. | both |
Same engine, no browser — for scripts, servers and automation.
| Command | What it does |
|---|---|
cargo install --path . --root ~/.local | Build & install the rogue binary to ~/.local/bin. |
rogue predict data/sample-buoy.csv | Physical sea-state forecast from a CSV/TSV of t, hs, tp (optionally gamma). |
rogue predict sea.csv --json | Same forecast as machine-readable JSON (for hooks). |
rogue akhmediev rogue peregrine rogue ocean rogue blowup | Scenario solvers with conservation + blow-up + rogue diagnostics. |
./dev p sea.csv | Repo alias for the production forecast path. |
Runs are seeded and reproducible; the report prints mass / momentum / energy conservation and flagged rogue events.
Live feed from a buoy, bridge, coastal station or vessel — the solver runs where the data is.
Any instrument that outputs t, hs, tp works — wave buoys (Datawell, Spotter, TRIAXYS), shipboard X-band radars, coastal ADCP stations, drifting Waveriders, or a helmsman typing observations. CSV over serial, NMEA log, HTTP POST, or a plain file — Rogue reads all these.
Run rogue predict /dev/stdin --json in a watch loop or systemd timer. Every new row is a physical, dimensionality-correct forecast. JSON output drops straight into an alarm, a bridge display, or a routing-aid panel — no middleware.
No install on the vessel — the same WASM forecast engine lives at /production. A captain, a tug operator, or a coast-guard watch can enter a sea state in a browser and get a forecast in under a second.
Deterministic and seeded — replay a 12-hour AIS / S-AIS log and Rogue produces identical alerts. Critical for post-voyage review, insurance claims, port-state inspections, and regulatory compliance (SOLAS, MARPOL).