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
27 changes: 27 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,33 @@ All notable changes to CableDyn are recorded in this file. The format follows
routines and a 4 × 4 eigensolve, none of which passes DGEMM an inner dimension above 128,
and the released Windows executables use reference LAPACK, so results are unchanged. An existing environment takes the exclusion with
`conda env update -f environment.yml`, followed by a fresh build directory.
- The anchor tension of a finite-EI cable laid on the seabed no longer jumps when the line moves
out of its plane. The seabed contact acts at the nodes, which carry no moment, so at an
anchor resting on the floor the end moment of the end element's weight turned the free end
tangent into the floor: the element dipped below the seabed between its nodes (27 mm for the
power cable of `examples/iea15mw_umaine_mixed_cabledyn.dat`) and carried axial forces from
−47 kN to +127 kN about a line tension of 1.2 kN. Once the hang-off swayed, the element
buckled sideways; with seabed friction the anchor tension then locked at about 2.5 times its
static value for the rest of the run (1.22 kN to 3.1 kN in a coupled OpenFAST run while the
platform drifted toward the anchor), and without friction the end nodes wandered by up to
0.18 m. The seabed now carries the end element's weight with its end moment at a held line end
resting on the floor (along the floor normal on a sloped bathymetry), in the statics and the
dynamics alike, in the share in which the element lies on the floor: the contact force of
its inner node against half the element's weight, through a smooth step that is zero when
that node is clear of the floor and one from half the weight up. Lines whose held end does
not rest on the seabed, or whose end element rises from it (a taut line anchored on the
floor), are unchanged. In the
shipped finite-EI examples with an anchor on the seabed the end tensions change by at most
0.34 N (0.004 %). Two decks of the statics robustness matrix change outcome. A lazy wave
in a 1 m/s current on a frictional bed (`LW_1015__cur_fr`) had been reported as a hairpin
past its anchor only at its exact seabed stiffness. It now fails closed: the friction-held
touchdown goes into compression at about 0.33 m/s, before any tension-only equilibrium is
reached from the still-water layout, and a slow current ramp in the dynamics with
`tensile_safety` stops at the same point. A short line in a 1.9 m/s current on a
frictionless bed (`CUR_1013`) had failed closed. It now finds the equilibrium with the
grounded run turned sideways on the seabed: when the refinement of the catenary
continuation stops on a compression in a current, its failure now names the current limit,
so the driver retries out of the plane.

## [0.1.1] - 2026-10-09

