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
40 changes: 40 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,46 @@ All notable changes to CableDyn are recorded in this file. The format follows

### Added

- Seabed friction in the static solve, toward the as-laid position (OrcaFlex's *as laid*
statics seabed friction policy, opt-in): `asLaid staticsFriction`. Every grounded node is
held by a friction spring toward the position at which the line was laid from its lower end
(the anchor, or the fairlead when that is lower) along the lay azimuth on the seabed, with the regularised Coulomb law of the dynamics
(isotropic or axial/lateral, capped at `mu N`), in still water and in a current, on `EI = 0`
and finite-EI lines, standalone, coupled OpenFAST and through the C API; the march continues
the static springs, so a held run stays at rest. New OPTIONS `staticsFriction none|asLaid`,
`layAzimuth` and `layAzimuth<ID>` (default: the horizontal direction of each line's chord,
from its lower end),
`asLaidTension` and `asLaidTension<ID>` (default 0). The default stays `none`, as in MoorDyn:
frictionless statics in still water (friction from the still-water equilibrium in a current),
conservative for anchor loads, and every deck without the new rows runs as before. With
`asLaid`, a 700 m chain on a 5° slope with `frictionMu 1`, which the frictionless static
folds 24.0 m back past its anchor, holds where it was laid (friction up to 0.087 `mu N`, the
slope; FairTen 714.2 → 622.9 kN; held for 2 s to 1.5e-10 of FairTen), and a 650 m finite-EI
cable on a 10° slope, rejected as too long for its span, solves. As an illustration of the
effect on anchor loads, `asLaid` in `iea15mw_umaine_mixed_cabledyn.dat` lowers the chains'
AnchTen from 1351.6 to 368.2 kN (FairTen +0.16 %) and the laid cable's from 1230 N to 0.36 N:
runs laid slack and pulled taut are held back by friction. A run laid at the tension it
carries (`asLaidTension`) mobilises none: on a flat seabed FairTen equals the frictionless
one to 6e-6 and AnchTen to 0.4 %. A finite-EI line laid past the point under its fairlead has
no static solution yet (its touchdown hook is not reached); a lay azimuth across the span
solves it. A lay azimuth across the vertical plane of the chord, or a bathymetry sloping across
it under the laid run, solves a finite-EI line in 3D from the start (so a march from it stays
at rest), and a finite-EI line is laid from its lower end like an `EI = 0` one; a line whose
fairlead lies below its other end is laid, and seeded, from the fairlead. With discrete
`ATTACHMENTS` the reference sinks each node under its discrete load (its share of the line's
weight plus the attachment's net weight), so a module node rests on the laid path like the rest
of the run instead of taking its sink for a friction deflection. On a mesh the finite-EI
statics refines (adaptive refinement, the bending-length and stability refinements) or
coarsens, the reference is laid on that mesh itself, under its own lumped weights and nodal
seabed stiffnesses, and the march takes it on the final mesh: a run refined 16x on a seabed
curved along it and sloping across it, with a section change on the grounded run, rests where
its twin declared on the refined mesh does (to solver precision), where a reference
interpolated from the deck nodes moved it by up to 1 mm and reversed its lateral anchor force. The policy is rejected
where the statics carry no seabed friction: on decks with bodies, rods or dynamic
(`Connect`/`Free`) points (`frictionMu` itself is rejected on the latter and accepted on the
default monolithic body and rod march), and on a finite-EI deck whose line has a moving End B
(a line shared between two turbines, which takes the compatibility route). The Python `DeckFile`, `DeckWriter` and `DeckModel` take the new
rows. See the theory page (Friction in statics).
- Run-time profile of the standalone driver. With the environment variable
`CABLEDYN_PROFILE=1`, the driver prints at the end of the run how its wall time divides
between input parsing, initialisation and statics, and the dynamic march. The march is split
Expand Down
13 changes: 13 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1393,6 +1393,19 @@ if(Python3_Interpreter_FOUND)
TIMEOUT 900
ENVIRONMENT "${_cabledyn_python_test_environment}")

# Static seabed friction toward the as-laid position: a run on a slope below the friction
# angle holds (EI = 0 and finite EI), the march continues the static springs at rest, a
# line laid at its run tension reproduces the frictionless statics, and the inputs are
# checked.
add_test(NAME static_friction_as_laid
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_static_friction_as_laid.py
--exe $<TARGET_FILE:cabledyn>
--output ${CMAKE_BINARY_DIR}/static_friction_as_laid)
set_tests_properties(static_friction_as_laid PROPERTIES
LABELS "python;static;seabed"
TIMEOUT 600
ENVIRONMENT "${_cabledyn_python_test_environment}")

# Finite-EI generalised-alpha blends: force-blend dtM convergence under prescribed surge.
add_test(NAME hermite_force_blend_dt
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_hermite_force_blend_dt.py
Expand Down
5 changes: 4 additions & 1 deletion doc/driver_format.md
Original file line number Diff line number Diff line change
Expand Up @@ -992,8 +992,11 @@ syntax form. The most frequently edited keywords are:
| `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 |
| `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), 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 |
| `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` |
| `staticsFriction` | statics seabed friction policy (OrcaFlex): `none` solves frictionless statics (in a deck current, friction from the still-water equilibrium); `asLaid` holds every grounded node toward its as-laid position (laid from the line's lower end, the anchor or the fairlead when that is lower, along `layAzimuth` at `asLaidTension`) with the regularised Coulomb law; rejected where the statics solve the lines without seabed friction (decks with bodies, rods or `Connect`/`Free` points, and a finite-EI line whose End B is not `Fixed`, as a line shared between two turbines) | `none` |
| `layAzimuth`, `layAzimuth<ID>` | lay azimuth (deg, from +x toward +y) of every line, or of line `ID` | chord direction, from the lower end |
| `asLaidTension`, `asLaidTension<ID>` | as-laid effective tension (N, ≥ 0) of every line, or of line `ID` | 0 |
| `dtM` | dynamic time step [s] | — |
| `TMax` | dynamic end time [s]; an integer multiple of `dtM` | — |
| `rhoInf` | generalised-α spectral radius | 0.4 |
Expand Down
8 changes: 8 additions & 0 deletions doc/modeling.rst
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,14 @@ fallback) rather than by artificial drag-scaled relaxation. A converged
solver is necessary but not sufficient: reject a result with the wrong touchdown side, impossible
tension gradient, penetrated seabed, broken symmetry, or unresolved curvature peak.

