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
5 changes: 5 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,11 @@ All notable changes to CableDyn are recorded in this file. The format follows
the Delta Flume vertical riser of Chaplin et al. (2005), modes 1-7 at five top tensions, from
CableDyn's modal analysis with no fitted parameter: 1.87 % high on average over 34 of the 35
measured values (largest 4.88 %), the 35th, an outlier in the measurements, reported apart.
- Validation case L3-W (`validation/experiments/wang_scr`): cross-flow VIV of the SJTU truncated
steel catenary riser of Wang et al. (2014) in a 0.2 m/s uniform current, with the coefficient set
Thorsen et al. (2017) use for it: dominant strain frequency 0.992 Hz against the measured
1.00 Hz, largest r.m.s. strain 7.3 % above the measured largest, station mean 3.6 % above;
converged in mesh and time step to 0.2 %.

## [0.4.2] - 2026-11-09

Expand Down
13 changes: 13 additions & 0 deletions VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,7 @@ article's methods, are compared in
| **L3-H** | Holcombe static lazy-wave experiment | measured marker geometry | position RMSE 1.07–1.89% of suspended length; peak marker-curvature error 0.34–5.54% | end-restraint bracket | Pass |
| **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-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 |
| **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 @@ -338,6 +339,18 @@ scripts, results, and source provenance are in
separately. 128 elements and ten times the unpublished axial stiffness change no frequency by
more than 3e-6 and 1.2e-4.

