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
97 changes: 91 additions & 6 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,9 +106,92 @@ All notable changes to CableDyn are recorded in this file. The format follows
snap peaks are not resolved in time. The standalone driver also prints a note for a dynamic
deck with `rhoInf` above 0.95, on the missing numerical dissipation. See the manual's
troubleshooting page.
- Anchor uplift channels for the drag-anchor check of a catenary mooring (no vertical load at
the anchor in the intact condition). `AnchFz<L>` and `AnchFH<L>` are the vertical component
(positive upward, the line lifting its anchor) and the horizontal magnitude of the `AnchTen<L>`
end force; for an anchor that holds one line they equal `Point<P>Fz` and `Point<P>FH`.
`TDP<L>Grd` is the grounded length, the deformed chord length from the grounded end to the
touchdown point; it varies continuously with the touchdown point and is 0 only when nothing
touches (an anchor node on the seabed beside a node a few millimetres clear of it reads
micrometres to millimetres, so test it against a small tolerance such as 0.01 m). The
channels are available on the static, `EI = 0`, finite-EI, mixed and multibody routes, in the C
API and in coupled OpenFAST and FAST.Farm runs; the two-moving-end finite-EI route rejects
`AnchFz`/`AnchFH` by name. The Python deck reader and builder accept the new names. See the
manual's outputs page (Anchor uplift), which also states the end-node weight share that a laid
`Fixed` anchor carries (slightly negative `AnchFz` on an `EI = 0` line, not uplift; exactly 0
on a finite-EI line, whose grounded end leaves its node weight to the floor). Because of that
share, `AnchFz` on an `EI = 0` line turns positive only after the anchor segment has started
to lift, so `TDP<L>Grd` is the primary no-uplift check and `AnchFz` the vertical anchor load.
- `OutputRecovery` option (`equilibrium`, the default, or `element`): the definition of the
finite-EI node tension, curvature, bend moment and segment tension (see Changed). `element`
restores the definitions of 0.1.1. The Python deck reader accepts and checks it.
- `CD_HermiteCable_Dyn_Curvature_Exact` and `CD_HFMF_Curvature_Exact`: the exact geometric
nodal curvature of the cubic-Hermite centreline, the larger one-sided trace at a node, which
`CD_HermiteCable_Dyn_Curvature` and `CD_HFMF_Curvature` returned up to 0.1.1.

### Changed

