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
10 changes: 10 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,6 +118,16 @@ All notable changes to CableDyn are recorded in this file. The format follows
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.
- A buoyancy module (an `ATTACHMENTS` row) on a finite-EI line that floats had no static
position: its buoyancy switched off at its node's height, so its weight in air took it below
the surface and its weight in water above it, and the static start stopped with an error. Its
buoyancy, Froude-Krylov force and drag now carry the immersed fraction of the sphere of its
volume (of its drag area without one), as a Rigid6 body's buoyancy does, continuous with its
slope through the surface; the statics solve for it in each Newton iterate with its stiffness.
A 200 kg, 2 m^3 module on a slack cable now floats 0.35 m below the surface and holds that
height in the march, and rides 1.5 m waves. A module deeper than its sphere's radius is
unchanged to the bit. In deck waves a node above the instantaneous surface takes the wave
kinematics at the surface (they were zero there), as a cable's internal waves already did.

## [0.4.2] - 2026-11-09

Expand Down
4 changes: 4 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1333,6 +1333,10 @@ add_executable(test_static_surface_crossing tests/test_static_surface_crossing.f
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)
add_executable(test_attachment_surface tests/test_attachment_surface.f90)
target_link_libraries(test_attachment_surface PRIVATE cabledyn_core)
add_test(NAME attachment_surface COMMAND test_attachment_surface)
set_tests_properties(attachment_surface PROPERTIES LABELS "fortran;unit;static")

# 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
29 changes: 22 additions & 7 deletions doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3480,19 +3480,34 @@ with the fluid velocity :math:`\mathbf{u}` and acceleration :math:`\dot{\mathbf{
the relative velocity :math:`\mathbf{w} = \mathbf{u} - \dot{\mathbf{r}}_j` split normal and along
the nodal tangent :math:`\mathbf{m}_j/\lvert\mathbf{m}_j\rvert` (the line's Morison law with
:math:`C_dA = C_{d,n} d` and :math:`C_dA_x = \pi C_{d,t} d`). The drag enters the velocity tangent
and, through :math:`\mathbf{m}_j`, the position tangent exactly. Above the free surface an
attachment carries its weight :math:`-m g\,\mathbf{e}_z` alone. The statics start from the
and, through :math:`\mathbf{m}_j`, the position tangent exactly. At the free surface the buoyancy,
Froude–Krylov force and drag carry the immersed fraction of the sphere of the attachment's volume,
:math:`r = (3V/4\pi)^{1/3}` (of its drag area, :math:`C_dA = \pi r^2`, without a volume), as a
Rigid6 body's buoyancy does: with the immersed height :math:`h = \min(2r, \max(0, \eta - z_j + r))`,

.. math::

\phi = \frac{h^2 (3r - h)}{4 r^3},

so the weight is :math:`-(m - \phi\rho V)\,g\,\mathbf{e}_z`, continuous with its slope as the node
crosses the surface: :math:`\phi = 1` exactly from :math:`r` below the surface (the loads above,
unchanged) and :math:`\phi = 0` from :math:`r` above it (the weight :math:`-m g\,\mathbf{e}_z`
alone). A module that floats then rests at the height where :math:`\phi\rho V g` balances its
share of the load, where a wet/dry switch at the node gave it no position. The added mass
:math:`C_a \rho V` stays in the constant mass matrix, and the modal analysis leaves out the
hydrostatic stiffness of the surface, a module's as a line's own. The statics start from the
equilibrium with the net weight smeared over the node's two elements, in a deck current across
the vertical plane of the chord with the drag areas smeared over them too (per-metre drag
coefficients :math:`C_dA/(d\,L)` and :math:`C_dA_x/(\pi d\,L)` added to an element of length
:math:`L` for each share), and continue to the lumped loads in warm-started Newton solves, the
smeared weight and drag moving to the node together; in a deck current the drag at rest is
lumped at the node, each solve takes
every attachment's load on the side of the still-water level its node is on, and the final
solve is repeated with the loads of its own solution until the nodes stop moving and no
attachment changes side (an attachment that its weight in air takes below the surface and its
weight in water above it has no static position, and the solve fails closed, naming the
attachment that crossed the surface). Before, an attachment above the surface
it at its incoming state, and the final solve is repeated with the drag of its own solution
until the nodes stop moving. The buoyancy an attachment loses at the still-water level,
:math:`\rho V g (1 - \phi)` downward, is part of every Newton iterate with its stiffness
:math:`-\rho V g\, \partial\phi/\partial z` and potential, so a floating module needs no
outer iteration. Before, a wet/dry switch at the node gave a module at the surface no static
position and the solve stopped with an error; and before that, an attachment above the surface
kept its buoyancy in the statics: a 500 kg, 0.2 m\ :sup:`3` module 3 m above it moved the
fairlead load by up to 6.1 % in the first second of the march. The load moves
in eighths; a solve that stalls on a residual floor above the tight static tolerance is
Expand Down
9 changes: 2 additions & 7 deletions doc/troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -653,13 +653,8 @@ but a few geometries are genuinely hard:
reported in the note ``... was reached after a failed Newton solve ... and passed the
acceptance checks of the smeared state``. Check that the deck with the modules replaced by the equivalent
smeared buoyancy section solves; if it does, the discrete layout itself is the difficulty.
``... attachment <k> of the line (Mass ..., Volume ...) crossed the still-water level ...``
means the solves carried that attachment across the surface, where the dynamics drops its
buoyancy: its weight in air takes it below the surface and its weight in water above it, so a
point attachment has no static position there (the dynamics would bob it there). It is a
net-buoyant module that would float, or a module whose node lies nearer the surface than the
deflection its buoyancy gives the line. The message of the failed solve follows it. Move it
along the line or change its ``Mass`` or ``Volume``.
A module at the surface is not a cause: its buoyancy fades over the sphere of its volume, so a
module that floats has a static position.
- **A cold start at full load.** The static solve continues the load in stages; if you have
hand-tuned a case into a bad basin, remove the tuning and let the default continuation run
from the catenary/arch seed.
Expand Down
Loading
Loading