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 @@ -132,6 +132,17 @@ All notable changes to CableDyn are recorded in this file. The format follows
(cross-flow r.m.s. log error 0.731); the generic set is 38 % low at the peak and releases at
the measured speed (0.594); the wake oscillator of Facchinetti et al. (2004) is 62 % low
(1.208).
- Validation case L3-Wh (`validation/experiments/wang_scr`): heave-induced cross-flow VIV of
the L3-W riser in still water, its upper end moved along the measured top trajectory of
Thorsen et al. (2017, period 5.96 s), with their coefficient set, the strain band-passed as
Wang et al. (2014) process it. Without a `VIV FRAME` row the dominant frequency is 1.019 Hz
(measured close to 1 Hz), the largest r.m.s. strain 20.8 % above the measured largest and the
lower half of the span 1.71 times the measured on average (Thorsen et al.'s model 5.6 % and
1.44). The heave period is about 6 VIV periods, below the `VIV FRAME` scale separation, and the
result depends on `Tf` (0.35–1 s): the response falls on a 1.01–1.02 Hz or a 0.88–0.89 Hz
branch, reported as a sensitivity. The case's script is now `wang_scr_viv.py` for both parts
(it replaces `wang_scr_uniform_current.py`; the L3-W numbers are unchanged), and its data,
including Thorsen et al.'s simulated lines, are read by `extract_thorsen2017.py`.
- 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
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -172,8 +172,8 @@ layout is described in the architecture notes in the repository.

