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
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,13 @@ All notable changes to CableDyn are recorded in this file. The format follows
chain 0.6 % and the polyester 2.9 times too stiff). Free/Connect points, a `Rigid` cable end
connection, VIV lines, bodies, rods, buoys, torsion and `CONTROL` fail closed with named
messages. This replaces the quasi-static linearisation without states.
- Composite Syrope lines: a Syrope polyester section between plain `EI = 0` sections, such as a
chain-polyester-chain mooring, in one LINE. The static start puts every Syrope element on the
rest curve of its load history with its own secant EA (the tension varies along a sagging
section), so the dynamics start in the static equilibrium; the chains keep their `BA` damping,
and `SYROPE IC` applies to every Syrope section of the line. On a 400 m polyester section
between chains every element starts on its OWC to 2e-11, and a still run keeps the fairlead
tension. Example `composite_chain_syrope_chain.dat`, on a moving vessel.
- 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
Expand Down
8 changes: 7 additions & 1 deletion CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2076,6 +2076,11 @@ 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_syrope_composite tests/test_syrope_composite.f90)
target_link_libraries(test_syrope_composite PRIVATE cabledyn_core)
add_test(NAME syrope_composite COMMAND test_syrope_composite)
set_tests_properties(syrope_composite PROPERTIES LABELS "fortran;driver;integration;static;dynamic")

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 Expand Up @@ -2882,7 +2887,8 @@ foreach(_floor_case IN ITEMS held_start_gomex80_power_cable held_start_humboldt8
set_tests_properties(${_floor_case} PROPERTIES LABELS "fortran;driver;integration;dynamic")
endforeach()
foreach(_dyn_example IN ITEMS dynamic_chain_held dynamic_chain_current dynamic_chain_waves
ve_polyester_dynamic_waves syrope_polyester_mooring clump_weight_free_point connect_weighted_point)
ve_polyester_dynamic_waves syrope_polyester_mooring composite_chain_syrope_chain clump_weight_free_point
connect_weighted_point)
add_test(NAME example_${_dyn_example}
COMMAND cabledyn "${CMAKE_CURRENT_SOURCE_DIR}/examples/${_dyn_example}.dat"
"${CMAKE_CURRENT_BINARY_DIR}/example_${_dyn_example}")
Expand Down
2 changes: 1 addition & 1 deletion VALIDATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -812,7 +812,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. 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 |
| 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 lines (a 400 m Syrope polyester section between chains, `syrope_composite`): every polyester element starts on its OWC to 2e-11 across its 1.005–1.012 MN tension range, a still run keeps the fairlead tension to the printed digits (one secant per section moved it by 1.4e-5 within 2 s), the chains keep their `BA` damping, a `SYROPE IC` history puts the section on the `Tmax0` working curve, a line split into two Syrope sections reaches the single section's tensions to 1e-8, and a tension above the OWC table stops with a named error. 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
7 changes: 4 additions & 3 deletions doc/capabilities.rst
Original file line number Diff line number Diff line change
Expand Up @@ -77,9 +77,10 @@ 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, 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
- dynamic line with OWC and two history states, single-section and taut or between
linear-elastic ``EI = 0`` sections (chain–polyester–chain), with the seabed, Morison loads,
current, waves, host fluid fields and VIV of any ``EI = 0`` line; 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
18 changes: 13 additions & 5 deletions doc/driver_format.md
Original file line number Diff line number Diff line change
Expand Up @@ -286,9 +286,16 @@ and `BA = BA_s|BA_d`:
or `EXP`), `k1`, and `k2` rows as `value name`. `OWC` names the original-working-curve table,
resolved relative to the settings file: a `strain tension` table of at least two numeric rows.
- `BA_d` enters the slow-state rate; the physical damping contribution is `BA_s*d(eps_slow)/dt`.
- A Syrope type requires `EI = 0`. A Syrope line must be a single section, taut at
initialisation, and run on a dynamic deck (`dtM`/`TMax`). It does not support `bathymetryFile`,
deck current or waves, or host-driven fluid loads. A flat `WtrDpth` seabed is accepted.
- A Syrope type requires `EI = 0`. A Syrope line is either a single section, taut at
initialisation, or a composite line whose other sections are linear-elastic `EI = 0` sections (a
chain–polyester–chain mooring), with every Syrope element in tension at initialisation. It runs
on a dynamic deck (`dtM`/`TMax`) and takes the seabed, `bathymetryFile`, Morison loads, current,
waves, host fluid fields and VIV of any `EI = 0` line.
- The static start solves each Syrope element on the rest curve of its load history (the OWC, or
the `Tmax0` working curve under `SYROPE IC`). A single-section line takes one secant EA from the
curve at its mean strain; on a composite line, where the tension varies along a sagging Syrope
section, every Syrope element takes its own secant at its own tension, so every element starts
on its curve and the dynamics start in the static equilibrium.

The settings-file grammar is in [Auxiliary file formats](file_formats.rst).

Expand Down Expand Up @@ -718,8 +725,9 @@ Line(s) Tmax0 Tmean0

The last two tokens are `Tmax0 Tmean0`; the tokens before them form the line list. Line ids are
comma-separated (`1,2` or `1, 2`); ids separated only by spaces are rejected. Values must satisfy
`Tmax0 >= Tmean0 >= 0` and `Tmax0 > 0`, and be finite. Every referenced line must be a
single-section Syrope line, named in only one row.
`Tmax0 >= Tmean0 >= 0` and `Tmax0 > 0`, and be finite. Every referenced line must have a
Syrope section, and be named in only one row. On a composite line the history applies to every
Syrope section.

