Skip to content

docs: in-line drag amplification includes the in-line damping; VIV FRAME scale separation - #174

Merged
SMI-Lab-Inha merged 1 commit into
devfrom
docs/viv-frame-separation
Nov 16, 2026
Merged

SMI-Lab-Inha merged 1 commit into
devfrom
docs/viv-frame-separation

Conversation

@SMI-Lab-Inha

Copy link
Copy Markdown
Owner

Summary

Two documentation fixes. No code changes.

1. The CdAmp drag factor also amplifies the in-line damping

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

$$ \mathbf f_n = \tfrac12\rho D\left[C_{dn}A_d,|\mathbf w|,w_x,\mathbf e_x + \dots\right], $$

on the whole in-line component. Because $w_x$ contains the in-line velocity of the cable, the in-line damping rises with the factor too. With Chaplin et al. (2005, Eq. 4) that is a factor of 2.3–2.8 at A/D 0.6–0.8.

This is the usual drag-factor form, so the code is unchanged. theory.rst and driver_format.md now say what it does.

2. VIV FRAME: when a filter time exists

The VIV FRAME pages said to take Tf "several VIV periods long and short against the motion". They now give the bound for the first-order filter $H(\omega) = 1/(1 + i\omega T_f)$. Two conditions apply:

  • keep about 95 % of the VIV velocity: $\omega T_f \ge 3$;
  • leave at most 10 % of the motion's velocity in the relative velocity: $|1 - H(\omega_m)| \le 0.1$, so $\omega_m T_f \le 0.1$.

Together they need $\omega/\omega_m \ge 30$, 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.

Checks

  • Sphinx build in CI.

…AME 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 <jaehoon.seo@inha.ac.kr>
@SMI-Lab-Inha

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 16, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-16T15:33:50.570867Z b1378d3 Manual request
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@read-the-docs-community

Copy link
Copy Markdown

Documentation build overview

📚 CableDyn | 🛠️ Build #35931135 | 📁 Comparing b1378d3 against latest (789cb6d)

  🔍 Preview build  

15 files changed · ± 15 modified

± Modified

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Bravo.

Reviewed commit: b1378d3dd0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@SMI-Lab-Inha
SMI-Lab-Inha merged commit 41df15d into dev Nov 16, 2026
16 checks passed
@SMI-Lab-Inha
SMI-Lab-Inha deleted the docs/viv-frame-separation branch November 16, 2026 23:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant