From f520af8935aff8d1fbef905236cf21971a007bc4 Mon Sep 17 00:00:00 2001 From: Claude Date: Tue, 27 Oct 2026 01:10:56 +0000 Subject: [PATCH] refinement: document that the free-memory preflight is a lower bound only Co-Authored-By: Claude Opus 5.5 --- src/CelerisLab/lbm/refinement_stepper.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/CelerisLab/lbm/refinement_stepper.py b/src/CelerisLab/lbm/refinement_stepper.py index e884616..1fb7624 100644 --- a/src/CelerisLab/lbm/refinement_stepper.py +++ b/src/CelerisLab/lbm/refinement_stepper.py @@ -373,7 +373,11 @@ class FixedPatchStepper: raise def _planned_bytes(self): - """Both G buffers, halo pairs and boundary columns of every level (transfer tables excluded).""" + """Both G buffers, halo pairs and boundary columns of every level (transfer tables excluded). + + A fail-fast lower bound only: passing it cannot guarantee that later + allocations succeed (other consumers, fragmentation, races). + """ total = 0 for index, layout in enumerate(self._layouts): cells = int(np.prod(layout.blocked_shape if layout is not None