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
22 changes: 18 additions & 4 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1752,9 +1752,8 @@ if(Python3_Interpreter_FOUND)
TIMEOUT 600
ENVIRONMENT "${_cabledyn_python_test_environment}")

# Discrete buoyancy modules on a lazy wave in a cross current (the attachment polish falls
# back from diverging Newton steps on the frictional seabed): the static solve converges and
# its end tensions match the equivalent smeared section.
# Discrete buoyancy modules on a lazy wave in a cross current on a frictional seabed: the static
# solve converges without a fallback and its end tensions match the equivalent smeared section.
add_test(NAME attachment_cross_current
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_attachment_cross_current.py
--exe $<TARGET_FILE:cabledyn>
Expand Down Expand Up @@ -1961,8 +1960,23 @@ if(Python3_Interpreter_FOUND)
LABELS "python;integration;static;dynamic;capi"
TIMEOUT 600
ENVIRONMENT "${_cabledyn_python_test_environment}")
# Discrete buoyancy modules in oblique and cross currents (speed, heading, module count and
# mesh refinement swept): the attachment polish converges without its fallbacks on a frictional
# seabed, and a mid-water lazy wave's end forces balance its weight, buoyancy and drag (C API).
# PROCESSORS reserves the four driver processes the test runs at once.
add_test(NAME attachment_polish_current
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_attachment_polish_current.py
--exe $<TARGET_FILE:cabledyn>
--library ${_node_channels_library}
--source ${CMAKE_CURRENT_SOURCE_DIR}
--output ${CMAKE_BINARY_DIR}/attachment_polish_current)
set_tests_properties(attachment_polish_current PROPERTIES
LABELS "python;hermite;static;robustness;attachments;capi"
PROCESSORS 4
TIMEOUT 900
ENVIRONMENT "${_cabledyn_python_test_environment}")
else()
message(STATUS "node_channels_refined_line: skipped (numpy not importable in ${Python3_EXECUTABLE})")
message(STATUS "node_channels_refined_line, attachment_polish_current: skipped (numpy not importable in ${Python3_EXECUTABLE})")
endif()

# The arbiter imports numpy + scipy at load time; only register the test when they are
Expand Down
5 changes: 3 additions & 2 deletions doc/driver_format.md
Original file line number Diff line number Diff line change
Expand Up @@ -1041,8 +1041,9 @@ Behaviour:
with the same drag law at rest, so a run in a current starts in equilibrium.
An attachment above the free surface carries its weight only, in the static initial condition
too. Attachments have no seabed contact of their own; the node's contact acts on the line.
- The static equilibrium is solved first with each attachment's net weight spread over the two
elements at its node, then carried to the discrete loads by continuation. The current drag
- The static equilibrium is solved first with each attachment's net weight, and in a current
across the vertical plane of the line its drag areas, spread over the two elements at its node,
then carried to the discrete loads by continuation. The current drag
depends on the node's position and line direction, and the weight on the side of the surface
an attachment is on, so the final solve is repeated until the node positions change by less
than 1e-9 m and no attachment changes side. On a line restrained in torsion the torsion stage
Expand Down
24 changes: 16 additions & 8 deletions doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2970,8 +2970,12 @@ the nodal tangent :math:`\mathbf{m}_j/\lvert\mathbf{m}_j\rvert` (the line's Mori
: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
equilibrium with the net weight smeared over the node's two elements and continue to the lumped
load in warm-started Newton solves; in a deck current the drag at rest is added, each solve takes
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
Expand All @@ -2989,12 +2993,16 @@ At most 64 load steps may fail in all. A discrete state reached this way passes
tensile, physical-branch and stability checks of the smeared state before it is accepted, the
kink limit :math:`L_0\kappa \le 0.7` applied away from the attachment nodes: a lumped load
turns the line by a slope jump :math:`\theta` at its node, which the :math:`C^1` elements
beside the node carry as :math:`L_0\kappa \approx 2\theta` at any mesh size. The smeared state carries no
attachment drag, and on a frictional seabed, whose regularised friction force turns from its
sticking stiffness to its sliding capacity over a short slip, the Newton update for a
cross-flow drag can overshoot and diverge from the first step (a lazy wave with 25 modules in a
0.3 m/s cross current on 2 m elements, even in steps of 1/64), which the pseudo-transient
regularisation avoids.
beside the node carry as :math:`L_0\kappa \approx 2\theta` at any mesh size. On a frictional
seabed, whose regularised friction force turns from its sticking stiffness to its sliding
capacity over a short slip, a smeared state without the attachment drag left the polish to apply
the whole module drag, and its damped Newton updates diverged from the first step as the
grounded run slid metres sideways (a lazy wave with 25 modules in a 0.3 m/s cross current on 2 m
elements); with the drag smeared, each load step moves the line by millimetres and converges in
a few iterations. A current along the plane does not move the line out of it, and the polish
carries the attachment drag from the smeared state without it, as the smeared start of a coarse
deck mesh could otherwise stop at the grounded-run compression check (a lazy wave restrained in
torsion in 0.5 m/s along its plane).
As the pitch :math:`p` of identical modules shrinks, the discrete equilibrium
converges to the smeared section at :math:`O(p^2)`.

Expand Down
Loading
Loading