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
42 changes: 41 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,8 @@ All notable changes to CableDyn are recorded in this file. The format follows
tension, or that of its viscoelastic or Syrope law) at one step exceeds four times its own one
step before and after, ten times the largest tension anywhere on the line one step before and
after, and the largest tension of the initial state. The first spike of a line is reported as
a warning, once per line, and the run summary counts them. The run ends with a note when a
a warning, once per line, naming its segment from End A as `.Line<L>.t.out` numbers it, and
the run summary counts them. The run ends with a note when a
taut segment turned by more than 1° in one solver step (with `ei0_substeps auto`, see Changed,
1.1 times the larger of 1° and `ei0_substep_angle`; the sub-steps of a sub-stepped or
recovered step count as steps; the mean and standard deviation of the tension err by about
Expand Down Expand Up @@ -183,6 +184,28 @@ All notable changes to CableDyn are recorded in this file. The format follows
still reject `CONTROL`. A zero command, with a `DeltaLdot` of either sign, leaves the run
bit-identical to an uncontrolled one, and a checkpoint restart continues bit-identically. See
the manual's deck format page (CONTROL).
- A note when the static layout of an `EI = 0` line folds back on the seabed (a hairpin), the
twin of the finite-EI note. A current toward the anchor or a seabed falling past it can carry
the grounded run of a tension-only line past its anchor where no seabed friction holds it,
and it folds back with zero tension at the fold: a 2 m/s current carried a chain 20 m past its
anchor, a 5° slope 24 m, without a word. The equilibrium is kept, and one note per line names
the fold (the distance past the anchor, or a turn above 150° of the grounded run at a deck
node, numbered from End A as the node channels), its cause
(a deck current on the line, a seabed steeper than 0.5° at the fold, or a slack run) and the
remedy that fits the deck's static friction: `frictionMu` against a current,
`staticsFriction asLaid` on a slope (with the default `staticsFriction none` the static solve
applies friction against a deck current only), or a shorter line where friction already acts
or the route rejects it; a run without `dtM` and `TMax` is told that friction needs them,
since the static-only line solve carries none. A run that the `staticsFriction asLaid`
reference itself lays past its end (laid from the lower end along `layAzimuth`) is not
noted, nor is a near-vertical line (horizontal span under a tenth of the water depth) past
its end. The finite-EI note on a run past its anchor, which named "seabed friction or a
shorter line" whatever the deck, now names the same cause and remedy by the same rule and
skips the same as-laid run. It is printed on the static, `TMax = 0`, point-system and
multibody routes and in the OpenFAST initialisation report, which now also prints the
initialisation notes of finite-EI cables, and returned in the line report of the OpenFAST
aggregate. No example deck prints it, and no result changes. See the manual's theory page
(EI = 0 path) and Troubleshooting.

### Changed

Expand Down Expand Up @@ -635,6 +658,23 @@ All notable changes to CableDyn are recorded in this file. The format follows
OPTION); an anchor below the seabed by more than the
tolerance gives the depth, the tolerance rule, and the Z to use. These messages change no
acceptance rule.
- `Free` and `Connect` points (clump weights, buoys) and `Point3` buoys now have their own
seabed contact. Until now only the end nodes of the attached lines held a point on the
seabed, over their tributary length, so a heavy clump sank silently into it: a 50 t clump
between two polyester lines ended 2.8 m below the seabed, a 20 t clump on chain 1.0 m. A
point with `Mass` or `Vol` (a `Point3` buoy: its BODY `Mass` and `Vol`) now rests on a
footprint `A = V^(2/3)` (`V` = `Vol`, or `Mass`/7850 kg/m³ for a clump declared by its mass
alone), the face area of a cube of its volume, with the line contact law, stiffness `kBot·A`
and damping `cBot·A`, along the surface normal on a bathymetry, in the point static
equilibrium (which does not place a `Point3` buoy) and in the monolithic, staggered and
OpenFAST/C API point steps. The 50 t clump now rests 0.95 m deep (its weight alone presses
its 3.44 m² footprint in by 1.43 m) and the 20 t clump 0.67 m. The point routes still reject
`frictionMu`, so the contact is frictionless. Formal OpenFAST linearisation of a deck with a
`Point3` buoy now fails closed by name, like a deck with Rigid6 bodies or rods: its
quasi-static re-solve held the buoy at its deck position. Results change only where a point touches the seabed: of the examples only
`clump_weight_free_point.dat`, whose clump now rests 4.7 cm deep instead of 6.6 cm and whose
anchor tension falls from 186 kN to 92 kN; decks whose points stay clear of the seabed give
identical output. See the manual's theory page (Seabed contact).
- The development environment (`environment.yml`) excludes OpenBLAS 0.3.34, which caused the
access violation in the modal analysis tests listed under Known issues for 0.1.1. On AMD
Zen 4 and Zen 5 CPUs that expose AVX-512, OpenBLAS 0.3.34 enlarges the GEMM blocking,
Expand Down
80 changes: 80 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -986,6 +986,14 @@ target_link_libraries(test_deck_massless_connect PRIVATE cabledyn_core)
add_test(NAME deck_massless_connect COMMAND test_deck_massless_connect WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(deck_massless_connect PROPERTIES LABELS "fortran;driver;integration;dynamic")

# Seabed contact of Free/Connect points: a clump weight rests on its own footprint in the
# statics and stays at rest in the monolithic and staggered marches, on a flat and a sloped
# seabed; the fold note of an EI = 0 line reaches the OpenFAST aggregate's line report.
add_executable(test_point_seabed_contact tests/test_point_seabed_contact.f90)
target_link_libraries(test_point_seabed_contact PRIVATE cabledyn_core)
add_test(NAME point_seabed_contact COMMAND test_point_seabed_contact WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(point_seabed_contact PROPERTIES LABELS "fortran;driver;integration;dynamic;static")

add_executable(test_openfast_shell tests/test_openfast_shell.f90)
target_link_libraries(test_openfast_shell PRIVATE cabledyn_core)
add_test(NAME openfast_shell COMMAND test_openfast_shell)
Expand Down Expand Up @@ -2098,6 +2106,78 @@ add_test(NAME driver_advisories
-DSEABED_DECK=${CMAKE_CURRENT_SOURCE_DIR}/examples/chain_catenary_shallow_30m.dat
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_advisories.cmake)
set_tests_properties(driver_advisories PROPERTIES LABELS "fortran;driver;integration")
# The fold note of an EI = 0 line, once per folded line and never on a usual layout: a current
# that pushes the grounded run 20 m past its anchor (TMax = 0, the line-model route), a seabed
# sloping down past the anchor (static run over a bathymetry), each with the remedy that fits
# the deck's friction, and no note on a grounded chain that does not fold, on the same current
# deck with frictionMu, on the same slope with as-laid friction, on a run the deck itself lays
# past its anchor (staticsFriction asLaid along layAzimuth), or on two lines through a clump
# resting on the seabed.
add_test(NAME driver_ei0_fold_note_current
COMMAND ${CMAKE_COMMAND} -DDRIVER=$<TARGET_FILE:cabledyn> -DEXPECT_RC=0
"-DARGS=${CMAKE_CURRENT_SOURCE_DIR}/tests/data/ei0_hairpin_current.dat|hairpin"
"-DONCE=Note: line 1: the static layout carries the grounded run 20\\.[0-9]+ m past its anchor, where it folds back;the current drives the run along the seabed, which holds it only by friction"
"-DMUST_MATCH=seabed friction \\(frictionMu\\) or a shorter line prevents it"
-DWORKDIR=${CMAKE_CURRENT_BINARY_DIR}/driver_ei0_fold_note_current
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(driver_ei0_fold_note_current PROPERTIES LABELS "fortran;driver;integration;static")
add_test(NAME driver_ei0_fold_note_slope
COMMAND ${CMAKE_COMMAND} -DDRIVER=$<TARGET_FILE:cabledyn> -DEXPECT_RC=0
"-DARGS=${CMAKE_CURRENT_SOURCE_DIR}/tests/data/ei0_fold_slope.dat|slope"
"-DONCE=Note: line 1: the static layout carries the grounded run 2[0-9]\\.[0-9]+ m past its anchor, where it folds back;the seabed slope drives the run downhill"
"-DMUST_MATCH=frictionMu with staticsFriction asLaid, which need dtM and TMax: the static-only solve carries no seabed friction\\) or a shorter line prevents it"
-DWORKDIR=${CMAKE_CURRENT_BINARY_DIR}/driver_ei0_fold_note_slope
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(driver_ei0_fold_note_slope PROPERTIES LABELS "fortran;driver;integration;static")
# ... and a fold of the grounded run onto itself between two grounded ends, named at its deck
# node (driver_ei0_fold_layouts checks that it is the node of the fold).
add_test(NAME driver_ei0_fold_note_turn
COMMAND ${CMAKE_COMMAND} -DDRIVER=$<TARGET_FILE:cabledyn> -DEXPECT_RC=0
"-DARGS=${CMAKE_CURRENT_SOURCE_DIR}/tests/data/ei0_fold_turn_current.dat|turn"
"-DONCE=Note: line 1: the static layout folds the grounded run back on itself \\(a 180 deg turn at node 49, a hairpin\\);the current drives the run along the seabed, which holds it only by friction"
"-DMUST_MATCH=seabed friction \\(frictionMu\\) or a shorter line prevents it"
"-DMUST_NOT=past its anchor"
-DWORKDIR=${CMAKE_CURRENT_BINARY_DIR}/driver_ei0_fold_note_turn
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(driver_ei0_fold_note_turn PROPERTIES LABELS "fortran;driver;integration;static")
foreach(_deck IN ITEMS examples/chain_catenary_shallow_30m tests/data/ei0_hairpin_current_friction
tests/data/ei0_fold_slope_aslaid tests/data/ei0_aslaid_behind_anchor
tests/data/ei0_clump_no_fold)
get_filename_component(_name "${_deck}" NAME)
if(_name STREQUAL "chain_catenary_shallow_30m")
set(_test driver_ei0_no_fold_note)
else()
set(_test driver_ei0_no_fold_note_${_name})
endif()
add_test(NAME ${_test}
COMMAND ${CMAKE_COMMAND} -DDRIVER=$<TARGET_FILE:cabledyn> -DEXPECT_RC=0
"-DARGS=${CMAKE_CURRENT_SOURCE_DIR}/${_deck}.dat|${_name}"
"-DONCE=converged run written"
"-DMUST_NOT=folds back|a hairpin"
-DWORKDIR=${CMAKE_CURRENT_BINARY_DIR}/${_test}
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(${_test} PROPERTIES LABELS "fortran;driver;integration;static")
endforeach()
# The finite-EI twin of the current note: the same cause and remedy (fold_cause_remedy).
add_test(NAME driver_fei_fold_note_current
COMMAND ${CMAKE_COMMAND} -DDRIVER=$<TARGET_FILE:cabledyn> -DEXPECT_RC=0
"-DARGS=${CMAKE_CURRENT_SOURCE_DIR}/tests/data/fei_hairpin_current.dat|fei_hairpin"
"-DONCE=Note: line 1: the static layout carries the grounded run [0-9.]+ m past its anchor, where it folds back;the current drives the run along the seabed, which holds it only by friction"
"-DMUST_MATCH=seabed friction \\(frictionMu\\) or a shorter line prevents it"
-DWORKDIR=${CMAKE_CURRENT_BINARY_DIR}/driver_fei_fold_note_current
-P ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_driver_output.cmake)
set_tests_properties(driver_fei_fold_note_current PROPERTIES LABELS "fortran;driver;integration;static")
# ... and the layouts behind those notes: the frictionless current carries the run past its
# anchor, frictionMu holds it short of the note threshold, and the as-laid run the note skips
# does lie past the anchor (so the no-note tests cannot pass on a layout that never got there).
if(Python3_Interpreter_FOUND)
add_test(NAME driver_ei0_fold_layouts
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/check_fold_layout.py
$<TARGET_FILE:cabledyn> ${CMAKE_CURRENT_SOURCE_DIR}/tests/data)
set_tests_properties(driver_ei0_fold_layouts PROPERTIES
LABELS "python;driver;integration;static"
ENVIRONMENT "${_cabledyn_python_test_environment}")
endif()
# A clamped finite-EI cable with a buoyant section on a Rigid6 body: the body static solve
# holds the objects at their deck poses, warns once, and reports no balanced clamped end loads.
add_test(NAME driver_clamped_buoyant_held
Expand Down
11 changes: 8 additions & 3 deletions doc/driver_format.md
Original file line number Diff line number Diff line change
Expand Up @@ -621,7 +621,12 @@ A POINTS row has 9 columns, `ID Type X Y Z Mass Vol CdA Ca`, or the short 5-colu
For dynamic `Connect`/`Free` points, `Mass` is inertial mass and `(rhoW·Vol − Mass)·g` is a
constant vertical load. A `Mass = 0` junction is accepted; it moves with the end-node mass of its
lines. `CdA` adds lumped drag and `Ca` lumped added mass in EI = 0 dynamic runs with uniform or
profile current or deck waves. `Connect`/`Free` points require `dtM`/`TMax` in the
profile current or deck waves. A `Connect`/`Free` point with `Mass` or `Vol` (a clump weight or
a buoy) has its own seabed contact, the line contact law with stiffness `kBot·A` and damping
`cBot·A` over the footprint `A = V^(2/3)`, where `V = Vol`, or `Mass/7850` (solid steel) when
`Vol = 0`; a point with neither has none. A `Point3` buoy has the same contact over the footprint
of its BODY `Mass`/`Vol` (see the theory manual, Seabed contact).
`Connect`/`Free` points require `dtM`/`TMax` in the
standalone driver. Non-zero `Mass`/`Vol`/`CdA`/`Ca` on `Fixed`, `Coupled`, `Vessel`, `Body<N>`,
`Rod<N>A/B`, or `Turbine<J>` points is rejected.

Expand Down Expand Up @@ -1041,8 +1046,8 @@ syntax form. The most frequently edited keywords are:
| `rhoW` / `WtrDnsty` | water density [kg/m³] | 1025.0 |
| `WtrDpth` | water depth [m]; seabed plane z = −WtrDpth. Omit for a suspended or taut line with no bottom contact | none |
| `bathymetryFile` / `bathymetry_file` / `seafloorFile` | structured bathymetry file (rows `x y depth`); mutually exclusive with `WtrDpth`. Supported for static EI = 0, independent-line EI = 0 dynamic, EI = 0 `Connect`/`Free` point-system line contact, cubic-Hermite finite-EI dynamic with held or prescribed-translation ends, free/fixed rod dynamic, and Rigid6 dynamic decks | none |
| `kBot` | seabed penalty stiffness base [Pa/m = N/m³], scaled per line node and rod contact station by diameter × tributary length, and by a fixed 1 m² reference area at a Rigid6 reference point (only with `WtrDpth`/`bathymetryFile`) | 1.0e5 |
| `cBot` | seabed normal damping base [Pa·s/m = N·s/m³], scaled like `kBot`; active only on contacting nodes moving downward | 1.0e4 |
| `kBot` | seabed penalty stiffness base [Pa/m = N/m³], scaled per line node and rod contact station by diameter × tributary length, at a Free/Connect point with Mass or Vol and a Point3 buoy by its footprint `V^(2/3)` (`V` = Vol, or Mass/7850), and by a fixed 1 m² reference area at a Rigid6 reference point (only with `WtrDpth`/`bathymetryFile`) | 1.0e5 |
| `cBot` | seabed normal damping base [Pa·s/m = N·s/m³], scaled like `kBot` (also over a point footprint); active only on contacting nodes and points moving downward | 1.0e4 |
| `bodyIC` | `static`: free `Rigid6` bodies and free rods, with `Free`/`Connect` points, start at their static equilibrium; `deck`: they start at their deck pose (for example a free-decay test) | `static` |
| `frictionMu` / `mu` | isotropic seabed friction coefficient: stick-slip springs on line nodes (held by the static solve too in a deck current, from the still-water laid shape, or toward the as-laid position with `staticsFriction asLaid`), regularised kinetic friction on rods and bodies; requires `WtrDpth` or `bathymetryFile`, and `dtM`/`TMax` in the standalone driver. Rejected on some routes (decks with `Connect`/`Free` points, `Point3` buoys or `FAILURE` rows, and body or rod decks off the default monolithic march); see the [OPTIONS reference](options.rst) | 0 |
| `frictionMuAxial` / `frictionMuLateral` | anisotropic line friction: the coefficients along and across the local line axis (OrcaFlex axial/normal); an omitted one takes `frictionMu`; both positive or both zero; rods and bodies use the lateral one | `frictionMu` |
Expand Down
8 changes: 5 additions & 3 deletions doc/openfast.rst
Original file line number Diff line number Diff line change
Expand Up @@ -178,7 +178,8 @@ Before trusting a run, confirm in the console:
#. the ``dtM`` line and the model inventory (``Created CableDyn model: ... line object(s)``);
#. for every line, the converged fairlead effective tension, force vector, inclination,
declination, and azimuth at the static equilibrium — printed unconditionally, whether or not
``OUTPUTS`` is present;
``OUTPUTS`` is present — followed by the line's static-initialisation notes, if any
(``Note: line ...``, for example a folded ``EI = 0`` layout; see :doc:`troubleshooting`);
#. ``Requested CableDyn OUTPUTS at t = 0 s``, the deck's channels in the first output row. With
SeaState waves or current the header adds ``SeaState kinematics at t = 0``: the equilibrium is
solved before the kinematics act, so a line-end tension at t = 0 can differ slightly from the
Expand Down Expand Up @@ -328,8 +329,9 @@ without an auxiliary process:
the ``.lin`` matrices in the ``.fst`` ``OutFmt``; to compare them with MoorDyn's
``D - C A^-1 B``, use a full-precision format such as ``"ES24.15E3"``, because the usual
4-digit format cannot resolve that reduction. A deck with
Rigid6 bodies or rods is rejected at initialisation: the quasi-static reduction would hold
them at their deck pose instead of re-solving their equilibrium.
Rigid6 bodies, rods or ``Point3`` buoys is rejected at initialisation: the quasi-static
reduction would hold them at their deck pose instead of re-solving their equilibrium (a
``Free`` point with the buoy's ``Mass``, ``Vol``, ``CdA`` and ``Ca`` is re-solved).
* **FAST.Farm** selects CableDyn with ``Mod_SharedMooring = 5`` for shared lines and
connections. Gravity, water density, depth, and ``TMax`` are host-owned and must agree across
turbines, otherwise initialisation fails.
Expand Down
9 changes: 6 additions & 3 deletions doc/options.rst
Original file line number Diff line number Diff line change
Expand Up @@ -89,14 +89,17 @@ Environment and seabed
- real, Pa/m (N/m³)
- ``1.0e5``
- finite, > 0 when a seabed is present. Mapped to each line node and rod contact station by
local diameter × tributary length; a Rigid6 reference point uses a fixed 1 m² area
local diameter × tributary length; a Free/Connect point with Mass or Vol, and a Point3
buoy, over its footprint (Vol, or Mass/7850 kg/m³, to the power 2/3); a Rigid6 reference
point uses a fixed 1 m² area
- both
- ``1.0e5 kBot``
* - ``cBot`` / ``cb``
- real, Pa·s/m (N·s/m³)
- ``1.0e4``
- finite, ≥ 0 when a seabed is present; scaled like ``kBot`` and acts only on contacted
nodes moving downward
- finite, ≥ 0 when a seabed is present; scaled like ``kBot`` (per line node and rod contact
station, and over the footprint of a Free/Connect point with Mass or Vol or a Point3
buoy) and acts only on contacting nodes and points moving downward
- both
- ``1.0e4 cBot``
* - ``frictionMu`` / ``mu`` / ``frictionCoefficient``
Expand Down
Loading
Loading