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
11 changes: 11 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
Expand Up @@ -1828,6 +1828,17 @@ if(Python3_Interpreter_FOUND)
TIMEOUT 600
ENVIRONMENT "${_cabledyn_python_test_environment}")

# EI = 0 statics: a residual that cycles inside its round-off floor is converged, so a line in
# a current solves the same under every small translation of its deck.
add_test(NAME ei0_static_floor_cycle
COMMAND ${Python3_EXECUTABLE} ${CMAKE_CURRENT_SOURCE_DIR}/tests/test_ei0_static_floor_cycle.py
--exe $<TARGET_FILE:cabledyn>
--output ${CMAKE_BINARY_DIR}/ei0_static_floor_cycle)
set_tests_properties(ei0_static_floor_cycle PROPERTIES
LABELS "python;static;robustness"
TIMEOUT 300
ENVIRONMENT "${_cabledyn_python_test_environment}")

# The note on grounded lines that a current moves over a seabed without friction: once per run
# on every standalone route, and never without a grounded node, a current, or a march, or
# with friction.
Expand Down
3 changes: 2 additions & 1 deletion doc/theory.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1652,7 +1652,8 @@ beyond a :math:`10^{-6}` relative round-off band; a slack element reports zero t
:math:`\lVert\mathbf{R}\rVert_\infty < 10^{-14}`, where :math:`s` is the largest of the
infinity norms of the external load, the seabed reaction, and any current drag; a residual
that stops decreasing inside the round-off floor
:math:`16\,\epsilon\,\max(EA/L_0)\max(\lvert q\rvert, L_0)` of the nodal forces is converged.
:math:`16\,\epsilon\,\max(EA/L_0)\max(\lvert q\rvert, L_0)` of the nodal forces is converged,
whether it stays flat or cycles between values (three iterations without a new minimum).
A line with no admissible equilibrium fails closed, naming the line, the seeds and stages
tried, and the reason.

Expand Down
9 changes: 9 additions & 0 deletions src/CableDyn_Static.f90
Original file line number Diff line number Diff line change
Expand Up @@ -726,6 +726,15 @@ SUBROUTINE CD_Static_Cable_Solve(q0, elem_conn, l0, ea, tension_only, f_ext, fix
RETURN
END IF
END IF
! Inside the round-off floor a residual can also cycle between two or more values (the
! rounding of the last digits alternating), which the flat test above never sees: when
! the last stall_window samples set no new minimum, there is no digit left to gain either
IF (k > cfg%stall_window .AND. hist(k) <= r_floor) THEN
IF (lo >= MINVAL(hist(1:k - cfg%stall_window))) THEN
converged = .TRUE.
RETURN
END IF
END IF
END IF
END DO
! exhausted max_iter without converging or stalling
Expand Down
102 changes: 102 additions & 0 deletions tests/test_ei0_static_floor_cycle.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
#!/usr/bin/env python3
# SPDX-License-Identifier: Apache-2.0
# Copyright (c) 2026 Jae Hoon Seo, SMI Lab, Inha University
"""An EI = 0 static solve whose residual cycles inside its round-off floor is converged.

A suspended three-section line (wire, then two polyester sections, 1151 m, 316 elements) hangs
between a fairlead and an anchor 693 m below it in a 0.67 m/s uniform current. The slack-capable
static stages bring the residual to about 1e-4 N, inside the round-off floor of its nodal forces
(3e-3 N) and above the relative tolerance (2.6e-5 N). Depending on the last digits of the
coordinates the iterates then settle on one value (flat, converged) or alternate between two
(9.49e-5 and 8.77e-5 N), which the flat-stall test never saw: every stage ran out of iterations
and no equilibrium was found. The deck is translated by 32 small offsets, every one of which must
solve and give the same fairlead and anchor tensions to 1e-7.

usage: test_ei0_static_floor_cycle.py --exe <cabledyn> --output <dir>
"""

from __future__ import annotations

import argparse
import os
import subprocess
import sys
from pathlib import Path

DECK = """--------------------- CableDyn Input File ------------------------------------
Suspended three-section line in a uniform current
--------------------- LINE TYPES ---------------------------------------
TypeName Diam Mass EA BA EI Cd_n Cd_t Ca_n Ca_t
(-) (m) (kg/m) (N) (N-s) (N-m2) (-) (-) (-) (-)
t1 0.16489335960471715 135.94910020865282 2447083803.755751 -1.0 0.0 1.2 0.008 1.0 0.0
t2 0.07370991400051977 7.052224668855406 11019101.045086572 -0.8 0.0 2.0 0.4 1.1 0.15
t3 0.10037023217840212 13.076279295895747 20431686.399837103 -0.8 0.0 2.0 0.4 1.1 0.15
--------------------- POINTS -------------------------------------------
ID Type X Y Z
(-) (-) (m) (m) (m)
1 Coupled {xa!r} {ya!r} -67.45321271085669
2 Fixed {xb!r} {yb!r} -761.0028936967904
--------------------- LINES --------------------------------------------
ID NodeA NodeB Outputs
(-) (-) (-) (-)
1 1 2 -
--------------------- SECTIONS -----------------------------------------
LineID LineType Length NumSegs
(-) (-) (m) (-)
1 t1 296.3708154484327 127
1 t2 120.1220550938935 55
1 t3 734.2263766070876 134
--------------------- OPTIONS ------------------------------------------
uniform -0.6393706682921939 -0.20430951085352095 0.0 current
0.01 dtM
0.0 TMax
--------------------- OUTPUTS ------------------------------------------
FairTen1
AnchTen1
--------------------- need this line -----------------------------------
"""

A = (-239.01858425733275, -260.87547371415656)
B = (-732.1643435012232, -617.3791587315022)
DX = [0.0, 0.25, 0.5, 1.0, 2.0, 4.0, 8.0, 16.0]
DY = [0.0, 0.3, 3.0, 30.0]


def main() -> int:
ap = argparse.ArgumentParser()
ap.add_argument("--exe", required=True)
ap.add_argument("--output", required=True)
a = ap.parse_args()
out = Path(a.output)
out.mkdir(parents=True, exist_ok=True)
env = dict(os.environ)
env.setdefault("OPENBLAS_NUM_THREADS", "1")
failures = []
ref = None
for dx in DX:
for dy in DY:
name = "shift_%g_%g" % (dx, dy)
deck = out / (name + ".dat")
deck.write_text(DECK.format(xa=A[0] + dx, ya=A[1] + dy, xb=B[0] + dx, yb=B[1] + dy), encoding="utf-8",
newline="\n")
root = out / name
p = subprocess.run([a.exe, str(deck), str(root)], capture_output=True, text=True, env=env,
cwd=str(out))
if p.returncode != 0:
failures.append("shift (%g, %g): exit %d: %s" % (dx, dy, p.returncode, (p.stdout + p.stderr)[-300:]))
continue
rows = Path(str(root) + ".out").read_text(encoding="utf-8").splitlines()
vals = [float(v) for v in rows[2].split()[1:3]]
if ref is None:
ref = vals
for v, r, ch in zip(vals, ref, ("FairTen1", "AnchTen1")):
if abs(v - r) > 1.0e-7 * abs(ref[0]):
failures.append("shift (%g, %g): %s %.8e differs from %.8e" % (dx, dy, ch, v, r))
print("translated line in a current: %d runs, %d failures" % (len(DX) * len(DY), len(failures)))
for f in failures:
print("FAIL:", f)
return 1 if failures else 0


if __name__ == "__main__":
sys.exit(main())
Loading