Skip to content

feat(openfast): linearise the line dynamics, as MoorDyn-F - #66

Merged
SMI-Lab-Inha merged 3 commits into
devfrom
feat/dynamic-lin
Oct 29, 2026
Merged

SMI-Lab-Inha merged 3 commits into
devfrom
feat/dynamic-lin

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

OpenFAST linearisation with the line dynamics, as MoorDyn-F

With Linearize = True the module now registers continuous states and linearises the line dynamics, replacing the quasi-static linearisation without states.

States

  • every EI = 0 line's interior-node positions, with MoorDyn's names and order (Line 1 node 1 Px, m ... Vz, m/s);
  • every finite-EI cable's free DOFs: node positions and tangents m = dr/ds (Cable 1 node 2 Px, m, Tx, -, dTx, 1/s, node 1 at End A);
  • then their velocities.

Matrices. lin_eval loads a state and an input into the committed mirror and solves the accelerations without a time step. It then restores the committed state. CD_CalcContStateDeriv, CD_JacobianPContState and the input Jacobian central-difference it for A, B, C and D.

Steps.

  • Positions, tangents and coupled-point displacements are stepped by 1 µm. A millimetre step lifted a light cable's grounded nodes out of their 0.3 mm seabed penetration on one side of the difference. The former 5 cm input step slackened a chain's last element. Each halved a stiffness: the lazy-wave cable's sway stiffness read 242 instead of 2.6 N/m.
  • Velocities take MoorDyn-F's 0.1 m/s. Quadratic drag has no slope at rest, so this step sets its equivalent linear damping.

Validation (validation/scripts/openfast_lin_ab.py)

Gate Result
UMaine twin, D − C A⁻¹ B vs MoorDyn-F (882 states each) ≤ 0.10 % per fairlead and on the platform 6×6
Lowest nine line-mode frequencies vs MoorDyn-F ≤ 0.30 % (consistent vs lumped mass)
Stability every eigenvalue of both state matrices in the left half-plane
Mixed deck with the lazy-wave power cable (--cable-deck, 2976 cable states) vs central differences of the deck's own static solves ≤ 3.3e-4 at every coupled point (cable 36.0 / 2.62 / 38.5 N/m); also with a 5e4 N·m/rad hang-off spring

The damping ratios are printed, not gated, and come out at half MoorDyn-F's. Both codes difference the drag over ±0.1 m/s. CableDyn integrates the drag over the element, and for a one-node perturbation that gives half the slope. The script now solves an ill-conditioned A plainly (cond ~1e11 from a frictionless laid cable is physical). It switches to the pseudo-inverse only above 1e14.

Scope

  • A cable end connection with a numeric stiffness now linearises.
  • Free/Connect points and a Rigid cable end connection fail closed with named messages, as bodies, rods, Point3 buoys, torsion, CONTROL and FAST.Farm already did. These carry states that are not linearisation states.
  • The quasi-static path (quasistatic_dydu) is removed. Outside a linearisation run the input Jacobian is the runtime fixed-state derivative as before.

Checks

  • Lin A/B (all five gates) PASS on a fresh OpenFAST build.
  • A 5 s coupled time-domain run terminates normally.
  • Core suite passes; the one exception is deck_driver in the deep scratch build tree, whose Syrope long-path case exceeds Windows' path limit there and passes in the repository build.
  • Docs: doc/openfast.rst (new Linearisation section), doc/troubleshooting.rst, VALIDATION.md, CHANGELOG.md.

With Linearize = True the module now registers continuous states: the
interior-node positions of every EI = 0 line (MoorDyn's names and order)
and the free DOFs of every finite-EI cable (node positions and tangents),
then their velocities. lin_eval loads a state and an input into the
committed mirror, solves the accelerations without a time step and
restores the committed state; CD_CalcContStateDeriv, CD_JacobianPContState
and the input Jacobian central-difference it for A, B, C and D. This
replaces the quasi-static linearisation without states.

Positions, tangents and coupled-point displacements are stepped by 1 um:
a millimetre step lifted a light cable's grounded nodes out of their
0.3 mm seabed penetration on one side of the difference, and the former
5 cm input step slackened a chain's last element, each halving a
stiffness. Velocities take MoorDyn-F's 0.1 m/s, which gives the quadratic
drag its equivalent linear damping.

On the UMaine twin decks the reduction D - C A^-1 B matches MoorDyn-F's to
0.1 % per fairlead and on the platform 6x6, and the lowest nine line-mode
frequencies to 0.3 %; both state matrices are stable. On the mixed deck
with a lazy-wave power cable every coupled point matches central
differences of the deck's own static solutions to 3.3e-4, also with a
hang-off spring. openfast_lin_ab.py gates the frequencies, the stability
and (with --cable-deck and --driver) the mixed deck, and solves an
ill-conditioned A plainly instead of truncating it.

A numeric-stiffness cable end connection now linearises. Free/Connect
points and a Rigid cable end connection fail closed with named messages,
as bodies, rods, Point3 buoys, torsion and CONTROL already did.

Signed-off-by: Jae Hoon Seo <jaehoon.seo@inha.ac.kr>
Every Linearize call now takes the line-state branch of the input
Jacobian, dXdu included only when the glue asks for it (a deck without
line states has none), so quasistatic_dydu and its scratch-aggregate
re-solves are unreachable and removed. Outside a linearisation run the
input Jacobian is the runtime fixed-state derivative for any state
count, and dXdu or a state Jacobian fails with a named message. The
module comments no longer describe the zero-state reduction.

Signed-off-by: Jae Hoon Seo <jaehoon.seo@inha.ac.kr>
@SMI-Lab-Inha

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-29T08:36:49.592405Z b5e1b20 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@read-the-docs-community

read-the-docs-community Bot commented Oct 29, 2026 •

Copy link
Copy Markdown

Documentation build overview

📚 CableDyn | 🛠️ Build #35492657 | 📁 Comparing b5e1b20 against latest (fd1936d)

  🔍 Preview build  

26 files changed · ± 26 modified

± Modified

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 3a7eb208d2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread src/openfast/CableDyn_OF.f90 Resolved
The viscoelastic slow-branch stretch dl_1 and the Syrope slow strain are
dynamic states with their own rate laws, but the linearisation held them,
so D - C A^-1 B gave these ropes' instantaneous stiffness instead of their
relaxed static one. They are now first-order linearisation states
(VF_DerivOrder1, "Line l segment e dl1, m" / "slow strain, -"):
lin_eval loads them from x and writes their rates, which the new
CD_Get_Model_Internal_Rates evaluates with the instantaneous element laws
(the taut series-Kelvin ODE or the slack zero-load relaxation; the Syrope
kernel at dt = 0).

A viscoelastic variant of the UMaine chains (150 stretches) now matches
its static solutions to 7e-5 (held: 0.6 % too stiff); a taut three-leg
Syrope spread with a SYROPE IC history (60 slow strains) to 6e-6 (held:
2.9 times too stiff). The Syrope running maximum and the seabed-friction
stick anchors stay held: load histories, whose operating-point values are
the small-motion tangent. A line or cable with VIV fails closed: it
oscillates about a lock-in cycle, not an equilibrium. The A/B script's
static reference adds TMax = 0 to a deck that leaves TMax to the host.

Signed-off-by: Jae Hoon Seo <jaehoon.seo@inha.ac.kr>
@SMI-Lab-Inha

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Nice work!

Reviewed commit: b5e1b20744

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@SMI-Lab-Inha
SMI-Lab-Inha merged commit acaaa12 into dev Oct 29, 2026
15 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the feat/dynamic-lin branch October 29, 2026 11:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant