Models and Analysis provided by Marine Cybernetics Laboratory

This repository is the inventory of hydrodynamic models for vessels used by the Marine Cybernetics Laboratory (MCLab). Each vessel's raw analysis -- WAMIT (3D panel method, used for station-keeping / DP) and VERES (2D strip theory via ShipX, used for maneuvering) -- is converted with the MSS toolbox into a common .mat vessel struct, which is then consumed either directly in MATLAB/Simulink or via mcsimpy in Python.

Documentation

• data/vessels/readme.md -- per-vessel folder layout (mesh/, hydro/wamit/, hydro/veres/) and what each subfolder holds.
• scripts/readme.md -- converting raw WAMIT runs into MSS vessel structs / state-space models (wamit_v7_to_v6.py, vessel_station_keeping.m, and related helper scripts).
• ShipX / VERES guide -- full ShipX workflow from task creation to results, with a CS-Voyager worked example.
• external/MSS/README.md -- the vendored MSS toolbox (Fossen's Marine Systems Simulator), plus install guides for MATLAB and GNU Octave.

Data pipeline

flowchart LR
    A["WAMIT / VERES<br/>Hydrodynamic data"] --> B["MSS<br/>Fossen's toolbox"]
    B --> C[".mat file<br/>mcmodels format"]
    C --> D["Python<br/>mcsimpy"]
    C --> E["MATLAB<br/>MSS toolbox"]
    D -.-> F["Application"]
    E -.-> F

Loading

Vessel inventory

Vessel	WAMIT	VERES
drillship	✅	❌
enterprise	✅	❌
gunnerus	❌	❌
ma1	✅	❌
voyager	✅	❌