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
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,10 @@ All notable changes to CableDyn are recorded in this file. The format follows
- `cabledyn.current_steps`: a stepped-current schedule for a VIV study in one run (each speed
held, then ramped to the next), written as the deck's MoorDyn-C `Currents 2` file, with the
VIV response of every hold.
- Validation case L3-C (`validation/experiments/chaplin`): the still-water natural frequencies of
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.

## [0.4.2] - 2026-11-09

Expand Down
13 changes: 12 additions & 1 deletion VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,7 @@ article's methods, are compared in
| **L3-8** | Bend stiffener at a clamped hang-off (5 m tapered polyurethane) | OrcaFlex 11.6d (stiffener attachment) / planar elastica | curvature 0.45% of root; cable moment 0.01%, section moment 0.01%, deflection angle 0.0001°; local curvature 0.27% (0.1 m elements) | <1.5% / <2%, 0.05°, <0.5% | Pass |
| **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 |
| **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 @@ -300,7 +301,7 @@ initialisation.

### Physical experiments

No line or load parameter is fitted to either experiment. Inputs, reduction
No line or load parameter is fitted to any of the experiments. Inputs, reduction
scripts, results, and source provenance are in
[`validation/experiments`](https://github.com/SMI-Lab-Inha/CableDyn/tree/main/validation/experiments).

Expand All @@ -326,6 +327,16 @@ scripts, results, and source provenance are in
the run taken as given bit for bit); at
0.625 ms the T = 1.25 s maxima are 1.2% higher (with 0.3.0, 6.5% with every step taken as
given), and with 0.3.0 at 1.25 ms they were 2–15% higher and varied from cycle to cycle.
- **L3-C Delta Flume riser, still-water natural frequencies**
([Chaplin et al., 2005](https://cabledyn.readthedocs.io/en/latest/references.html#ref-chaplin2005)):
the modal analysis of the 13.12 m pinned riser about its static state, at the five top
tensions of the paper's Table 2, gives the first seven frequencies 1.87% high on average
(mean absolute error 2.28%, largest 4.88%, the first mode of the lowest tension) over 34 of
the 35 measured values; the added-mass coefficient 1 is kept (1.1 would bring the mean to +0.62%).
The 35th, the second mode of series C, is measured at 1.423 Hz against CableDyn's 1.619 Hz;
its ratio to the first mode departs from that of every other series, and it is reported
separately. 128 elements and ten times the unpublished axial stiffness change no frequency by
more than 3e-6 and 1.2e-4.

## L4 coupled OpenFAST

Expand Down
7 changes: 7 additions & 0 deletions doc/references.rst
Original file line number Diff line number Diff line change
Expand Up @@ -235,6 +235,13 @@ 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-chaplin2005:

- **Chaplin, J. R., Bearman, P. W., Huera Huarte, F. J. & Pattenden, R. J. (2005).** Laboratory
measurements of vortex-induced vibrations of a vertical tension riser in a stepped current.
*Journal of Fluids and Structures* **21**\ (1), 3–24.
https://doi.org/10.1016/j.jfluidstructs.2005.04.010

Comparison codes
----------------

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 and Bergdahl et al. (2016) dynamic-chain comparisons |
| [`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 |
| [`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 two published physical
This directory lets reviewers reproduce CableDyn's comparisons with three 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 @@ -11,5 +11,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 |

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

# Delta Flume vertical riser: still-water natural frequencies

This directory compares CableDyn's modal analysis with the still-water natural frequencies of the
13.12 m vertical tension riser that Chaplin et al. (2005) tested in the Delta Flume,
<https://doi.org/10.1016/j.jfluidstructs.2005.04.010>. The riser is the subject of the paper's
stepped-current VIV measurements. Its frequencies at five top tensions (Table 2) check the riser
model, the mass, added mass and tension along the line, which a VIV comparison then builds on. No
model parameter is fitted to the measurements.

## Model and data

- From Section 2 of the paper: length 13.12 m, diameter 28 mm, bending stiffness 29.9 N m², mass
ratio 3.0 with the internal water (so 1.847 kg/m in fresh water, whose submerged weight
12.08 N/m matches the paper's 12.1 N/m), universal joints at both ends (pinned in bending). The
riser was submerged over its whole length, the upper part in the water-filled tank.
- `natural_frequencies.csv` holds the top tensions and the first seven measured frequencies of
Table 2, typed from the article, next to CableDyn's.
- Assumed: fresh water (1000 kg/m³), the normal added-mass coefficient 1, and an axial stiffness
of 5.5e6 N, which the paper does not give. The unstretched length of each series gives its
Table 2 top tension, with the tension falling by the submerged weight down the riser.
- CableDyn: a finite-EI line between two stationary points, 64 elements, `nModes` about the
static state (TMax 0). The two transverse planes of the straight riser give each frequency
twice; the script checks that they agree and keeps one.

## Reproduce

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

```powershell
python validation/experiments/chaplin/chaplin_natural_frequencies.py `
path/to/cabledyn.exe validation/experiments/chaplin/work `
--summary validation/experiments/chaplin
```

`--segments`, `--ca` and `--ea` change the mesh, the added-mass coefficient and the axial
stiffness.

## Results

| Statistic (34 frequencies, series C mode 2 left out) | Value |
| --- | ---: |
| Mean error | +1.87 % |
| Mean absolute error | 2.28 % |
| Largest absolute error | 4.88 % (series A, mode 1) |

- CableDyn is 2–3 % high in most modes. The difference corresponds to a slightly larger added
mass: with `--ca 1.1` the mean error is +0.62 % and with `--ca 1.2` it is −0.59 %. The default
keeps the potential-flow value 1.
- Series C mode 2 is measured at 1.423 Hz, where CableDyn gives 1.619 Hz (+13.8 %). Its ratio
to the first mode, 1.82, departs from the near-harmonic ratios of the other four series
(1.97–2.16), while the neighbouring C modes agree with CableDyn within 3.3 %. It is reported
in the CSV and counted in the all-35 statistic (mean absolute error 2.61 %).
- 128 elements change no frequency by more than 3e-6, and ten times the axial stiffness by more
than 1.2e-4 (relative).

`natural_frequencies_summary.json` records the statistics and the SHA-256 of the executable.
231 changes: 231 additions & 0 deletions validation/experiments/chaplin/chaplin_natural_frequencies.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,231 @@
#!/usr/bin/env python3
# SPDX-License-Identifier: Apache-2.0
# Copyright (c) 2026 Jae Hoon Seo, SMI Lab, Inha University
"""Still-water natural frequencies of the Delta Flume riser of Chaplin et al. (2005).

Writes a CableDyn deck for each of the five test series (Table 2 top tensions), runs the modal
analysis about the static state, and compares the first seven frequencies with Table 2.

python chaplin_natural_frequencies.py path/to/cabledyn.exe WORKDIR [--segments 64]
[--ca 1.0] [--ea 5.5e6] [--summary DIR]

Source: J.R. Chaplin, P.W. Bearman, F.J. Huera Huarte, R.J. Pattenden (2005), Laboratory
measurements of vortex-induced vibrations of a vertical tension riser in a stepped current,
Journal of Fluids and Structures 21(1), 3-24, https://doi.org/10.1016/j.jfluidstructs.2005.04.010
"""

from __future__ import annotations

import argparse
import csv
import hashlib
import json
import math
import os
import subprocess
from pathlib import Path

# Section 2 of the paper: length, diameter, bending stiffness, mass ratio including the internal
# water, submerged weight (12.1 N/m, reproduced by the mass ratio below), universal joints at
# both ends. The tank was filled with water, so the whole riser is submerged.
LENGTH = 13.12 # m
DIAMETER = 0.028 # m
EI = 29.9 # N m^2
MASS_RATIO = 3.0 # mass / displaced mass, internal water included
RHO_W = 1000.0 # kg/m^3, fresh water (assumed)
GRAVITY = 9.80665 # m/s^2
AREA = math.pi * DIAMETER**2 / 4.0
MASS = MASS_RATIO * RHO_W * AREA # kg/m
SUBMERGED_WEIGHT = (MASS - RHO_W * AREA) * GRAVITY # N/m
Z_BOTTOM = -14.0 # m; any depth that keeps the riser submerged
WATER_DEPTH = 20.0 # m

# Table 2: still-water top tension [N] and the first seven natural frequencies [Hz] of each series
TABLE2: dict[str, tuple[float, tuple[float, ...]]] = {
"A": (389.0, (0.405, 0.873, 1.326, 1.804, 2.278, 2.797, 3.389)),
"B": (813.0, (0.633, 1.329, 1.954, 2.625, 3.312, 4.028, 4.753)),
"C": (1185.0, (0.782, 1.423, 2.394, 3.203, 4.024, 4.875, 5.704)),
"D": (1546.0, (0.899, 1.815, 2.741, 3.614, 4.561, 5.525, 6.439)),
"E": (1925.0, (1.037, 2.046, 3.084, 4.099, 5.127, 6.222, 7.298)),
}
N_MODES = 7


def unstretched_length(top_tension: float, ea: float) -> float:
"""Unstretched length that gives ``top_tension`` on the vertical riser of length LENGTH.

The effective tension falls linearly with the submerged weight from the top joint down,
and an element ds of the stretched riser has the unstretched length ds / (1 + T/EA).
"""
t_bottom = top_tension - SUBMERGED_WEIGHT * LENGTH
# exact integral of ds / (1 + T(s)/EA) with T linear in s
return ea / SUBMERGED_WEIGHT * math.log((ea + top_tension) / (ea + t_bottom))


def deck_text(
series: str, top_tension: float, segments: int, ca: float, ea: float
) -> str:
l0 = unstretched_length(top_tension, ea)
return f"""--------------------- CableDyn Input File ---------------------------------
Delta Flume riser of Chaplin et al. (2005), series {series}: still-water top tension {top_tension:g} N
----------------------- LINE TYPES ------------------------------------------
TypeName Diam Mass EA BA EI Cd_n Cd_t Ca_n Ca_t
(-) (m) (kg/m) (N) (N-s) (N-m^2) (-) (-) (-) (-)
riser {DIAMETER} {MASS:.6f} {ea:.6e} 0.0 {EI} 1.2 0.0 {ca} 0.0
----------------------- POINTS ----------------------------------------------
ID Attachment X Y Z M V CdA CA
(-) (-) (m) (m) (m) (kg) (m^3) (m^2) (-)
1 Coupled 0.0 0.0 {Z_BOTTOM + LENGTH:.6f} 0 0 0 0
2 Fixed 0.0 0.0 {Z_BOTTOM:.6f} 0 0 0 0
----------------------- LINES -----------------------------------------------
ID LineType AttachA AttachB UnstrLen NumSegs Outputs
(-) (-) (-) (-) (m) (-) (-)
1 riser 1 2 {l0:.9f} {segments} -
---------------------- OPTIONS ----------------------------------------------
{RHO_W} rhoW
{GRAVITY} g
{WATER_DEPTH} WtrDpth
{2 * (N_MODES + 1)} nModes
0.01 dtM
0.0 TMax
---------------------- OUTPUTS -----------------------------------------------
FairTen1
AnchTen1
END
------------------------- need this line --------------------------------------
"""


def frequencies(path: Path) -> list[float]:
"""The distinct frequencies of a straight line's .modes.out (each in both planes)."""
lines = path.read_text(encoding="utf-8").splitlines()
start = lines.index("# Natural frequencies") + 3
values = []
for line in lines[start:]:
if not line.strip() or line.startswith("#"):
break
values.append(float(line.split()[2]))
pairs = values[0::2]
for a, b in zip(values[0::2], values[1::2]):
if not math.isclose(a, b, rel_tol=1e-6):
raise SystemExit(f"{path.name}: the two planes differ ({a} and {b} Hz)")
return pairs


def top_tension(path: Path) -> float:
rows = [line.split() for line in path.read_text(encoding="utf-8").splitlines()[2:]]
return float(rows[0][1])


def main() -> None:
parser = argparse.ArgumentParser(description=__doc__.split("\n\n")[0])
parser.add_argument("executable", type=Path)
parser.add_argument("workdir", type=Path)
parser.add_argument("--segments", type=int, default=64)
parser.add_argument(
"--ca", type=float, default=1.0, help="normal added-mass coefficient"
)
parser.add_argument(
"--ea", type=float, default=5.5e6, help="axial stiffness [N] (not given)"
)
parser.add_argument(
"--summary", type=Path, help="write the committed summary files here"
)
args = parser.parse_args()

work = args.workdir.resolve()
work.mkdir(parents=True, exist_ok=True)
env = os.environ.copy()
env.setdefault("OMP_NUM_THREADS", "1")
rows = []
for series, (tension, measured) in TABLE2.items():
stem = f"chaplin_{series}"
(work / f"{stem}.dat").write_text(
deck_text(series, tension, args.segments, args.ca, args.ea),
encoding="utf-8",
)
run = subprocess.run(
[str(args.executable.resolve()), f"{stem}.dat", stem],
cwd=work,
env=env,
capture_output=True,
text=True,
encoding="utf-8",
errors="replace",
check=False,
)
(work / f"{stem}.console.txt").write_text(
run.stdout + run.stderr, encoding="utf-8"
)
if run.returncode != 0:
raise SystemExit(f"{stem}: CableDyn exited with {run.returncode}")
computed = frequencies(work / f"{stem}.modes.out")[:N_MODES]
t_top = top_tension(work / f"{stem}.out")
for mode, (f_c, f_m) in enumerate(zip(computed, measured), start=1):
rows.append(
{
"series": series,
"top_tension_N": tension,
"computed_top_tension_N": round(t_top, 3),
"mode": mode,
"measured_Hz": f_m,
"cabledyn_Hz": round(f_c, 5),
"error_percent": round(100.0 * (f_c / f_m - 1.0), 2),
}
)

errors = [abs(float(r["error_percent"])) for r in rows]
# Series C mode 2 (Table 2: 1.423 Hz) breaks the near-harmonic pattern of every other series
# (f2/f1 of 1.82 against 1.97-2.16): reported, and also left out of a second statistic
regular = [
abs(float(r["error_percent"]))
for r in rows
if (r["series"], r["mode"]) != ("C", 2)
]
signed = [
float(r["error_percent"]) for r in rows if (r["series"], r["mode"]) != ("C", 2)
]
summary = {
"source": "Chaplin et al. (2005), J. Fluids Struct. 21, 3-24, Table 2",
"doi": "10.1016/j.jfluidstructs.2005.04.010",
"segments": args.segments,
"added_mass_coefficient": args.ca,
"axial_stiffness_N": args.ea,
"mass_kg_per_m": round(MASS, 5),
"submerged_weight_N_per_m": round(SUBMERGED_WEIGHT, 3),
"frequencies_compared": len(rows),
"mean_abs_error_percent": round(sum(errors) / len(errors), 2),
"max_abs_error_percent": round(max(errors), 2),
"without_C2": {
"frequencies_compared": len(regular),
"mean_error_percent": round(sum(signed) / len(signed), 2),
"mean_abs_error_percent": round(sum(regular) / len(regular), 2),
"max_abs_error_percent": round(max(regular), 2),
},
"executable_sha256": hashlib.sha256(args.executable.read_bytes()).hexdigest(),
}
for row in rows:
print(
f"{row['series']} mode {row['mode']}: measured {row['measured_Hz']:.3f} Hz, "
f"CableDyn {row['cabledyn_Hz']:.3f} Hz, {row['error_percent']:+.1f} %"
)
print(
json.dumps(
{k: v for k, v in summary.items() if k != "executable_sha256"}, indent=2
)
)
if args.summary is not None:
args.summary.mkdir(parents=True, exist_ok=True)
with (args.summary / "natural_frequencies.csv").open(
"w", newline="", encoding="utf-8"
) as f:
writer = csv.DictWriter(f, fieldnames=list(rows[0]), lineterminator="\n")
writer.writeheader()
writer.writerows(rows)
(args.summary / "natural_frequencies_summary.json").write_text(
json.dumps(summary, indent=2) + "\n", encoding="utf-8", newline="\n"
)


if __name__ == "__main__":
main()
Loading
Loading