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
18 changes: 10 additions & 8 deletions ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -322,14 +322,16 @@ analytic Jacobians.
about its static equilibrium, `K φ = ω² M φ`, over the free DOFs, with `K` the
static tangent (element stiffness and linearised seabed contact) and `M` the
consistent mass plus Morison added mass. `K` and `M` are assembled in symmetric
band storage; LAPACK `DSBGVX` gives the eigenvalues and inverse iteration on the
banded pencil gives each mode shape, so the cost grows with line length rather
than with its square. Dense `DSYGV` is kept as the test reference. Both line paths
are supported (`nModes`). A finite-EI line's modes (`CD_Modal_Hermite_Line`) take
its end connections and attachments from the dynamic model, and a line restrained
in torsion adds the twist angle of every node: its lumped polar inertia and the
second variation of the nodal-twist energy (`CD_HermiteCable_Dyn_Twist_Hessian`)
in a band of 7 DOFs per node.
band storage. A shift-invert block Lanczos iteration on the banded Cholesky factor
of `K` gives the eigenvalues, certified by a Sturm count of `K - σM` (LAPACK
`DSBGVX` takes short lines, an indefinite or singular `K`, and an uncertified run),
and inverse iteration on the banded pencil gives each mode shape, so the cost
grows with line length rather than with its square. Dense `DSYGV` is kept as the
test reference. Both line paths are supported (`nModes`). A finite-EI line's
modes (`CD_Modal_Hermite_Line`) take its end connections and attachments from the
dynamic model, and a line restrained in torsion adds the twist angle of every
node: its lumped polar inertia and the second variation of the nodal-twist energy
(`CD_HermiteCable_Dyn_Twist_Hessian`) in a band of 7 DOFs per node.

### Outputs

Expand Down
2 changes: 1 addition & 1 deletion doc/examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -360,7 +360,7 @@ touchdown and lazy-wave shape from the geometry alone; there is no initial-shape
- the 10 lowest natural periods and mode shapes (``nModes``) of the 80 m cable on its
1024-element mesh — :doc:`tutorial_lazywave`
- Hermite, modal
- ~2 s
- ~1 s
* - ``torsion_lazy_wave_hangoff_twist.dat``
- the 80 m cable with an illustrative ``GJ`` of 50 kN·m², clamped and restrained in torsion
at both ends, twisted two turns at the hang-off over 60 s by the ``motionFile`` roll column
Expand Down
4 changes: 2 additions & 2 deletions doc/options.rst
Original file line number Diff line number Diff line change
Expand Up @@ -622,8 +622,8 @@ Ambient fluid and prescribed motion
lines stops with ``OPTION nModes is not supported for mixed EI=0/finite-EI decks;
remove it or set it to 0``. A line restrained in torsion adds the twist angle of every
node to its modes (``PolarShare`` and ``dTwist`` in :doc:`outputs`). The banded solver has
no line-length limit: a
1024-element finite-EI cable takes a few seconds. See :doc:`theory`
no line-length limit: the 10 modes of a 1024-element finite-EI cable take a fraction of a
second. See :doc:`theory`
- standalone
- ``10 nModes``
* - ``WaveSeed`` / ``wave_seed``
Expand Down
4 changes: 3 additions & 1 deletion doc/outputs.rst
Original file line number Diff line number Diff line change
Expand Up @@ -462,7 +462,9 @@ row:
* ``# Mode shapes``: ``LineID Mode Node X Y Z dX dY dZ``, one row per mode and node.
``X Y Z`` is the static node position and ``dX dY dZ`` the nodal translation of the mode,
scaled so that the largest nodal displacement of the mode is 1. Nodes are numbered End A first,
as in the other line files; the held end nodes have zero displacement.
as in the other line files; the held end nodes have zero displacement. The sign of a mode
makes the largest component of its mode vector positive; where two components are equally
large (the mirrored nodes of a symmetric line), the first of them in the solver's node order.

