diff --git a/doc/driver_format.md b/doc/driver_format.md index 8b2cb0f..b22b1fb 100644 --- a/doc/driver_format.md +++ b/doc/driver_format.md @@ -1413,6 +1413,11 @@ Behaviour: same row (within 0.25 % without the row), with or without a VIV AMPLITUDE table and VIV DAMPING. On a held cable in a current `Tf` changes A/D by 0.03 % (wake oscillator) and at most 0.24 % (synchronisation model). +- The two conditions hold together only for a motion much slower than the VIV. Keeping about + 95 % of the VIV velocity (`omega Tf >= 3`) while leaving at most 10 % of the motion's velocity + in the relative velocity (`omega_m Tf <= 0.1`) needs a motion period at least 30 VIV periods + long. For a motion only a few VIV periods long (a floater heave close to the VIV frequency) no + `Tf` separates the two, and the response depends on `Tf`: report its sensitivity to `Tf`. - The filtered velocity is part of the step-recovery, snapshot and checkpoint state. A row with `Tf = 0` leaves the run exactly as without it. It acts on `EI = 0` lines and finite-EI cables, standalone and coupled. A row fails if it is not `TypeName Tf`, names an undefined or already @@ -1450,7 +1455,8 @@ Behaviour: row the axes and the blend take the ambient flow relative to the cable's filtered motion. - **`0 0 1` amplifies the in-line drag alone.** With an amplitude table's `CdAmp` (for example Chaplin et al. 2005, Eq. 4), the mean in-line drag of a vibrating cable rises while its - cross-flow drag stays Morison's. A `CdAmp` without this row multiplies the whole normal drag, + cross-flow drag stays Morison's. The factor multiplies the whole in-line drag term, so the + in-line damping rises with it. A `CdAmp` without this row multiplies the whole normal drag, the cross-flow damping included. - **`0.31 0.89` is the published cross-flow-only model** of Thorsen et al. (2016), fitted to still-water decay tests for `y0/D` up to about 0.6. It removes the linear part of Morison's diff --git a/doc/theory.rst b/doc/theory.rst index e0a540c..0f8b391 100644 --- a/doc/theory.rst +++ b/doc/theory.rst @@ -1576,8 +1576,10 @@ relative to the cable's filtered motion (:ref:`theory-viv-frame`). The row serves two uses: - With :math:`(0, 0, 1)` and the drag factor of :ref:`Chaplin et al. (2005) `, - the amplification acts on the mean in-line drag alone, as measured, while the cross-flow drag - stays Morison's (validation case L3-D, the Delta Flume riser in a stepped current). + the amplification acts on the in-line drag alone, while the cross-flow drag stays Morison's + (validation case L3-D, the Delta Flume riser in a stepped current). The factor is measured on + the mean drag, but it multiplies the whole in-line term, so the in-line damping + :math:`-\tfrac12\rho D C_{dn}A_d|\mathbf w|\,\dot x` rises with it. - :math:`(0.31, 0.89, 0)` is Thorsen's cross-flow model. It drops the linear part :math:`\tfrac12\rho D C_{dn}U\dot y` of Morison's cross-flow damping, so it is consistent with cross-flow VIV alone. An in-line force that turns with the relative flow can then drive an @@ -1631,7 +1633,13 @@ The velocity relative to :math:`\bar{\mathbf v}` loses the part of the VIV veloc at :math:`\omega` it is scaled by :math:`\omega T_f/\sqrt{1 + \omega^2 T_f^2}` and led by :math:`\arctan(1/\omega T_f)` (0.9985 and 3.1° at 0.29 Hz with :math:`T_f` 10 s). For a motion at :math:`\omega_m` the filter lags by :math:`\arctan\omega_m T_f`. :math:`T_f` is therefore taken -several VIV periods long and short against the motion. +several VIV periods long and short against the motion. The two conditions hold together only for +a motion much slower than the VIV: keeping about 95 % of the VIV velocity +(:math:`\omega T_f \ge 3`) while leaving at most 10 % of the motion's velocity in the relative +velocity (:math:`|1 - H(\omega_m)| = \omega_m T_f/\sqrt{1 + \omega_m^2 T_f^2} \le 0.1` with the +filter's :math:`H(\omega) = 1/(1 + i\omega T_f)`, so :math:`\omega_m T_f \le 0.1`) needs :math:`\omega/\omega_m \ge 30`, a motion period at least 30 +VIV periods long. For a motion only a few VIV periods long no :math:`T_f` separates the two, and +the response depends on :math:`T_f`. A pipe of the displaced mass (20 m, :math:`D` 0.1 m, ``Cl`` 0.8) moved in still water with velocity amplitude 0.6 m/s and period 40 s, against the same pipe held in the water moving the