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
6 changes: 6 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,12 @@ All notable changes to CableDyn are recorded in this file. The format follows
line rolled at 60 deg/s the coupled torque is the quasi-static `GJ phi / L` to 3e-6 N m, and
`SaveState`/`RestoreState` carry the rotations. Python: `CableDyn.init_deck_rotating`,
`update_rotations`, `coupled_moments`.
- `ATTACHMENTS` on a finite-EI line restrained in torsion: the torsion stage of the static start
runs on the discrete equilibrium, after the attachment polish, with the modules' net weights
and current drag (to a fixed point) as nodal loads. A lazy wave with 25 buoyancy modules and
one turn of pretwist, in still water and in a cross-flow current, keeps its torque, twist and
fairlead tension over a still 10 s run to the output precision (a torsion stage before the
polish would ring by 3e-3 of the torque); neutral modules reproduce the bare line's GJ Phi / L.
- 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 Down
7 changes: 7 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2095,6 +2095,13 @@ target_link_libraries(test_torsion_deck PRIVATE cabledyn_core)
add_test(NAME torsion_deck COMMAND test_torsion_deck)
set_tests_properties(torsion_deck PROPERTIES LABELS "fortran;driver;integration;static;dynamic")

add_executable(test_torsion_attachments tests/test_torsion_attachments.f90)
target_link_libraries(test_torsion_attachments PRIVATE cabledyn_core)
add_test(NAME torsion_attachments
COMMAND test_torsion_attachments ${CMAKE_CURRENT_SOURCE_DIR}/tests/data/lazy_wave_torsion_attachments.dat
WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
set_tests_properties(torsion_attachments PROPERTIES LABELS "fortran;driver;integration;static;dynamic")

add_executable(test_section_curvature tests/test_section_curvature.f90)
target_link_libraries(test_section_curvature PRIVATE cabledyn_core)
add_test(NAME section_curvature COMMAND test_section_curvature)
Expand Down
5 changes: 3 additions & 2 deletions doc/capabilities.rst
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ Line and constitutive capability
range graphs. Stopped by name: the standalone mixed ``EI = 0`` + finite-EI aggregate and
``CableDyn_InitDeck``/``InitDeckAt`` (which move the line ends by translation only),
OpenFAST linearisation of a line restrained in torsion,
rod ends, bodies other than Rigid6, lines with ``ATTACHMENTS``, modal analysis, and
rod ends, bodies other than Rigid6, modal analysis, and
``False alpha_force_blend``. Not modelled: seabed friction against twist, anisotropic
sections, self-contact of a loop (see :ref:`theory-torsion`)
* - Hockling loops, nonlinear cross-section laws
Expand All @@ -106,7 +106,8 @@ Line and constitutive capability
production route
* - Discrete attachments (``ATTACHMENTS``: buoyancy modules, clumps)
- Supported
- lumped at nodes of a finite-EI cable, standalone and coupled; rejected on the two-moving-end
- lumped at nodes of a finite-EI cable, standalone and coupled, also on a line restrained in
torsion (they add no polar inertia to its twist); rejected on the two-moving-end
compatibility solver
* - Bend stiffeners (``STIFFENERS``)
- Supported with limits
Expand Down
7 changes: 5 additions & 2 deletions doc/driver_format.md
Original file line number Diff line number Diff line change
Expand Up @@ -862,7 +862,7 @@ Scope. A torsionally restrained line needs a finite-EI line with a `Fixed` End B
`GJ` on every section, and, at End A, a `Fixed`, `Coupled`/`Vessel` point or a Rigid6
`Body<N>` point; in a coupled OpenFAST or FAST.Farm run the End A frame turns with the platform
(see the manual's OpenFAST page, Line torsion). Each of the following stops with a named error:
torsion on an `EI = 0` line, on a rod end or on a `Point3` body, a line with `ATTACHMENTS`,
torsion on an `EI = 0` line, on a rod end or on a `Point3` body,
modal analysis (`nModes`), a dynamic or coupled run with `False alpha_force_blend`, any
restrained end (one end included) in a standalone deck mixing `EI = 0` and finite-EI lines
without a body or through the C API's `CableDyn_InitDeck`/`InitDeckAt`, which move the line
Expand Down Expand Up @@ -945,7 +945,10 @@ Behaviour:
- The static equilibrium is solved first with each attachment's net weight spread over the two
elements at its node, then carried to the discrete loads by continuation. The current drag
depends on the node's depth and line direction, so the final solve is repeated until the
node positions change by less than 1e-9 m.
node positions change by less than 1e-9 m. On a line restrained in torsion the torsion stage
(the imposed twist) follows on the discrete equilibrium, with the attachments' net weights
and drag as nodal loads (the drag again to a fixed point), so a run starts in the twisted
equilibrium. An attachment adds no polar inertia to the line's twist.
- A row fails if the line is not finite-EI, the arc lies beyond the line, every one of `Mass`,
`Volume`, `CdA` and `CdAx` is zero, a value is negative or non-finite, or a series has a
non-positive
Expand Down
3 changes: 2 additions & 1 deletion doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -442,7 +442,8 @@ post-buckled states of the validation (see :doc:`validation`) that rate is 0.05
same term enters the dynamic effective tangent, scaled by :math:`1 - \alpha_f` of the force
blend, and is frozen together with a reused factorisation.

**Statics and stability.** The imposed twist is the last static load stage, ramped from the
**Statics and stability.** The imposed twist is the last static load stage (on a line with
``ATTACHMENTS``, after the attachment polish, on the discrete equilibrium), ramped from the
geometric twist of the untwisted equilibrium in steps of at most :math:`\pi/4`. Each converged
stage is tested for stability by the inertia of :math:`\mathbf{K}` on the free DOFs,
:math:`\operatorname{neg}(\mathbf{K}) = \operatorname{neg}(\mathbf{B}) -
Expand Down
5 changes: 2 additions & 3 deletions doc/troubleshooting.rst
Original file line number Diff line number Diff line change
Expand Up @@ -393,10 +393,9 @@ Torsion
with Fixed End B``
- torsion is solved on cubic-Hermite lines whose End B is an anchor.
* - ``a torsional END CONNECTION on a rod end is not supported`` / ``on a body needs a Rigid6
body`` / ``torsion is not combined with ATTACHMENTS in this build``
body``
- outside the torsion scope (:doc:`capabilities`). Move End A to a ``Fixed``,
``Coupled``/``Vessel`` point or a Rigid6 body, or represent the modules as a smeared
buoyancy section.
``Coupled``/``Vessel`` point or a Rigid6 body.
* - ``a line restrained in torsion needs a host that turns its fairlead frame``
- the standalone deck that mixes ``EI = 0`` and finite-EI lines without a body, and the C
API's ``CableDyn_InitDeck``/``InitDeckAt``, move the line ends by translation only. Run the
Expand Down
6 changes: 0 additions & 6 deletions python/cabledyn/deck_file.py
Original file line number Diff line number Diff line change
Expand Up @@ -4225,7 +4225,6 @@ def _check_torsion_lines(
and FAST.Farm routes turn the fairlead frame with the platform and accept it.
"""
# _check_attachments has already accepted every LineID as an integer
attachment_lines = {str(_native_int(row.tokens[0])) for row in self._rows("ATTACHMENTS")}
torsion_lines: set[str] = set()
has_torsion_column = False
for line_id, ends in torsion_ends.items():
Expand Down Expand Up @@ -4259,11 +4258,6 @@ def _check_torsion_lines(
f'its LINE TYPES row "{name}" must give an explicit GJ > 0 (the 14-column '
"row; torsion has no EI/1.3 default)"
)
if line_id in attachment_lines:
raise DeckFormatError(
f"{self._label}: line {line_id}: torsion is not combined with ATTACHMENTS "
"in this build"
)
if _rod_point(point_types[end_a]) is not None:
raise DeckFormatError(
f"{self._label}: line {line_id}: a torsional END CONNECTION on a rod end is "
Expand Down
2 changes: 1 addition & 1 deletion python/tests/test_deck_native_parity.py
Original file line number Diff line number Diff line change
Expand Up @@ -1057,7 +1057,7 @@ def test_torsion_scope_rules_follow_the_native_checks():
f"1 50.0 10.0 0.0 0.0 0.0\n{_BAR} OPTIONS {_BAR}",
),
)
_rejects(attachments, "torsion is not combined with ATTACHMENTS")
DeckFile.from_text(attachments) # a torsional line with ATTACHMENTS is accepted
# restrained at both ends, End B must be Fixed
_rejects(
_torsion_two_moving("1 A Pinned 1 0 0 Rigid 0 0 1 0\n"),
Expand Down
Loading
Loading