- Finite-EI node tension, curvature and bend moment are recovered from nodal equilibrium. The
`Ten<L>N<J>`, `Curv<L>N<J>` and `BendMom<L>N<J>` channels, the `Tension`, `Curvature` and
`BendMoment` columns of the static profile and the range graph, and the `.t.out` segment
tensions of a finite-EI line had used the element-mean axial force `EA(|r'| - 1)` and the
exact one-sided curvature of the element interpolation. With a stiff `EA` that axial force
oscillates between elements wherever the line bends over an element (the nodal seabed
reaction near touchdown, a section junction), and it exceeds the tension by `EI kappa^2` on
any mesh. The outputs now come from the element end forces, each element with its own
distributed loads and inertia: the effective tension is the axial component of the section
force, the bend moment the moment the neighbouring elements carry, and the curvature that
moment over `EI`. The derivation is in the manual's theory page (Node tension, curvature and
bend moment). On the lazy-wave cable of `examples/iea15mw_umaine_mixed_cabledyn.dat` on its
former 87-element mesh the static interior node tension now stays between 1217 N and the
11.9 kN fairlead tension instead of dropping to -173 N. Against the equilibrium of the
converged line, the largest error falls from 1552 N to 60 N at that mesh, from 2059 N to
12 N, 1921 N to 1 N and 516 N to 0.3 N at twice, four times and ten times the mesh density, and from 164 N to
1 N at 0.25 m elements. The largest curvature error falls from 64 % to 30 %, 44 % to 7 %, 19
% to 4 % and 2.1 % to 0.8 % of the peak. Under an 8 m surge and 2 m heave of the hang-off,
the error of the maximum-tension envelope against a 1 m mesh falls from 2164 N to 857 N, 1488
N to 283 N and 3049 N to 31 N, and the minimum tension of the run from -719 N to +610 N at
that mesh. A `.t.out` segment tension is now the mean of the axial components of the
element's two end forces instead of the axial resultant at its midpoint. The library
curvature (`CD_HermiteCable_Dyn_Curvature`, `CD_HFMF_Curvature`) follows the same definition
as the channels. A section softer than `max(|w| L0^2)/12` times 1 m (about 1.3 kN m^2 for the
10 m elements of that cable) takes its curvature from the exact geometric trace, as an
`EI = 0` section does: the recovered moment carries an error of that order whatever `EI` is,
which `Curv = BendMom/EI` would amplify (6.9 1/m against 0.12 1/m at `EI` = 100 N m^2).
Line-end values (`FairTen`, `AnchTen`, the end-node tension; the end reaction, without the
inertia, added mass and seabed friction that the recovered section forces of the interior
nodes include), positions and the material-strain checks (`tensile_safety`, the static
compression notes) are unchanged. At a `Fixed` anchor resting on the seabed the end element
carries the floor-support share of its weight, as in the residual, so the end node reports
the bend moment of the line (0.02 N m, not 903 N m, at the anchor of the 87-element cable of
`examples/iea15mw_umaine_mixed_cabledyn.dat`, and 0.1 N m, not 205 N m, at the next node; on
the example's 248-element mesh 0.1 N m and 1.5 N m, the bend of the laid run sinking into the
penalty seabed beside the anchor held at the seabed depth). On
a line restrained in torsion the condensed torque is left out of the recovery; it moves the
tension by at most 0.45 N of 9.4 kN on `examples/torsion_lazy_wave_hangoff_twist.dat`. Range
graphs and `.t.out` files written every step cost 4 % more run time, plain channels under 2
%. `OutputRecovery element` restores the previous definitions. The T-6 record of
`VALIDATION.md` (twisted lazy wave against OrcaFlex), which reads the static-profile
curvature, moves from 0.056 % to 0.049 %. The curvatures of the one-hour coupled full-turbine
run in its coupled finite-EI touchdown row (0.156 1/m at the sag bend, 0.109 1/m at the
touchdown) were recorded with the previous definition and are marked as such, as is the
static sag-bend curvature of the Hs = 11 power-cable case of
`validation/OPENFAST_DLC_VERIFICATION.md`, which now also gives the recovered values. The other
records use end tensions or the exact geometric curvature
(`CD_HermiteCable_Dyn_Curvature_Exact`) and are unchanged.
- The touchdown point (`TDP<L>` channels and `cabledyn.touchdown_history`) is located inside
the element by the parabola through the last grounded node and the next two nodes instead of
the linear clearance between the last grounded node and the next. On a stiff seabed the
linear interpolation held the TDP on the last grounded node until the next one grounded, so
the TDP moved in steps of one element and, under a small motion, jumped by an element and
back. The parabola reaches a node exactly when the node grounds or lifts off, so the TDP moves
continuously. On a 450 m finite-EI cable under a 10 m fairlead surge, the largest step between
output rows falls from 4.64 m to 0.08 m with 5 m elements and from 1.98 m to 0.08 m with
2.5 m elements, and the largest error against a 1 m mesh from 2.96 m to 1.92 m and from
1.39 m to 1.18 m; under a 0.5 m surge the quasi-static TDP excursion with 1 m elements is
0.63 m against 0.64 m converged, where the linear interpolation gave 0.23 m. On the
`EI = 0` chain of `examples/chain_range_tdp.dat` the largest step falls from 2.59 m to 1.33 m.
The TDP now lies on the contact-onset height, and `TDP<L>Grd` uses the same location.
- Faster wave kinematics of directional and multi-train seas (`wavetrain` rows, spectral
`waves` rows, `WaveSpreading`). Each component's phase cosine is now computed once for the
surface elevation and the kinematics, and its depth profile with one exponential instead of
Expand Down Expand Up @@ -145,12 +228,14 @@ All notable changes to CableDyn are recorded in this file. The format follows
the static state, solved in the vertical plane of the cable, was unstable out of that plane.
The static fairlead tension of the cable changes from 11 898 N to 11 922 N (11 921 N on a
1 m mesh), its anchor tension from 1218 N to 1230 N, and the touchdown curvature from
0.058 1/m to 0.079 1/m (0.080 1/m on the 1 m mesh). The curvature output moves with the
mesh: `Curv4N20`/`BendMom4N20` (76 m from the hang-off) become `Curv4N38`/`BendMom4N38`
(74 m, the peak of the sag bend). In the one-hour full-turbine run of the validation record
the hang-off tension statistics are unchanged (11.5 ± 1.1 kN), the touchdown curvature peaks
at 0.109 1/m instead of 0.075 1/m, and the anchor tension stays at its static 1.23 kN, where
the coarse mesh showed stick-slip peaks up to 4.1 kN. The validation record and the tutorials
0.058 1/m to 0.079 1/m (0.080 1/m on the 1 m mesh; the geometric curvature, which
`OutputRecovery element` reports, while the curvature recovered from nodal equilibrium reads
0.100 1/m on the 87-element mesh and 0.081 1/m on the 248-element one). The curvature output
moves with the mesh: `Curv4N20`/`BendMom4N20` (76 m from the hang-off) become
`Curv4N38`/`BendMom4N38` (74 m, the peak of the sag bend). In the one-hour full-turbine run of
the validation record the hang-off tension statistics are unchanged (11.5 ± 1.1 kN), the
touchdown curvature (geometric) peaks at 0.109 1/m instead of 0.075 1/m, and the anchor
tension stays at its static 1.23 kN, where the coarse mesh showed stick-slip peaks up to 4.1 kN. The validation record and the tutorials
are updated.
- Faster tension-only (`EI = 0`) line steps. In every Newton evaluation the element kernels of
the line loads (axial damping, Morison drag, Froude-Krylov, buoyancy recovery, added mass) no
Expand Down
22 changes: 22 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -688,6 +688,11 @@ target_link_libraries(test_bathymetry PRIVATE cabledyn_core)
add_test(NAME bathymetry COMMAND test_bathymetry)
set_tests_properties(bathymetry PROPERTIES LABELS "fortran;unit;seabed")