`Tmax0` is the rope's running maximum tension. The static initial condition is solved on its
rest curve, the working curve regenerated at `Tmax0` (the OWC beyond that curve's top strain).
Expand Down
5 changes: 5 additions & 0 deletions doc/examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -158,6 +158,11 @@ for the equations, the viscoelastic (series-Kelvin) and Syrope sections of :doc:
``data/syrope/syrope_settings.dat`` and ``data/syrope/syrope_owc.dat``
- cable, dynamic
- < 1 s
* - ``composite_chain_syrope_chain.dat``
- chain–Syrope polyester–chain mooring on a vessel in a 12 s surge, heave and pitch record;
needs ``data/syrope/`` and ``data/vessel/vessel_surge_heave_pitch_12s_dt005.txt``
- cable, dynamic
- < 1 s

Dynamic environment
-------------------
Expand Down
2 changes: 1 addition & 1 deletion doc/modeling.rst
Original file line number Diff line number Diff line change
Expand Up @@ -308,7 +308,7 @@ Use-case map
- ``ve_polyester_dynamic_waves.dat``
- slow/dynamic state, relaxation time, cyclic tension
* - Syrope polyester
- ``syrope_polyester_mooring.dat``
- ``syrope_polyester_mooring.dat`` / ``composite_chain_syrope_chain.dat``
- OWC/settings files, initial history, supported-combination limits
* - Current/wave-loaded mooring
- ``dynamic_chain_current.dat`` / ``dynamic_chain_waves.dat``
Expand Down
4 changes: 3 additions & 1 deletion doc/tutorial_ropes.rst
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,9 @@ The static initial condition is solved on the ``Tmax0`` working curve, and the l
that equilibrium: ``FairTen1`` is 972.8 kN at t = 0 and stays there over the 2 s run (the fairlead
is held). With both ends fixed, the geometry and ``Tmax0`` set the mean tension, so ``Tmean0``
does not enter the state. The driver prints a note because this deck's 1.5 MN differs from the
972.8 kN equilibrium. Syrope lines are single-section and run dynamically (``dtM``/``TMax``).
972.8 kN equilibrium. Syrope lines run dynamically (``dtM``/``TMax``). A Syrope section can also
sit between chains: ``composite_chain_syrope_chain.dat`` is a chain–polyester–chain mooring on a
moving vessel, every polyester element starting on its working curve.

.. important::

Expand Down
4 changes: 2 additions & 2 deletions examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,9 @@ Copy a deck under a new name and keep every file it references at the same relat
| --- | --- |
| `*.dat` | Standalone decks. `iea15mw_umaine_openfast_cabledyn.dat` is an OpenFAST-only `MooringFile`; `iea15mw_umaine_mixed_cabledyn.dat` runs both standalone and coupled. |
| `openfast/` | IEA-15MW VolturnUS-S `.fst` pair (`CompMooring = 5` and `3`) with their mooring decks; see [openfast/README.md](openfast/README.md). |
| `data/syrope/` | Syrope settings and original working-curve table used by `syrope_polyester_mooring.dat`. |
| `data/syrope/` | Syrope settings and original working-curve table used by `syrope_polyester_mooring.dat` and `composite_chain_syrope_chain.dat`. |
| `data/lozon/` | Prescribed hang-off heave history for `lozon_gomex80_power_cable_motion.dat` and the script that generates it. |
| `data/vessel/` | 6-DOF vessel-motion record for `lazy_wave_vessel_motion.dat`, the script that generates it, and the illustrative RAO table for `lazy_wave_vessel_rao.dat` and `lazy_wave_bend_stiffener.dat`. |
| `data/vessel/` | 6-DOF vessel-motion record for `lazy_wave_vessel_motion.dat` and `composite_chain_syrope_chain.dat`, the script that generates it, and the illustrative RAO table for `lazy_wave_vessel_rao.dat` and `lazy_wave_bend_stiffener.dat`. |
| `data/torsion/` | Hang-off roll history (motionFile roll column) for `torsion_lazy_wave_hangoff_twist.dat` and the script that generates it. |
| `data/range_tdp/` | Fairlead surge history for `chain_range_tdp.dat` and the script that generates it. |
| `moordynC_wavekin/` | A deck with the MoorDyn-C `wave_frequencies.txt` and `current_profile.txt` files it reads from its own folder. |
Expand Down
7 changes: 4 additions & 3 deletions examples/SYNTHETIC_ROPES.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,9 +54,10 @@ rope 0.1438 22.42 "SYROPE:data/syrope/syrope_settings.dat|1.53e8|23.12"
initialisation with the offending tension and the next admissible `Tmax`. `EXP` requires
`k2 > 0`.
- Viscoelastic and Syrope line types require `EI = 0`; a finite-EI type is rejected.
- A Syrope line must be a single section and taut at initialisation, and the deck must set
`dtM` and `TMax` (there is no static-only output). Current, waves, bathymetry and host-driven
hydrodynamic loads on a Syrope line are rejected with an error naming the feature.
- A Syrope line is a single section, taut at initialisation, or a composite line whose other
sections are linear-elastic `EI = 0` sections (`composite_chain_syrope_chain.dat`), and the deck
must set `dtM` and `TMax` (there is no static-only output). It takes the seabed, bathymetry,
Morison loads, current, waves, host fluid fields and VIV of any `EI = 0` line.

## Run the Syrope example

Expand Down
Loading
Loading