Skip to content

validation: FLOTANT power-cable specimen VIV in tow tests (L3-F) - #175

Merged
SMI-Lab-Inha merged 2 commits into
devfrom
feat/validation-flotant
Nov 17, 2026
Merged

SMI-Lab-Inha merged 2 commits into
devfrom
feat/validation-flotant

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

Summary

New validation case L3-F: the OD 48 mm research power cable of the FLOTANT tow tests at MARIN (de Wilde, Heijnsdijk & de Ridder 2021, Deliverable D5.5). A 6.4 m length hangs from the carriage with a 200 kg clump and is towed at 40 speeds from 0.025 to 1.0 m/s.

The case compares cross-flow and in-line VIV of a real cable section with three published coefficient sets. None of the sets is fitted to these tests. The structure is identified only from the specimen's forced-oscillation RAOs.

Result: no set predicts these tests. The best set matches the peak height but locks in early and releases 1.2 Ur late.

Set (source; fitted to) Cross-flow r.m.s. log error Peak A/D at 1/2L (Ur) Release Ur
uls19 (Ulveseter et al. 2019, Table 1; NDP riser) 0.731 0.755 (5.30) 7.06
b1 (generic Delta Flume set, Chaplin drag amplification) 0.594 0.483 (3.83) 5.89
wake (Facchinetti et al. 2004 wake oscillator) 1.208 0.296 (4.41) 5.30
Measured 0.776 (5.58) 5.88

The errors are taken over 1/2L, 3/4L and L at Ur ≥ 3.

  • uls19: the response rises at a lower speed than measured (A/D 0.42 against 0.18 at Ur 3.53). Above Ur 9 it stays on an upper branch at 0.64–0.71, where the test falls to 0.18–0.44.
  • b1: 38 % low at the peak, but it releases at the measured Ur.
  • wake: 62 % low.

