Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,17 @@ All notable changes to CableDyn are recorded in this file. The format follows
U_R,max 4 the wake oscillator gives the measured largest A/D (0.280 against 0.286); at 6.5 and
7.9 every set holds the lock-in while the flow slows, the gap between the paths 2-5 times the
measured one and the largest A/D 1.3-2.3 times the measured.
- Validation case L3-K (`validation/experiments/chaplin_catenary`): cross-flow VIV of the
untensioned catenary model riser of Chaplin & King (2018), 5.36 m long with EI 1.3 N m² and
floor touchdown, at both mass ratios in current of 0.2–1.4 m/s in both directions, with three
published coefficient sets none of which is fitted to these tests, against the measured mean
top tension, cross-flow frequencies and straight-part inclination (read from the article's
figures by `extract_chaplin2018.py`). Every set gives the measured single frequency along the
span in positive current, at f d/U 0.121 (Ulveseter et al. 2019), 0.138 (generic set) and
0.17 (wake oscillator) against 0.111; the generic set's drag amplification gives the light
riser's tension rise (9.8 % r.m.s.) and the heavy riser's inclination in negative current
(5.0° r.m.s.). The heavy riser's still-water tension is 37 % above the measured with the
article's geometry, reported as a caveat of the data.
- Theory manual, Published coefficient sets: the VIV coefficient sets of Thorsen et al. (2016,
2017), Ulveseter et al. (2018), Andersen et al. (2024a, b) and Facchinetti et al. (2004), each
with its source, its test data and the line-type columns it maps to, and Thorsen et al.'s
Expand Down
5 changes: 3 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,9 +171,10 @@ layout is described in the architecture notes in the repository.
## Validation

