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 @@ -101,6 +101,17 @@ All notable changes to CableDyn are recorded in this file. The format follows
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 %.

### Fixed

- The statics of a finite-EI line through the free surface could fail at isolated currents:
each Gauss point's hydrodynamic load switched on and off at the surface, so the residual
jumped and an equilibrium with a point at the waterline had no root (a light lazy-wave cable,
OD 31 mm, in a cross current solved at 0.399 and 0.401 m/s and failed every static route at
0.400 m/s, the load stepping stopping at a drag fraction of 0.997). The drag, added mass, wave
Froude-Krylov load and VIV lift of a Gauss point now carry the immersed fraction of its
section, linear across one diameter about the surface, with its derivative in the Jacobians.
Fully submerged points are unchanged to the bit; the full test suite passes unchanged.

## [0.4.2] - 2026-11-09

### Added
Expand Down
4 changes: 4 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1329,6 +1329,10 @@ add_executable(test_viv_wake_deck tests/test_viv_wake_deck.f90)
target_link_libraries(test_viv_wake_deck PRIVATE cabledyn_core)
add_test(NAME viv_wake_deck COMMAND test_viv_wake_deck WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(viv_wake_deck PROPERTIES LABELS "fortran;integration;dynamic;viv" TIMEOUT 1200)
add_executable(test_static_surface_crossing tests/test_static_surface_crossing.f90)
target_link_libraries(test_static_surface_crossing PRIVATE cabledyn_core)
add_test(NAME static_surface_crossing COMMAND test_static_surface_crossing WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(static_surface_crossing PROPERTIES LABELS "fortran;integration;static" TIMEOUT 600)

# VIV amplitude estimate (Thorsen et al. 2016, Eq. 8 and 9) and the amplitude tables.
add_executable(test_viv_amplitude_kernel tests/test_viv_amplitude_kernel.f90)
Expand Down
23 changes: 18 additions & 5 deletions doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1451,11 +1451,24 @@ On the ``EI = 0`` path, an element crossing the free surface uses its wetted fra
Drag, added mass, and fluid inertia act on the wetted part (drag with the wet-weighted relative
velocity), and a recovery load :math:`-(1 - f)\,\tfrac{1}{2}\rho A g L_0` on each end node removes
the buoyancy of the dry part; the derivatives of :math:`f` with respect to the nodal heights are
included in the tangent. On the Hermite path the hydrodynamic loads are integrated over the
deformed element length at three Gauss points, and a Gauss point above the local surface
carries no load. This is exact for fully submerged elements, the regime of lazy-wave cables and
moorings, and approximates the wetted length of a surface-piercing element by the Gauss
sampling. The Hermite buoyancy recovery is exact: the waterline crossings of the cubic
included in the tangent. On the Hermite path the hydrodynamic loads (drag, added mass, the wave
Froude-Krylov load and the VIV lift) are integrated over the deformed element length at the
Gauss points, each weighted by the immersed fraction of its section, linear across one diameter:

.. math::

w = \min\left(1, \max\left(0, \tfrac12 + \frac{\eta - z_g}{D}\right)\right),

with :math:`z_g` the height of the Gauss point and :math:`\eta` the local surface. A point
deeper than :math:`D/2` has :math:`w = 1` exactly, so fully submerged elements, the regime of
lazy-wave cables and moorings, are integrated as before to the bit; across the surface the load
of a point is continuous in its height (with :math:`\partial w/\partial z_g = -1/D` in the
tangent). In waves a point above the instantaneous surface inside the band takes the wave velocity
and acceleration at the surface, where the Wheeler-stretched field vanishes above it. A wet/dry
switch per point made the load jump, and a static equilibrium with a Gauss point at the surface
then had no root: a 31 mm cable through the surface in a 0.400 m/s cross current
failed every static route while 0.399 and 0.401 m/s solved. The Hermite buoyancy recovery is
exact: the waterline crossings of the cubic
centreline height are located on each element, and the load :math:`\rho g A` is integrated in
closed form against the Hermite shape functions over the dry intervals,

Expand Down
Loading
Loading