Skip to content

docs: published VIV coefficient sets with their sources - #161

Merged
SMI-Lab-Inha merged 1 commit into
devfrom
docs/viv-coefficient-sets
Nov 14, 2026
Merged

SMI-Lab-Inha merged 1 commit into
devfrom
docs/viv-coefficient-sets

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

Summary

The VIV coefficients are empirical, and the published sets differ by test, Reynolds number range and model form. This adds "Published coefficient sets" to the theory manual. Each set comes with its source, the tests it was fitted to, and the line-type columns it maps to. Every value was read from the papers; nothing is quoted second-hand.

Source Data Values In CableDyn
Thorsen et al. (2016) 44 NDP riser tests, Re 8 000–65 000 $C_v(y_0/D)$: 0.35 at 0, maximum 1.00 at 0.46, zero from 0.66; $C_{d,y} = 0.31 + 0.89,y_0/D$ VIV AMPLITUDE table; VIV DAMPING 0.31 0.89 0
Thorsen et al. (2017) Wang et al. (2014) catenary riser $C_v$ 0.7, $\hat f_0$ 0.18, $\Delta\hat f$ 0.08, $C_D$ 1.2, $C_M$ 2 Cl dF cF = 0.7 0.08 0.18 (case L3-W)
Ulveseter et al. (2018) in-line force at twice the CF frequency $C_x$ 0.85, $\alpha$ 0.15 (CF $C_L$ 0.65) VIV row 0.85 0.15
Andersen et al. (2024a), Table 3 low-Re forced-oscillation calibration $C_v$ 1.2, $C_D$ 1.1, $C_a$ 1.0, band 0.11–0.26 Cl 1.2; dF cF = 0.075 0.185
Andersen et al. (2024a) 7 tests, rigid cylinder on a spring-supported pendulum unified $C_v \approx 2.0$ Cl 2.0
Andersen et al. (2024b), Table 3 22 sheared-flow NDP tests (per-case average) CF: 1.28, 0.131, 0.066; $C_D$ 1.16 Cl dF cF = 1.28 0.066 0.131; the in-line set uses another in-line form (said)
Facchinetti et al. (2004) forced-cylinder lift, lock-in $C_{L0}$ 0.3, St 0.2, $\varepsilon$ 0.3, $A$ 12 WAKE OSCILLATOR 0.3 0.2 0.3 12

Thorsen et al.'s excitation curve, read from the vector figure, is given as a VIV AMPLITUDE table on 0.05 steps.

The section ends with the caveat both groups state. Andersen et al.'s per-case optima scatter with no trend in Reynolds number, and Thorsen et al.'s curve holds only in the Reynolds number range of the tests it was fitted to.

Changes

  • doc/theory.rst: new subsection theory-viv-coefficients, after Cross-flow damping;
  • doc/references.rst: Andersen et al. (2024a, b), checked against Crossref;
  • CHANGELOG.md.

Checks

  • Sphinx -W, pre-commit;
  • documentation only.

The theory manual gains "Published coefficient sets": each set with its
source, the tests it was fitted to and the line-type columns it maps to:
- Thorsen et al. (2016): the excitation curve Cv(y0/D) fitted to the 44
  NDP riser tests (0.35 at 0, a maximum of 1.00 at 0.46, zero from
  0.66) and the cross-flow damping 0.31 + 0.89 y0/D;
- Thorsen et al. (2017): the Wang et al. (2014) riser set (L3-W);
- Ulveseter et al. (2018): the in-line Cx 0.85, alpha 0.15;
- Andersen et al. (2024a): the forced-oscillation set of their Table 3
  (Cv 1.2, CD 1.1, Ca 1.0, band 0.11-0.26, i.e. dF 0.075 about cF
  0.185 here) and the unified Cv of about 2.0;
- Andersen et al. (2024b): the cross-flow average of their Table 3
  (1.28, 0.131, 0.066; their in-line set belongs to another in-line
  synchronisation form, which is said);
- Facchinetti et al. (2004): CL0 0.3, St 0.2, eps 0.3, A 12.

Thorsen et al.'s curve, read from the vector figure, is given as a
VIV AMPLITUDE table on 0.05 steps. Every value was read from the
papers; the two Andersen references were 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-14T14:52:10.554210Z ef3247d 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 #35892215 | 📁 Comparing ef3247d against latest (789cb6d)

  🔍 Preview build  

13 files changed · ± 13 modified

± Modified

@chatgpt-codex-connector

Copy link
Copy Markdown

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

Reviewed commit: ef3247da5b

ℹ️ 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 c46eb64 into dev Nov 14, 2026
16 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the docs/viv-coefficient-sets branch November 14, 2026 17:37
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