How the case is built

  • Data (extract_d55.py, from the report's PDF):

    • FEM tables from the text;
    • RAO charts from the vector graphics;
    • Appendix 3 tow results from the raster images, calibrated on the grid lines. Every point maps to a tested speed within 0.0085 m/s.
  • Structure: the line follows the report's FEM tables node by node, in fresh water. Table 2-2 implies 1000 kg/m³.

  • Identified from the RAOs (rao comparison, Appendices 1 and 2), where the tests leave the structure open:

    • cable EI 1650 N m² and bending damping 130 N m² s, from the in-air resonance;
    • in water, a link chain with EI 100 N m², and the clump held laterally by 32.5 kN/m and 20 N s/m.

    This reproduces the measured split of the first in-water mode: surge r.m.s. log error 0.46, against 1.19 for a fixed clump and 1.17 for a free one.

  • Tow processing: A/D_rms = σ/OD at 1/2L, 3/4L and L, cross-flow and in line, at the test speed.

    • The model's displacement is processed like the report's accelerometer motions: the $g\theta/\omega^2$ tilt term and the 3.5 rad/s high-pass.
    • Ur uses f₁ = 1.77 Hz, as in Appendix 3.
    • Runs are 60 s with statistics after 20 s, at dt 2 ms.
  • Stated caveats of the data:

    • the Ur basis (1.77 Hz, against the 1.3 Hz first in-water mode of Sec. 5.3);
    • the bottom tension (1436 N in Table 6-1, against about 1700 N in the FEM table);
    • the towing direction alternates with speed.

Convergence and reproducibility

Checked on this build:

Check Largest A/D_rms change Largest cross-flow error change
Half time step 0.006 2.1 %
Two elements per table element 0.004 1.4 %
120 s runs 0.005 1.0 %
  • RAOs: the scores move by at most 0.001.
  • Reproducibility: the default command, run into a fresh work directory, reproduces response_comparison.csv, rao_comparison.csv and summary.json byte for byte.

Checks

On the branch rebased onto dev 3d779fb (#173):

  • ctest: 431/431, including the documentation and validation-records tests.
  • Python suite: 3217 passed, 47 skipped.
  • pre-commit: clean on the changed files, and ruff is clean on the case scripts.
  • Sphinx: builds with -W; the ref-dewilde2021 anchor and the new relative links resolve.

The OD 48 mm research cable of the FLOTANT tests at MARIN (de Wilde,
Heijnsdijk & de Ridder 2021, Deliverable D5.5, MARIN report
30995-53-DWB): 6.4 m hanging from the carriage with a 200 kg clump,
towed at the 40 speeds of 0.025-1.0 m/s. It tests cross-flow and in-line
VIV of a real cable section against three published coefficient sets,
none fitted to these tests, on a structure identified only from the
specimen's forced-oscillation RAOs.

validation/experiments/flotant/flotant_viv.py writes a deck per case,
runs them in parallel (reused when deck and executable are unchanged)
and compares:
- tow: A/D_rms = sigma/OD at 1/2L, 3/4L and L, cross-flow and in line,
  at the same test speed, the model's displacement processed as the
  report's accelerometer motions (the g theta/omega^2 tilt term, the
  3.5 rad/s high-pass); Ur with f1 1.77 Hz as Appendix 3; 60 s runs,
  statistics after 20 s, dt 2 ms;
- rao: the in-air (5 and 10 mm) and in-water (5 mm) RAOs of
  Appendices 1 and 2, the structural check.

The line follows the report's FEM tables node by node, in fresh water
(Table 2-2 implies 1000 kg/m^3), with the clump or counterweight as a
20 kN/m axial spring in series. What the tests leave open is identified
from the RAOs: cable EI 1650 N m^2 and bending damping 130 N m^2 s from
the in-air resonance (the tables' EI 3000 needs MARIN's empirical factor
1.10), and in water a link chain bending with EI 100 N m^2 and the clump
held laterally by 32.5 kN/m and 20 N s/m, which give the measured split
of the first in-water mode (r.m.s. log error 0.46 in surge against 1.19
for MARIN's fixed clump and 1.17 for a free one).

Sets, checked against the articles:
- uls19, Ulveseter et al. (2019), Table 1 (Cl 0.85, cF 0.144, dF 0.064,
  ClX 0.75, alpha 0.15, Chh 1.5), fitted to the NDP riser: blind here;
- b1, the generic set of the Delta Flume case (Cl 0.8, cF 0.18, dF 0.08,
  ClX 0.85, alpha 0.15, Chaplin's drag amplification, VIV DAMPING
  0 0 1): blind;
- wake, Facchinetti et al. (2004) (CL0 0.3, St 0.2, eps 0.3, A 12):
  blind.

Result on the second-order VIV phase update (#171) (cross-flow r.m.s.
log error over the three stations, Ur >= 3):
- uls19 0.731: the first peak at 1/2L is 0.755 at Ur 5.30 against 0.776
  at 5.58, but the rise starts at a lower speed (0.42 against 0.18 at
  Ur 3.53), the lock-in releases at Ur 7.06 against 5.88 (1.2 Ur late)
  and the upper branch stays at 0.64-0.71 above Ur 9 where the test
  falls to 0.18-0.44;
- b1 0.594: 38 % low at the peak (0.483), releases at the measured Ur;
- wake 1.208: 62 % low (0.296).
With MARIN's fixed clump or a free clump (End B Free) uls19 scores
0.721 and 0.692 but releases at Ur 8.83 and 9.12 and misses the RAOs.

extract_d55.py reads the data from the report's PDF (FEM tables from the
text, the RAO charts from the vector graphics, Appendix 3 from the raster
images calibrated on the grid lines; every point maps to a tested speed
within 0.0085 m/s). The caveats of the data are stated: the Ur basis
(1.77 Hz against the 1.3 Hz first in-water mode of Sec. 5.3), the bottom
tension (1436 N in Table 6-1 against about 1700 N in the FEM table) and
the towing direction alternating with speed.

Half the time step, two elements per table element and 120 s runs change
no A/D_rms by more than 0.006 at five speeds; the RAO scores move by at
most 0.001. The default command run into a new work directory reproduces
the committed record byte for byte.

Added to VALIDATION.md as L3-F, to the experiments index, the changelog
and the references (de Wilde et al. 2021, from the report's PDF; no DOI);
the top-level README now names the seven published experiments.

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 16, 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-17T00:02:21.631154Z 1677f63 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 16, 2026 •

Copy link
Copy Markdown

Documentation build overview

📚 CableDyn | 🛠️ Build #35943222 | 📁 Comparing 1677f63 against latest (789cb6d)

  🔍 Preview build  

15 files changed · ± 15 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: 01f0d3b305

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

flotant_viv.py and ndp_riser_viv.py reuse a folder's result.json when
its inputs, executable and analysis key match. A rerun with changed
inputs replaced the inputs but left the old result.json and executable
stamp in place, so if the run then failed or was interrupted, the next
attempt saw matching inputs and a matching key and returned the previous
model's results. The result, the stamp and the output are now removed
before the inputs are written (checked with a failing executable).

A tow selection entirely below Ur 3 (for example --speeds 0.1) has no
ratio in the scoring band, so its r.m.s. log errors are None, and the
console line raised a TypeError before the comparison CSV and summary
were written. The console line now prints n/a for those scores.

The committed records are unchanged.

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. Nice work!

Reviewed commit: 1677f63dce

ℹ️ 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 dca9e29 into dev Nov 17, 2026
16 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the feat/validation-flotant branch November 17, 2026 02:36
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