CableDyn is verified against analytical solutions and compared with MoorDyn,
OrcaFlex, seven published physical experiments (Holcombe lazy-wave, Bergdahl dynamic
chain, Chaplin riser natural frequencies and stepped-current VIV, Wang catenary-riser VIV,
NDP high-mode riser VIV, FLOTANT power-cable VIV), the IEA 15 MW VolturnUS-S reference systems, and coupled OpenFAST runs. Results,
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), 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
29 changes: 25 additions & 4 deletions VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,8 @@ article's methods, are compared in
| **L3-B** | Bergdahl chain experiment, 30 orbit conditions | measured upper-end force | RMSE 1.58 N; MAPE 3.11%; Pearson 0.993; Lin concordance 0.989 | full published matrix | Pass |
| **L3-C** | Chaplin Delta Flume riser, still-water natural frequencies | measured modes 1–7 at five tensions | mean error +1.87%, mean absolute 2.28%, largest 4.88% (34 of 35; one outlier reported) | full published table, no fitted parameter | Pass |
| **L3-D** | Chaplin Delta Flume riser in a stepped current, blind-trial cases 1–9, cross-flow and in-line VIV | measured dominant mode, peak cross-flow amplitude, mean in-line displacement, curvature standard deviations | mode right in 5/9, within one in 9/9; mean in-line within ±17% in 7/9 (−25% to +34%); cross-flow amplitude −45% to +4%; cross-flow curvature −39% to +26% | generic coefficient set, no fitted parameter | Pass measured |
| **L3-W** | SJTU steel catenary riser in 0.2 m/s current, cross-flow VIV | measured r.m.s. strain (25 stations) and dominant frequency | frequency 0.992 vs 1.00 Hz; max r.m.s. strain +7.3%, station mean +3.6% | published coefficient set, no fitted parameter | Pass |
| **L3-W** | SJTU steel catenary riser in 0.2 m/s current, cross-flow VIV | measured r.m.s. strain (25 stations) and dominant frequency | frequency 0.992 vs 1.00 Hz; max r.m.s. strain +7.3%, station mean +3.6% (Thorsen et al. 2017: 1.02 Hz, −0.4%, −3.0%) | published coefficient set, no fitted parameter | Pass |
| **L3-Wh** | SJTU steel catenary riser, heave-induced cross-flow VIV in still water (measured top motion, 5.96 s) | measured r.m.s. strain (25 stations, band-passed 0.67–50 Hz) and dominant frequency | no `VIV FRAME`: frequency 1.019 Hz vs close to 1 Hz; max r.m.s. strain +20.8%, station mean +33%, lower/upper half 1.71/0.93 (Thorsen et al. 2017: +5.6%, +8.7%, 1.44/0.71); `VIV FRAME` `Tf` 0.35–1 s: two branches, 1.01–1.02 Hz (max +7 to +13%) or 0.88–0.89 Hz (max −2.8 to −4.2%), `Tf` 0.5 s changes branch at dt/2 | published coefficient set, no fitted parameter; heave period about 6 VIV periods, below the `VIV FRAME` scale separation | Pass measured |
| **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 |
| **L-fig** | Along-arc curvature overlay (CableDyn / OrcaFlex / MoorDyn-F ±4×) | 3-code committed record | CableDyn peak 0.11% from OrcaFlex | <0.5% | Pass |
Expand Down Expand Up @@ -373,9 +374,29 @@ the tow tests it predicts). Inputs, reduction scripts, results, and source prove
frequency 8.25 m from the lower end is 0.992 Hz against the measured 1.00 Hz (their model 1.02 Hz;
[Davies et al., 2026](https://cabledyn.readthedocs.io/en/latest/references.html#ref-davies2026),
1.04 Hz). The largest r.m.s. strain is 7.3% above the measured largest (theirs 0.4% below) and the
mean over the 25 stations 3.6% above. The response has one r.m.s. peak more along the span than
the test, 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%.
mean over the 25 stations 3.6% above (theirs 3.0% below). The response has one r.m.s. peak more
along the span than the test, as theirs, so the station-by-station ratio scatters (r.m.s. log
error 0.338, theirs 0.360). 400 elements and half the time step change the largest r.m.s.
strain by 0.2% and 0.1%.

- **L3-Wh SJTU steel catenary riser, heave-induced cross-flow VIV**
([Wang et al., 2014](https://cabledyn.readthedocs.io/en/latest/references.html#ref-wang2014);
[Thorsen et al., 2017](https://cabledyn.readthedocs.io/en/latest/references.html#ref-thorsen2017)):
the L3-W riser in still water, its upper end moved along the measured top trajectory (two
sinusoids of 5.96 s fitted to their Fig. 19: x 0.049 m, z 0.130 m), with Thorsen et al.'s set
for this case (C_v 0.8), the strain band-passed from 4 times the motion frequency to 50 Hz as
Wang et al. process the measurement. Without a `VIV FRAME` row, the published model's phase
input, the dominant frequency 8.25 m from the lower end is 1.019 Hz (measured close to 1 Hz),
the largest r.m.s. strain 20.8% above the measured largest (theirs 5.6% above) and the
station mean 33% above (theirs 8.7%). The lower half of the span reads 1.71 times the measured
on average and the upper half 0.93 times; their model has the same pattern, 1.44 and 0.71.
Half the time step and 400 elements change the largest strain by −1.0% and −0.7% and the
station mean by −2.9% and −2.3%, at the same frequency. The heave period is about 6 VIV
periods, below the scale separation a `VIV FRAME` filter needs (about 30), and the result
depends on `Tf`: at 0.35–0.5 s the response stays at 1.01–1.02 Hz with the largest strain
7–13% high, at 0.75–1 s it moves to 0.88 Hz with the largest strain 3–4% low and the upper half
0.60–0.63 times the measured, and at 0.5 s half the time step moves it from the first branch
to the second. The default run reproduces the committed record byte for byte.

- **L3-N NDP high-mode riser, cross-flow VIV in uniform flow**
([Trim et al., 2005](https://cabledyn.readthedocs.io/en/latest/references.html#ref-trim2005);
Expand Down
10 changes: 6 additions & 4 deletions doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1705,10 +1705,12 @@ and model form. The table gives each set with its source and the line-type colum
damping :math:`C_{d,y} = 0.31 + 0.89\,y_0/D` (their Eq. 1)
- a ``VIV AMPLITUDE`` table (below); ``VIV DAMPING`` ``0.31 0.89 0``
* - :ref:`Thorsen et al. (2017) <ref-thorsen2017>`: the truncated catenary riser of
:ref:`Wang et al. (2014) <ref-wang2014>` in uniform current (Re about 3 000)
- :math:`C_v` 0.7, :math:`\hat f_0` 0.18, :math:`\Delta\hat f` 0.08, :math:`C_D` 1.2,
:math:`C_M` 2
- ``Cl dF cF`` = ``0.7 0.08 0.18``, ``Cd_n`` 1.2, ``Ca_n`` 1.0 (validation case L3-W)
:ref:`Wang et al. (2014) <ref-wang2014>` in uniform current (Re about 3 000) and under
heave motion of its upper end (Re about 4 000)
- :math:`C_v` 0.7 in the current, 0.8 in heave; :math:`\hat f_0` 0.18,
:math:`\Delta\hat f` 0.08, :math:`C_D` 1.2, :math:`C_M` 2
- ``Cl dF cF`` = ``0.7 0.08 0.18`` (current) or ``0.8 0.08 0.18`` (heave), ``Cd_n`` 1.2,
``Ca_n`` 1.0 (validation cases L3-W and L3-Wh)
* - :ref:`Ulveseter et al. (2018) <ref-ulveseter2018>`: in-line force at twice the
cross-flow frequency
- :math:`C_x` 0.85, :math:`\alpha` 0.15, with a cross-flow :math:`C_L` of 0.65
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, Trim et al. (2005) NDP high-mode riser VIV and de Wilde et al. (2021) FLOTANT power-cable 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 and de Wilde et al. (2021) FLOTANT power-cable 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
4 changes: 2 additions & 2 deletions validation/experiments/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ committed results.
| [`bergdahl/`](bergdahl/README.md) | Bergdahl et al. (2016), 33 m dynamically scaled chain | Tension-only mooring chain |
| [`chaplin/`](chaplin/README.md) | Chaplin et al. (2005), 13.12 m vertical tension riser, still-water natural frequencies | Finite-EI riser, modal analysis |
| [`delta_flume/`](delta_flume/README.md) | Chaplin et al. (2005), 13.12 m vertical tension riser, stepped current, blind-trial cases 1–9 | Finite-EI riser, synchronisation VIV, cross-flow and in-line |
| [`wang_scr/`](wang_scr/README.md) | Wang et al. (2014), truncated steel catenary riser in uniform current, cross-flow VIV | Finite-EI riser, synchronisation VIV |
| [`wang_scr/`](wang_scr/README.md) | Wang et al. (2014), truncated steel catenary riser in uniform current and under heave motion of its upper end, cross-flow VIV | Finite-EI riser, synchronisation VIV |
| [`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 |

The results are summarised as cases L3-H, L3-B, L3-C, L3-D, L3-W, 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 and L3-F in [`VALIDATION.md`](../../VALIDATION.md).
Loading
Loading