Skip to content
Merged
6 changes: 5 additions & 1 deletion ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -325,7 +325,11 @@ consistent mass plus Morison added mass. `K` and `M` are assembled in symmetric
band storage; LAPACK `DSBGVX` gives the eigenvalues and inverse iteration on the
banded pencil gives each mode shape, so the cost grows with line length rather
than with its square. Dense `DSYGV` is kept as the test reference. Both line paths
are supported (`nModes`).
are supported (`nModes`). A finite-EI line's modes (`CD_Modal_Hermite_Line`) take
its end connections and attachments from the dynamic model, and a line restrained
in torsion adds the twist angle of every node: its lumped polar inertia and the
second variation of the nodal-twist energy (`CD_HermiteCable_Dyn_Twist_Hessian`)
in a band of 7 DOFs per node.

### Outputs

Expand Down
39 changes: 37 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,18 @@ All notable changes to CableDyn are recorded in this file. The format follows
load-dependent) and 4e-9 at rest; after a length step it is MoorDyn's at the carried stretch
to 4e-16 (carrying the strain instead would be off by 0.4 to 4.6 %); a restart in the ramp
continues bit for bit.
- OpenFAST linearisation of finite-EI lines restrained in torsion: the twist angles of the nodes
the end frames do not hold, and their rates, are continuous states (`Cable 1 node 2 twist,
rad`); the coupled point's orientation turns the torsion frame of the line's coupled
(host-driven) end, its angular velocity and acceleration reach the torsional damping and the
held end section's inertia, and the fairlead
moment carries the torque. A straight line's torsional modes from the eigenvalues of `A` are
the lumped chain's to 5e-14 (the continuum's `nπ/L √(GJ/Irn)` less the discretisation error,
1.6e-4 for the first mode at 50 elements) and its roll stiffness `D − C A⁻¹ B` is `GJ/L` to
1.5e-14; a 90° twisted lazy wave matches the deck's static solutions for a rolled and a moved
fairlead to 4.9e-4. In a `Linearize = True` run every input Jacobian, those of the time march
included, steps the coupled-point rotation by 1e-4 rad instead of 0.1 rad, which changes the
rotation columns of a deck with a hang-off spring by up to 0.17 %.
- OpenFAST linearisation with the line dynamics, as MoorDyn-F's: the continuous states are the
interior-node positions of every `EI = 0` line (MoorDyn's names and order) and the free
degrees of freedom of every finite-EI cable (node positions and tangents), then their
Expand All @@ -63,8 +75,8 @@ All notable changes to CableDyn are recorded in this file. The format follows
and the Syrope slow strain are first-order states, so the reduction gives these ropes' relaxed
static stiffness (each matches its deck's static solutions to 7e-5; held, they would read the
chain 0.6 % and the polyester 2.9 times too stiff). Free/Connect points, a `Rigid` cable end
connection, VIV lines, bodies, rods, buoys, torsion and `CONTROL` fail closed with named
messages. This replaces the quasi-static linearisation without states.
connection, VIV lines, bodies, rods, buoys and `CONTROL` fail closed with named messages. This
replaces the quasi-static linearisation without states.
- Composite Syrope lines: a Syrope polyester section between plain `EI = 0` sections, such as a
chain-polyester-chain mooring, in one LINE. The static start puts every Syrope element on the
rest curve of its load history with its own secant EA (the tension varies along a sagging
Expand All @@ -83,6 +95,23 @@ All notable changes to CableDyn are recorded in this file. The format follows
and the OpenFAST checkpoint mirror. Decks with torsion whose `Irn` was a placeholder (the
column was unused before) need the section's real value. The Python deck reader and builder
take `GJ|K|Bt` (builder `gj=(GJ, K, Bt)`).
- Active line control (`CONTROL`) of a finite-EI cable restrained in torsion, which was refused:
the torsional compliance, the nodal twist's `GJ`/l and `Bt`/l, the torque–tension coupling and
the polar inertia take the new lengths, a `-ζ` torsional damping keeps its `ζ`, and the damping
acts on the rate of the twist per length. A taut line paid out and hauled in carries
`GJ Φ/L(t) + K (H − L)/L` to 1.5e-12 and its tension to 4e-6; a constant pay-out carries the
Kelvin–Voigt torque to 6e-6 N m of its 0.64 N m damping share; a pay-out under a ringing twist
balances the energy to 8e-5 of the work done; restarts mid-ramp (snapshot, checkpoint mirror,
a coupled deck) are bit-identical. The checkpoint mirror of a line with the nodal twist gains
one value, its committed torque.
- Modal analysis (`nModes`) of finite-EI lines restrained in torsion: the modes carry the twist
angle of every node, as the dynamics do, with the lumped polar inertia and the second variation
of the twist energy at the static torque. A clamped straight line's torsional modes match
`nπ/L √(GJ/Irn)` within the lumped chain's own error (2.6e-4 on the first), elastic ends and
the torque–tension coupling their continuum solutions to 1e-3, and under a torque its lateral
modes match the clamped Greenhill cable to 3e-7; eliminating the angles reproduces the
condensed static tangent to 1e-16. `<root>.modes.out` adds `PolarShare` and `dTwist` when a
line carries twist.
- Torque–tension coupling of finite-EI cables: the 14-column LINE TYPES row's `GJ` column takes
`GJ|K`, with `K` the coupling of an armoured cable or wire rope (`T = EA ε + K τ`,
`M = GJ τ + K ε`). The cable carries the axial stiffness `EA − K²/GJ` of a section free to twist.
Expand Down Expand Up @@ -230,6 +259,12 @@ All notable changes to CableDyn are recorded in this file. The format follows
The static tangent takes the current's gradient along the line, so the Newton iteration also
converges in a current sheared across the line. A later `current` row now discards the levels
of an earlier profile row.
- The modal analysis of finite-EI lines ignored the end connections and the discrete
attachments: a clamped end was solved pinned (the first twelve frequencies of the lazy wave
of `torsion_lazy_wave_hangoff_twist.dat`, untwisted, rise by 0.1 % to 3.8 % with its clamps)
and buoyancy modules had no mass (with `nModes`, the first six frequencies of
`lazy_wave_buoyancy_modules.dat` drop by 13 % to 29 %). The positions and translations of a
line with a heading are written in the deck's axes, not the line's.
- A deck with a WaterKin elevation history (`WaveKinMod 1`) at `TMax = 0`, a check of the static
start, reduces the record over its own length instead of failing for want of a positive
`TMax`.
Expand Down
44 changes: 44 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -715,6 +715,15 @@ target_link_libraries(test_hermite_cable_control PRIVATE cabledyn_core)
add_test(NAME hermite_cable_control COMMAND test_hermite_cable_control)
set_tests_properties(hermite_cable_control PROPERTIES LABELS "fortran;unit;dynamic;hermite")

# Active line control of a line restrained in torsion: the quasi-static torque GJ Phi/L(t) (with
# torque-tension coupling), the torsional damping of the twist per length, the length terms a
# fresh build carries, the energy of a length change with a real Irn, no lag at alpha_f > 0,
# restart mid-ramp (snapshot, mirror) and a CONTROL deck on the coupled aggregate.
add_executable(test_control_torsion tests/test_control_torsion.f90)
target_link_libraries(test_control_torsion PRIVATE cabledyn_core)
add_test(NAME control_torsion COMMAND test_control_torsion WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(control_torsion PROPERTIES LABELS "fortran;unit;dynamic;hermite;openfast")

add_executable(test_hermite_added_mass tests/test_hermite_added_mass.f90)
target_link_libraries(test_hermite_added_mass PRIVATE cabledyn_core)
add_test(NAME hermite_added_mass COMMAND test_hermite_added_mass)
Expand Down Expand Up @@ -2005,6 +2014,13 @@ add_executable(test_modal tests/test_modal.f90 tests/blas_config_probe.c)
target_link_libraries(test_modal PRIVATE cabledyn_core)
add_test(NAME modal COMMAND test_modal)
set_tests_properties(modal PROPERTIES LABELS "fortran;unit;driver;static;validation")
# Modal analysis of a line restrained in torsion: the twist angle of every node joins the modes
# (torsional, elastic-end and torque-tension coupled modes, the lateral modes under a torque, the
# Schur complement of the angles against the condensed static tangent).
add_executable(test_modal_torsion tests/test_modal_torsion.f90)
target_link_libraries(test_modal_torsion PRIVATE cabledyn_core)
add_test(NAME modal_torsion COMMAND test_modal_torsion)
set_tests_properties(modal_torsion PROPERTIES LABELS "fortran;unit;static;validation")
# The modal eigensolves through CableDyn's LAPACK layer with every argument array against a
# no-access page: no read or write outside the arrays the modal code passes.
if(NOT CABLEDYN_STATIC_WINDOWS_RELEASE)
Expand Down Expand Up @@ -2188,6 +2204,14 @@ target_link_libraries(test_coupled_torsion PRIVATE cabledyn_core)
add_test(NAME coupled_torsion COMMAND test_coupled_torsion WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(coupled_torsion PROPERTIES LABELS "fortran;unit;static;dynamic;openfast")

# OpenFAST linearisation of a line restrained in torsion, by the shell's lin_eval recipe on the
# aggregate: the twist modes of A against n pi/L sqrt(GJ/Irn), the reduced roll stiffness GJ/L
# (nodal twist and condensed), the damping and inertia columns of the platform's angular rates.
add_executable(test_lin_torsion tests/test_lin_torsion.f90)
target_link_libraries(test_lin_torsion PRIVATE cabledyn_core)
add_test(NAME lin_torsion COMMAND test_lin_torsion WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(lin_torsion PROPERTIES LABELS "fortran;unit;dynamic;openfast")

add_executable(test_torsion_orcaflex tests/test_torsion_orcaflex.f90)
target_link_libraries(test_torsion_orcaflex PRIVATE cabledyn_core)
add_test(NAME torsion_orcaflex
Expand Down Expand Up @@ -2385,6 +2409,13 @@ add_test(NAME driver_cli_mixed_nmodes
"-DMUST_MATCH=nModes is not supported for mixed EI=0/finite-EI decks"
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(driver_cli_mixed_nmodes PROPERTIES LABELS "fortran;driver;cli")
# A lazy wave restrained in torsion and twisted two turns writes its modes with the twist.
add_test(NAME driver_cli_torsion_nmodes
COMMAND ${CMAKE_COMMAND} -DDRIVER=$<TARGET_FILE:cabledyn> -DEXPECT_RC=0
"-DARGS=${CMAKE_CURRENT_SOURCE_DIR}/tests/data/torsion_lazy_wave_modes.dat|${CMAKE_CURRENT_BINARY_DIR}/driver_cli_torsion_nmodes"
"-DMUST_MATCH=torsion solved, imposed twist 7.20000E\\+02 deg;converged run written"
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(driver_cli_torsion_nmodes PROPERTIES LABELS "fortran;driver;cli")
# Non-ASCII, reserved-device, input-clobbering, and concurrently used output paths.
add_test(
NAME driver_cli_paths
Expand Down Expand Up @@ -2724,6 +2755,16 @@ if(Python3_Interpreter_FOUND)
--output ${CMAKE_CURRENT_BINARY_DIR}/lozon_example_equilibrium)
set_tests_properties(lozon_example_equilibrium PROPERTIES
LABELS "python;driver;integration;example;lozon;validation")
# Modal analysis of decks restrained in torsion: the torsional modes of a straight clamped
# line against the chain and the continuum, its other modes against TorsStiffness Free, and
# the twisted lazy wave's modes.
add_test(
NAME modal_torsion_deck
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_modal_torsion_deck.py
--exe $<TARGET_FILE:cabledyn>
--source ${CMAKE_CURRENT_SOURCE_DIR}
--output ${CMAKE_CURRENT_BINARY_DIR}/modal_torsion_deck)
set_tests_properties(modal_torsion_deck PROPERTIES LABELS "python;driver;integration;validation")
# Static-initialization robustness matrix: a deterministic sample of EI=0 mooring regimes
# (catenary, semi-taut, taut, suspended, composite, slack/vertical, anchors off the seabed,
# sloped seabed, fine mesh, soft seabed, current, one/two segments, Free/Connect points)
Expand Down Expand Up @@ -2837,6 +2878,7 @@ if(CMAKE_Fortran_COMPILER_ID STREQUAL "GNU")
test_hermite_drag_dynamics
test_hermite_axial_damping
test_hermite_cable_control
test_control_torsion
test_endconn_spring
test_torsion_coupling)
target_compile_options(${_cabledyn_exact_real_test} PRIVATE -Wno-compare-reals)
Expand All @@ -2849,6 +2891,7 @@ if(CMAKE_Fortran_COMPILER_ID STREQUAL "GNU")
target_compile_options(test_hermite_cable_control PRIVATE -Wno-uninitialized -Wno-maybe-uninitialized)
target_compile_options(test_syrope_control PRIVATE -Wno-uninitialized -Wno-maybe-uninitialized)
target_compile_options(test_viscoelastic_control PRIVATE -Wno-uninitialized -Wno-maybe-uninitialized)
target_compile_options(test_control_torsion PRIVATE -Wno-uninitialized -Wno-maybe-uninitialized)
endif()

if(CABLEDYN_ENABLE_COVERAGE)
Expand Down Expand Up @@ -2900,6 +2943,7 @@ if(CABLEDYN_ENABLE_COVERAGE)
test_hermite_drag_dynamics
test_hermite_axial_damping
test_hermite_cable_control
test_control_torsion
test_hermite_added_mass
test_hermite_wave_forcing
test_lazywave_dynamics
Expand Down
Loading
Loading