Skip to content

feat: higher-harmonic VIV force (VIV section column Chh) - #151

Merged
SMI-Lab-Inha merged 2 commits into
devfrom
feat/viv-higher-harmonic
Nov 12, 2026
Merged

SMI-Lab-Inha merged 2 commits into
devfrom
feat/viv-higher-harmonic

Conversation

@SMI-Lab-Inha

@SMI-Lab-Inha SMI-Lab-Inha commented Nov 12, 2026 •

Copy link
Copy Markdown
Owner

Summary

Adds a higher-harmonic VIV force to the synchronisation model, set by a new Chh column in the VIV section.

With in-line VIV, the model resolves the cross-flow response at the shedding frequency and the in-line response at twice it. Riser measurements also show cross-flow response at three times the shedding frequency, and at high modes it dominates curvature fatigue. Ulveseter, Thorsen, Sævik and Larsen (Appl. Ocean Res. 90, 2019, 101856, Eq. 6) model it with a force of the lift's form at the sum of the cross-flow and in-line phases:

$$\mathbf{f}_{hh} = \tfrac{1}{2}\,\rho D\, C_{hh} \cos(\phi + \phi_x)\, U\, (\mathbf{t} \times \mathbf{v}_n)$$

Across the flow this force acts at 3ω, and at ω and 5ω through the turn of the relative flow. Along the flow it acts at 2ω and 4ω.

Deck input

Column Default Rule
Chh (4th VIV column) 0 (off) Chh > 0 needs in-line VIV (ClX > 0); negative values are refused

Chh works on both EI = 0 lines and finite-EI cables.

Implementation

  • Finite-EI cable: k_hh cos(φ + φ_x) is added to the node values of the lift scale that its elements integrate.
  • EI = 0 line: adds a second node lift at the phase sum.

The force needs no state of its own, and its derivatives enter the tangent with the lift's. The Python deck reader and builder take the column.

A second commit documents the published coefficient sets as deck columns: Ulveseter et al. (2018) Table 3 and (2019) Table 1, with the C_hh of their Section 4. They are mapped onto the LINE TYPES and VIV columns (cF = f0, dF = df, Ca = C_M − 1) and checked against the papers.

Checks

  • tests/test_viv_inline_deck D5:
    • Chh = 1.0 raises the quarter-span in-line response at four times the cross-flow frequency from A/D 0.0017 to 0.0070, and the EI = 0 line agrees with the cable within 2 %;
    • Chh = 0 reproduces the row without the column to the printed digits;
    • Chh without in-line VIV, a negative Chh and a fifth column are all refused.
  • tests/test_hermite_load_power L4 now carries Chh = 1, and the load work still closes the cable's energy balance (3e-5).
  • The native and Python readers agree on nine row forms.
  • Full ctest under the default and Prescott BLAS kernels; Debug -fcheck=all on the VIV, model and system tests; pytest; Sphinx -W.

The synchronisation model with in-line VIV resolves the cross-flow
response at the shedding frequency and the in-line one at twice it.
Riser measurements show cross-flow components at three times the
frequency as well, and they dominate curvature fatigue at high modes.
Ulveseter, Thorsen, Saevik and Larsen (Appl. Ocean Res. 90, 2019,
101856, Eq. 6) add a higher-harmonic force of the lift's form at the
sum of the two phases,

  f_hh = 1/2 rho D C_hh cos(phi + phi_x) U (t x v_n),

which acts across the flow at 3 omega (and at omega and 5 omega
through the turn of the relative flow), and along it at 2 and 4 omega.

A fourth VIV section column Chh (default 0; Chh > 0 needs ClX > 0)
adds it on EI = 0 lines and finite-EI cables:
- the cable adds k_hh cos(phi + phi_x) to the node values of the lift
  scale its elements integrate;
- the EI = 0 line adds a second node lift at the phase sum.
It needs no state of its own, and its derivatives enter the tangent
with the lift's. The Python deck reader and builder take the column.

Checks:
- tests/test_viv_inline_deck D5: Chh 1.0 raises the quarter-span
  in-line response at four times the cross-flow frequency from A/D
  0.0017 to 0.0070, the EI = 0 line within 2 % of the cable; Chh 0 is
  the row without the column to the printed digits; Chh without
  in-line VIV, a negative Chh and five columns are refused;
- tests/test_hermite_load_power L4 now carries Chh 1: the load work
  still closes the cable's energy balance (3e-5);
- native/Python parity of nine row forms;
- full ctest on the default and Prescott kernels, Debug -fcheck=all
  on the VIV, model and system tests, pytest, Sphinx -W.

Signed-off-by: Jae Hoon Seo <jaehoon.seo@inha.ac.kr>
Ulveseter et al. (2018) Table 3 and (2019) Table 1 with the C_hh of their Section 4, mapped onto the LINE TYPES and VIV columns (cF = f0, dF = df, Ca = C_M - 1), checked against the papers.

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 Nov 12, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

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

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-12T07:08:21.970052Z f712c4c 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 #35832291 | 📁 Comparing f712c4c against latest (789cb6d)

  🔍 Preview build  

11 files changed · ± 11 modified

± Modified

@chatgpt-codex-connector

Copy link
Copy Markdown

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

Reviewed commit: f712c4c247

ℹ️ 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 b5feeac into dev Nov 12, 2026
22 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the feat/viv-higher-harmonic branch November 12, 2026 09:42
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