add_executable(test_range_tdp_locator tests/test_range_tdp_locator.f90)
target_link_libraries(test_range_tdp_locator PRIVATE cabledyn_core)
add_test(NAME range_tdp_locator COMMAND test_range_tdp_locator)
set_tests_properties(range_tdp_locator PROPERTIES LABELS "fortran;unit;seabed")

add_executable(test_hydro tests/test_hydro.f90)
target_link_libraries(test_hydro PRIVATE cabledyn_core)
add_test(NAME hydro COMMAND test_hydro)
Expand Down Expand Up @@ -1470,6 +1475,23 @@ if(Python3_Interpreter_FOUND)
message(STATUS "range_graph_tdp: skipped (numpy not importable in ${Python3_EXECUTABLE})")
endif()

# Anchor uplift channels (AnchFz/AnchFH, TDP<L>Grd): the analytic laid and suspended elastic
# catenaries, the Point<P>F identity on every standalone route, and a surge that lifts the
# anchor of a catenary (needs numpy).
if(_range_tdp_numpy_rc EQUAL 0)
add_test(NAME anchor_uplift_channels
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_anchor_uplift.py
--exe $<TARGET_FILE:cabledyn>
--examples ${CMAKE_CURRENT_SOURCE_DIR}/examples
--output ${CMAKE_BINARY_DIR}/anchor_uplift_channels)
set_tests_properties(anchor_uplift_channels PROPERTIES
LABELS "python;integration;static;dynamic;validation"
TIMEOUT 600
ENVIRONMENT "${_cabledyn_python_test_environment}")
else()
message(STATUS "anchor_uplift_channels: skipped (numpy not importable in ${Python3_EXECUTABLE})")
endif()

# The arbiter imports numpy + scipy at load time; only register the test when they are
# importable, so an image with python3 but without those packages does not fail the
# validation suite with ModuleNotFoundError before any CableDyn gate runs.
Expand Down
Loading
Loading