Skip to content

validation: cross-flow VIV of a steel catenary riser in uniform current (L3-W) - #160

Merged
SMI-Lab-Inha merged 2 commits into
devfrom
validation/wang-scr
Nov 14, 2026
Merged

SMI-Lab-Inha merged 2 commits into
devfrom
validation/wang-scr

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

Summary

New validation case L3-W: cross-flow VIV of the SJTU truncated steel catenary riser (Wang et al. 2014) in a 0.2 m/s uniform in-plane current. Thorsen et al. (2017) use this case to verify the time-domain synchronisation model that CableDyn's cross-flow VIV implements. Here CableDyn runs it with their published coefficients and no fitted parameter, on a curved riser that rests partly on the seabed.

Quantity CableDyn Measured Thorsen et al. (2017) Davies et al. (2026)
Dominant strain frequency, 8.25 m from the lower end 0.992 Hz 1.00 Hz 1.02 Hz 1.04 Hz
Largest r.m.s. cross-flow strain / measured largest 1.073 1 0.996 —
Mean ratio over the 25 stations 1.036 1 — —
r.m.s. peaks along the span 7 6 7 —

CableDyn shows one more r.m.s. peak along the span than the test, as Thorsen et al.'s model does, so the station-by-station ratio scatters.

Convergence

Run Largest r.m.s. strain ratio Mean ratio Frequency
200 elements, $\Delta t$ = 0.005 s (reported) 1.0731 1.036 0.992 Hz
400 elements 1.0753 1.0367 0.992 Hz
$\Delta t$ = 0.0025 s 1.0742 1.0366 0.992 Hz

The case

  • Riser:
    • 23.71 m between pinned joints, the top joint 21.0425 m out and 9 m up;
    • $D$ = 0.024 m, 0.69 kg/m, $EI$ = 10.5 N m², $EA$ = 6.66e5 N (Wang et al. 2014, Table 2).
  • Seabed: 1 (kN/m)/m in compression, friction 0.2.
  • VIV coefficients (cross-flow only): $C_v$ 0.7, $\hat f_0$ 0.18, $\Delta\hat f$ 0.08, $C_D$ 1.2, $C_M$ 2. These are Thorsen et al. (2017)'s values for this case, not tuned.
  • Measured r.m.s. strains: the 25 stations of Thorsen et al. (2017) Fig. 17, read from the vector figure with the axes calibrated on its tick marks. As a check, the figure's simulated maximum reads 99.6 % of the measured one, as their text states.
  • Cross-flow strain: the section curvature component with no static mean (the in-plane component carries the catenary curvature), taken as $\varepsilon = \kappa D/2$ at the outer surface.

Files

  • validation/experiments/wang_scr/wang_scr_uniform_current.py: writes the deck, runs it and writes the comparison;
  • measured_rms_strain.csv, rms_strain_comparison.csv, summary.json, provenance.json, README.md;
  • VALIDATION.md: the L3-W row and section; experiments and validation indexes;
  • doc/references.rst: Wang et al. 2014, Thorsen et al. 2017, Davies et al. 2026 (checked against Crossref);
  • CHANGELOG.md.

To reproduce:

python validation/experiments/wang_scr/wang_scr_uniform_current.py path/to/cabledyn.exe WORKDIR --summary validation/experiments/wang_scr

Checks

  • pre-commit, ruff (check and format), Sphinx -W;
  • no source change, so the Fortran and Python suites are unaffected.

…nt (L3-W)

The SJTU truncated steel catenary riser of Wang et al. (2014, Marine
Structures 39, 131-156) in a 0.2 m/s uniform in-plane current is the
case Thorsen et al. (2017, Marine Structures 51, 134-151) use to verify
the time-domain synchronisation model that CableDyn's cross-flow VIV
implements. It checks the VIV term on a curved, partly grounded riser
with its own published coefficients, so no parameter is fitted.

validation/experiments/wang_scr/wang_scr_uniform_current.py writes the
deck (23.71 m riser between pinned joints, the top 21.0425 m out and
9 m up, D 0.024 m, 0.69 kg/m, EI 10.5 N m^2, EA 6.66e5 N; seabed
1 (kN/m)/m with friction 0.2; Cv 0.7, f0 0.18, df 0.08, CD 1.2, CM 2,
cross-flow only), runs it and compares:
- the r.m.s. dynamic cross-flow strain at the 25 stations of Thorsen et
  al. Fig. 17, read from the vector figure (axes calibrated on its tick
  marks; the figure's simulated maximum reads 99.6 % of the measured,
  as their text states);
- the dominant strain frequency 8.25 m from the lower end.

Result (200 elements, dt 0.005 s, 150 s):
- frequency 0.992 Hz against the measured 1.00 Hz (their model 1.02 Hz,
  Davies et al. 2026 1.04 Hz);
- largest r.m.s. strain 7.3 % above the measured largest (theirs 0.4 %
  below), the mean over the stations 3.6 % above;
- one r.m.s. peak more along the span than the test (7 against 6), as
  theirs, so the station-by-station ratio scatters;
- 400 elements and half the time step change the largest r.m.s. strain
  by 0.2 % and 0.1 % and leave the frequency unchanged.

Added to VALIDATION.md as L3-W, to the experiments index and the
references (Wang et al. 2014, Thorsen et al. 2017, Davies et al. 2026,
checked against Crossref).

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 14, 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-14T12:52:48.561354Z fb6ed03 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 Nov 14, 2026 •

Copy link
Copy Markdown

Documentation build overview

📚 CableDyn | 🛠️ Build #35890868 | 📁 Comparing fb6ed03 against latest (789cb6d)

  🔍 Preview build  

13 files changed · ± 13 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: 37f19561b8

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

Review: the script runs CableDyn in the generated case folder, so a
relative executable path (as in the README command) resolved against
that folder and raised FileNotFoundError.

The executable is resolved against the invocation directory first (or
found on PATH for a bare name), and that path is run and hashed; a
missing executable stops with its name. Checked with a relative path
from another directory and with a missing one.

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. What shall we delve into next?

Reviewed commit: fb6ed03d4f

ℹ️ 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 befec35 into dev Nov 14, 2026
16 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the validation/wang-scr branch November 14, 2026 14:50
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