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

### Added

- Section-frame curvature channels `CurvX<L>N<J>` and `CurvY<L>N<J>` on finite-EI lines: the
curvature vector on the cable's cross-section axes, for the fatigue of an armour wire or
conductor at a fixed point of the section. The axes start at End A from the end connection
(the torsion normal, or the static start's upper normal), turn with a clamped hang-off, are
carried along the line by parallel transport and turn with the twist of a line restrained in
torsion; `CurvX^2 + CurvY^2 = Curv^2`. On a line twisted 90 degrees the carried axes reach
End B within 3e-6 rad of its pretwisted normal. `EI = 0` lines and finite-EI lines with two
moving ends refuse the channels.
- Cross-flow vortex-induced vibration of `EI = 0` lines in the standalone driver: MoorDyn v2's
LINE TYPES columns `Cl` or `Cl dF cF` switch on the synchronisation model of Thorsen et al.,
with the same phase start and running-RMS window (`VIVrmsWindow`, default 500 steps of
Expand Down Expand Up @@ -72,6 +80,19 @@ All notable changes to CableDyn are recorded in this file. The format follows
0.1 s drops from 18,000 components to 1,800. On the 300 s lazy-wave case both records then run
in 72 s, and every output channel's standard deviation moves by at most 0.002 %. A record with
no component at or below the cut-off is refused by name.
- Coupled OpenFAST runs start from the equilibrium in SeaState's steady current (`CurrMod 1`),
as standalone decks start in their `current` option, instead of from the still-water shape.
The current is evaluated at SeaState's vertical grid levels for the static solves only; the
dynamics take the SeaState field alone. On the IEA-15 MW mixed example in a 0.5 m/s cross
current, the lazy-wave cable starts 29 m across at its deepest monitored node and moves less
than 0.6 m over the first 30 s, where the still-water start has reached a third of that offset.
`CurrMod 2` and InflowWind currents keep the still-water start, with a note.
- Syrope polyester lines take the seabed, Morison drag and added mass, deck current and waves,
a coupled host's fluid field, a `bathymetryFile` and VIV, as every `EI = 0` line does and as
MoorDyn's do; before, they ran without hydrodynamics and refused current, waves, host fluid
and bathymetry. The static initial condition includes the current's drag. A taut polyester
line whose fairlead sways 2 m in water matches MoorDyn-C's fairlead tension within 11 N on a
45 kN range (1.03 MN mean); without drag and added mass the range is 5 % larger.
- Under a bend stiffener, `BendMom<L>N<J>` (and the `BendMoment` columns of the static profile,
range graphs and element file) report the cable's own moment, the line type's EI times the
curvature; lines without stiffeners are unchanged.
Expand Down
14 changes: 14 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1661,6 +1661,15 @@ if(Python3_Interpreter_FOUND)
PROCESSORS 4
TIMEOUT ${_viv_lockin_timeout}
ENVIRONMENT "${_cabledyn_python_test_environment}")
# Syrope polyester with hydrodynamics against MoorDyn-C (a fairlead swaying in water)
add_test(NAME syrope_hydro
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_syrope_hydro.py
--exe $<TARGET_FILE:cabledyn>
--output ${CMAKE_BINARY_DIR}/syrope_hydro)
set_tests_properties(syrope_hydro PROPERTIES
LABELS "python;integration;dynamic;validation"
TIMEOUT ${_viv_lockin_timeout}
ENVIRONMENT "${_cabledyn_python_test_environment}")
# MoorDyn-C's VIV test case: the catenary riser of Thorsen et al. in a uniform current
add_test(NAME viv_riser
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_viv_riser.py
Expand Down Expand Up @@ -2062,6 +2071,11 @@ 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_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)
set_tests_properties(section_curvature PROPERTIES LABELS "fortran;driver;integration;static")

add_executable(test_coupled_torsion tests/test_coupled_torsion.f90)
target_link_libraries(test_coupled_torsion PRIVATE cabledyn_core)
add_test(NAME coupled_torsion COMMAND test_coupled_torsion WORKING_DIRECTORY ${CMAKE_BINARY_DIR})
Expand Down
2 changes: 1 addition & 1 deletion VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -793,7 +793,7 @@ stop with a named error.
| Coupled pinned rods (`Pinned`, `CoupledPinned`/`VesselPinned`) | Pass verified | `openfast_pinned_rod` on the aggregate: a dry rod (10 m, 500 kg) released at 30° swings with the elliptic-integral compound-pendulum period to 1.6e-4 at `dt = T/100`, End A on the pin to 0 m; a held `CoupledPinned` node reproduces the `Pinned` rod to round-off (1e-12), returns zero moment, and its force equals the analytic pin reaction to 2.0e-13 of `mg`; a pin accelerating at 2 m/s² gives the mean angle `atan(a/g)` to 1e-6 rad and the period of `sqrt(g² + a²)` to 1.6e-4; a harmonic pin motion follows the linear base-excitation solution to 1.5e-3 / 3.7e-4 of the amplitude at `T0/100` / `T0/200` (ratio 4.03); a 0.1 s step sub-cycled 7 times reproduces a run at the sub-step size to 1e-14 rad and 4e-10 N for a drifting pin; a 1 m `Pinned` rod that carries no line (dry and hanging, or buoyant and upright under water) at a 0.6 s step (`omega0 dt` 2.29 / 3.42, beyond the explicit limit 2) sub-cycles it 6 / 9 times from its own swing stiffness `|W d_g - B d_b|`, equals the run at the sub-step size bit for bit, stays within its release angle and keeps the elliptic-integral period to 6.0e-3 / 5.9e-3 (taken whole, the step turns the rod over); a `CoupledPinned` pin crossing the free surface within one step at constant velocity (a 1 kg/m rod lifted from submerged to dry in 0.1 s, `omega dt` 2.13 wet; a 33 kg/m rod lowered from dry to submerged in 0.6 s, 2.29 dry) takes at least 6 sub-steps from its step-start wetting (more from the waterplane near the surface) and ends within 5e-5 / 3e-4 rad of a run at a sixtieth of the step, where the end-of-step wetting alone gives one sub-step and an angle error of 0.20 / 0.69 rad; on a stiff seabed (`kBot` 1e7 N/m³) a `Pinned` rod whose far end rests on the bed (0.1 s step) and a `Free` rod lying on it (0.05 s step) sub-cycle their contact mode (34–36 and 26 sub-steps), stay at rest on the bed over 5 s (angle change 3.8e-3 / 4e-15 rad, the undamped static settlement) and end within 1.9e-6 / 8e-8 of a run at a tenth of the step, where the sub-steps of the lines and swing alone (1 and 4) throw them off the bed (4.2 rad, 0.8 m); an output probe returns `-m (I_c/I_p) a_p` within 1e-10 of `mg` (not `-m a_p`), and its pin force moves by 2e-11 N when the held end acceleration of the attached tethers changes their end load by 8 N; snapshot/restore, probe restore and restart overlay are bit-identical, the restored state's loads before the next step included; a step without the staged rods (the step-start pin carried by the rod) is bit-identical to the staged one; a `Free` or `Coupled` rod with an end without a line is refused by name; with `PtfmInit` the static start leaves 1.4e-8 N·m about the pin. OpenFAST (IEA-15 UMaine, JONSWAP Hs 6 m, 60 s, `dtM = DT = 0.025 s`) with line 1 hung from a 4 m `CoupledPinned` rod at its fairlead: `openfast -restart` at 30 s reproduces every later OpenFAST output row bit for bit (`NumCrctn` 0 and 1), `NumCrctn = 1` equals `NumCrctn = 0` bit for bit, and surge/heave/pitch statistics stay within 0.2 % / 0.4 % / 1.7 % (mean) of the deck with line 1 on a `Coupled` point |
| 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 (its power cable on 248 elements, each at most half the bending length) has 149 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 12 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 149 nodes grounded at the static state stay grounded, joined by one more once the platform has drifted (the touchdown moves 2.5 m toward the platform). The peak curvature is 0.156 1/m at the sag bend, 72 m from the hang-off, and 0.109 1/m at the touchdown. On the former 87-element mesh (10 m elements along the laid section) the peak was 0.160 1/m and the touchdown curvature 0.075 1/m, under-resolved by about 30 %. These curvatures were recorded before the `Curv` channels took the curvature recovered from nodal equilibrium: they are the geometric curvature of the centreline (the larger one-sided trace at a node), which `OutputRecovery element` reproduces. 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 stays at its static 1.23 kN (maximum 1.24 kN): the seabed friction of the 370 m laid section holds the tension changes at the touchdown. On the former mesh it read 1.39 kN (median) with wave-frequency stick-slip peaks up to 4.1 kN lasting under 1 s, which the resolved mesh does not show, and before the anchor-end correction of this release it locked at about 2.75 kN for the whole run. The run takes 27.1 min of wall time (18.8 min on the former mesh) |
| `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 |
| 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. The line takes the seabed, Morison loads, current, waves, host fluid and VIV of any `EI = 0` line: a taut 88.5 m polyester line in water whose fairlead sways 2 m matches MoorDyn-C v2.7.2 within 10.6 N over a 44.8 kN tension range (1.03 MN mean; t = 0 within 0.5 N), and its range grows 4.8 % without drag and added mass (`syrope_hydro`). Composite and finite-EI combinations stop with a named error |
| Cross-flow VIV (LINE TYPES `Cl`) | Pass verified | `EI = 0` lines and finite-EI cables on the aggregate with the host's fluid field: an `EI = 0` riser and a cable (EI 1 N m²) in a 0.15 m/s host current lock in at A/D 0.6645 / 0.6646 and 0.292 Hz (MoorDyn-F 0.662 at 0.293 Hz; standalone 0.665); the phases, running mean squares and averaging time ride in the checkpoint state and the correction rewind: a rebuild from the checkpoint continues bit for bit, one without the VIV reload does not (`viv_coupled`). OpenFAST (IEA-15 UMaine mixed deck, `Cl` 0.8 on the lazy-wave cable, SeaState 0.5 m/s current, 60 s): `openfast -restart` at 30 s reproduces every later CableDyn and OpenFAST output row bit for bit |

**Standalone mixed aggregate.** `CableDyn_driver.exe` partitions and steps the
Expand Down
5 changes: 3 additions & 2 deletions doc/capabilities.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,8 +77,9 @@ Line and constitutive capability
including load-dependent dynamic stiffness; ``EI = 0`` lines
* - Syrope polyester
- Supported with limits
- single-section taut dynamic line with OWC and two history states; composite, hydro,
finite-EI, current, and wave combinations fail closed by name
- single-section taut dynamic line with OWC and two history states, with the seabed,
Morison loads, current, waves, host fluid fields and VIV of any ``EI = 0`` line;
composite and finite-EI combinations fail closed by name
* - Torsion of finite-EI lines
- Supported with limits
- condensed isotropic torsion (uniform torque, quasi-static: no torsional inertia) of a
Expand Down
2 changes: 1 addition & 1 deletion doc/modeling.rst
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ models:
- MoorDyn ``ElasticMod = 3`` behaviour
* - Syrope
- ``SYROPE:settings|alpha|beta`` and ``BA_s|BA_d``
- supported single-section taut dynamic polyester use case
- single-section taut dynamic polyester line, with the hydrodynamics of any ``EI = 0`` line

Use :doc:`examples` for runnable instances and :doc:`theory` for the state equations (the
viscoelastic model is a four-parameter series-Kelvin solid that reduces to a standard linear
Expand Down
14 changes: 12 additions & 2 deletions doc/openfast.rst
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,16 @@ WaterKin file can select file waves, a file depth-dependent current, host waves,
current independently where the field is separable. Unsupported or double-counted combinations
fail during initialisation. The selector matrix is in :doc:`options` and :doc:`driver_format`.

The static start includes the steady SeaState current. With ``CurrMod = 1`` and the host
current in use, CableDyn evaluates that current at the levels of SeaState's vertical wave grid
and solves the equilibrium of every line, cable, point and body in it. A run therefore starts
where a standalone deck with the same ``current`` starts, not from the still-water shape. The
profile is linear in depth between the grid levels, so the start agrees with the first step's
current at the levels and very nearly between them. The dynamics then take the SeaState field
alone, and the current is not counted twice. Waves act from t = 0. A ``CurrMod = 2`` current or
an InflowWind current field is known only through the run's samples: the start is then the
still-water equilibrium, and the console says so.

SeaState grid
~~~~~~~~~~~~~

Expand Down Expand Up @@ -213,8 +223,8 @@ Before trusting a run, confirm in the console:
(``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
equilibrium value above by the kinematic load on the end node. ``<root>.CD.static.out`` holds
solved in the steady current before the waves act, so a line-end tension at t = 0 can differ
slightly from the equilibrium value above by the kinematic load on the end node. ``<root>.CD.static.out`` holds
the equilibrium; and
#. ``OpenFAST terminated normally.``

Expand Down
10 changes: 10 additions & 0 deletions doc/outputs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -690,6 +690,16 @@ Line-node channels
same value; ``CD_HermiteCable_Dyn_Curvature_Exact`` and ``CD_HFMF_Curvature_Exact`` the
exact geometric traces
- 1/m
* - ``CurvX<L>N<J>``, ``CurvY<L>N<J>``
- the curvature vector at node ``J`` on the cross-section axes x and y of a finite-EI line
(:ref:`theory-section-curvature`): the vector points to the centre of curvature, its
length is ``Curv<L>N<J>`` (``CurvX² + CurvY² = Curv²``), and a section point at (x, y)
has the bending strain ``−(CurvX x + CurvY y)``. The axes start at End A from the end
connection, follow the hang-off when End A is clamped, and are carried along the line,
turned by the twist when the line is restrained in torsion. ``EI = 0`` lines and
finite-EI lines with two moving ends refuse the channels. ``CD_HFMF_Section_Curvature``
returns them for every node
- 1/m
* - ``BendMom<L>N<J>``
- bend moment ``EI × κ`` measured relative to the stress-free reference shape (the
cubic-Hermite reference is straight). Finite-EI lines: the component normal to the tangent
Expand Down
Loading
Loading