Expand Down
2 changes: 1 addition & 1 deletion VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -734,7 +734,7 @@ stop with a named error.
| Active tension (`CtrlChan`) | Pass verified | CONTROL parsing, last-segment length/rate modulation, and exact unit tests; coupled A/B in which a ServoDyn cable-control DLL drives the same pay-out/haul-in `DeltaL` schedule into `=5` (CableDyn) and `=3` (stock MoorDyn) in one binary: hold tensions agree to <0.03% and the tension responses to <0.6% (controlled fairleads) / <0.7% (anchors) ([`validation/scripts/activetension/`](https://github.com/SMI-Lab-Inha/CableDyn/tree/main/validation/scripts/activetension), [`validation/scripts/openfast_activetension_ab.py`](https://github.com/SMI-Lab-Inha/CableDyn/blob/main/validation/scripts/openfast_activetension_ab.py)) |
| Coupled `Rigid6` bodies + `Point3` buoys | Pass verified | 6-DOF `Rigid6` motion with hydrostatic (`C33`/`C44`/`C55`) restoring, checkpoint state (bit-identical `openfast -restart` of a 13.9 MN-swinging tethered body), and SeaState drag / Froude–Krylov / added mass. `Point3` buoys take buoyancy and drag/added-mass/FK; a submerged volume-only buoy takes FK. Tests: `case_coupled_rigid6`/`_mirror`/`_fluid`, `case_coupled_point3_buoy`/`_fluid` |
| Coupled rigid rods | Pass verified | host-driven `Rod<N>A/B` endpoints, correction rewind, bit-identical 24-scalar-per-rod checkpoint state, and two Gauss fluid nodes per rod with SeaState drag/Froude–Krylov/added mass; `case_coupled_rod`, `_mirror`, and `_fluid` pass, and the OpenFAST module compiles with rod decks enabled |
| Coupled finite-EI touchdown/contact | Pass verified | flat `WtrDpth` and equivalent constant structured bathymetry initialise and step with matching loads; friction and checkpoint restore are tested. The IEA-15 mixed example has 38 grounded nodes and completes a 20 s aggregate trajectory at `dtM=0.025 s` with 2 m surge, 1 m heave, and 0.5 m/s host current, without fallback or stall recovery, at most 14 Newton iterations. This is an aggregate integration test, not a full-turbine touchdown DLC |
| Coupled finite-EI touchdown/contact | Pass verified | flat `WtrDpth` and equivalent constant structured bathymetry initialise and step with matching loads; friction and checkpoint restore are tested. The IEA-15 mixed example has 38 grounded nodes and completes a 20 s aggregate trajectory at `dtM=0.025 s` with 2 m surge, 1 m heave, and 0.5 m/s host current, without fallback or stall recovery, at most 14 Newton iterations. A full-turbine run of the same model (one hour after a 200 s transient; TurbSim normal turbulence, 10.6 m/s, 17 % TI; JONSWAP Hs 8 m, Tp 12 s, aligned with the wind and the cable; AeroDyn with the rotor held at 7.55 rpm, no controller, rigid blades and tower; SeaState grid covering the lines) completes without recoveries or non-finite values. The cable's hang-off tension is 11.5 ± 1.1 kN (static 11.9 kN, maximum 17.9 kN), the same 38 nodes stay grounded, and the peak curvature, 0.160 1/m at the hog bend, is mesh-converged (0.156 1/m on a refined mesh); the 10 m elements of the laid section under-resolve the touchdown curvature by about 30 %. The chain-only twin of the run matches stock MoorDyn over 1200 s to 0.3 % in platform motion and fairlead tension statistics. The anchor tension of the laid cable is 1.39 kN (median, static 1.22 kN) with wave-frequency stick-slip peaks up to 4.1 kN lasting under 1 s; before the anchor-end correction of this release it locked at about 2.75 kN for the whole run |
| `WaterKin` from file | Pass verified | See [WaterKin and SeaState modes](#waterkin-and-seastate-modes) |
| Syrope polyester (`SYROPE:` syntax; [Falkenberg et al., 2017](https://cabledyn.readthedocs.io/en/latest/references.html#ref-falkenberg2017)) | Pass verified | MoorDyn-F/C `BA_s|BA_d` rate and force equations; analytic position/velocity tangents with finite-difference checks; projected, bracketed backward-Euler slow-state update with a strong-unloading boundary test; OWC running maximum; `SYROPE IC` `Tmax0/Tmean0` history with range/order checks; both states carried through every lifecycle stage and the coupled checkpoint. `BA_s` is kept separate from line axial damping (`BA`) and tested against double counting. Composite, hydrodynamic, finite-EI, current, and wave combinations stop with a named error |
| VIV (`compVIV`) | Not supported | outside CableDyn's scope |
Expand Down
9 changes: 8 additions & 1 deletion doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1031,7 +1031,14 @@ The fallback and the dynamic Hermite path use
- **continuation in** ``EI``, and, for a net-buoyant line, **continuation in buoyancy**, which
tracks the smooth branch of the buoyant arch from the seed;
- the **consistent Hermite self-weight**, :math:`wL_0/2` on each end :math:`r_z` and
:math:`\pm wL_0^2/12` on the end :math:`m_z`;
:math:`\pm wL_0^2/12` on the end :math:`m_z`. At a held line end resting on the seabed the
floor carries the end element's weight with this end moment (its normal share
:math:`\cos\theta\,\mathbf{n}` on a floor of slope :math:`\theta` and upward normal
:math:`\mathbf{n}`), in the share :math:`3r^2 - 2r^3` (:math:`0 \le r \le 1`) in which the
element lies on the floor, :math:`r` the elastic contact force of its inner node over half the
element's weight: the nodal contact carries no moment, and the unbalanced end moment would
otherwise turn the end tangent of a laid element into the floor, while an element rising
from an anchor on the floor (:math:`r = 0`) keeps it;
- **mesh sequencing**: the equilibrium is selected on a coarse mesh that preserves section,
load, and contact-diameter interfaces, prolonged through the Hermite interpolant, and polished
on each finer level and finally on the exact user mesh with the same residual test. Deterministic
Expand Down
119 changes: 117 additions & 2 deletions src/CableDyn_HermiteCableDynamic.f90
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,8 @@ MODULE CableDyn_HermiteCableDynamic
CD_Component_Wave_Kinematics, CD_Solve_Dispersion_Wavenumber, CD_HYDRO_OK
USE CableDyn_SeabedContact, ONLY: CD_Seabed_Normal_Law, CD_Seabed_Contact_Gate, CD_SEABED_CONTACT_BLEND, &
CD_Seabed_Friction_Stick_Slip, CD_Seabed_Friction_Aniso, &
CD_Seabed_Friction_Mu_Dir, CD_FRICTION_STICK_SLIP
CD_Seabed_Friction_Mu_Dir, CD_FRICTION_STICK_SLIP, CD_Seabed_End_Support, &
CD_Seabed_End_Element_Share
USE CableDyn_Bathymetry, ONLY: CD_BathymetryType, CD_Bathymetry_Is_Initialized, &
CD_Bathymetry_Floor_Gradient, CD_End_Bathymetry, CD_BATHY_OK
USE CableDyn_HermiteTorsion, ONLY: CD_HermiteTorsionType, CD_HermiteTorsion_Line, CD_HermiteTorsion_Unwrap, &
Expand Down Expand Up @@ -5278,7 +5279,8 @@ SUBROUTINE assemble_residual(model, q_cfg, v_cfg, t_eval, want_residual, want_ta
REAL(wp) :: fdry(4), kdry(4, 4), dry_wl, dry_b, dry_r
INTEGER :: zdof(4), b
LOGICAL :: dry
REAL(wp) :: endconn_d0_eval(3, 2)
REAL(wp) :: endconn_d0_eval(3, 2), support(3), dsupport(3), nin(3), mend
INTEGER :: inode, jr, jc
CHARACTER(200) :: em2

ErrStat = CD_HCDYN_OK; ErrMsg = ''
Expand Down Expand Up @@ -5356,6 +5358,15 @@ SUBROUTINE assemble_residual(model, q_cfg, v_cfg, t_eval, want_residual, want_ta
R(6*e + 3) = R(6*e + 3) + model%w(e)*0.5_wp*model%l0(e)
R(6*e + 6) = R(6*e + 6) - model%w(e)*model%l0(e)*model%l0(e)/12.0_wp
END DO
! A held end whose end element lies on the floor: the seabed carries the element's
! weight with its consistent end moment (CD_Seabed_End_Support and
! CD_Seabed_End_Element_Share), which the nodal contact cannot.
IF (model%has_contact .OR. model%kn > CD_ZERO) THEN
IF (held_end_floor_support(model, q_cfg, 1, support, dsupport, inode, nin)) &
R(4:6) = R(4:6) - (model%w(1)*model%l0(1)*model%l0(1)/12.0_wp)*support
IF (held_end_floor_support(model, q_cfg, 2, support, dsupport, inode, nin)) &
R(6*ne + 4:6*ne + 6) = R(6*ne + 4:6*ne + 6) + (model%w(ne)*model%l0(ne)*model%l0(ne)/12.0_wp)*support
END IF
END IF
IF (model%has_attach) THEN
CALL assemble_attachments(model, q_cfg, v_cfg, want_residual, want_tangent, R, Kb, Kvb, es, em2)
Expand Down Expand Up @@ -5416,6 +5427,26 @@ SUBROUTINE assemble_residual(model, q_cfg, v_cfg, t_eval, want_residual, want_ta
END IF
END DO
END IF
! The floor-carried end moment of a held end follows the contact of the end element's
! inner node (inode, floor normal nin): its tangent couples the end tangent to that node.
IF (want_tangent .AND. (model%has_contact .OR. model%kn > CD_ZERO)) THEN
IF (held_end_floor_support(model, q_cfg, 1, support, dsupport, inode, nin)) THEN
mend = model%w(1)*model%l0(1)*model%l0(1)/12.0_wp
DO jc = 1, 3
DO jr = 1, 3
CALL scatter_contact_band(Kb, 3 + jr, 6*inode - 6 + jc, mend*dsupport(jr)*nin(jc))
END DO
END DO
END IF
IF (held_end_floor_support(model, q_cfg, 2, support, dsupport, inode, nin)) THEN
mend = model%w(ne)*model%l0(ne)*model%l0(ne)/12.0_wp
DO jc = 1, 3
DO jr = 1, 3
CALL scatter_contact_band(Kb, 6*ne + 3 + jr, 6*inode - 6 + jc, -mend*dsupport(jr)*nin(jc))
END DO
END DO
END IF
END IF

! Scatter the element-private hydrodynamic tangents in the same phase and element
! order as the serial formulation, retaining its floating-point accumulation order.
Expand Down Expand Up @@ -5871,6 +5902,90 @@ SUBROUTINE assemble_contact(model, q_cfg, v_cfg, want_residual, want_tangent, Er
END DO
END SUBROUTINE assemble_contact

LOGICAL FUNCTION held_end_floor_support(model, q_cfg, iend, support, dsupport, inode, nin) RESULT(held)
!! Floor reaction carrying the weight of the end element at line end iend (1: node 1,
!! 2: node nn) of a model with seabed contact, per unit weight: the floor's normal share
!! cos(slope) n of the weight (n the upward floor normal at the end, e_z on a flat bed)
!! times the share of the element lying on the floor. Its consistent end moment cancels
!! the weight's on a grounded end element; the along-floor part of the weight stays with
!! the line. The share is CD_Seabed_End_Support of the end node (on or below the floor)
!! times CD_Seabed_End_Element_Share of the element's inner node inode (the normal force
!! of its elastic contact law against half the element's weight): zero for an element
!! rising from an anchor on the floor, one for a laid element, smooth in between.
!! dsupport is d(support)/d(gap) of the inner node, whose gap gradient is -nin (nin its
!! floor normal). False (support zero) unless the end node's translations are all held
!! (not free), its end element is net-heavy and the share is positive.
TYPE(CD_HermiteCableDynType), INTENT(IN) :: model
REAL(wp), INTENT(IN) :: q_cfg(:)
INTEGER, INTENT(IN) :: iend
REAL(wp), INTENT(OUT) :: support(3), dsupport(3), nin(3)
INTEGER, INTENT(OUT) :: inode
INTEGER :: node, e, ix, es
REAL(wp) :: gap, sfac, share, nvec(3), sfac_in, gap_in, normal, normal_gap, elem, delem
CHARACTER(200) :: em
support = CD_ZERO
dsupport = CD_ZERO
nin = [CD_ZERO, CD_ZERO, CD_ONE]
held = .FALSE.
IF (iend == 1) THEN
node = 1; e = 1; inode = 2
ELSE
node = model%nn; e = model%ne; inode = model%nn - 1
END IF
IF (.NOT. (model%w(e) > CD_ZERO)) RETURN
ix = 6*node - 5
IF (ANY(model%freemask(ix:ix + 2))) RETURN
CALL floor_gap(node, gap, nvec, sfac, es)
IF (es /= CD_BATHY_OK) RETURN
share = CD_Seabed_End_Support(gap)
IF (.NOT. (share > CD_ZERO)) RETURN
CALL floor_gap(inode, gap_in, nin, sfac_in, es)
IF (es /= CD_BATHY_OK) RETURN
IF (model%has_contact) THEN
CALL CD_Seabed_Normal_Law(gap_in, model%contact_kn(inode), normal, normal_gap)
ELSE IF (gap_in > CD_ZERO) THEN
normal = model%kn*model%trib(inode)*gap_in
normal_gap = model%kn*model%trib(inode)
ELSE
normal = CD_ZERO
normal_gap = CD_ZERO
END IF
CALL CD_Seabed_End_Element_Share(normal, normal_gap, 0.5_wp*model%w(e)*model%l0(e), elem, delem)
IF (.NOT. (elem > CD_ZERO)) RETURN
held = .TRUE.
support = (share*elem/sfac)*nvec
dsupport = (share*delem/sfac)*nvec

CONTAINS

SUBROUTINE floor_gap(k, gap_k, n_k, sfac_k, es_k)
!! Normal penetration gap_k, upward floor normal n_k and slope factor of node k, on the
!! floor the contact assembly uses (structured bathymetry or the flat seabed plane). A
!! failed bathymetry query (es_k) fails closed in the contact assembly at the same point.
INTEGER, INTENT(IN) :: k
REAL(wp), INTENT(OUT) :: gap_k, n_k(3), sfac_k
INTEGER, INTENT(OUT) :: es_k
REAL(wp) :: xg, yg, z_floor, gxg, gyg, gx, gy
INTEGER :: kx
kx = 6*k - 5
es_k = CD_BATHY_OK
gx = CD_ZERO
gy = CD_ZERO
z_floor = model%seabed_z
IF (model%has_contact .AND. model%has_contact_bathymetry) THEN
xg = model%contact_frame_c*q_cfg(kx) - model%contact_frame_s*q_cfg(kx + 1)
yg = model%contact_frame_s*q_cfg(kx) + model%contact_frame_c*q_cfg(kx + 1)
CALL CD_Bathymetry_Floor_Gradient(model%contact_bathymetry, xg, yg, z_floor, gxg, gyg, es_k, em)
IF (es_k /= CD_BATHY_OK) RETURN
gx = model%contact_frame_c*gxg + model%contact_frame_s*gyg
gy = -model%contact_frame_s*gxg + model%contact_frame_c*gyg
END IF
sfac_k = SQRT(CD_ONE + gx*gx + gy*gy)
n_k = [-gx, -gy, CD_ONE]/sfac_k
gap_k = (z_floor - q_cfg(kx + 2))/sfac_k
END SUBROUTINE floor_gap
END FUNCTION held_end_floor_support

SUBROUTINE commit_friction_anchors(model)
!! Return mapping of the elastic-plastic friction springs at the committed state: a
!! spring stretched beyond the capacity mu*normal moves its anchor to the capacity
Expand Down
Loading
Loading