Skip to content

feat(viv): cross-flow VIV of finite-EI cables on the multibody march - #61

Merged
SMI-Lab-Inha merged 1 commit into
devfrom
feat/viv-multibody
Oct 28, 2026
Merged

SMI-Lab-Inha merged 1 commit into
devfrom
feat/viv-multibody

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

A finite-EI cable runs on the multibody march when its deck has a Rigid6 body or rod, or Free or Connect points. That march refused Cl > 0, so VIV of such a cable was not possible. This PR lifts the refusal.

Changes

  • Lift on the multibody march. Its cable builds now pass install_viv, as the Hermite march's do. Both builds are covered: clamped and pinned.
  • Fluid field. The march already refreshes each cable's held fluid field every step, so the phase sees the deck's waves and current.
  • Re-steps. Each outer iteration and each step halving re-steps the cables from CD_HFMF_Snapshot / CD_HFMF_Restore. That pair already carries the VIV phase and running mean squares, so a re-step does not advance the phase twice.
  • Python. DeckFile drops the matching refusal. A finite-EI line with two moving ends still refuses Cl > 0: that is the Cosserat compatibility element, which has no VIV.
  • Docs. capabilities, theory, troubleshooting and CHANGELOG.

Checks

  • viv_lockin, new case: the same 100 m finite-EI cable (EI 1 N·m², 0.15 m/s current) as the Hermite case, with End A Fixed. A 5 t Connect point hung on two chains 300 m away puts the deck on the multibody march.

    Route Mid / quarter A/D Frequency
    Multibody march 0.662 / 0.421 0.300 Hz
    Hermite march 0.662 / 0.421 0.300 Hz

    The gate is within 1 % and one frequency bin.

  • A cable on a moving buoy. buoy_clamped_cable (a clamped cable on a moored Rigid6 buoy) with Cl 0.8, in current, ran 30 s on the monolithic body step: at most 3 outer iterations, no step halvings.

  • Python: buoy_clamped_cable with Cl 0.8 passes the validator; it was refused before.

  • Test suite: ctest all green; Python 2064 passed.

  • Examples: all 52 shipped examples byte-identical to dev (none uses Cl > 0 on the multibody march).

  • Format: fprettify and ruff are clean.

Remaining VIV refusal: a finite-EI line with two moving ends.

Signed-off-by: Jae Hoon Seo jaehoon.seo@inha.ac.kr

A finite-EI line on a Rigid6 body or rod, or in a deck with Free or
Connect points, runs on the multibody march, which refused Cl > 0. That
march refreshes each cable's held fluid field every step and steps the
cable through the same snapshot and restore the VIV state already rides
in, so the builds now install the lift as the Hermite march's do. A taut
cable beside a weighted Connect point locks in as on the Hermite route
(mid/quarter A/D 0.662/0.421 at 0.300 Hz on both), and a clamped cable
on a moving Rigid6 buoy runs with it.

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 28, 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-28T05:14:06.881872Z 5c7b96a 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

Copy link
Copy Markdown

Documentation build overview

📚 CableDyn | 🛠️ Build #35461094 | 📁 Comparing 5c7b96a against latest (fd1936d)

  🔍 Preview build  

24 files changed · ± 24 modified

± Modified

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. 🚀

Reviewed commit: 5c7b96abd5

ℹ️ 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 47580d8 into dev Oct 28, 2026
21 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the feat/viv-multibody branch October 28, 2026 06:35
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