With seabed friction (``frictionMu``) the static solve is frictionless in still water by
default, as in MoorDyn, which is conservative for anchor loads. ``asLaid staticsFriction``
holds the grounded run toward the position in which the line was laid, as OrcaFlex's *as laid*
policy does: then decide how the line was laid (``layAzimuth``, by default along the chord
from its lower end, normally the anchor) and at what tension (``asLaidTension``, by default slack), because the
anchor tension depends on it: a run laid slack and pulled taut is held back by friction. See
:ref:`friction in statics <static-friction>`.

7. Configure dynamics and forcing
----------------------------------

Expand Down
53 changes: 52 additions & 1 deletion doc/options.rst
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,8 @@ Environment and seabed
- finite, ≥ 0, or ``none``. A positive value needs ``WtrDpth`` or ``bathymetryFile``, and
``dtM``/``TMax`` in the standalone driver. Line nodes carry stick-slip friction springs; in
a current the static solve holds the line with friction springs from its still-water laid
shape, and the march continues them. The isotropic shorthand of
shape, and the march continues them (``staticsFriction asLaid`` holds it toward its
as-laid position instead, in still water too). The isotropic shorthand of
``frictionMuAxial``/``frictionMuLateral``. Not supported (the deck is rejected) with a
``FAILURE`` section, on a deck with ``Connect``/``Free`` points or ``Point3`` buoys, or
on a deck whose lines attach to ``Rigid6`` bodies or rods unless it runs on the default
Expand All @@ -126,6 +127,56 @@ Environment and seabed
``frictionMuNormal``, ``frictionMu_normal`` for the lateral one. See :doc:`theory`
- both, within the limits of ``frictionMu``
- ``0.2 frictionMuAxial``
* - ``staticsFriction`` / ``statics_friction`` / ``staticsSeabedFrictionPolicy`` /
``seabedFrictionPolicy``
- word
- ``none``
- ``none`` or ``asLaid`` (also ``as_laid``, ``as-laid``), case-insensitive; OrcaFlex's
statics seabed friction policy. ``none``: the static solve is frictionless in still water
and the friction anchors of the march start at the static node positions; in a deck
current friction springs from the still-water equilibrium hold the line, and the anchors
continue their static forces. ``asLaid``: the
static solve resists the horizontal displacement of every grounded node from its as-laid
position (the line laid from its lower end, the anchor or the fairlead when that is lower,
along ``layAzimuth`` on the seabed at ``asLaidTension``, its top end then moved to its
position; on a mesh the finite-EI statics refines, laid on the refined mesh) with the
regularised Coulomb
law of the dynamics, capped at ``mu N``, in still water and in a current, so a run on a
slope with ``tan(slope) < mu`` holds and surplus length rests where it was laid; the
march continues the springs. ``none`` is the default, as in MoorDyn: a run laid slack
and pulled taut is held back by its friction, so the as-laid statics lowers anchor
tensions (by up to ``mu w`` times the grounded length), and the frictionless statics is
the conservative choice for anchor loads unless the as-laid layout and tension are
known. Used only with ``frictionMu > 0`` and a seabed; rejected where the static
equilibrium solves the lines without seabed friction: on decks with bodies, rods or
``Connect``/``Free`` points (``frictionMu`` itself is accepted on the default monolithic
body and rod march), and on the finite-EI two-moving-end route (a line whose End B is
not ``Fixed``, as a line shared between two turbines). See
:ref:`friction in statics <static-friction>`
- both
- ``asLaid staticsFriction``
* - ``layAzimuth`` / ``lay_azimuth``, and ``layAzimuth<ID>``
- real, deg
- absent: each line's chord direction, from its lower end (anchor → fairlead, or
fairlead → anchor when the fairlead is lower)
- finite. Horizontal direction, from global +x toward +y, in which the line was laid away
from its lower end (the anchor, or the fairlead when that is lower): the as-laid
reference of ``staticsFriction asLaid``.
``layAzimuth`` sets every line; ``layAzimuth<ID>`` (the line ID appended, e.g.
``layAzimuth2``) sets line ``ID`` and overrides it. A direction off the vertical plane of
the line ends puts the finite-EI static solve in 3D, as does a bathymetry sloping across
that plane under the laid run. An ID that names no line is rejected
- both
- ``225.0 layAzimuth2``
* - ``asLaidTension`` / ``as_laid_tension``, and ``asLaidTension<ID>``
- real, N
- ``0``
- finite, ≥ 0. Effective tension with which the line was laid: the as-laid node spacing is
the unstretched one times ``1 + asLaidTension/EA``, so a run on a level seabed whose
static tension equals it carries no friction force. ``asLaidTension<ID>`` sets line ``ID`` alone, as for
``layAzimuth<ID>``
- both
- ``2.0e5 asLaidTension1``

Clock and initial condition
---------------------------
Expand Down
Loading
Loading