Skip to content

feat: stochastic VIV band centre (VIV STOCHASTIC, Ulveseter et al. 2017) - #179

Merged
SMI-Lab-Inha merged 1 commit into
devfrom
feat/viv-stochastic
Nov 17, 2026
Merged

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

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

Summary

Adds plan item H8: the stochastic synchronisation of Ulveseter, Thorsen, Sævik & Larsen (2017, Eq. 6 and Fig. 4). An optional VIV STOCHASTIC section turns the centre cF of a line type's synchronisation band into a slowly varying random process:

$$\hat F_0(t) = \hat f_0 + \sum_{i=1}^{N_f} a \sin\bigl(p_i + 2\pi \hat f_i,\theta(t)\bigr), \qquad \theta = \int_0^t \frac{U}{D},dt$$

--------------------- VIV STOCHASTIC -----------------------------------
TypeName   sigma   c      Nf    seed
riser      0.016   0.07   100   1
  • Spectrum: flat over $(0, c,\hat f_0]$, with components at the mid-points $\hat f_i = (i - \tfrac12),c\hat f_0/N_f$ and amplitude $a = \sigma\sqrt{2/N_f}$. The process therefore has mean cF and standard deviation sigma.
  • Phase advance: each component advances at its non-dimensional frequency times $U/D$, the same rule as the shedding phase.
  • Start phases: seeded per node and per line. Nodes are independent, as in the article; a run repeats its realisation, and two lines of one type differ.
  • Unchanged: the band half-width dF.
  • Scope:
    • runs on EI = 0 lines and finite-EI cables, standalone and coupled, with or without in-line VIV;
    • refused on a type without Cl > 0 or with a WAKE OSCILLATOR row.

State and numerics

  • One new state per node: θ, stored as an extra row of the node's VIV motion statistics. Step recovery, snapshots, rollback and checkpoints therefore carry it, both standalone and in the OpenFAST mirror. The phases are rebuilt from the seed, so nothing else is stored.
  • Time step: the step advances θ by $\Delta t,U/D$ at the mid-point and evaluates $\hat F_0$ at $\theta + \Delta t,U/(2D)$, the same mid-point rule the phase uses (fix: the coupled VIV response converges at second order in the time step #171).
  • EI = 0 model: its explicit copy and move routines and its VIV row count (CD_Model_VIV_NMS) now carry the new fields.

Checks

New test viv_stochastic, plus a stochastic case in viv_coupled:

Gate Result
Process statistics, the article's NDP values (cF 0.144, σ 0.016, c 0.07, 100 components), θ 0–4e6 mean − cF = −2.0e-6; sd/σ = 1.0000; excess kurtosis −0.18
Phases repeat per seed and node; differ between nodes and between seeds
sigma 0 row against no section bit-identical on both cores
sigma 0.02 repeats bit for bit; another seed differs; A/D over 50–80 s 0.6708 against 0.6768 (finite-EI) and 0.6713 against 0.6772 (EI = 0)
Coupled checkpoint restart continues bit for bit with θ in both VIV blocks (one more value per node); a rebuild without the VIV state does not; a rewound step repeats
Refusals no Cl; wake-oscillator type; c outside (0, 1]; non-integer Nf; seed out of range

Wider checks:

  • ctest: 432/432 pass, with 0 build warnings.
  • Example A/B: all 138 example and test-data decks are byte-identical to dev.
  • Python: the reader and builder handle the section, its native checks and a round trip. 2548 tests pass; ruff is clean.

Docs

  • driver_format.md: the new section.
  • theory.rst: a new "Stochastic band centre" section.
  • capabilities.rst, CHANGELOG.md.
  • references.rst: Ulveseter et al. (2017), checked against the article's first page.

An optional VIV STOCHASTIC section, rows TypeName sigma c [Nf [seed]],
makes the centre cF of a line type's synchronisation band the slowly
varying random process of Ulveseter, Thorsen, Saevik & Larsen (2017,
Eq. 6 and Fig. 4):

  F0 = cF + sum_i a sin(p_i + 2 pi f_i theta),  theta = integral U/D dt,

Nf components (default 100) at the mid-points f_i = (i - 1/2) c cF/Nf of
a flat spectrum over (0, c cF], amplitude a = sigma sqrt(2/Nf), so F0
has the mean cF and the standard deviation sigma. Each component
advances at its non-dimensional frequency times U/D, as the shedding
phase does (U the shedding speed of the phase rate). The start phases
are uniform on [0, 2 pi), drawn per node from a minimal-standard stream
that the seed, the node and the line select: the nodes are independent,
as in the article, a run repeats its realisation and two lines of one
type differ. The band half-width dF stays constant.

theta is the one new state: one more row of each node's VIV motion
statistics, so step recovery, snapshots, rollback and checkpoints
(standalone and the OpenFAST mirror) carry it; the phases are rebuilt
from the seed. The step advances theta by dt U/D at the mid-point and
takes F0 at theta + dt U/(2D), the mid-point rule of the phase (#171).
On EI = 0 lines and finite-EI cables, standalone and coupled, with or
without in-line VIV; refused on a type without Cl > 0 or with a WAKE
OSCILLATOR row.

Checks (test_viv_stochastic, test_viv_coupled):
- the process with the article's NDP values (cF 0.144, sigma 0.016,
  c 0.07, 100 components) over theta 0-4e6 has the mean cF to 2e-6, the
  standard deviation sigma to four digits and an excess kurtosis of
  -0.18; the phases repeat per seed and node and differ between them;
- a sigma 0 row is the deck without it, bit for bit, on both cores;
- with sigma 0.02 a run repeats bit for bit, another seed differs, and
  the taut cable stays locked in (A/D within 1 % of the constant centre's
  over 50-80 s on both cores);
- the coupled checkpoint restart continues bit for bit with theta in
  both VIV blocks (one more value per node), a rebuild without the VIV
  state does not, and a rewound step repeats;
- refusals: no Cl, a wake-oscillator type, c out of (0, 1], a
  non-integer Nf, a seed out of range.

The EI = 0 model's explicit copy and move routines and its VIV row
count (CD_Model_VIV_NMS) carry the new fields. Python reader and
builder: the section, its native checks and a round trip. Driver
format, theory (Stochastic band centre), capabilities, changelog and
the reference (from the article's first page).

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 17, 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-17T11:26:51.523660Z 11121d5 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 #35953148 | 📁 Comparing 11121d5 against latest (789cb6d)

  🔍 Preview build  

15 files changed · ± 15 modified

± Modified

@chatgpt-codex-connector

Copy link
Copy Markdown

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

Reviewed commit: 11121d5605

ℹ️ 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

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. What shall we delve into next?

Reviewed commit: 11121d5605

ℹ️ 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 fea3c4e into dev Nov 17, 2026
22 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the feat/viv-stochastic branch November 17, 2026 13:04
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