- **L3-W SJTU steel catenary riser, cross-flow VIV in uniform current**
([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 23.71 m truncated catenary in a 0.2 m/s in-plane current, run with Thorsen et al.'s coefficient
set for this case (C_v 0.7, f̂0 0.18 ± 0.08, C_D 1.2, C_M 2). The dominant cross-flow strain
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%.

## L4 coupled OpenFAST

- **L4-1 synthetic** (`l4_platform_mooring`): 6-DOF platform moored by three taut
Expand Down
19 changes: 19 additions & 0 deletions doc/references.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,12 @@ Hydrodynamics and ocean environment
vortex-induced vibrations in stationary and oscillating flows. *Journal of Fluids and
Structures* **61**, 1–19. https://doi.org/10.1016/j.jfluidstructs.2015.11.006

.. _ref-thorsen2017:

- **Thorsen, M. J., Sævik, S. & Larsen, C. M. (2017).** Non-linear time domain analysis of
cross-flow vortex-induced vibrations. *Marine Structures* **51**, 134–151.
https://doi.org/10.1016/j.marstruc.2016.10.007

.. _ref-ulveseter2018:

- **Ulveseter, J. V., Thorsen, M. J., Sævik, S. & Larsen, C. M. (2018).** Time domain
Expand Down Expand Up @@ -247,6 +253,19 @@ Verification and validation references
experiment of a mooring cable. *Journal of Marine Science and Engineering* **4**\ (1), 5.
https://doi.org/10.3390/jmse4010005

.. _ref-wang2014:

- **Wang, J., Fu, S., Baarholm, R., Wu, J. & Larsen, C. M. (2014).** Fatigue damage of a steel
catenary riser from vortex-induced vibration caused by vessel motions. *Marine Structures*
**39**, 131–156. https://doi.org/10.1016/j.marstruc.2014.07.002

.. _ref-davies2026:

- **Davies, R., Lekkala, M. R., Michaloliakos, A., Wong, W.-Y., Hall, M., Vakakis, A. & Zuo, L.
(2026).** Time-domain vortex induced vibration modeling of reference dynamic power cable for the
Gulf of Maine. *Journal of Fluids and Structures* **146**, 104651.
https://doi.org/10.1016/j.jfluidstructs.2026.104651

.. _ref-chaplin2005:

- **Chaplin, J. R., Bearman, P. W., Huera Huarte, F. J. & Pattenden, R. J. (2005).** Laboratory
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 and Chaplin et al. (2005) riser natural-frequency 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 Wang et al. (2014) 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 three published physical
This directory lets reviewers reproduce CableDyn's comparisons with four 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 @@ -12,5 +12,6 @@ committed results.
| [`holcombe/`](holcombe/README.md) | Holcombe et al. (2025), 1:70 static lazy-wave cable | Finite-EI power cable |
| [`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 |
| [`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 |

The results are summarised as cases L3-H, L3-B and L3-C in [`VALIDATION.md`](../../VALIDATION.md).
The results are summarised as cases L3-H, L3-B, L3-C and L3-W in [`VALIDATION.md`](../../VALIDATION.md).
61 changes: 61 additions & 0 deletions validation/experiments/wang_scr/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
<!-- SPDX-License-Identifier: Apache-2.0 -->

# Steel catenary riser in uniform current: cross-flow VIV

This directory compares CableDyn's cross-flow VIV with the SJTU model test of a truncated steel
catenary riser in a 0.2 m/s uniform current: Wang et al. (2014),
<https://doi.org/10.1016/j.marstruc.2014.07.002>, as Thorsen et al. (2017),
<https://doi.org/10.1016/j.marstruc.2016.10.007>, use it to verify the time-domain synchronisation
model that CableDyn's cross-flow VIV implements. The model runs with their coefficient set for this
case; nothing is fitted to the measurements.

## Model and data

- **Riser (Thorsen et al. 2017, Table 1):**
- length 23.71 m, between universal joints (pinned);
- the top 21.0425 m horizontally and 9 m vertically from the lower end, with a 2.626 m flowline on
the seabed;
- D 0.024 m, 0.69 kg/m (a solid section: no internal water is added), EI 10.5 N m², EA 6.66e5 N.
- **Seabed:** 1 (kN/m)/m in compression (`kBot` = 1000/D), friction 0.2.
- **Current:** 0.2 m/s along the riser plane, from the lower end towards the top.
- **VIV (their set for this case):** C_v 0.7 (their choice for Re ≈ 3000), f̂0 0.18, Δf̂ 0.08,
cross-flow only; C_D 1.2, C_M 2.
- **Measurements:** `measured_rms_strain.csv` holds the 25 measured r.m.s. dynamic cross-flow strains
at the outer surface (Thorsen et al. 2017, Fig. 17), read from the vector figure. The axes are
calibrated on its tick marks; as a check, the simulated maximum of the same figure reads 99.6 % of
the measured one, as their text states. The measured dominant strain frequency 8.25 m from the
lower end is 1.00 Hz (their Fig. 18).
- **Assumed:** the top joint 0.5 m below the surface (not given; the current is uniform).
- **CableDyn:** 200 elements, dt 0.005 s, 150 s, statistics over t > 30 s. The cross-flow curvature
is the section component with no static mean (the in-plane one carries the catenary curvature);
strain = κ D/2.

## Reproduce

From the repository root, with `path/to/cabledyn.exe` the release executable or a local build:

```powershell
python validation/experiments/wang_scr/wang_scr_uniform_current.py `
path/to/cabledyn.exe validation/experiments/wang_scr/work `
--summary validation/experiments/wang_scr
```

`--segments` and `--dt` change the mesh and the time step.

## Results

| | CableDyn | Measured | Thorsen et al. (2017) | Davies et al. (2026) |
| --- | --- | --- | --- | --- |
| Dominant cross-flow strain frequency, 8.25 m from the lower end | **0.992 Hz** (±0.008) | 1.00 Hz | 1.02 Hz | 1.04 Hz |
| Maximum r.m.s. strain / measured maximum | **1.073** | 1 | 0.996 | - |
| Mean ratio at the 25 stations | 1.036 | 1 | - | - |
| r.m.s. peaks along the span | 7 | 6 | 7 | - |

- **Frequency:** within the 0.008 Hz resolution of the measured value.
- **Strain magnitude:** the largest r.m.s. strain is 7 % above the measured largest, and the mean
over the stations 4 % above.
- **Spatial pattern:** the predicted response has one r.m.s. peak more along the span than the test
(7 against 6), as in Thorsen et al. (2017). So the peaks and troughs fall at different stations,
and the station-by-station ratio scatters (`rms_strain_comparison.csv`, r.m.s. log error 0.34).
- **Convergence:** 400 elements and half the time step change the maximum ratio by 0.2 % and 0.1 %
and leave the frequency unchanged (`provenance.json`).
26 changes: 26 additions & 0 deletions validation/experiments/wang_scr/measured_rms_strain.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
s_m,rms_strain
1.044,4.5870e-05
1.9427,3.5715e-05
2.8415,3.9650e-05
3.7493,5.3852e-05
4.6479,4.5683e-05
5.5467,2.5858e-05
6.4454,2.9980e-05
7.3441,4.7144e-05
8.2428,5.1266e-05
9.1416,3.9199e-05
10.0493,2.9081e-05
10.9479,4.0136e-05
11.8468,4.8156e-05
12.7454,4.5607e-05
13.6441,3.3653e-05
14.5428,3.3615e-05
15.4416,4.0436e-05
16.3494,4.2572e-05
17.2481,3.9012e-05
18.1467,2.5709e-05
19.0456,2.8369e-05
19.9442,3.7176e-05
20.8429,3.3653e-05
21.7416,2.8107e-05
22.6495,2.2223e-05
19 changes: 19 additions & 0 deletions validation/experiments/wang_scr/provenance.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
{
"source": "Wang, Fu, Baarholm, Wu & Larsen (2014), Marine Structures 39, 131-156 (the model riser, Table 2); Thorsen, Saevik & Larsen (2017), Marine Structures 51, 134-151 (Table 1, Sec. 5.1, Figs. 17-18)",
"doi": ["10.1016/j.marstruc.2014.07.002", "10.1016/j.marstruc.2016.10.007"],
"data_used": "the model riser properties; the 25 measured r.m.s. dynamic cross-flow strains of Fig. 17 (read from the vector figure, axes calibrated on its tick marks; the simulated maximum of the same figure reads 99.6 % of the measured one, as the text states); the measured dominant frequency 1.00 Hz 8.25 m from the lower end",
"coefficients": "Thorsen et al. (2017) for this case, not tuned: Cv 0.7, f0 0.18, df 0.08 (cross-flow only), CD 1.2, CM 2",
"CableDyn_commit": "1847a0d (dev)",
"validation_date": "2026-11-14",
"executable_name": "cabledyn.exe",
"executable_sha256": "see summary.json",
"compiler": "GNU Fortran 16.2.0",
"build_type": "Release",
"platform": "Windows 11 x86-64",
"segments": 200,
"dt_s": 0.005,
"sensitivity": {
"segments_400": {"max_ratio": 1.0753, "mean_ratio_at_stations": 1.0367, "dominant_frequency_hz": 0.9917},
"dt_0p0025": {"max_ratio": 1.0742, "mean_ratio_at_stations": 1.0366, "dominant_frequency_hz": 0.9917}
}
}
26 changes: 26 additions & 0 deletions validation/experiments/wang_scr/rms_strain_comparison.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
s_m,measured_rms_strain,cabledyn_rms_strain,ratio
1.0440,4.5870e-05,1.8708e-05,0.4079
1.9427,3.5715e-05,4.0653e-05,1.1383
2.8415,3.9650e-05,3.2249e-05,0.8134
3.7493,5.3852e-05,4.7770e-05,0.8871
4.6479,4.5683e-05,3.2998e-05,0.7223
5.5467,2.5858e-05,1.8495e-05,0.7153
6.4454,2.9980e-05,4.1456e-05,1.3828
7.3441,4.7144e-05,4.9755e-05,1.0554
8.2428,5.1266e-05,3.4480e-05,0.6726
9.1416,3.9199e-05,2.6913e-05,0.6866
10.0493,2.9081e-05,4.7323e-05,1.6273
10.9479,4.0136e-05,5.3446e-05,1.3316
11.8468,4.8156e-05,4.1079e-05,0.8531
12.7454,4.5607e-05,4.0281e-05,0.8832
13.6441,3.3653e-05,5.5683e-05,1.6546
14.5428,3.3615e-05,5.4886e-05,1.6328
15.4416,4.0436e-05,4.0594e-05,1.0039
16.3494,4.2572e-05,3.8404e-05,0.9021
17.2481,3.9012e-05,4.6681e-05,1.1966
18.1467,2.5709e-05,4.3938e-05,1.7090
19.0456,2.8369e-05,3.0334e-05,1.0693
19.9442,3.7176e-05,2.5013e-05,0.6728
20.8429,3.3653e-05,2.9946e-05,0.8899
21.7416,2.8107e-05,2.9305e-05,1.0426
22.6495,2.2223e-05,2.1199e-05,0.9539
17 changes: 17 additions & 0 deletions validation/experiments/wang_scr/summary.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"segments": 200,
"dt_s": 0.005,
"analysis_window_s": [
30.0,
150.0
],
"frequency_resolution_hz": 0.00833333333332907,
"max_rms_strain": 5.777620876413861e-05,
"measured_max_rms_strain": 5.3852e-05,
"max_ratio": 1.072870251135308,
"mean_ratio_at_stations": 1.0361663237798966,
"rms_log_error_at_stations": 0.3385758147803219,
"dominant_frequency_hz": 0.9916666666661592,
"measured_dominant_frequency_hz": 1.0,
"executable_sha256": "dd80f0b2b0ba5a526b46da7961b8ea7e18ed8c650c42583107b4df6eee3a8a74"
}
Loading
Loading