Amplitude-aware ship stability reporting — linear K(m) correction with method and quality warnings
K(m) — complete elliptic integral of the first kind from classical Bernoulli/Euler mechanics. Exact for GZ = GM·sin(φ). Use validated wall-sided correction or vessel GZ tables when richer hull data are available.
Or use k-factor: C = 2πk/√g (k typically 0.33–0.42)
GM recovered from observed roll period:
| Parameter | Value |
|---|---|
| Tobs | — |
| φmax | — |
| Elliptic modulus m | — |
| K(m) | — |
| T₀ (small-angle) | — |
| T₀ (RT4 corrected) | — |
| SA bias (under-estimate) | — |
| φmax (deg) | m = sin²(φ/2) | K(m) | T / T₀ | Correction factor | SA bias (%) |
|---|
Linear GZ (GZ = GM·sinφ):
Formula is exact to 211 ppm vs numerical ODE.
GM recovery mean error < 1 µm across 120 S4-validated test cases
(vs 20.7 mm for the uncorrected small-angle method — a 20-billion-fold improvement).
Wall-sided hull (GZ = sinφ·(GM + BM/2·tan²φ)):
The standalone K(m) formula is approximate for wall-sided curves. The Python package includes a validated
wall-sided correction envelope for φ ≤ 30° and BM/GM ≤ 4. For arbitrary hull forms, use vessel
GZ tables or direct numerical integration.
Publication status: open technical reference implementation; not class-approved software,
not a loading computer, and not a substitute for professional stability review.