CableDyn is verified against analytical solutions and compared with MoorDyn,
OrcaFlex, eight published physical experiments (Holcombe lazy-wave, Bergdahl dynamic
OrcaFlex, nine published physical experiments (Holcombe lazy-wave, Bergdahl dynamic
chain, Chaplin riser natural frequencies and stepped-current VIV, Wang catenary-riser VIV in
current and heave, NDP high-mode riser VIV, FLOTANT power-cable VIV, oscillatory-flow cylinder VIV), the IEA 15 MW VolturnUS-S reference systems, and coupled OpenFAST runs. Results,
current and heave, NDP high-mode riser VIV, FLOTANT power-cable VIV, oscillatory-flow cylinder VIV, Chaplin & King
untensioned catenary-riser VIV), the IEA 15 MW VolturnUS-S reference systems, and coupled OpenFAST runs. Results,
acceptance criteria, and reproduction commands are in
the [validation record](https://cabledyn.readthedocs.io/en/latest/validation.html); data and scripts are in
[`validation/`](https://cabledyn.readthedocs.io/en/latest/validation.html).
Expand Down
32 changes: 32 additions & 0 deletions VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ article's methods, are compared in
| **L3-N** | NDP 38 m high-mode riser in uniform flow, 0.3–2.4 m/s (22 tests), cross-flow VIV | measured maximum r.m.s. cross-flow strain, dominant frequency, spatial-mean σ/D | strain r.m.s. log error: Ulveseter et al. (2019) set 0.178, Andersen et al. (2024b) 0.186, generic set 0.277, Thorsen et al. (2016) 0.363 (their own simulation 0.187); f D/U 0.145 / 0.134 / 0.192 / 0.193 vs 0.143 measured | generic set blind; the other sets fitted by their authors to NDP tests (implementation check) | Pass measured |
| **L3-F** | FLOTANT OD 48 mm power-cable specimen with a 200 kg clump, tow tests at 0.025–1.0 m/s (40 tests), cross-flow and in-line VIV | measured A/D_rms (σ/OD) at 1/2L, 3/4L and L (de Wilde et al. 2021, App. 3) | CF r.m.s. log error (Ur ≥ 3): Ulveseter et al. (2019) set 0.731, generic set 0.594, wake oscillator 1.208; first peak at 1/2L 0.755 / 0.483 / 0.296 vs 0.776 measured; release Ur 7.06 / 5.89 / 5.30 vs 5.88 | published VIV sets, none fitted to these tests; structure identified from the specimen's in-air and in-water RAOs | Pass measured |
| **L3-O** | SJTU 4 m flexible cylinder moved harmonically through still water, KC 178 at U_R,max 4, 6.5 and 7.9, cross-flow VIV | measured A/D on the acceleration and deceleration paths at mid-span (Fu et al. 2014, Figs. 15–17); lock-in shares 17/34/50 % | A/D r.m.s. error: wake oscillator 0.088 / 0.177 / 0.132, generic set 0.138 / 0.339 / 0.345, Ulveseter et al. (2019) set 0.079 / 0.340 / 0.338; largest A/D at U_R,max 4: 0.280 / 0.472 / 0.124 vs 0.286; at 6.5 and 7.9 every set holds the lock-in while the flow slows: mean deceleration-acceleration gap 0.25–0.50 vs 0.09–0.12 measured | published VIV sets, none fitted to these tests; `VIV FRAME` Tf 0.2 s (sensitivity none, 0.1, 0.3 s) | Pass measured |
| **L3-K** | Southampton untensioned catenary riser with high curvature and floor touchdown, two mass ratios, current of 0.2–1.4 m/s in both directions (13 speeds each), cross-flow VIV | measured mean top tension and its standard deviation, cross-flow spectral peak frequencies, inclination of the straight part (Chaplin & King 2018, Figs. 9, 10, 12, 13, 15) | frequency uniform along the span in positive current (26/26 runs generic set, 22 wake oscillator, 20 Ulveseter et al. 2019) at f d/U 0.138 / 0.17 / 0.121 vs 0.111 measured; light-riser tension in positive current r.m.s. 9.8% with drag amplification (generic set), 17.8–24.5% without; heavy-riser straight-part inclination 5.0° r.m.s. (implied C_d 2.55 vs 2.47); still-water top tension 81.2 vs 59.1 N (m* 1.84) | published VIV sets, none fitted to these tests; floor friction and damping assumed, with sensitivity runs | Pass measured |
| **L-fig** | Along-arc curvature overlay (CableDyn / OrcaFlex / MoorDyn-F ±4×) | 3-code committed record | CableDyn peak 0.11% from OrcaFlex | <0.5% | Pass |
| **L4-1** | Coupled platform + mooring | synthetic reference | bit-for-bit | — | Pass |
| **L4-1b** | VolturnUS-S coupled platform + power cable | OpenFAST v5.0.0 (CompMooring 5 vs 3) | platform DOFs <0.6% (3-seed DLC-1.1); fairlead and anchor <0.001% static | <3% platform | Pass |
Expand Down Expand Up @@ -471,6 +472,37 @@ the tow tests it predicts). Inputs, reduction scripts, results, and source prove
21%, the wake oscillator's by up to 11%. Half the time step and 80 elements change the largest A/D
by at most 0.1% (generic set, wake oscillator) and 4.1% (Ulveseter et al. set); the default run
reproduces the committed record byte for byte.
- **L3-K Southampton untensioned catenary riser, cross-flow VIV with high curvature and
touchdown**
([Chaplin & King, 2018](https://cabledyn.readthedocs.io/en/latest/references.html#ref-chaplin2018)):
the 5.36 m, 56 mm riser of very low bending stiffness (EI 1.3 N m²) pinned on the floor of a
2 m flume and 0.2 m above the surface 4.30 m away, at both mass ratios (2.9 and 20.9 N/m
submerged) in current of 0.2–1.4 m/s in both directions, with floor contact (friction 0.5,
assumed) and 3% Rayleigh damping. The article measures one cross-flow frequency along the
whole riser in positive current, close to f d/U = 0.11 on the speed at the near-vertical top,
so that the local Strouhal number on the normal velocity runs from 0.11 to above 0.3. Three
published VIV sets, none fitted to these tests, and a run without VIV:
- all three give one frequency along the suspended span, the curved lower part included
(within 10% in 26 of 26 positive runs with the generic set, 22 with the wake oscillator of
Facchinetti et al. (2004), 20 with Ulveseter et al.'s (2019) set), at their own level:
f d/U 0.121 for Ulveseter et al.'s set (9% above the measured 0.111), 0.138 for the generic
set and 0.17 for the wake oscillator;
- in negative current the heavy riser's measured frequency stays at 1.05–1.16 Hz from 1.1 m/s;
Ulveseter et al.'s set levels off at 1.45–1.5 Hz (f d/(U sin ψ) 0.130 against 0.119), the
generic set gives 1.45–1.85 Hz and the wake oscillator 2.1–2.45 Hz;
- the mean top tension needs the drag amplification of the generic set (Chaplin et al. 2005,
Eq. 4): the light riser's tension in positive current within 9.8% r.m.s. and a rise to
1.4 m/s of 88.8 N against 88.6 N measured (49.8 N without VIV, 60.1 and 51.4 N with the two
sets that keep C_d 1.2); the heavy riser's straight-line inclination in negative current
within 5.0° r.m.s., implying C_d 2.55 through the article's Eq. 9 against 2.47 measured.

With the article's length, span and weights the heavy riser's still-water top tension is
81.2 N against 59.1 and 61.8 N measured (light 15.1 against 13.4 and 11.5 N), a geometry the
article's numbers do not close, so the tension is also compared as its increment from still
water. Half the time step and twice the elements change the mean tension by at most 5.3% and
2.9%; without structural damping or floor friction the mean tension moves by up to 15% and
40% and its standard deviation by up to +296% and +412%. The default run reproduces the
committed record byte for byte.

## L4 coupled OpenFAST

Expand Down
6 changes: 6 additions & 0 deletions doc/references.rst
Original file line number Diff line number Diff line change
Expand Up @@ -300,6 +300,12 @@ Verification and validation references
laboratory measurements of vortex-induced vibrations of a tension riser. *Journal of Fluids and
Structures* **21**\ (1), 25–40. https://doi.org/10.1016/j.jfluidstructs.2005.05.016

.. _ref-chaplin2018:

- **Chaplin, J. R. & King, R. (2018).** Laboratory measurements of the vortex-induced vibrations
of an untensioned catenary riser with high curvature. *Journal of Fluids and Structures*
**79**, 26–38. https://doi.org/10.1016/j.jfluidstructs.2018.01.008

.. _ref-trim2005:

- **Trim, A. D., Braaten, H., Lie, H. & Tognarelli, M. A. (2005).** Experimental investigation
Expand Down
2 changes: 1 addition & 1 deletion validation/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ redistributed.
| [`RELEASE_0_1_1.md`](RELEASE_0_1_1.md) | The same for v0.1.1 |
| [`RELEASE_0_1_0.md`](RELEASE_0_1_0.md) | The same for v0.1.0 |
| [`bodies/`](bodies/README.md) | Rigid-body, rod and shared-anchor cases with MoorDyn-C twins, stored references and pass limits |
| [`experiments/`](experiments/README.md) | Holcombe et al. (2025) static lazy-wave, Bergdahl et al. (2016) dynamic-chain, Chaplin et al. (2005) riser natural-frequency and stepped-current VIV, Wang et al. (2014) catenary-riser VIV in current and heave, Trim et al. (2005) NDP high-mode riser VIV, de Wilde et al. (2021) FLOTANT power-cable VIV and Fu et al. (2014) oscillatory-flow cylinder VIV comparisons |
| [`experiments/`](experiments/README.md) | Holcombe et al. (2025) static lazy-wave, Bergdahl et al. (2016) dynamic-chain, Chaplin et al. (2005) riser natural-frequency and stepped-current VIV, Wang et al. (2014) catenary-riser VIV in current and heave, Trim et al. (2005) NDP high-mode riser VIV, de Wilde et al. (2021) FLOTANT power-cable VIV, Fu et al. (2014) oscillatory-flow cylinder VIV and Chaplin & King (2018) untensioned catenary-riser VIV comparisons |
| [`PERFORMANCE_0_1_0.md`](PERFORMANCE_0_1_0.md) | Wall time of CableDyn 0.1.0, MoorDyn-C and MoorDyn-F at equal accuracy on five mooring, cable, buoy and coupled cases |
| [`performance/`](performance/README.md) | Same-host wall-clock records of the L5 cases: the resolved lazy-wave spans, the one-hour VolturnUS-S mooring and the tension-only chain |
| [`PAPER_REPRODUCTION.md`](PAPER_REPRODUCTION.md) | Every CableDyn result in the journal article, re-run with the release defaults and in paper mode |
Expand Down
5 changes: 3 additions & 2 deletions validation/experiments/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

# Experimental comparisons

This directory lets reviewers reproduce CableDyn's comparisons with seven published physical
This directory lets reviewers reproduce CableDyn's comparisons with eight published physical
experiments. Each subdirectory gives the data source, the translation of the published
parameters into a CableDyn model, the assessed quantity, the reproduction commands and the
committed results.
Expand All @@ -17,5 +17,6 @@ committed results.
| [`ndp_riser/`](ndp_riser/README.md) | Trim et al. (2005), NDP 38 m high-mode riser in uniform flow, cross-flow VIV with a generic and three published coefficient sets | Finite-EI riser, synchronisation VIV |
| [`flotant/`](flotant/README.md) | de Wilde et al. (2021), FLOTANT OD 48 mm power-cable specimen with a clump weight, tow tests and forced-oscillation RAOs, cross-flow and in-line VIV with three published coefficient sets | Finite-EI cable, synchronisation and wake-oscillator VIV |
| [`fu_oscillatory/`](fu_oscillatory/README.md) | Fu et al. (2014), SJTU 4 m flexible cylinder moved harmonically through still water, cross-flow VIV on the acceleration and deceleration paths with three published coefficient sets | Finite-EI cylinder, synchronisation and wake-oscillator VIV, `VIV FRAME` |
| [`chaplin_catenary/`](chaplin_catenary/README.md) | Chaplin & King (2018), 5.36 m untensioned catenary riser with high curvature and floor touchdown in current of both directions, two mass ratios: mean top tension, cross-flow frequency, inclination, with three published coefficient sets | Finite-EI riser with floor contact, synchronisation and wake-oscillator VIV |

The results are summarised as cases L3-H, L3-B, L3-C, L3-D, L3-W, L3-Wh, L3-N and L3-F in [`VALIDATION.md`](../../VALIDATION.md).
The results are summarised as cases L3-H, L3-B, L3-C, L3-D, L3-W, L3-Wh, L3-N, L3-F and L3-K in [`VALIDATION.md`](../../VALIDATION.md).
Loading
Loading