From b1378d3dd0329e74e1bc802ffe7cf048dbb2db5e Mon Sep 17 00:00:00 2001 From: Jae Hoon Seo Date: Mon, 16 Nov 2026 22:21:23 +0900 Subject: [PATCH] docs: in-line drag amplification includes the in-line damping; VIV FRAME scale separation The theory page said that VIV DAMPING 0 0 1 with a CdAmp drag factor amplifies the mean in-line drag alone. The force is 1/2 rho D Cdn A_d |w| w_x on the whole in-line component, so the in-line damping rises with the factor too (by 2.3-2.8 at A/D 0.6-0.8 with Chaplin et al. 2005, Eq. 4). The code is unchanged; the theory page and the input reference now say so. The VIV FRAME pages said to take Tf several VIV periods long and short against the motion. They now give the bound: 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 no Tf separates the two, and the response depends on Tf. Signed-off-by: Jae Hoon Seo --- doc/driver_format.md | 8 +++++++- doc/theory.rst | 14 +++++++++++--- 2 files changed, 18 insertions(+), 4 deletions(-) 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