Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
8a62231
feat: bending damping of finite-EI cables (EI|Bb, EI|-zeta|f) (#144)
SMI-Lab-Inha Nov 11, 2026
7e6350c
feat: in-line VIV of finite-EI cables (the VIV section) (#145)
SMI-Lab-Inha Nov 11, 2026
4a91d68
feat: in-line VIV on EI = 0 lines (#146)
SMI-Lab-Inha Nov 11, 2026
a0e8c04
feat: load power channels VIVPow, DragPow and DampPow (#147)
SMI-Lab-Inha Nov 11, 2026
9bd50e4
feat: cabledyn.viv_response, the VIV response of a line (#148)
SMI-Lab-Inha Nov 11, 2026
07c91bb
feat: section-point stress and fatigue of biaxial bending (#149)
SMI-Lab-Inha Nov 12, 2026
42aeab3
feat: cabledyn.current_steps, stepped-current VIV studies in one run …
SMI-Lab-Inha Nov 12, 2026
b5feeac
feat: higher-harmonic VIV force (VIV section column Chh) (#151)
SMI-Lab-Inha Nov 12, 2026
df0324f
feat: VIV columns after the 14-column finite-EI LINE TYPES row (#152)
SMI-Lab-Inha Nov 12, 2026
a2b552d
validation: Delta Flume riser natural frequencies (L3-C) (#153)
SMI-Lab-Inha Nov 12, 2026
0c73735
feat: wake-oscillator VIV on finite-EI cables (WAKE OSCILLATOR sectio…
SMI-Lab-Inha Nov 13, 2026
3a2753f
feat: amplitude-dependent VIV coefficients (VIV AMPLITUDE section) (#…
SMI-Lab-Inha Nov 13, 2026
025cbad
feat: diameter of the VIV model apart from the hydrodynamic one (VIV …
SMI-Lab-Inha Nov 13, 2026
281b021
feat: cross-flow damping on finite-EI cables (VIV DAMPING section) (#…
SMI-Lab-Inha Nov 13, 2026
1847a0d
fix: bending forces in the round-off floor of the dynamic tolerance (…
SMI-Lab-Inha Nov 13, 2026
43fcba4
feat: a finite-EI line may end on a Free point (a free cable end) (#159)
SMI-Lab-Inha Nov 14, 2026
befec35
validation: cross-flow VIV of a steel catenary riser in uniform curre…
SMI-Lab-Inha Nov 14, 2026
c46eb64
docs: published VIV coefficient sets with their sources (#161)
SMI-Lab-Inha Nov 14, 2026
5e65151
feat: wake-oscillator VIV on EI = 0 lines (#162)
SMI-Lab-Inha Nov 14, 2026
28ece63
fix: continuous Gauss-point loads of a finite-EI line at the free sur…
SMI-Lab-Inha Nov 14, 2026
ecd12d6
fix: a buoyancy module on a finite-EI line can float at the surface (…
SMI-Lab-Inha Nov 15, 2026
7d3998f
feat: VIV FRAME section, wake frequency relative to the cable's filte…
SMI-Lab-Inha Nov 15, 2026
5114299
feat: VIV FRAME for the synchronisation model's amplitude estimate, d…
SMI-Lab-Inha Nov 15, 2026
6c469fe
validation: Delta Flume riser VIV in a stepped current (L3-D) (#167)
SMI-Lab-Inha Nov 15, 2026
efbfbba
fix: a finite-EI dynamic step on the inertia's round-off floor conver…
SMI-Lab-Inha Nov 15, 2026
041337e
fix: a finite-EI step no longer converges to the root with its tangen…
SMI-Lab-Inha Nov 16, 2026
4b94321
feat: Rayleigh damping of finite-EI cables (EI|-zeta|f1|f2) (#170)
SMI-Lab-Inha Nov 16, 2026
f4c9958
fix: the coupled VIV response converges at second order in the time s…
SMI-Lab-Inha Nov 16, 2026
05a4f14
validation: NDP 38 m high-mode riser VIV in uniform flow (L3-N) (#172)
SMI-Lab-Inha Nov 16, 2026
3d779fb
test: long-run VIV checks; one OpenMP thread per batch job; load-powe…
SMI-Lab-Inha Nov 16, 2026
41df15d
docs: in-line drag amplification includes the in-line damping; VIV FR…
SMI-Lab-Inha Nov 16, 2026
dca9e29
validation: FLOTANT power-cable specimen VIV in tow tests (L3-F) (#175)
SMI-Lab-Inha Nov 17, 2026
dfbbf33
build: the Release build is warning-free again (#176)
SMI-Lab-Inha Nov 17, 2026
a244dfc
fix: the side a symmetric static leaves its plane to follows the line…
SMI-Lab-Inha Nov 17, 2026
15b5ebc
validation: SJTU catenary riser VIV under heave of its upper end (L3-…
SMI-Lab-Inha Nov 17, 2026
b49dddb
validation: SJTU flexible cylinder VIV in oscillatory flow (L3-O) (#180)
SMI-Lab-Inha Nov 17, 2026
fea3c4e
feat: stochastic VIV band centre (VIV STOCHASTIC, Ulveseter et al. 20…
SMI-Lab-Inha Nov 17, 2026
9ab09f7
ci: pull requests run the Debug tier without the slow-labelled tests …
SMI-Lab-Inha Nov 17, 2026
a46d997
validation: Southampton untensioned catenary riser VIV with touchdown…
SMI-Lab-Inha Nov 17, 2026
5f1db71
ci: pull-request Debug tier also skips the tests over 200 CPU-s at -O…
SMI-Lab-Inha Nov 17, 2026
3aec0cb
perf: evaluate a cable's line-wide channel values once per output row…
SMI-Lab-Inha Nov 19, 2026
8cf5cfc
perf: cheaper coupled CalcOutput of a cable with the nodal twist (#185)
SMI-Lab-Inha Nov 19, 2026
5d97bde
feat: OPTIONS CDOutDt, the interval of the coupled .CD.out rows (#186)
SMI-Lab-Inha Nov 20, 2026
93010d4
perf: cheaper nodal-twist kernels (Hessians, frame-only transfer) (#187)
SMI-Lab-Inha Nov 20, 2026
3e5638d
feat: VIV FRAME method cycle, a lag-free frame velocity (#188)
SMI-Lab-Inha Nov 20, 2026
1b1c469
release: CableDyn 0.4.3
SMI-Lab-Inha Nov 20, 2026
706ab87
chore(release): rerun the experiment records with 0.4.3
SMI-Lab-Inha Nov 20, 2026
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
15 changes: 14 additions & 1 deletion .github/workflows/fortran.yml
Original file line number Diff line number Diff line change
Expand Up @@ -85,10 +85,23 @@ jobs:
# at once, so each runs single-threaded: OpenMP and OpenBLAS would otherwise start a
# thread per core in every test and oversubscribe the runner. Tests that check
# threading set their own thread counts.
#
# A pull request runs the Debug tier without the tests labelled slow (the long lazy-wave,
# mooring and statics campaigns) or debug_long (tests over about 200 CPU-s at -O0, listed in
# CMakeLists.txt): the -O0 faults this tier exists for live in code the remaining tests
# reach, and the skipped tests still run in Release on both platforms and on the Prescott
# kernel. Every push to dev
# and main runs the full suite at -O0, so each merge is hardened without holding the PR.
env:
OMP_NUM_THREADS: "1"
OPENBLAS_NUM_THREADS: "1"
run: ctest --test-dir build --output-on-failure --parallel 4
FAST_DEBUG: ${{ matrix.build_type == 'Debug' && github.event_name == 'pull_request' }}
run: |
if [ "$FAST_DEBUG" = "true" ]; then
ctest --test-dir build --output-on-failure --parallel 4 -LE 'slow|debug_long'
else
ctest --test-dir build --output-on-failure --parallel 4
fi

# Round-off fragility: a result that depends on the BLAS kernel fails here although every
# job above, on the runner's own kernel, passes. Prescott, an SSE3 kernel of the conda-forge
Expand Down
365 changes: 364 additions & 1 deletion CHANGELOG.md

Large diffs are not rendered by default.

4 changes: 2 additions & 2 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -23,8 +23,8 @@ authors:
repository-code: "https://github.com/SMI-Lab-Inha/CableDyn"
url: "https://github.com/SMI-Lab-Inha/CableDyn"
license: Apache-2.0
version: 0.4.2
date-released: 2026-11-09
version: 0.4.3
date-released: 2026-11-20
keywords:
- mooring dynamics
- cable dynamics
Expand Down
210 changes: 208 additions & 2 deletions CMakeLists.txt

Large diffs are not rendered by default.

20 changes: 11 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ lifting off the seabed lie inside the formulation.

It runs as a standalone program, as a mooring module of OpenFAST and FAST.Farm
(`CompMooring = 5`), through a C interface, or from Python.
The current stable release is `v0.4.2`; interfaces are versioned and may change before `1.0.0`.
The current stable release is `v0.4.3`; interfaces are versioned and may change before `1.0.0`.

## What CableDyn does

Expand Down Expand Up @@ -68,10 +68,10 @@ selection:
| Bergdahl dynamic chain test, 30 conditions | measured end force | correlation 0.993 |
| IEA 15 MW VolturnUS-S in OpenFAST with a power cable | OpenFAST with MoorDyn | platform motions within 0.6 % |

Run times on one processor thread, same host and protocol, with the timing scripts in
Run times of the 0.4.2 release driver on one processor thread, same host and protocol, with the timing scripts in
[`validation/performance`](https://cabledyn.readthedocs.io/en/latest/validation.html):

| Case | CableDyn 0.4.2 | OrcaFlex 11.6d |
| Case | CableDyn | OrcaFlex 11.6d |
|---|---|---|
| 80 / 200 / 800 m lazy-wave spans, 60 s of heave | 1.3 / 2.4 / 5.0 s | 2.7 / 5.3 / 27.8 s |
| One-hour VolturnUS-S chain mooring | 4.3 s | 19.7 s |
Expand All @@ -89,8 +89,8 @@ Unsupported combinations stop with a named error rather than running approximate
|---|---|
| `CableDyn_driver.exe` | Standalone solver for Windows x64 (AVX2 processor) |
| `openfast.exe` | OpenFAST with CableDyn available as `CompMooring = 5` |
| `cabledyn-0.4.2-py3-none-any.whl` | Python package (pre- and post-processing, batch runs) |
| `cabledyn-0.4.2.tar.gz` | Python source distribution |
| `cabledyn-0.4.3-py3-none-any.whl` | Python package (pre- and post-processing, batch runs) |
| `cabledyn-0.4.3.tar.gz` | Python source distribution |
| `SHA256SUMS.txt` | Checksums for the assets above |

Both executables are statically linked, need no installer, compiler, or runtime
Expand Down Expand Up @@ -128,7 +128,7 @@ Unsupported combinations stop with a named error rather than running approximate
cabledyn-run examples\wd0050_chain.dat wd0050
```

The pure Python wheel on the release page (`cabledyn-0.4.2-py3-none-any.whl`)
The pure Python wheel on the release page (`cabledyn-0.4.3-py3-none-any.whl`)
carries no driver: `cabledyn-run` then needs `--executable .\CableDyn_driver.exe`,
the `CABLEDYN_DRIVER` environment variable, or the driver on `PATH`. A source
build names the driver `cabledyn` (see [Build from source](#build-from-source));
Expand Down Expand Up @@ -171,8 +171,10 @@ layout is described in the architecture notes in the repository.
## Validation

CableDyn is verified against analytical solutions and compared with MoorDyn,
OrcaFlex, two physical experiments (Holcombe lazy-wave, Bergdahl dynamic chain),
the IEA 15 MW VolturnUS-S reference systems, and coupled OpenFAST runs. Results,
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, 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 Expand Up @@ -200,7 +202,7 @@ If you use CableDyn in academic work, please cite:
> offshore wind. *Ocean Engineering* 368 (Part 2), 128332, 2026.
> <https://doi.org/10.1016/j.oceaneng.2026.128332>

To identify the software version, also cite the release (CableDyn 0.4.2).
To identify the software version, also cite the release (CableDyn 0.4.3).
The [citation file](https://cabledyn.readthedocs.io/en/latest/citing.html) contains both entries (GitHub **Cite this
repository**); BibTeX is on the manual's
[How to cite](https://cabledyn.readthedocs.io/en/latest/citing.html) page.
Expand Down
2 changes: 1 addition & 1 deletion RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -104,7 +104,7 @@ The build fails if either executable imports a non-system DLL or lacks the UTF-8
active-code-page manifest (`release/check_static_windows_binary.ps1`), or if the
standalone and `CompMooring = 5` smoke cases fail with a system-only `PATH` or from
a folder named in mixed scripts. It also fails unless `openfast.exe -v` names the
executable `OpenFAST-v5.0.0-CableDyn-0.4.2`: the OpenFAST base and the CableDyn version,
executable `OpenFAST-v5.0.0-CableDyn-0.4.3`: the OpenFAST base and the CableDyn version,
never a `-dirty` describe of the patched tree.

The release workflow (`.github/workflows/release-windows-static.yml`) produces
Expand Down
Loading
Loading