Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
51 commits
Select commit Hold shift + click to select a range
3e3e2c0
feat(stiffeners): model tapered bend stiffeners on finite-EI lines (#50)
SMI-Lab-Inha Oct 26, 2026
d855f9e
fix(statics): converge weightless taut finite-EI lines (#51)
SMI-Lab-Inha Oct 26, 2026
6b9fac4
fix(outputs): keep the down-slope pull in a grounded finite-EI end fo…
SMI-Lab-Inha Oct 26, 2026
8abfec7
fix(outputs): write every channel value with a three-digit exponent (…
SMI-Lab-Inha Oct 26, 2026
f267527
fix(openfast): restart a finite-EI cable from its committed boundary …
SMI-Lab-Inha Oct 26, 2026
1554411
feat(viv): cross-flow vortex-induced vibration of EI = 0 lines (#55)
SMI-Lab-Inha Oct 26, 2026
7980bcc
feat(viv): cross-flow VIV on finite-EI cables (#56)
SMI-Lab-Inha Oct 27, 2026
3f54f1c
fix(outputs): note that line nodes are numbered from 1, MoorDyn's fro…
SMI-Lab-Inha Oct 27, 2026
d7bfaae
docs: describe CableDyn as geometrically exact, not geometrically non…
SMI-Lab-Inha Oct 27, 2026
149c064
fix(statics): solve light slack finite-EI lines; keep a line's azimut…
SMI-Lab-Inha Oct 27, 2026
abd9ad6
feat(viv): cross-flow VIV on the coupled routes (#60)
SMI-Lab-Inha Oct 28, 2026
47580d8
feat(viv): cross-flow VIV of finite-EI cables on the multibody march …
SMI-Lab-Inha Oct 28, 2026
31f7fef
feat(outputs): LINES Outputs flag V, the VIV lift at the nodes (#62)
SMI-Lab-Inha Oct 28, 2026
4754a69
fix(viv): seed the shedding phase from the deck's End A; MoorDyn-C's …
SMI-Lab-Inha Oct 29, 2026
ca381d7
fix: TMax = 0 static checks, faster elevation-record waves, WvHiCOff …
SMI-Lab-Inha Oct 29, 2026
a515485
fix/feat: coupled start in the SeaState current, CurvX/CurvY section …
SMI-Lab-Inha Oct 29, 2026
acaaa12
feat(openfast): linearise the line dynamics, as MoorDyn-F (#66)
SMI-Lab-Inha Oct 29, 2026
287e3a9
feat(syrope): composite lines, a Syrope section between chains (#67)
SMI-Lab-Inha Oct 29, 2026
2ef4453
feat(torsion): torque-tension coupling of finite-EI cables (#68)
SMI-Lab-Inha Oct 29, 2026
66e3e83
feat(torsion): torsional inertia and damping, a twist angle at every …
SMI-Lab-Inha Oct 30, 2026
27b7738
feat(capi): host rotations, torsion through the C API (#70)
SMI-Lab-Inha Oct 30, 2026
6195432
feat(torsion): ATTACHMENTS on a line restrained in torsion (#71)
SMI-Lab-Inha Oct 30, 2026
0f53412
feat: MoorDyn parity - CoupledPinned bodies, CONTROL on Syrope and vi…
SMI-Lab-Inha Oct 30, 2026
ffc57c0
feat(torsion): OpenFAST linearisation, active line control and modal …
SMI-Lab-Inha Oct 30, 2026
e992e9f
feat(torsion): torsion on the mixed deck, at one restrained end and o…
SMI-Lab-Inha Oct 31, 2026
357f9eb
feat(cable): finite-EI lines with two moving ends, between two floate…
SMI-Lab-Inha Oct 31, 2026
1a8a606
ci(wheels): build the macOS wheel on the macOS 15 runner (#76)
SMI-Lab-Inha Oct 31, 2026
e760bc6
fix(statics): the static start above the surface, in sheared currents…
SMI-Lab-Inha Oct 31, 2026
591acbc
fix(multibody): couple a finite-EI cable pinned to a moving object im…
SMI-Lab-Inha Nov 2, 2026
780708c
feat(current): deck currents on the standalone mixed EI=0 + finite-EI…
SMI-Lab-Inha Nov 2, 2026
8bbcd4e
build: thread-safe Intel builds, value-safe floating point, openfast.…
SMI-Lab-Inha Nov 3, 2026
4fd6a72
fix(cable): one Newton tolerance for a finite-EI cable on every route…
SMI-Lab-Inha Nov 3, 2026
3a15aef
fix(torsion): coupled held lines step, body passes converge, a lazy w…
SMI-Lab-Inha Nov 3, 2026
7a7ef27
fix: findings of the 0.4.0 end-to-end validation in OpenFAST and FAST…
SMI-Lab-Inha Nov 3, 2026
43810b5
fix(hydro): an EI = 0 line above the surface carries its dry weight w…
SMI-Lab-Inha Nov 3, 2026
f530efa
fix(openfast): linearise from double-precision loads in a single-prec…
SMI-Lab-Inha Nov 3, 2026
bb1722e
chore(release): prepare CableDyn 0.4.0
SMI-Lab-Inha Nov 3, 2026
7e16590
chore(release): rerun the Bergdahl record with 0.4.0
SMI-Lab-Inha Nov 3, 2026
edd0d62
test: the GNU build of the test programs has no warnings
SMI-Lab-Inha Nov 3, 2026
4cbd24b
docs: the nitpicky Sphinx build resolves the Stiffener row class
SMI-Lab-Inha Nov 3, 2026
88ebb61
chore(release): the 0.4.0 release record
SMI-Lab-Inha Nov 3, 2026
8e40e33
fix(python): renaming a line carries its CurvX and CurvY channels
SMI-Lab-Inha Nov 3, 2026
c7da932
chore(release): record the assets rebuilt with the CurvX fix
SMI-Lab-Inha Nov 3, 2026
79760e0
fix(driver): an output root never overwrites an input named like a V …
SMI-Lab-Inha Nov 3, 2026
0920005
fix(python): an overwrite keeps and restores the lift, range and moda…
SMI-Lab-Inha Nov 3, 2026
476e2c5
fix(python): read_output reads a VIV lift file
SMI-Lab-Inha Nov 3, 2026
48faf70
chore(release): record the assets rebuilt with the output-file fixes
SMI-Lab-Inha Nov 3, 2026
27ce301
fix(study): reserve the lift, range and modal output suffixes in case…
SMI-Lab-Inha Nov 3, 2026
e859c79
fix(deck): accept VIV on an EI = 0 line without a seabed
SMI-Lab-Inha Nov 3, 2026
0979ba7
test(ci): reserve four processors for torsion_current_start
SMI-Lab-Inha Nov 3, 2026
3d04008
chore(release): record the assets rebuilt with the study and VIV fixes
SMI-Lab-Inha Nov 4, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions .github/workflows/release-windows-static.yml
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,8 @@ jobs:
repository: OpenFAST/openfast
ref: 2895884d2be01862173c88d70f86b358d2f1a50a
path: openfast
# the history and tags: openfast.exe names its base by `git describe --tags`
fetch-depth: 0
persist-credentials: false

- name: Check out the pinned OpenFAST regression model
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/wheels.yml
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ jobs:
if-no-files-found: error

macos:
runs-on: macos-14
runs-on: macos-15
steps:
- name: Check out CableDyn
uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
Expand All @@ -112,7 +112,7 @@ jobs:
# deployment target is the runner's macOS, the oldest the Homebrew libraries support.
CIBW_BEFORE_ALL_MACOS: brew install gcc openblas
CIBW_ENVIRONMENT_MACOS: >-
MACOSX_DEPLOYMENT_TARGET=14.0
MACOSX_DEPLOYMENT_TARGET=15.0
FC=gfortran
CMAKE_PREFIX_PATH=$(brew --prefix openblas)
CIBW_TEST_COMMAND: >-
Expand Down
16 changes: 11 additions & 5 deletions ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -325,7 +325,11 @@ consistent mass plus Morison added mass. `K` and `M` are assembled in symmetric
band storage; LAPACK `DSBGVX` gives the eigenvalues and inverse iteration on the
banded pencil gives each mode shape, so the cost grows with line length rather
than with its square. Dense `DSYGV` is kept as the test reference. Both line paths
are supported (`nModes`).
are supported (`nModes`). A finite-EI line's modes (`CD_Modal_Hermite_Line`) take
its end connections and attachments from the dynamic model, and a line restrained
in torsion adds the twist angle of every node: its lumped polar inertia and the
second variation of the nodal-twist energy (`CD_HermiteCable_Dyn_Twist_Hessian`)
in a band of 7 DOFs per node.

### Outputs

Expand Down Expand Up @@ -360,10 +364,11 @@ the exchange buildable and testable without OpenFAST.
committed positions and holds them for the step.
- **State mirror.** The authoritative state lives in the module instance, and
`x%states` carries a mirror of it: line node velocities and positions, finite-EI
cable DOFs, constitutive states (`dl_1`, Syrope), friction anchors, and body and
rod states. Checkpoint/restart, correction iterations, and the framework
metadata use the mirror; a restart rebuilds the model from the packed deck and
the mirror.
cable DOFs, constitutive states (`dl_1`, Syrope), friction anchors, the committed
boundary kinematics of the coupled ends, and body and rod states.
Checkpoint/restart, correction iterations, and the framework metadata use the
mirror; a restart rebuilds the model from the packed deck and the mirror, which
then overrides the restored input mesh at the coupled ends.
- **Scope.** Correction iterations, quasi-static linearisation, FAST.Farm shared
moorings (`MooringMod = 5`), line failures, and active line-length control are
supported. Combinations that are not supported coupled stop with a named error;
Expand Down Expand Up @@ -441,6 +446,7 @@ src/
CableDyn_Hydro.f90 Morison loads, Airy and JONSWAP waves, currents
CableDyn_WaveSpectra.f90 spectra, spreading, and multi-train seas
CableDyn_StreamWave.f90 stream-function regular nonlinear waves
CableDyn_WaveMath.f90 block sine/cosine and exponential of the wave kinematics
CableDyn_Vessel.f90 vessel kinematics, 6-DOF motion, displacement RAOs
CableDyn_SeabedContact.f90 C1 normal contact and stick-slip friction laws
CableDyn_Bathymetry.f90 gridded bathymetry
Expand Down
107 changes: 106 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,110 @@ All notable changes to CableDyn are recorded in this file. The format follows

## [Unreleased]

## [0.4.0] - 2026-11-04

### Added

- Full torsion of finite-EI lines: in the dynamics a twist angle at every node, with the polar
inertia `Irn` and torsional damping (`GJ|K|Bt`), so the torque varies along the line and
travels as a torsional wave; the statics stay condensed. Lines restrained at one end only
(the other free to twist), lines hanging from a `Fixed` rod end (I-tube, J-tube), `CONTROL`,
`ATTACHMENTS` and modal analysis all take torsion. Torsional modes match the continuum within
the lumped-inertia error (2.6e-4 on the first).
- Torque–tension coupling of armoured cables and wire ropes (`GJ|K`: `T = EA ε + K τ`,
`M = GJ τ + K ε`) in statics, dynamics, linearisation and the tensile audits; `GJ|0` is the
uncoupled cable bit for bit.
- OpenFAST linearisation with the line dynamics, as MoorDyn-F's: interior node positions and
velocities of `EI = 0` lines, the free degrees of freedom of finite-EI cables, and the twist
angles of lines restrained in torsion. On the UMaine chains the reduced stiffness matches
MoorDyn-F's to 0.1 % and the lowest nine line-mode frequencies to 0.3 %. Replaces the
quasi-static linearisation without states. A single-precision OpenFAST (the release
`openfast.exe`) linearises from CableDyn's double-precision loads, as a double-precision one.
- Section-frame curvature channels `CurvX<L>N<J>`/`CurvY<L>N<J>` on finite-EI lines, for the
fatigue of an armour wire or conductor at a fixed point of the section; the axes follow the
twist.
- Cross-flow VIV (the Thorsen et al. model of MoorDyn v2, LINE TYPES `Cl`, `dF`, `cF`) on
`EI = 0` lines and, as a distributed lift, on finite-EI cables, standalone and on the coupled
routes, with the LINES output flag `V`. Lock-in follows MoorDyn-F to two to three digits.
- Bend stiffeners (`STIFFENERS`): a tapered linear-elastic sleeve over a finite-EI line end;
a clamped hang-off follows the planar elastica within 0.2 % of the root moment and OrcaFlex
11.6d's curvature within 0.8 %. Channels `StfMom`, `FairDefl`/`AnchDefl`.
- Finite-EI lines with two moving ends (a cable shared by two floaters, a FAST.Farm shared
line) standalone, in OpenFAST, FAST.Farm and the C API; and between two objects on the
multibody march. The retired Cosserat compatibility route no longer runs them.
- `CoupledPinned`/`VesselPinned` bodies in OpenFAST, as MoorDyn-F's coupled pinned body.
- Active line control (`CONTROL`) of Syrope and viscoelastic segments and of finite-EI cables
restrained in torsion; composite Syrope lines (chain–polyester–chain).
- Deck currents, prescribed motion, torsion and `TURBINES` rows on the standalone mixed
`EI = 0` + finite-EI deck; MoorDyn-C `Currents 2` and `5` (time-varying and gridded) on the
standalone routes, identical to MoorDyn-C v2.7.1 at 739 points and times.
- C API host rotations (ABI 1.3, `CableDyn_InitDeckRotating`, `CableDyn_UpdateRotations`,
`CableDyn_GetCoupledMoments`), so torsion decks and `Rigid` end connections run there; Python
`init_deck_rotating`.

### Changed

- Coupled OpenFAST runs start from the equilibrium in SeaState's steady current (`CurrMod 1`)
instead of the still-water shape.
- A finite-EI cable on the coupled aggregate (mixed decks, OpenFAST, FAST.Farm, the C API) steps
to the deck's `dynamic_solver` tolerance instead of a fixed 5e-3. The looser step gave wrong
tensions (a fairlead peak of 4.3e5 N against 1.9e4 N) and a coupled cable that did not damp
out its residual; the routes now agree to 5e-8 of the peak tension.
- A finite-EI cable pinned to a light moving object is coupled implicitly in the multibody step
(it was explicit and diverged on light objects).
- Waves: `WvHiCOff` (default 0.5 Hz) cuts an elevation record's components, and the wave
kinematics vectorise (irregular seas 20 to 33 % faster); `WaveKinMod 1` decks run two to four
times faster.
- Every Intel ifx build uses the value-safe floating-point model (`/fp:precise`) and automatic
local variables; ifx results change at round-off.
- Syrope lines take the seabed, Morison loads, current, waves, host fluid and VIV.
- The macOS wheel needs macOS 15 or newer on Apple silicon.
- `TURBINES` decks read and turn finite-EI end frames in each turbine's axes, as FAST.Farm does.
- The CableDyn-enabled `openfast.exe` names itself `OpenFAST-v5.0.0-CableDyn-0.4.0`.
- Speed: on the 51 example decks that 0.3.0 also runs, 0.4.0 is 6 % faster (geometric mean of
the per-deck times; gfortran, one thread), the wave decks 16 to 30 %. Two decks are slower for
the fixes above: `mixed_body_rods_points` 52 % (the implicit coupling of a pinned cable) and
`torsion_lazy_wave_hangoff_twist` 25 % (the nodal twist), and a coupled finite-EI cable step
costs about 38 % more (the deck tolerance).

### Fixed

- Thread safety of the Intel builds: concurrent handles crashed (shared closure trampolines,
static local storage), and `CableDyn_Close` paused the OpenMP runtime of the whole process.
- Static starts that failed or depended on round-off: a cable whose End A rests on the seabed,
a lazy wave restrained in torsion in current (at any pretwist, on every BLAS kernel), torsion
between two bodies, neutral, weightless and straight lines, pinned and attachment-carrying
cables on bodies and rods.
- Physics: an `EI = 0` line above the still-water level on a deck without a seabed was modelled
fully submerged (13 % light in air); lines and attachments above the surface now carry their
dry weight in the static start; the anchor force on a sloped seabed; the static start in a
sheared current; modal analysis with end connections and attachments.
- OpenFAST: restarts with a finite-EI cable continue bit for bit; Free and pinned objects start
from their solved acceleration; channel values below 1e-99 no longer print as asterisks.
- Stack overflows of non-static ifx builds and of `FAST.Farm.exe` built with MinGW, and a crash
of the ifx run-time on a failing `OPEN` of a long path.
- Messages that said something untrue (SeaState kinematics, body/rod start moves, deck current
source, torsion twist, FAST.Farm `DT_Mooring`), and a coupled deck mixing bodies and rods now
says where it runs.
- Output files: the driver refuses an output root whose `.modes.out` or `.Line<N>.V.out` would
overwrite an input; the Python `overwrite` run keeps aside and restores the `.V.out`,
`.range.out` and `.modes.out` files as well (an existing one now needs `overwrite`);
`read_output` reads a `.V.out` lift file; a study refuses a case name such as
`base.Line1.V`, `base.Line1.range` or `base.modes` beside a case `base`; renaming a line in
`DeckModel` carries its `CurvX`/`CurvY` channels.
- Python deck validation accepts VIV on an EI = 0 line without a seabed (for example in a
MoorDyn-C `Currents` profile), as the driver does: the line has its still-water drag either way.

### Upgrading

- OpenFAST checkpoints written by 0.3.0 for decks with finite-EI lines restrained in torsion do
not reload.
- Decks with torsion need the section's real polar inertia `Irn` (the column was unused).
- Results change beyond round-off on decks with torsion, pinned cables on bodies, coupled
finite-EI cables (the tolerance), coupled runs in a SeaState current (the static start),
`TURBINES` decks with rotated turbines, elevation records with components above `WvHiCOff`,
and `EI = 0` lines above the surface without a seabed.

## [0.3.0] - 2026-10-23

### Added
Expand Down Expand Up @@ -585,7 +689,8 @@ Corrections made during the pre-release review.
values of the shipped example decks and states which tension (end element or
`FairTen` end force) each comparison uses.

[Unreleased]: https://github.com/SMI-Lab-Inha/CableDyn/compare/v0.3.0...HEAD
[Unreleased]: https://github.com/SMI-Lab-Inha/CableDyn/compare/v0.4.0...HEAD
[0.4.0]: https://github.com/SMI-Lab-Inha/CableDyn/releases/tag/v0.4.0
[0.3.0]: https://github.com/SMI-Lab-Inha/CableDyn/releases/tag/v0.3.0
[0.2.0]: https://github.com/SMI-Lab-Inha/CableDyn/releases/tag/v0.2.0
[0.1.1]: https://github.com/SMI-Lab-Inha/CableDyn/releases/tag/v0.1.1
Expand Down
11 changes: 6 additions & 5 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -3,11 +3,12 @@ message: >-
If you use CableDyn in academic work, please cite the journal article given
as the preferred citation. To identify the exact software release used, also
cite this software entry with its version.
title: "CableDyn: A cable and mooring dynamics solver for floating offshore wind"
title: "CableDyn: Geometrically exact finite-element statics and dynamics of mooring lines and dynamic power cables for floating offshore wind"
type: software
abstract: >-
CableDyn is an open-source finite-element solver for the static and dynamic
analysis of offshore mooring lines and dynamic power cables. It combines
CableDyn is an open-source, geometrically exact finite-element solver for the
static and dynamic analysis of offshore mooring lines and dynamic power cables.
Its strain and curvature are the exact large-deformation measures. It combines
tension-only elements for moorings with cubic-Hermite finite-bending elements
for power cables, solves the static equilibrium by Newton's method, and
integrates the dynamics with the implicit generalised-alpha scheme. It runs as
Expand All @@ -22,8 +23,8 @@ authors:
repository-code: "https://github.com/SMI-Lab-Inha/CableDyn"
url: "https://github.com/SMI-Lab-Inha/CableDyn"
license: Apache-2.0
version: 0.3.0
date-released: 2026-10-23
version: 0.4.0
date-released: 2026-11-04
keywords:
- mooring dynamics
- cable dynamics
Expand Down
Loading
Loading