When a line is restrained in torsion (both ends, see :doc:`driver_format`), its modes carry the
twist angle of every node (:ref:`nodal twist <theory-nodal-twist>`) and both tables gain a
Expand Down
32 changes: 25 additions & 7 deletions doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1979,13 +1979,31 @@ element, the Hessian of its strain energy. The linearised seabed normal contact
stiffness on the contacting nodes. :math:`\mathbf M` is the consistent structural mass plus the
Morison added mass at the static shape. Friction, damping, and drag are left out, as in any
undamped modal analysis. :math:`\mathbf K` and :math:`\mathbf M` are banded (the nodes are
numbered along the line), and only the ``nModes`` lowest modes are computed: LAPACK ``dsbgvx``
gives the eigenvalues, inverse iteration with the banded factors of
:math:`\mathbf K - \omega^2\mathbf M` gives each shape (M-orthogonal to the shapes before
it, so a repeated frequency gets independent shapes), and the returned :math:`\omega^2` is the
Rayleigh quotient of the shape, summed in quadruple precision. That quotient keeps the lowest
frequencies of a long, axially stiff line accurate, where the band reduction alone loses
digits. Memory grows linearly with the line length. The frequencies
numbered along the line), and only the ``nModes`` lowest modes are computed. Their eigenvalues
come from a block Lanczos iteration on the shift-inverted operator
:math:`\mathbf K^{-1}\mathbf M`, applied with the banded Cholesky factor of :math:`\mathbf K`,
in the :math:`\mathbf M` inner product with full reorthogonalisation. The block holds two
vectors, so both planes of a straight line, whose transverse frequencies coincide, are found.
A Ritz value is accepted when the residual of the shift-inverted eigenproblem is below
:math:`10^{-10}` of its eigenvalue. The count is then certified: the Cholesky factor shows that
no eigenvalue lies at or below zero, and the inertia of :math:`\mathbf K - \sigma\mathbf M`
(the negative pivots of its banded :math:`\mathbf L\mathbf D\mathbf L^{\mathsf T}`
factorisation, by Sylvester's law of inertia) at a shift :math:`\sigma` in a gap above the
wanted eigenvalues must equal the number of Ritz values below :math:`\sigma`, so no frequency
is missed or counted twice. The iteration's time grows linearly with the line length. Short
lines, many modes of a short line, an indefinite or singular :math:`\mathbf K` (a compressed
or slack line), and an iteration that does not converge or is not certified within its basis
bound take LAPACK ``dsbgvx`` instead (band reduction and bisection), whose time grows with the
square of the line length. Inverse iteration with the banded factors of
:math:`\mathbf K - \omega^2\mathbf M` then gives each shape (M-orthogonal to the shapes
before it, so a repeated frequency gets independent shapes), and the returned
:math:`\omega^2` is the Rayleigh quotient of the shape, summed in quadruple precision. That
quotient keeps the lowest frequencies of a long, axially stiff line accurate, where the band
reduction alone loses digits. A shape the Lanczos eigenvalues do not give is solved again on
the eigenvalues of the band reduction. Each shape is signed so that its largest component is
positive; where two components are equally large to round-off (the mirrored nodes of a
symmetric line), the first of them in the solver's node order is. Memory grows linearly with the line
length. The frequencies
:math:`f = \omega/2\pi` and the nodal translations of each mode (scaled to a unit largest
nodal displacement) are written to ``<root>.modes.out``. For a taut string of tension
:math:`T` the transverse frequencies are :math:`f_n = (n/2L)\sqrt{T/m}`; for a shallow sagging
Expand Down
2 changes: 1 addition & 1 deletion doc/tutorial_lazywave.rst
Original file line number Diff line number Diff line change
Expand Up @@ -184,7 +184,7 @@ vertical), 19.9 s (out of plane, along the grounded run) and 16.9 s (in plane).
2048 elements the out-of-plane periods and the 20.4 s mode agree to four digits. The in-plane
modes that move the touchdown (39.9 s, 16.9 s and 11.7 s) shift by up to 0.5 %, because the
linearised seabed contact at the touchdown changes with the node spacing. The run takes about
2 s, most of it in the modal solve.
a second, a quarter of it in the modal solve.

Exercises
---------
Expand Down
Loading
Loading