From 7066243c578a72a2243e14ccd22c4d694f311137 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@Mac.fritz.box>
Date: Wed, 26 Aug 2026 19:51:18 +0200
Subject: [PATCH 001/102] fix(omny): unbreak --session omny startup and the
 sim/harness gaps blocking its live smoke test

- post_startup.py: --session omny imported OMNY from the flomni plugin
  package instead of omny (ImportError on every start)
- omny/x_ray_eye_align.py: XrayEyeAlign.__init__ referenced self.lamni.align
  on the OMNY instance mid-construction, before OMNY.__init__ finishes
  assigning it (AttributeError on every OMNY() construction)
- omny/gui_tools.py: OMNYGuiTools.__init__ crashed with KeyError in any
  session without an open BEC-widgets "main" window (e.g. --nogui); guarded
  to fall back to None like flomni's GuiTools
- omny_e2e_tests/sim_flomni_harness.py: FakeDeviceManager had no .connector,
  breaking rt_lamni_ophyd.py's feedback_enable_with_reset() client-info call
- omny_e2e_tests/sim_lamni_omny_harness.py: fixed a stale import of the
  renamed LamNIFermatScan module
- AI_docs/SIMULATED_ENDSTATIONS.md: recorded the OMNY live-test results
- omny/AI_docs/OPEN_ISSUES.md: new, tracks what the live smoke test found,
  including the unfixed osamroy rotation-offset bug that still blocks scans

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 .../flomni/AI_docs/SIMULATED_ENDSTATIONS.md   |  67 +++++++++-
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 114 ++++++++++++++++++
 .../plugins/omny/gui_tools.py                 |   9 +-
 .../plugins/omny/x_ray_eye_align.py           |  10 +-
 .../startup/post_startup.py                   |   2 +-
 omny_e2e_tests/sim_flomni_harness.py          |   8 ++
 omny_e2e_tests/sim_lamni_omny_harness.py      |   6 +-
 7 files changed, 205 insertions(+), 11 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/AI_docs/SIMULATED_ENDSTATIONS.md b/csaxs_bec/bec_ipython_client/plugins/flomni/AI_docs/SIMULATED_ENDSTATIONS.md
index 9d0ae74c..c3406b6f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/AI_docs/SIMULATED_ENDSTATIONS.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/AI_docs/SIMULATED_ENDSTATIONS.md
@@ -138,10 +138,69 @@ Passed: sample storage + GUI, moves incl. live progress bars and Ctrl-C, rotatio
 angle coupling, feedback enable/disable/status, tracker, fermat scans incl. progress and
 abort, X-ray eye GUI with camera frames, storage bookkeeping. Pending: full transfer
 chain end-to-end, tomo_scan (unblocked by the scilog fix), tomo queue executor
-(crash-resume checklist), then queue-reordering implementation. LamNI/OMNY: harness-
-validated; a short live smoke test (config load, a move, one scan, one OMNY transfer)
-recommended before relying on them, since flOMNI testing surfaced integration issues the
-harness cannot see.
+(crash-resume checklist), then queue-reordering implementation. LamNI: harness-validated;
+live smoke test still pending.
+
+**OMNY (2026-08-26): live smoke test run, config load / move / transfer passed, scan
+blocked by a real (pre-existing, non-sim) bug.** Fixes made along the way (separate from
+this doc's sim-package scope, see the repo's git history for exact diffs):
+- `bec_ipython_client/startup/post_startup.py`: `--session omny` imported `OMNY` from the
+  `flomni` plugin package (which doesn't export it) instead of `omny` — `ImportError` on
+  every OMNY session start.
+- `omny/x_ray_eye_align.py`: `XrayEyeAlign.__init__` called `self.lamni.align.reset_*()`
+  on the OMNY instance mid-construction (`OMNY.__init__` does
+  `self.align = XrayEyeAlign(self.client, self)`, so `.align` doesn't exist yet) —
+  `AttributeError` on every `OMNY()` construction. This file is otherwise still an
+  unadapted copy of LamNI's `x_ray_eye_align.py` (docstrings, types, and `self.lamni`
+  throughout) — the same kind of OMNY-specific adaptation `LamNI`'s copy already got is
+  still open as future work.
+- `omny/gui_tools.py`: `OMNYGuiTools.__init__` did `self.gui.windows["main"].widget`
+  unconditionally — `KeyError` in any session without an open BEC-widgets "main" window
+  (e.g. `--nogui`). Guarded to fall back to `None`, matching flomni's `GuiTools` pattern
+  (`self.flomni_window`, populated lazily by `flomnigui_show_gui()`).
+- Two *environment* fixes, not code bugs, but required before any of the above could even
+  be exercised: `csaxs_bec` and `bec_widgets` were both pip-installed editable pointing at
+  stale pre-repo-reorganization paths (`~/bec/csaxs_bec`, `~/bec/bec_widgets`, neither
+  exists) instead of their current location under `~/bec/bec/...` — `bec-server` couldn't
+  import its own plugins, which is what "bec-server doesn't start" actually was.
+- `omny_e2e_tests/sim_flomni_harness.py`: `FakeDeviceManager` had no `.connector` —
+  `rt_lamni_ophyd.py`'s `feedback_enable_with_reset()` gained a
+  `device_manager.connector.send_client_info(...)` call (commit `f736900`) the harness
+  mock never picked up. Added a no-op `FakeConnector`.
+- `omny_e2e_tests/sim_lamni_omny_harness.py`: imported the pre-rename module path
+  `csaxs_bec.scans.LamNIFermatScan` (now `lamni_components.LamNIComponents`, a
+  `@staticmethod`) — `ModuleNotFoundError`. Both harnesses pass cleanly again (42 flOMNI +
+  32 LamNI/OMNY checks) after these two fixes.
+
+Checklist result against a live local sim deployment (`simulated_omny.yaml`,
+`bec --session omny`):
+- **Config load**: pass — `bec.config.update_session_with_file(...)`, `OMNY(bec)`
+  constructs cleanly, all `simulated_omny.yaml` devices visible on `dev.*`.
+- **A move**: pass — `umv(dev.osamx, ...)`/`umv(dev.osamy, ...)`, live progress bar,
+  correct readback.
+- **One OMNY transfer**: pass — `omny.otransfer_park_slot(6)` drove `oparkz` to the
+  expected `-0.9` with progress reporting and no errors.
+- **One scan**: **blocked**, real bug found (not fixed — needs Mirko's confirmation of
+  intended hardware semantics before touching it). `osamroy` (the rotation axis, axis `C`
+  on the port-8083 controller) has a permanent, documented `+25`° display offset applied
+  only on read (`OMNYGalilReadbackSignal._socket_get`, `ogalil_ophyd.py:56-60` — "we
+  introduce an offset of 25 to the rotation axis... that way we just do tomography from 0
+  to 180 degrees"). Nothing subtracts that 25 back out on the write side
+  (`OMNYGalilMotor.move()`, same file) or in its own success check, so
+  `readback == raw + 25` is compared against the raw target passed to `.move()` — every
+  `.move()`/`umv()` call on `osamroy` fails its success check by exactly 25, unconditionally
+  (confirmed: readback stays fixed at the boot value 25.0 regardless of target; `osamx`/
+  `osamy` on the same controller move correctly, since only this one axis has the offset).
+  This isn't sim-specific — `ogalil_ophyd.py` is real, unmodified device code, so the sim
+  is faithfully reproducing a genuine bug. It unconditionally blocks
+  `feedback_enable_with_reset()`'s "rotate to zero before enabling feedback" precondition
+  (`rt_omny_ophyd.py:526-533`), which blocks every scan needing interferometer feedback —
+  i.e. effectively all of them. A correct fix needs to decide, with domain input: should
+  `OMNYGalilMotor.move()` convert the caller's display-space target to raw before sending
+  it over the wire for this axis (so `.move(0)` means "go to displayed zero"), or should
+  callers already pass raw targets (in which case `feedback_enable_with_reset()`'s
+  `osamroy.obj.move(0, ...)` and its `np.fabs(readback) > 0.1` guard are the ones passing
+  the wrong space)? Either reading is plausible from the code alone.
 
 ## Operational notes
 
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
new file mode 100644
index 00000000..ee91ca86
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -0,0 +1,114 @@
+# OMNY open issues (as of 2026-08-26)
+
+Tracks what the first OMNY live-smoke-test session found: bugs (fixed and unfixed) and
+what's still untested. Written so a future session can pick this up without re-deriving
+it. Companion docs: `../../flomni/AI_docs/SIMULATED_ENDSTATIONS.md` (the sim architecture
+and the fullest write-up of the rotation-offset bug below) and
+`../../flomni/AI_docs/FLOMNI_TO_LAMNI_COMPARISON.md` (the flomni→lamni migration this
+OMNY work is meant to mirror).
+
+## Standing question: OMNY should follow flOMNI, not LamNI
+
+Mirko's reaction on seeing the first findings: OMNY should be architecturally closer to
+**flOMNI**, not LamNI — the two systems are more alike (OMNY is flOMNI's predecessor/
+sibling; LamNI is the more different, laminography-specific setup with e.g. no 180° mode,
+different tomo-type scheduling, `tomo_circfov` instead of `fovx`/`fovy`, etc., per
+`FLOMNI_TO_LAMNI_COMPARISON.md`). This makes it suspicious whenever an OMNY file reads
+like LamNI, and is a general lens to apply going forward: if fixing an OMNY bug means
+choosing what the "correct" shape looks like, default to whatever flOMNI already does,
+not whatever LamNI does — a LamNI-shaped OMNY file is more likely a leftover copy-paste
+than a deliberate design choice. See the `x_ray_eye_align.py` finding below for a concrete
+example already found this way.
+
+## Bug found, NOT fixed — needs Mirko's call before touching it
+
+**`osamroy` (rotation axis) permanently fails every `.move()`/`umv()` call.** Full
+technical write-up: `SIMULATED_ENDSTATIONS.md`'s OMNY live-test section. Short version:
+`OMNYGalilReadbackSignal._socket_get()` (`devices/omny/galil/ogalil_ophyd.py:56-60`) adds
+a documented `+25`° offset on *read* only ("we introduce an offset of 25 to the rotation
+axis... that way we just do tomography from 0 to 180 degrees"). Nothing subtracts it back
+out on the *write* side (`OMNYGalilMotor.move()`, same file) or in that method's own
+success check, so `readback (= raw + 25)` is compared against the raw target passed to
+`.move()` — always off by exactly 25, for any target. This is real, unmodified hardware-
+facing code (not a sim artifact — the sim just relays it faithfully), and it
+unconditionally blocks `feedback_enable_with_reset()` (`rt_omny_ophyd.py:526-533`), which
+blocks every scan needing interferometer feedback, i.e. effectively all of them.
+
+Two plausible fixes, and only Mirko can say which matches real hardware intent:
+1. `OMNYGalilMotor.move()` should convert the caller's display-space target to raw
+   (subtract 25) before sending it over the wire, for this axis — i.e. `.move(0)` means
+   "go to displayed zero."
+2. Callers are expected to already pass raw targets, in which case
+   `feedback_enable_with_reset()`'s `osamroy.obj.move(0, wait=True)` and its
+   `np.fabs(readback) > 0.1` guard (which reads *display*-space) are the ones using the
+   wrong space, and should target/compare against `-25` instead of `0`.
+
+Do not guess-fix this one — a wrong sign/direction on a real rotation-stage offset is the
+kind of thing that should get hardware-review, not silent inference from code reading.
+
+## `x_ray_eye_align.py` — worse than the crash that got fixed
+
+The construction-time crash (`self.lamni.align.reset_correction()` called on an object
+still mid-construction) is fixed (matches the fix LamNI's own copy of this file already
+got — see its `__init__` for the rationale comment). But that only unblocks
+*construction*. The rest of `omny/x_ray_eye_align.py` is still an **unadapted copy of
+`LamNI/x_ray_eye_align.py`**, not code actually written for OMNY:
+- Docstring: `"""BEC-GUI-based X-ray eye alignment for LamNI. ... The key difference from
+  the FlOMNI alignment is that LamNI needs *both* x and y fits..."""` — describes LamNI
+  vs flOMNI, doesn't mention OMNY at all.
+- Type hint: `def __init__(self, client, lamni: LamNI) -> None`, attribute `self.lamni`
+  used throughout (`self.lamni.align...`, `self.lamni.read_xray_eye_correction_from_gui()`
+  etc.) — the parameter is actually the `OMNY` instance, not `LamNI`.
+- `LAMNI_ALIGNMENT_ANGLES = [k * 45 for k in range(8)]` (8 angles, full 360°, laminography-
+  specific) — presumably wrong for OMNY, which (per the flOMNI/LamNI comparison doc) is
+  the kind of full-rotation tomography flOMNI's alignment already handles differently.
+
+None of this was exercised in the live smoke test beyond the constructor no longer
+crashing — `start_x_ray_eye_alignment()` / `xrayeye_update_frame()` were never called.
+Given the "OMNY ≈ flOMNI, not LamNI" principle above, the right fix is almost certainly to
+port OMNY's version from `flomni/x_ray_eye_align.py` (440 lines, the flOMNI-specific
+implementation) the way `LamNI/x_ray_eye_align.py` was itself adapted from flOMNI's,
+rather than patching the current LamNI-derived file in place.
+
+## Checklist items not yet run (smoke test only covered 3 of 4)
+
+From the live session against `simulated_omny.yaml` / `bec --session omny`:
+- **Passed**: config load, a translation-axis move (`osamx`, `osamy`), one lightweight
+  transfer (`omny.otransfer_park_slot(6)`).
+- **Blocked**: any scan (see rotation-offset bug above) — includes `omny.tomo_scan()`
+  itself, never reached.
+
+Still completely untested (not attempted yet, not known-broken — just unexplored):
+- The **full gripper sample-transfer chain**: `otransfer_put_sample()` /
+  `otransfer_get_sample()` (the actual pin pickup/dropoff with the `confirm`/`atconfir`
+  handshake), as opposed to the lighter `otransfer_park_slot()` used for the smoke test.
+- **X-ray eye alignment** end-to-end (blocked in practice by the section above, but worth
+  retesting once that file is properly ported).
+- **Dewar / temperatures** (`omny_dewar`, `omny_temperatures` devices) — they load and
+  construct (`SimOMNYDewar`/`SimOMNYTemperatures`), but no `omny.py`-level method that
+  reads/uses them was called.
+- **Sample storage** (`omny_samples`) beyond it loading with seeded slots — no
+  `omny.py`-level storage-bookkeeping method exercised.
+- `omny_alignment_mixin.py`, `omny_optics_mixin.py`, and the rest of `omny_rt.py` beyond
+  `feedback_enable_with_reset`/`feedback_disable`/`feedback_status` — none of these were
+  called.
+- GUI-dependent flows (`omnygui_show_gui()` etc.) — the smoke test ran `--nogui`; nothing
+  that needs a real BEC-widgets window was exercised.
+
+## Known, already-documented, separate from this session
+
+- `omny_webpage_generator.py` (2957 lines) is dead/unwired code — never instantiated by
+  `omny.py`, per `FLOMNI_TO_LAMNI_COMPARISON.md`'s note ("omny was left untouched...
+  separate future task if omny ever needs a real one"). Not touched this session either.
+- The tomo-queue / `TomoParamsWidget` generalization done for LamNI
+  (`LamNI/AI_docs/TOMO_QUEUE_PORT.md`, `TOMO_PARAMS_GUI_PORT.md`) has no OMNY counterpart
+  yet — out of scope for the sim-validation work, in scope for the eventual macro-
+  standardization pass.
+
+## Environment note (not code, but will bite again if forgotten)
+
+Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
+reorganization paths (`~/bec/csaxs_bec`, `~/bec/bec_widgets`) that no longer exist — real
+location is under `~/bec/bec/...` now. Fixed this session (`pip install -e` from the
+correct path for both). If `bec-server` or `bec_widgets` imports start failing again with
+no obvious code cause, check `pip show <pkg>` → `Editable project location` first.
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index 76d1757f..89ef27f5 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -19,7 +19,14 @@ class OMNYGuiTools:
 
     def __init__(self, client):
         self.gui = getattr(client, "gui", None)
-        self.gui_window = self.gui.windows["main"].widget
+        # No "main" BEC-widgets window exists yet in --nogui sessions, or before
+        # a GUI has actually been opened; fall back to None like flomni's
+        # GuiTools does (self.flomni_window, lazily populated by
+        # flomnigui_show_gui()), instead of crashing OMNY's construction.
+        try:
+            self.gui_window = self.gui.windows["main"].widget
+        except (KeyError, AttributeError):
+            self.gui_window = None
         self.fig200 = None
         self.fig201 = None
         self.fig202 = None
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py b/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py
index ec15cff4..868d5c6f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py
@@ -57,9 +57,13 @@ class XrayEyeAlign:
         #   ...
         #   k=8  : sample at 315°
         self.alignment_values: dict[int, list[float]] = {}
-        # Reset correction state via the existing alignment object on lamni
-        self.lamni.align.reset_correction()
-        self.lamni.align.reset_xray_eye_correction()
+        # Deliberately NOT calling self.lamni.align.reset_correction()/
+        # reset_xray_eye_correction() here: `self.lamni` (the OMNY instance) is
+        # still mid-construction when this runs (OMNY.__init__ does
+        # `self.align = XrayEyeAlign(self.client, self)`), so `self.lamni.align`
+        # doesn't exist yet -- this crashed every OMNY() construction with
+        # AttributeError. Matches LamNI's x_ray_eye_align.py, which was fixed
+        # the same way (see its __init__ for the full rationale).
 
     # ------------------------------------------------------------------
     # GUI shortcut
diff --git a/csaxs_bec/bec_ipython_client/startup/post_startup.py b/csaxs_bec/bec_ipython_client/startup/post_startup.py
index d560a94c..32b6b1ea 100644
--- a/csaxs_bec/bec_ipython_client/startup/post_startup.py
+++ b/csaxs_bec/bec_ipython_client/startup/post_startup.py
@@ -65,7 +65,7 @@ if _args.session.lower() == "lamni":
     """)
 
 elif _args.session.lower() == "omny":
-    from csaxs_bec.bec_ipython_client.plugins.flomni import OMNY
+    from csaxs_bec.bec_ipython_client.plugins.omny import OMNY
 
     _session_name = "OMNY"
     omny = OMNY(bec)
diff --git a/omny_e2e_tests/sim_flomni_harness.py b/omny_e2e_tests/sim_flomni_harness.py
index 1b8778e4..47793ab4 100644
--- a/omny_e2e_tests/sim_flomni_harness.py
+++ b/omny_e2e_tests/sim_flomni_harness.py
@@ -46,9 +46,17 @@ class FakeDeviceContainer(dict):
             raise AttributeError(name) from exc
 
 
+class FakeConnector:
+    """Stand-in for device_manager.connector; client-info notifications are a no-op here."""
+
+    def send_client_info(self, *args, **kwargs):
+        pass
+
+
 class FakeDeviceManager:
     def __init__(self):
         self.devices = FakeDeviceContainer()
+        self.connector = FakeConnector()
 
     def add(self, name, obj, user_parameter=None):
         self.devices[name] = FakeConfiguredDevice(obj, user_parameter)
diff --git a/omny_e2e_tests/sim_lamni_omny_harness.py b/omny_e2e_tests/sim_lamni_omny_harness.py
index b388d5a6..915b19bb 100644
--- a/omny_e2e_tests/sim_lamni_omny_harness.py
+++ b/omny_e2e_tests/sim_lamni_omny_harness.py
@@ -178,10 +178,12 @@ def run_lamni():  # noqa: C901
 
     # coarse-stage coupling: with feedback off, the interferometer follows lsamx/lsamy
     # through the LamNI geometry (this is what makes the scan-center routine converge)
-    from csaxs_bec.scans.LamNIFermatScan import lamni_from_stage_coordinates
+    from csaxs_bec.scans.lamni_components import LamNIComponents
 
     lsamx.move(87.55, wait=True)  # +0.05 mm from center
-    expected_x, expected_y = (val * 1000 for val in lamni_from_stage_coordinates(0.05, 0.0))
+    expected_x, expected_y = (
+        val * 1000 for val in LamNIComponents.lamni_from_stage_coordinates(0.05, 0.0)
+    )
     check(
         np.isclose(rtx.readback.get(), expected_x, atol=0.5)
         and np.isclose(rty.readback.get(), expected_y, atol=0.5),

From 57903579fc62bd805e3a62edaf14e6390206963f Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 03:00:01 +0200
Subject: [PATCH 002/102] fix(sim): apply osamroy's 25 deg rotation offset in
 the simulated Galil controller

Real hardware already applies this correctly: controller1.dmc's #NEWPAR
handler subtracts 25 deg from the target when setting osamroy's position
(contrID=3, axis=2), symmetric with the +25 the ophyd read side
(OMNYGalilReadbackSignal._socket_get) already adds back. The simulated
Galil controller (SimGalilState.start_move_from_newpar) didn't replicate
this, so a simulated osamroy.move(x) landed 25 deg away from where real
hardware would -- a simulator-fidelity bug, not a hardware or ophyd bug.

Also adds osamroy to the offline sim_lamni_omny_harness so this class of
bug is caught there going forward, and a focused unit test for the
round-trip and its scoping to port 8083 / axis 2 only.
---
 csaxs_bec/devices/sim/sim_galil.py            | 13 ++++
 omny_e2e_tests/sim_lamni_omny_harness.py      | 22 +++++-
 .../test_sim_galil_omny_rotation_offset.py    | 77 +++++++++++++++++++
 3 files changed, 111 insertions(+), 1 deletion(-)
 create mode 100644 tests/tests_devices/test_sim_galil_omny_rotation_offset.py

diff --git a/csaxs_bec/devices/sim/sim_galil.py b/csaxs_bec/devices/sim/sim_galil.py
index f80e2a6b..c7df6f74 100644
--- a/csaxs_bec/devices/sim/sim_galil.py
+++ b/csaxs_bec/devices/sim/sim_galil.py
@@ -34,6 +34,12 @@ logger = bec_logger.logger
 _ASSIGNMENT_RE = re.compile(r"^([A-Za-z]+)(?:\[(\d+)\])?\s*=\s*(.+)$")
 _STPPERMM_EXPR_RE = re.compile(r"^([0-9.]+)\s*\*\s*stppermm\[(\d+)\]$")
 
+# OMNY's rotation-stage controller (contrID=3 in controller1.dmc) listens on port 8083;
+# osamroy is axis_Id "C" -> numeric 2. Kept in sync with OMNYGalilReadbackSignal's own
+# gating condition in ogalil_ophyd.py.
+_OMNY_ROTATION_PORT = 8083
+_OMNY_ROTATION_AXIS = 2
+
 
 class _SimGalilAxis:
     """State of a single simulated Galil axis (positions in microsteps)."""
@@ -235,6 +241,13 @@ class SimGalilState:
         if not (self.all_axes_referenced() and ax.referenced):
             return
         ax.motor_on = True
+        if self.port == _OMNY_ROTATION_PORT and axis_index == _OMNY_ROTATION_AXIS:
+            # Mirrors controller1.dmc's #NEWPAR handler for contrID=3 (the OMNY
+            # rotation-stage controller): "IF((contrID=3)&(axis=2)) ntarget=ntarget-25".
+            # Real hardware applies this on set; the ophyd read side already adds the
+            # +25 back (OMNYGalilReadbackSignal._socket_get). Without it here, the sim
+            # rotation axis lands 25 deg away from where real hardware would.
+            target_mm -= 25
         ax.start_move(target_mm * ax.stppermm)
 
     def reference_axis(self, axis_index: int, direction: float = 0.0):
diff --git a/omny_e2e_tests/sim_lamni_omny_harness.py b/omny_e2e_tests/sim_lamni_omny_harness.py
index 915b19bb..1d6f38bd 100644
--- a/omny_e2e_tests/sim_lamni_omny_harness.py
+++ b/omny_e2e_tests/sim_lamni_omny_harness.py
@@ -232,6 +232,18 @@ def run_omny():  # noqa: C901
             sim_initial_position=2.5,
         ),
     )
+    osamroy = dm.add(
+        "osamroy",
+        SimOMNYGalilMotor(
+            "C",
+            name="osamroy",
+            host="mpc3217.psi.ch",
+            port=8083,
+            sign=1,
+            device_manager=dm,
+            sim_initial_position=0,
+        ),
+    )
     rtx = dm.add(
         "rtx",
         SimRtOMNYMotor(
@@ -257,7 +269,7 @@ def run_omny():  # noqa: C901
             name="rt_positions", host=host, port=3333, device_manager=dm, sim_point_dwell_s=0.005
         ),
     )
-    for device in (otransy, otracky, rtx, rty, rtz):
+    for device in (otransy, otracky, osamroy, rtx, rty, rtz):
         device.wait_for_connection()
     flyer.controller.on()
     print("--- OMNY simulated devices connected ---")
@@ -279,6 +291,14 @@ def run_omny():  # noqa: C901
     otransy.move(5.0, wait=True)
     check(np.isclose(otransy.readback.get(), 5.0, atol=1e-3), "omny: otransy moved to 5.0")
 
+    # osamroy: 25 deg rotation-stage offset applied on set by the real Galil controller
+    # (contrID=3 in controller1.dmc); the sim must mirror it so a move to a display-space
+    # target reads back the same target, not target+25.
+    osamroy.move(0, wait=True)
+    check(np.isclose(osamroy.readback.get(), 0.0, atol=1e-3), "omny: osamroy moved to 0")
+    osamroy.move(90, wait=True)
+    check(np.isclose(osamroy.readback.get(), 90.0, atol=1e-3), "omny: osamroy moved to 90")
+
     # shuttle-style direct axis commands
     con.socket_put_confirmed("SPG=15000")
     con.socket_put_confirmed("SHG")
diff --git a/tests/tests_devices/test_sim_galil_omny_rotation_offset.py b/tests/tests_devices/test_sim_galil_omny_rotation_offset.py
new file mode 100644
index 00000000..1d6338bf
--- /dev/null
+++ b/tests/tests_devices/test_sim_galil_omny_rotation_offset.py
@@ -0,0 +1,77 @@
+import pytest
+from bec_server.device_server.tests.utils import DMMock
+
+from csaxs_bec.devices.omny.galil.ogalil_ophyd import OMNYGalilController
+from csaxs_bec.devices.sim.sim_galil import SimGalilState
+from csaxs_bec.devices.sim.sim_omny import SimOMNYGalilMotor
+from csaxs_bec.devices.sim.sim_socket import SimStateRegistry
+
+# osamroy: axis_Id "C" (numeric 2) on port 8083 -- the OMNY rotation-stage controller
+# (contrID=3 in controller1.dmc). This is the only axis/port combination on which the
+# real controller applies the 25 deg offset when setting a position.
+_ROTATION_AXIS_ID = "C"
+_ROTATION_PORT = 8083
+_HOST = "test-omny-galil.psi.ch"
+# fast enough that a ~200 deg simulated move settles well within the poll loop's
+# resolution; OMNYGalilController is a per-(host, port) singleton so it must be reset
+# between tests too, like test_galil_flomni.py does for FlomniGalilController.
+_SIM_VELOCITY = 1000.0
+
+
+@pytest.fixture(autouse=True)
+def _reset_sim_state():
+    OMNYGalilController._reset_controller()
+    SimStateRegistry.reset()
+    yield
+    SimStateRegistry.reset()
+    OMNYGalilController._reset_controller()
+
+
+def _make_axis(axis_Id, port):
+    motor = SimOMNYGalilMotor(
+        axis_Id,
+        name=f"axis_{axis_Id}_{port}",
+        host=_HOST,
+        port=port,
+        sign=1,
+        device_manager=DMMock(),
+        sim_initial_position=0,
+        sim_velocity=_SIM_VELOCITY,
+    )
+    motor.wait_for_connection()
+    return motor
+
+
+@pytest.mark.parametrize("target", [0.0, 90.0, 180.0])
+def test_osamroy_move_round_trips_through_25_deg_offset(target):
+    """osamroy must round-trip through the sim exactly like real hardware does via
+    controller1.dmc's #NEWPAR 'IF((contrID=3)&(axis=2)) ntarget=ntarget-25' handler:
+    a move to a display-space target reads back the same target, not target+25."""
+    osamroy = _make_axis(_ROTATION_AXIS_ID, _ROTATION_PORT)
+    try:
+        osamroy.move(target, wait=True)
+        assert osamroy.readback.get() == pytest.approx(target, abs=1e-3)
+
+        # the raw sim axis must actually be sitting 25 deg away from the logical target,
+        # matching what the real controller drives the motor to
+        state = SimStateRegistry.get(SimGalilState, _HOST, _ROTATION_PORT)
+        raw_axis = state.axis(osamroy.axis_Id_numeric)
+        assert raw_axis.position() / raw_axis.stppermm == pytest.approx(target - 25, abs=1e-3)
+    finally:
+        osamroy.destroy()
+
+
+def test_offset_is_scoped_to_omny_rotation_axis_only():
+    """A different axis on the same controller, or the same axis letter on a different
+    port, must NOT get the -25 offset -- only port 8083 / axis numeric 2 (osamroy)."""
+    other_axis_same_port = _make_axis("A", _ROTATION_PORT)  # numeric 0, not the rotation axis
+    same_axis_other_port = _make_axis(_ROTATION_AXIS_ID, 8081)  # not the rotation controller
+    try:
+        other_axis_same_port.move(10.0, wait=True)
+        assert other_axis_same_port.readback.get() == pytest.approx(10.0, abs=1e-3)
+
+        same_axis_other_port.move(10.0, wait=True)
+        assert same_axis_other_port.readback.get() == pytest.approx(10.0, abs=1e-3)
+    finally:
+        other_axis_same_port.destroy()
+        same_axis_other_port.destroy()

From 446b20130232f3140b079fea9f7723e434004e8e Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 14:17:38 +0200
Subject: [PATCH 003/102] fix(omny): realistic sim motor temperatures, rotation
 heads-up, and corr_pos_x crash

- sim_galil.py: default unseeded analog-input channels to a voltage that
  reads back as a realistic ~30 degC motor temperature instead of the
  previous 0.0V/150 degC default (real motors run well under 60 degC).
- rt_omny_ophyd.py: feedback_enable_with_reset() now tells the user the
  current angle and warns it might take a while when osamroy has more
  than 5 deg to rotate back to zero, matching flomni's style of heads-up.
- omny_sample_transfer_mixin.py: otransfer_put_sample() now calls
  reset_correction()/reset_tomo_alignment_fit() when mounting into the
  sample stage (pin_position == 0), mirroring flomni's
  ftransfer_put_sample() -> ftransfer_flomni_stage_in() pattern. Fixes
  an AttributeError ('OMNY' object has no attribute 'corr_pos_x') hit
  when calling tomo_scan_projection() after a sample transfer.
---
 .../plugins/omny/omny_sample_transfer_mixin.py      |  8 ++++++++
 csaxs_bec/devices/omny/rt/rt_omny_ophyd.py          | 13 ++++++++++---
 csaxs_bec/devices/sim/sim_galil.py                  | 10 ++++++++--
 3 files changed, 26 insertions(+), 5 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 3cb19d27..b0f59611 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -764,6 +764,14 @@ class OMNYSampleTransferMixin:
         self._otransfer_controller_disable_mount_mode()
         # update the new sample status in storage
         self._otransfer_check_free_slot_available_at_position(pin_position, 1)
+
+        if pin_position == 0:
+            # sample is now in the sample stage (scanning position): any alignment
+            # correction data belongs to the previous sample, discard it -- matches
+            # flomni's ftransfer_put_sample()/ftransfer_flomni_stage_in()
+            self.reset_correction()
+            self.reset_tomo_alignment_fit()
+
         # this also moves the gripper to parking position
         # alternatively a next sample is to be picked
         # keep shuttle open and ask user which sample to pick
diff --git a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
index f2566f25..70c905b1 100644
--- a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
@@ -527,9 +527,16 @@ class RtOMNYController(Controller):
         # the following read will also upate the angle in rt during readout
         readback = osamroy.obj.readback.get()
         if np.fabs(readback) > 0.1:
-            self.device_manager.connector.send_client_info(
-                f"Rotating to zero", scope="feedback enable", show_asap=True
-            )
+            if np.fabs(readback) > 5:
+                self.device_manager.connector.send_client_info(
+                    f"Rotating from {readback:.1f} deg to zero. This might take a while.",
+                    scope="feedback enable",
+                    show_asap=True,
+                )
+            else:
+                self.device_manager.connector.send_client_info(
+                    f"Rotating to zero", scope="feedback enable", show_asap=True
+                )
             osamroy.obj.move(0, wait=True)
 
         osamx = self.device_manager.devices.osamx
diff --git a/csaxs_bec/devices/sim/sim_galil.py b/csaxs_bec/devices/sim/sim_galil.py
index c7df6f74..d6a21fc3 100644
--- a/csaxs_bec/devices/sim/sim_galil.py
+++ b/csaxs_bec/devices/sim/sim_galil.py
@@ -40,6 +40,12 @@ _STPPERMM_EXPR_RE = re.compile(r"^([0-9.]+)\s*\*\s*stppermm\[(\d+)\]$")
 _OMNY_ROTATION_PORT = 8083
 _OMNY_ROTATION_AXIS = 2
 
+# Default analog input voltage for unseeded channels, used by GalilController.
+# motor_temperature() (@AN[axis+1], converted via (V+10)/20*300 to degC). -8.0V -> 30
+# degC, a realistic idle motor temperature; the previous 0.0V default read back as
+# 150 degC on every axis without an explicit sim_analog_inputs override.
+_DEFAULT_ANALOG_INPUT_V = -8.0
+
 
 class _SimGalilAxis:
     """State of a single simulated Galil axis (positions in microsteps)."""
@@ -144,7 +150,7 @@ class SimGalilState:
         }
         self.digital_inputs = {14: 1.0}  # light curtain reads triggered by default
         self.digital_outputs = {9: 0.0, 15: 1.0}  # gripper closed, lights on
-        self.analog_inputs = {1: -1.6}
+        self.analog_inputs = {}
         self._thread_deadlines = {}  # thread_id -> unix time until which thread is active
         self._transfer_thread = None
         self._transfer_abort = threading.Event()
@@ -494,7 +500,7 @@ class SimGalilSocket(SimSocketBase):
             return f"{state.digital_outputs.get(channel, 0.0):.4f}"
         if arg.startswith("@AN["):
             channel = int(arg[4:].split("]")[0])
-            return f"{state.analog_inputs.get(channel, 0.0):.4f}"
+            return f"{state.analog_inputs.get(channel, _DEFAULT_ANALOG_INPUT_V):.4f}"
         if arg in ("allaxref", "axisref"):
             return f"{1.0 if state.all_axes_referenced() else 0.0:.4f}"
         if arg.startswith("axisref["):

From e6928f295e7cc3be67c14f77cbbef0eb3a7e9728 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 14:26:10 +0200
Subject: [PATCH 004/102] feat(omny): add 4/8 sub-tomogram tomo modes, hide
 advanced modes from regular users

- New shared static helper _equally_spaced_subtomo_angles(), ported from
  flomni's _subtomo_angle_plan() with the 180/360-degree-range branch
  removed (OMNY only ever scans 180 degrees). Generalizes the bit-reversal
  sub-tomogram interleaving to any power-of-two sub-tomogram count; for
  n_subtomos=2 it reduces to OMNY's original type-1 scheme.
- sub_tomo_scan() refactored onto the new helper (gains an n_subtomos
  param); tomo_type 1 (2 sub-tomograms) is otherwise unchanged.
- Adds tomo_type 4 (4 sub-tomograms) and 5 (8 sub-tomograms), gated by the
  same "wear in OMNY" authorization-code prompt already used for tomo_type
  2/3.
- Advanced tomo modes (2, 3, 4, 5) are now hidden from tomo_parameters()'s
  menu unless bec.active_account is in the new _SUPERUSER_ACCOUNTS
  allowlist; a non-superuser landing on an advanced type is forced back to
  type 1. _SUPERUSER_ACCOUNTS is left empty -- needs real account codes
  before anyone can use the advanced modes.
- As a side effect of reusing flomni's formula, also fixes a latent bug:
  the old code derived the inter-sub-tomogram phase offset from the raw
  configured tomo_angle_stepsize rather than the achievable (int-truncated)
  step, producing an unevenly-spaced combined grid whenever stepsize didn't
  divide 180 evenly.
- New tests/tests_bec_ipython_client/test_omny_tomo_angles.py: angle-count
  and no-duplicate-angle checks for n_subtomos in (2, 4, 8), a regression
  check against the old type-1 formula, an explicit test of the
  achievable-step fix, a cross-check against flomni's hardcoded N=8
  bit-reversal table, and superuser-gating tests (including the full
  tomo_parameters() interactive flow forcing a non-superuser back to
  type 1, and a superuser successfully unlocking type 5).
---
 .../bec_ipython_client/plugins/omny/omny.py   | 165 ++++++++---
 .../test_omny_tomo_angles.py                  | 259 ++++++++++++++++++
 2 files changed, 390 insertions(+), 34 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_tomo_angles.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 2a987d75..a11c7bce 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -29,9 +29,11 @@ if builtins.__dict__.get("bec") is not None:
     dev = builtins.__dict__.get("dev")
     scans = builtins.__dict__.get("scans")
 
+
 def umv(*args):
     return scans.umv(*args, relative=False)
 
+
 class OMNYInitError(Exception):
     pass
 
@@ -40,6 +42,13 @@ class OMNYError(Exception):
     pass
 
 
+# BEC accounts (bec.active_account, e.g. "e12345") allowed to select advanced tomo
+# modes (golden ratio, 4/8 sub-tomogram) in OMNY.tomo_parameters(). Regular users only
+# ever see "1: 2 equally spaced sub-tomograms". Populate with real beamline-staff
+# account codes -- left empty until populated, so nobody sees the advanced options yet.
+_SUPERUSER_ACCOUNTS: frozenset[str] = frozenset({})
+
+
 class OMNYInitStagesMixin:
 
     def enable_all_devices(self):
@@ -744,6 +753,12 @@ class OMNY(
         elif val == 3:
             # equally spaced tomography with starting angles shifted by golden ratio
             self.client.set_global_var("tomo_type", val)
+        elif val == 4:
+            # equally spaced tomography with 4 sub tomograms
+            self.client.set_global_var("tomo_type", val)
+        elif val == 5:
+            # equally spaced tomography with 8 sub tomograms
+            self.client.set_global_var("tomo_type", val)
         else:
             raise ValueError("Unknown tomo_type.")
 
@@ -925,41 +940,71 @@ class OMNY(
             tags,
         )
 
-    def sub_tomo_scan(self, subtomo_number, start_angle=None):
+    @staticmethod
+    def _equally_spaced_subtomo_angles(
+        subtomo_number, n_subtomos, tomo_angle_stepsize, start_angle=None
+    ):
+        """
+        Compute the projection angles for one sub-tomogram of an N-way, bit-reversal
+        interleaved, equally spaced 180 degree tomogram (n_subtomos a power of two:
+        2, 4, or 8). Ported from flomni's ``_subtomo_angle_plan()``
+        (flomni/flomni.py), with the 180-vs-360-degree-range branch removed since
+        OMNY only ever scans 180 degrees.
+
+        Odd sub-tomograms scan forward (ascending), even sub-tomograms scan in
+        reverse (descending, to minimize travel between sub-tomograms). Each
+        sub-tomogram's phase offset within a step is picked via a bit-reversal
+        permutation of 0..n_subtomos-1, so that successive sub-tomograms maximally
+        subdivide the angular gaps left by the previous ones. For n_subtomos=2 this
+        reduces to phases {0, step/2} -- the original OMNY scheme.
+
+        Always returns exactly ``int(180 / tomo_angle_stepsize)`` angles (no
+        redundant 0/180 duplicate point), matching the convention already used by
+        flomni's and lamni's own sub_tomo_scan().
+
+        Args:
+            subtomo_number (int): 1-indexed sub-tomogram number.
+            n_subtomos (int): Total number of sub-tomograms (2, 4, or 8).
+            tomo_angle_stepsize (float): Angular step size in degrees.
+            start_angle (float, optional): Explicit start angle override. Defaults
+                to the bit-reversal phase offset described above.
+        """
+        n_points = int(180.0 / tomo_angle_stepsize)
+        step = 180.0 / n_points
+
+        bits = n_subtomos.bit_length() - 1
+        subtomo_index = subtomo_number - 1
+        phase_index = int(format(subtomo_index, f"0{bits}b")[::-1], 2) if bits else 0
+        phase = step / n_subtomos * phase_index
+
+        forward = bool(subtomo_number % 2)
+        if start_angle is None:
+            start_angle = phase if forward else (180.0 - step + phase)
+
+        if forward:
+            return start_angle + np.arange(n_points) * step
+        return start_angle - np.arange(n_points) * step
+
+    def sub_tomo_scan(self, subtomo_number, n_subtomos=2, start_angle=None):
         """
         Performs a sub tomogram scan.
         Args:
             subtomo_number (int): The sub tomogram number.
+            n_subtomos (int): Total number of sub-tomograms in this scan (2, 4, or 8).
             start_angle (float, optional): The start angle of the scan. Defaults to None.
         """
         self._write_subtomo_to_scilog(subtomo_number)
 
-        if start_angle is None:
-            if subtomo_number == 1:
-                start_angle = 0
-            elif subtomo_number == 2:
-                start_angle = self.tomo_angle_stepsize / 2.0
-
-        # _tomo_shift_angles (potential global variable)
-        _tomo_shift_angles = 0
-        angle_end = start_angle + 180
-        angles = np.linspace(
-            start_angle + _tomo_shift_angles,
-            angle_end,
-            num=int(180 / self.tomo_angle_stepsize) + 1,
-            endpoint=True,
+        angles = self._equally_spaced_subtomo_angles(
+            subtomo_number, n_subtomos, self.tomo_angle_stepsize, start_angle
         )
-        # reverse even sub-tomogram
-        if not (subtomo_number % 2):
-            angles = np.flip(angles)
-        for angle in angles:
+        n_points = len(angles)
+        for idx, angle in enumerate(angles):
             self.progress["subtomo"] = subtomo_number
-            self.progress["subtomo_projection"] = np.where(angles == angle)[0][0]
-            self.progress["subtomo_total_projections"] = 180 / self.tomo_angle_stepsize
-            self.progress["projection"] = (subtomo_number - 1) * self.progress[
-                "subtomo_total_projections"
-            ] + self.progress["subtomo_projection"]
-            self.progress["total_projections"] = 180 / self.tomo_angle_stepsize * 2
+            self.progress["subtomo_projection"] = idx
+            self.progress["subtomo_total_projections"] = n_points
+            self.progress["projection"] = (subtomo_number - 1) * n_points + idx
+            self.progress["total_projections"] = n_points * n_subtomos
             self.progress["angle"] = angle
             self._tomo_scan_at_angle(angle, subtomo_number)
 
@@ -1009,7 +1054,7 @@ class OMNY(
         self._current_special_angles = self.special_angles.copy()
         # a new tomo scan was started
         if (
-            (self.tomo_type == 1 and subtomo_start == 1 and start_angle is None)
+            (self.tomo_type in (1, 4, 5) and subtomo_start == 1 and start_angle is None)
             or (self.tomo_type == 2 and projection_number == None)
             or (self.tomo_type == 3 and projection_number == None)
         ):
@@ -1030,11 +1075,12 @@ class OMNY(
                 self.tomo_id = 0
 
         with scans.dataset_id_on_hold:
-            if self.tomo_type == 1:
-                # 2 equally spaced sub-tomograms
-                self.progress["tomo_type"] = "Equally spaced sub-tomograms"
-                for ii in range(subtomo_start, 3):
-                    self.sub_tomo_scan(ii, start_angle=start_angle)
+            if self.tomo_type in (1, 4, 5):
+                # equally spaced sub-tomograms (2, 4, or 8)
+                n_subtomos = {1: 2, 4: 4, 5: 8}[self.tomo_type]
+                self.progress["tomo_type"] = f"Equally spaced sub-tomograms ({n_subtomos})"
+                for ii in range(subtomo_start, n_subtomos + 1):
+                    self.sub_tomo_scan(ii, n_subtomos=n_subtomos, start_angle=start_angle)
                     start_angle = None
 
             elif self.tomo_type == 2:
@@ -1289,6 +1335,17 @@ class OMNY(
                     corridor_size=corridor_size,
                 )
 
+    def _is_superuser_account(self) -> bool:
+        """Whether the active BEC account is allowed to select advanced tomo modes."""
+        bec = builtins.__dict__.get("bec")
+        try:
+            account = bec.active_account
+        except Exception:
+            return False
+        if isinstance(account, bytes):
+            account = account.decode()
+        return bool(account) and account in _SUPERUSER_ACCOUNTS
+
     def tomo_parameters(self):
         """print and update the tomo parameters"""
         print("Current settings:")
@@ -1329,6 +1386,13 @@ class OMNY(
                 print(
                     "repeating prjections at 0 degrees at the beginning of every second subtomogram"
                 )
+        if self.tomo_type in (4, 5):
+            n_subtomos = {4: 4, 5: 8}[self.tomo_type]
+            print(
+                f"\x1b[1mTomo type {self.tomo_type}:\x1b[0m {n_subtomos} equally spaced sub-tomograms"
+            )
+            print(f"Total number of projections: {180/self.tomo_angle_stepsize*n_subtomos}")
+            print(f"Angular step within sub-tomogram:   {self.tomo_angle_stepsize} degrees")
         print(f"\nSample name: {self.sample_name}\n")
 
         if self.OMNYTools.yesno("Are these parameters correctly set for your scan?", "y"):
@@ -1344,12 +1408,23 @@ class OMNY(
                 "Reconstruction queue ", self.ptycho_reconstruct_foldername, str
             )
 
+            is_superuser = self._is_superuser_account()
             print("Tomography type:")
             print("  1: 2 equally spaced sub-tomograms")
-            print("  2: Golden ratio tomography")
-            print("  3: Equally spaced tomography, golden ratio starting angle")
+            if is_superuser:
+                print("  2: Golden ratio tomography")
+                print("  3: Equally spaced tomography, golden ratio starting angle")
+                print("  4: 4 equally spaced sub-tomograms")
+                print("  5: 8 equally spaced sub-tomograms")
             self.tomo_type = self._get_val("Tomography type", self.tomo_type, int)
 
+            if self.tomo_type != 1 and not is_superuser:
+                print(
+                    "Advanced tomo modes are only available to superuser accounts. Tomo type 1"
+                    " selected: 2 sub-tomograms selected."
+                )
+                self.tomo_type = 1
+
             if self.tomo_type == 1:
                 tomo_numberofprojections = self._get_val(
                     "Total number of projections", 180 / self.tomo_angle_stepsize * 2, int
@@ -1417,6 +1492,28 @@ class OMNY(
                     )
                     self.tomo_type = 1
 
+            if self.tomo_type in (4, 5):
+                n_subtomos = {4: 4, 5: 8}[self.tomo_type]
+                code = self._get_val(
+                    "This mode causes significant wear in OMNY. Enter authorization code.", 0, str
+                )
+                if code == "x12sa":
+                    tomo_numberofprojections = self._get_val(
+                        "Total number of projections",
+                        180 / self.tomo_angle_stepsize * n_subtomos,
+                        int,
+                    )
+                    print(f"The angular step will be {180/tomo_numberofprojections}")
+                    self.tomo_angle_stepsize = 180 / tomo_numberofprojections * n_subtomos
+                    print(
+                        f"The angular step in a subtomogram it will be {self.tomo_angle_stepsize}"
+                    )
+                else:
+                    print(
+                        "Wrong authorization code. Tomo type 1 selected: 2 sub-tomograms selected."
+                    )
+                    self.tomo_type = 1
+
     @staticmethod
     def _get_val(msg: str, default_value, data_type):
         return data_type(input(f"{msg} ({default_value}): ") or default_value)
@@ -1507,7 +1604,7 @@ class OMNY(
     def dewar_show_all():
         dev.omny_dewar.show_all()
 
-        
+
 if __name__ == "__main__":
     import builtins
 
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
new file mode 100644
index 00000000..c1c25255
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -0,0 +1,259 @@
+"""Tests for OMNY's equally-spaced sub-tomogram angle scheme and the
+account-based superuser gating in tomo_parameters().
+
+OMNY._equally_spaced_subtomo_angles() is a static method ported from flomni's
+_subtomo_angle_plan() (flomni/flomni.py), with the 180-vs-360-degree-range
+branch removed since OMNY only ever scans 180 degrees. It backs tomo_type 1
+(2 sub-tomograms, unchanged/pre-existing), 4 (4 sub-tomograms), and 5 (8
+sub-tomograms, new).
+"""
+
+import builtins
+import types
+
+import numpy as np
+import pytest
+
+from csaxs_bec.bec_ipython_client.plugins.omny import omny as omny_module
+from csaxs_bec.bec_ipython_client.plugins.omny.omny import OMNY
+
+STEPSIZES = [10.0, 7.0, 25.0, 5.0]
+
+
+def _angles(subtomo_number, n_subtomos, stepsize):
+    return np.asarray(OMNY._equally_spaced_subtomo_angles(subtomo_number, n_subtomos, stepsize))
+
+
+def _old_omny_type1_angles(subtomo_number, stepsize):
+    """Reimplementation of OMNY's original (pre-refactor) type-1 angle logic,
+    for regression comparison against _equally_spaced_subtomo_angles(). Mirrors
+    the exact math that used to live inline in sub_tomo_scan(), including the
+    silent `_tomo_scan_at_angle()` filtering of angles outside [0, 180.05).
+    """
+    if subtomo_number == 1:
+        start_angle = 0
+    elif subtomo_number == 2:
+        start_angle = stepsize / 2.0
+    else:
+        raise ValueError("old scheme only supports 2 sub-tomograms")
+    angle_end = start_angle + 180
+    angles = np.linspace(start_angle, angle_end, num=int(180 / stepsize) + 1, endpoint=True)
+    if not (subtomo_number % 2):
+        angles = np.flip(angles)
+    return angles[(angles >= 0) & (angles < 180.05)]
+
+
+@pytest.mark.parametrize("stepsize", STEPSIZES)
+@pytest.mark.parametrize("n_subtomos", [2, 4, 8])
+def test_each_subtomo_generates_exactly_n_angles(stepsize, n_subtomos):
+    n_points = int(180.0 / stepsize)
+    for subtomo_number in range(1, n_subtomos + 1):
+        assert len(_angles(subtomo_number, n_subtomos, stepsize)) == n_points
+
+
+@pytest.mark.parametrize("stepsize", STEPSIZES)
+@pytest.mark.parametrize("n_subtomos", [2, 4, 8])
+def test_combined_subtomos_cover_180_degrees_without_duplicates(stepsize, n_subtomos):
+    n_points = int(180.0 / stepsize)
+    step = 180.0 / n_points
+    all_angles = []
+    for subtomo_number in range(1, n_subtomos + 1):
+        all_angles.extend(_angles(subtomo_number, n_subtomos, stepsize).tolist())
+
+    assert len(all_angles) == n_points * n_subtomos
+    unique = {round(a, 6) for a in all_angles}
+    assert len(unique) == n_points * n_subtomos, "combined sub-tomograms must not repeat an angle"
+
+    # each additional sub-tomogram doubles the resolution of the combined grid
+    combined_step = step / n_subtomos
+    sorted_angles = np.sort(np.asarray(all_angles))
+    diffs = np.diff(sorted_angles)
+    assert np.allclose(
+        diffs, combined_step, atol=1e-6
+    ), f"combined angles are not evenly spaced by {combined_step}: got {diffs}"
+
+
+# stepsizes that divide 180 evenly, where the old code's raw-stepsize-based
+# phase offset happens to coincide with the achievable-step-based one below
+EXACT_STEPSIZES = [10.0, 5.0, 4.0, 20.0]
+
+
+@pytest.mark.parametrize("subtomo_number", [1, 2])
+@pytest.mark.parametrize("stepsize", EXACT_STEPSIZES)
+def test_n_subtomos_2_matches_omnys_original_scheme(subtomo_number, stepsize):
+    old = _old_omny_type1_angles(subtomo_number, stepsize)
+    new = _angles(subtomo_number, 2, stepsize)
+    if subtomo_number == 1:
+        # the old code additionally scanned a redundant point at exactly 180
+        # deg (the same physical projection as 0 deg); the new implementation
+        # intentionally drops it, matching the "exactly N points, no
+        # redundant endpoint" convention already used by flomni's and lamni's
+        # own sub-tomogram scans.
+        np.testing.assert_allclose(new, old[:-1], atol=1e-9)
+    else:
+        np.testing.assert_allclose(new, old, atol=1e-9)
+
+
+@pytest.mark.parametrize("stepsize", [7.0, 25.0])
+def test_phase_offset_uses_achievable_step_not_raw_stepsize(stepsize):
+    """For stepsizes that don't divide 180 evenly, the old code derived
+    subtomo 2's phase offset from the raw configured tomo_angle_stepsize
+    (stepsize/2), producing an unevenly-spaced combined grid when overlaid
+    with subtomo 1. flomni's _subtomo_angle_plan() fixes this by deriving the
+    phase offset from the ACHIEVABLE step (180/int(180/stepsize)) instead --
+    this is the same fix, ported to OMNY. Regression-guards against
+    reintroducing the raw-stepsize version.
+    """
+    n_points = int(180.0 / stepsize)
+    achievable_step = 180.0 / n_points
+    new = _angles(2, 2, stepsize)
+
+    raw_stepsize_start = 180.0 - achievable_step + stepsize / 2.0
+    achievable_step_start = 180.0 - achievable_step + achievable_step / 2.0
+
+    assert not np.isclose(
+        new[0], raw_stepsize_start, atol=1e-9
+    ), "phase offset must not be derived from the raw configured tomo_angle_stepsize"
+    assert np.isclose(new[0], achievable_step_start, atol=1e-9)
+
+
+def test_bit_reversal_matches_flomnis_hardcoded_phase_eighths_table():
+    """flomni.py hardcodes the N=8 bit-reversal permutation as a literal dict
+    (phase_eighths = {1:0, 2:4, 3:2, 4:6, 5:1, 6:5, 7:3, 8:7}). The generalized
+    formula here must reproduce the same first-angle phase for n_subtomos=8."""
+    phase_eighths = {1: 0, 2: 4, 3: 2, 4: 6, 5: 1, 6: 5, 7: 3, 8: 7}
+    stepsize = 10.0
+    n_points = int(180.0 / stepsize)
+    step = 180.0 / n_points
+    for subtomo_number, expected_phase_index in phase_eighths.items():
+        angles = _angles(subtomo_number, 8, stepsize)
+        forward = bool(subtomo_number % 2)
+        expected_phase = step / 8.0 * expected_phase_index
+        expected_start = expected_phase if forward else (180.0 - step + expected_phase)
+        assert np.isclose(angles[0], expected_start, atol=1e-9)
+
+
+# --- superuser gating ---------------------------------------------------------
+
+
+class FakeClient:
+    """Minimal in-memory stand-in for BEC's global-var store."""
+
+    def __init__(self):
+        self._vars = {}
+
+    def get_global_var(self, key):
+        return self._vars.get(key)
+
+    def set_global_var(self, key, value):
+        self._vars[key] = value
+
+
+def make_omny() -> OMNY:
+    """Bare OMNY instance with only what tomo_type/_is_superuser_account() need,
+    bypassing __init__'s heavy side effects."""
+    obj = object.__new__(OMNY)
+    obj.client = FakeClient()
+    return obj
+
+
+@pytest.fixture
+def fake_bec(monkeypatch):
+    fake = types.SimpleNamespace(active_account="")
+    monkeypatch.setattr(builtins, "bec", fake, raising=False)
+    return fake
+
+
+def test_is_superuser_account_true_for_allowlisted_account(monkeypatch, fake_bec):
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
+    fake_bec.active_account = "e99999"
+    omny = make_omny()
+    assert omny._is_superuser_account() is True
+
+
+def test_is_superuser_account_false_for_other_account(monkeypatch, fake_bec):
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
+    fake_bec.active_account = "e00001"
+    omny = make_omny()
+    assert omny._is_superuser_account() is False
+
+
+def test_is_superuser_account_handles_bytes_account(monkeypatch, fake_bec):
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
+    fake_bec.active_account = b"e99999"
+    omny = make_omny()
+    assert omny._is_superuser_account() is True
+
+
+def test_is_superuser_account_false_when_empty_allowlist(monkeypatch, fake_bec):
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset())
+    fake_bec.active_account = "e99999"
+    omny = make_omny()
+    assert omny._is_superuser_account() is False
+
+
+def test_tomo_parameters_forces_type_1_for_non_superuser(monkeypatch, fake_bec):
+    """A non-superuser account that ends up picking an advanced tomo_type via
+    the interactive prompt must be forced back to tomo_type 1."""
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
+    fake_bec.active_account = "e00001"  # not a superuser
+    omny = make_omny()
+    omny.tomo_countingtime = 1.0
+    omny.tomo_shellstep = 0.1
+    omny.fovx = 20
+    omny.fovy = 20
+    omny.stitch_x = 1
+    omny.stitch_y = 1
+    omny.ptycho_reconstruct_foldername = "queue"
+    omny.tomo_angle_stepsize = 10.0
+    omny.tomo_type = 1
+    fake_dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+    omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
+
+    # canned answers for: ctime, step, fovx, fovy, stitch_x, stitch_y,
+    # reconstruct_foldername, tomo_type (=2, an advanced/hidden mode), then the
+    # type-1 fallback's own "Total number of projections" sub-prompt (since
+    # tomo_type gets forced back to 1 after the superuser check)
+    canned = iter([1.0, 0.1, 20, 20, 1, 1, "queue", 2, 36])
+    monkeypatch.setattr(OMNY, "_get_val", staticmethod(lambda *a, **k: next(canned)))
+
+    omny.tomo_parameters()
+
+    assert omny.tomo_type == 1
+
+
+def test_tomo_parameters_allows_superuser_to_unlock_8_subtomo_mode(monkeypatch, fake_bec):
+    """A superuser account can select and unlock tomo_type 5 (8 sub-tomograms)
+    with the correct authorization code."""
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
+    fake_bec.active_account = "e99999"  # superuser
+    omny = make_omny()
+    omny.tomo_countingtime = 1.0
+    omny.tomo_shellstep = 0.1
+    omny.fovx = 20
+    omny.fovy = 20
+    omny.stitch_x = 1
+    omny.stitch_y = 1
+    omny.ptycho_reconstruct_foldername = "queue"
+    omny.tomo_angle_stepsize = 10.0
+    omny.tomo_type = 1
+    fake_dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+    omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
+
+    # canned answers for: ctime, step, fovx, fovy, stitch_x, stitch_y,
+    # reconstruct_foldername, tomo_type (=5, 8 sub-tomograms), authorization
+    # code, total number of projections
+    canned = iter([1.0, 0.1, 20, 20, 1, 1, "queue", 5, "x12sa", 144])
+    monkeypatch.setattr(OMNY, "_get_val", staticmethod(lambda *a, **k: next(canned)))
+
+    omny.tomo_parameters()
+
+    assert omny.tomo_type == 5
+    # 144 total projections / 8 sub-tomograms -> stepsize 180/(144/8) = 10.0
+    assert omny.tomo_angle_stepsize == pytest.approx(10.0)

From 336cae3cf5309ce0b094658e3389e5f8bf69dbf3 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 14:31:00 +0200
Subject: [PATCH 005/102] feat(omny): grant gac-x01dc superuser access to
 advanced tomo modes

For testing tomorrow. Note: bec.active_account is a Redis-backed pgroup
value set via `bec-set-account <pgroup>`, not derived from the OS login --
testing under this account requires running `bec-set-account gac-x01dc`
(or otherwise setting the pgroup to that value) before it takes effect.
---
 csaxs_bec/bec_ipython_client/plugins/omny/omny.py | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index a11c7bce..0ff2437a 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -44,9 +44,11 @@ class OMNYError(Exception):
 
 # BEC accounts (bec.active_account, e.g. "e12345") allowed to select advanced tomo
 # modes (golden ratio, 4/8 sub-tomogram) in OMNY.tomo_parameters(). Regular users only
-# ever see "1: 2 equally spaced sub-tomograms". Populate with real beamline-staff
-# account codes -- left empty until populated, so nobody sees the advanced options yet.
-_SUPERUSER_ACCOUNTS: frozenset[str] = frozenset({})
+# ever see "1: 2 equally spaced sub-tomograms". active_account is a Redis-backed
+# pgroup value, set explicitly via `bec-set-account <pgroup>` -- it is NOT derived
+# from the OS login, so testing as this account requires running
+# `bec-set-account gac-x01dc` first (or wiring pgroup "gac-x01dc" some other way).
+_SUPERUSER_ACCOUNTS: frozenset[str] = frozenset({"gac-x01dc"})
 
 
 class OMNYInitStagesMixin:

From da0121216bbeef232f5ccc6b289595b31b13f73f Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 19:12:03 +0200
Subject: [PATCH 006/102] feat(omny): fall back to OS login for superuser check
 when no pgroup is set

bec.active_account is a Redis-backed pgroup, only set via bec-set-account
-- a fresh dev/test session normally has it unset. _is_superuser_account()
now falls back to os.getenv("USER") in that case, matching the
account/system-user comparison convention already used in
OMNY_shared/omny_general_tools.py's _accounts_match(). Lets gac-x01dc's
superuser grant take effect without requiring bec-set-account first.
---
 .../bec_ipython_client/plugins/omny/omny.py    | 10 +++++++++-
 .../test_omny_tomo_angles.py                   | 18 ++++++++++++++++++
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 0ff2437a..b8530a5b 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1338,7 +1338,13 @@ class OMNY(
                 )
 
     def _is_superuser_account(self) -> bool:
-        """Whether the active BEC account is allowed to select advanced tomo modes."""
+        """Whether the active BEC account is allowed to select advanced tomo modes.
+
+        bec.active_account is a pgroup set explicitly via `bec-set-account`; when no
+        pgroup has been set yet (e.g. a fresh dev/test session), fall back to the OS
+        login (matches the account/system-user comparison convention already used in
+        OMNY_shared/omny_general_tools.py's _accounts_match()).
+        """
         bec = builtins.__dict__.get("bec")
         try:
             account = bec.active_account
@@ -1346,6 +1352,8 @@ class OMNY(
             return False
         if isinstance(account, bytes):
             account = account.decode()
+        if not account:
+            account = os.getenv("USER") or ""
         return bool(account) and account in _SUPERUSER_ACCOUNTS
 
     def tomo_parameters(self):
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
index c1c25255..f71e5184 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -192,6 +192,24 @@ def test_is_superuser_account_false_when_empty_allowlist(monkeypatch, fake_bec):
     assert omny._is_superuser_account() is False
 
 
+def test_is_superuser_account_falls_back_to_os_user_when_no_pgroup_set(monkeypatch, fake_bec):
+    """bec.active_account is a pgroup, only set explicitly via bec-set-account. A
+    fresh dev/test session with no pgroup set must fall back to the OS login."""
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"gac-x01dc"}))
+    fake_bec.active_account = ""
+    monkeypatch.setenv("USER", "gac-x01dc")
+    omny = make_omny()
+    assert omny._is_superuser_account() is True
+
+
+def test_is_superuser_account_no_pgroup_and_unlisted_os_user(monkeypatch, fake_bec):
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"gac-x01dc"}))
+    fake_bec.active_account = ""
+    monkeypatch.setenv("USER", "someone-else")
+    omny = make_omny()
+    assert omny._is_superuser_account() is False
+
+
 def test_tomo_parameters_forces_type_1_for_non_superuser(monkeypatch, fake_bec):
     """A non-superuser account that ends up picking an advanced tomo_type via
     the interactive prompt must be forced back to tomo_type 1."""

From 7aedac148cdf99ecb69280ce2e17d310204e651a Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 19:16:35 +0200
Subject: [PATCH 007/102] feat(omny): seed realistic values in SimOMNYDewar and
 SimOMNYTemperatures

- SimOMNYDewar: patched_device()'s all-zero default read as an alarm
  state (LN2 flow 0.0 l/s trips OMNYDewar.is_flow_low()'s 3.8 l/s
  threshold). Seeded to a healthy/nominal state instead. These values
  are illustrative -- no real dewar-controller reference was available.
- SimOMNYTemperatures: seeded names/units/readings/setpoints for the 29
  real "TEMP" channels, sourced from the real OMNY_tempcontroller/
  tempcontrol.py channel config (name, EGU, ChanHeat, ALARMLIM) and
  cross-referenced against the existing _set_TEMP_default_setpoints()
  (already in this repo, confirmed to cover the same 29 channels).
  Heated channels read at their real setpoint; monitor-only channels get
  a plausible reading below their real alarm limit -- no channel now
  shows a false alarm. Channels not in use are now named "-" (matching
  tempcontrol.py's real default), so show_all() cleanly hides them
  instead of listing 19 fake all-zero rows. temperature_update_time and
  cryo_temperature_update_time are set to now() to avoid a false
  "controller communication is not running" warning.
- The 4 "CRYO" channels are NOT seeded yet -- pending the cryocon
  controller reference (still needed from Mirko).
---
 csaxs_bec/devices/sim/sim_omny.py | 89 ++++++++++++++++++++++++++++++-
 1 file changed, 87 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 5aebf832..929310fc 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -21,6 +21,7 @@ uses the patched-device pattern with in-memory mock PVs.
 from __future__ import annotations
 
 import random
+import time
 
 from bec_lib.logger import bec_logger
 from ophyd_devices.tests.utils import patched_device
@@ -266,16 +267,100 @@ class SimOMNYSampleStorage(OMNYSampleStorage):
 
 
 class SimOMNYDewar(OMNYDewar):
-    """OMNYDewar with all EPICS PVs replaced by in-memory mock PVs."""
+    """OMNYDewar with all EPICS PVs replaced by in-memory mock PVs, seeded to a
+    healthy/nominal state instead of the all-zero patched_device() default (which
+    reads as an alarm state: OMNYDewar.is_flow_low() trips below 3.8 l/s). These
+    values are illustrative -- no real dewar-controller reference was available
+    when writing this (unlike SimOMNYTemperatures below); adjust if real nominal
+    values are known.
+    """
 
     def __new__(cls, *args, **kwargs):
         with patched_device(OMNYDewar, *args, **kwargs) as dewar:
+            dewar.dewar_press_0.put(1200)
+            dewar.dewar_refilling.put(0)
+            dewar.dewar_press_1.put(1500)
+            dewar.dewar_press_2.put(950)
+            dewar.dewar_flow_0.put(4.5)  # above the 3.8 l/s is_flow_low() threshold
+            dewar.dewar_valvepos.put(0.35)
+            dewar.dewar_supply_voltage.put(24.0)
+            dewar.dewar_uptime_h.put(12)
+            dewar.dewar_uptime_m.put(30)
+            dewar.dewar_uptime_s.put(0)
+            dewar.dewar_valve_movements_h.put(0)
+            dewar.dewar_valve_movements_m.put(5)
+            dewar.dewar_valve_movements_s.put(0)
             return dewar
 
 
+# OMNY temperature-controller channels ("TEMP" bank, channels 1-48), sourced from the
+# real OMNY_tempcontroller/tempcontrol.py channel config (name, EGU, ChanHeat, ALARMLIM)
+# cross-referenced against OMNYTemperatures._set_TEMP_default_setpoints()'s existing
+# per-channel setpoints (already in this repo, confirmed to cover exactly the same 29
+# channels -- the setpoint value below is copied from that method, not re-derived).
+# Sentinel setpoints ("no active control": -199.9 degC / 73.2 K, matching
+# tempcontrol.py's configure_device()'s unused-channel convention) mark monitor-only
+# channels (ChanHeat=0); those get a plausible physical reading instead of the sentinel.
+# channel: (name, EGU, alarm limit, simulated current reading, real setpoint)
+_TEMP_CHANNELS = {
+    8: ("XEye Chamber", "degC", 50, 24.0, -199.9),
+    9: ("Kuehlsystem RT ZufOSA", "degC", 50, 23.0, 23.0),
+    10: ("OSA_HaltZul_517", "K", 140, 100.0, 73.2),
+    16: ("XEye Air", "degC", 50, 24.0, -199.9),
+    17: ("SampleShield_RT_440", "degC", 50, 23.0, 23.0),
+    18: ("DeltaA_RT", "degC", 50, 26.0, 26.0),
+    19: ("DeltaB_RT", "degC", 50, 26.0, 26.0),
+    20: ("DeltaC_RT", "degC", 50, 26.0, 26.0),
+    21: ("Haube_ST_RT", "degC", 50, 23.0, 23.0),
+    22: ("Delta_Basisplatte", "degC", 50, 24.0, -199.9),
+    23: ("InterfBridge", "degC", 30, 24.0, -199.9),
+    24: ("XEye Cam", "degC", 50, 24.0, -199.9),
+    25: ("OSA_HSupp_RT_403", "degC", 50, 25.0, 25.0),
+    27: ("OSA_Supp_RT_404", "degC", 50, 25.0, 25.0),
+    28: ("ST_Shield_1", "K", 140, 100.0, 73.2),
+    29: ("ST_Shield_2", "K", 140, 100.0, 73.2),
+    30: ("OSA_CoolConn_407", "K", 125, 95.0, 73.2),
+    31: ("OSA_Holder_406", "K", 115, 90.0, 73.2),
+    35: ("Gripper_Halter_460", "degC", 5, 25.0, 25.0),
+    36: ("Gripper_Flex_A", "degC", 5, 25.0, 25.0),
+    37: ("Gripper_Flex_B", "degC", 5, 25.0, 25.0),
+    38: ("Gripper_A", "K", 140, 100.0, 73.2),
+    39: ("Gripper_B", "K", 140, 100.0, 73.2),
+    41: ("FZP", "degC", 1, 30.0, 30.0),
+    42: ("Park_RT_A", "degC", 5, 25.0, 25.0),
+    44: ("Park_RT_B", "degC", 5, 25.0, 25.0),
+    45: ("BaseBlock", "degC", 50, 24.0, -199.9),
+    46: ("Park_Cryo_R", "K", 140, 100.0, 73.2),
+    47: ("Park_Cryo_L", "K", 140, 100.0, 73.2),
+}
+
+
 class SimOMNYTemperatures(OMNYTemperatures):
-    """OMNYTemperatures with all EPICS PVs replaced by in-memory mock PVs."""
+    """OMNYTemperatures with all EPICS PVs replaced by in-memory mock PVs, seeded
+    with realistic per-channel names/units/readings/setpoints for the 29 real "TEMP"
+    channels (see _TEMP_CHANNELS above). The 4 "CRYO" channels are not seeded yet --
+    pending the cryocon controller reference.
+    """
 
     def __new__(cls, *args, **kwargs):
         with patched_device(OMNYTemperatures, *args, **kwargs) as temperatures:
+            now = time.time()
+            for channel in range(1, 49):
+                if channel not in _TEMP_CHANNELS:
+                    # matches tempcontrol.py's real ChanName default ('-') for
+                    # channels not in use; show_all() hides these accordingly
+                    getattr(temperatures.temperature_names, f"temperature_name{channel}").put("-")
+                    continue
+                name, egu, _alarmlim, reading, setpoint = _TEMP_CHANNELS[channel]
+                getattr(temperatures.temperature_names, f"temperature_name{channel}").put(name)
+                getattr(temperatures.temperature_unit, f"temperature_unit{channel}").put(egu)
+                getattr(temperatures.temperature, f"temperature{channel}").put(reading)
+                getattr(temperatures.temperature_setpoint, f"temperature_setpoint{channel}").put(
+                    setpoint
+                )
+                getattr(
+                    temperatures.temperature_alarmstate, f"temperature_alarmstate{channel}"
+                ).put(0)
+            temperatures.temperature_update_time.put(now)
+            temperatures.cryo_temperature_update_time.put(now)
             return temperatures

From 5e8fda761f9af7218be657789273af35e35ff3f2 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 19:20:12 +0200
Subject: [PATCH 008/102] feat(omny): seed the 3 known CryoCon channels in
 SimOMNYTemperatures

Chan A "Cryo sample" 90K, Chan B "Cryo head" 82K, Chan C "Sample backup"
90K, all closed-loop (reading == setpoint). Channel D has no known real
use yet and is left unseeded.
---
 csaxs_bec/devices/sim/sim_omny.py | 23 +++++++++++++++++++++--
 1 file changed, 21 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 929310fc..f0574620 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -334,12 +334,19 @@ _TEMP_CHANNELS = {
     47: ("Park_Cryo_L", "K", 140, 100.0, 73.2),
 }
 
+# CryoCon channels ("CRYO" bank, cryo_temperature1-4 -> A-D). Closed-loop controlled,
+# so the simulated reading is put at the real setpoint. Channel D has no known real
+# use yet -- left unseeded (shows as "0"/0.00; the CRYO branch of show_all() has no
+# name-based hiding, unlike the TEMP bank).
+# controller number (1=A, 2=B, 3=C, 4=D): (name, reading/setpoint in K)
+_CRYO_CHANNELS = {1: ("Cryo sample", 90.0), 2: ("Cryo head", 82.0), 3: ("Sample backup", 90.0)}
+
 
 class SimOMNYTemperatures(OMNYTemperatures):
     """OMNYTemperatures with all EPICS PVs replaced by in-memory mock PVs, seeded
     with realistic per-channel names/units/readings/setpoints for the 29 real "TEMP"
-    channels (see _TEMP_CHANNELS above). The 4 "CRYO" channels are not seeded yet --
-    pending the cryocon controller reference.
+    channels (see _TEMP_CHANNELS above) and the 3 known "CRYO" channels (see
+    _CRYO_CHANNELS above).
     """
 
     def __new__(cls, *args, **kwargs):
@@ -361,6 +368,18 @@ class SimOMNYTemperatures(OMNYTemperatures):
                 getattr(
                     temperatures.temperature_alarmstate, f"temperature_alarmstate{channel}"
                 ).put(0)
+            for controller_nr, (name, reading) in _CRYO_CHANNELS.items():
+                getattr(
+                    temperatures.cryo_temperature_name, f"cryo_temperature_name{controller_nr}"
+                ).put(name)
+                getattr(temperatures.cryo_temperature, f"cryo_temperature{controller_nr}").put(
+                    reading
+                )
+                getattr(
+                    temperatures.cryo_temperature_setpoint,
+                    f"cryo_temperature_setpoint{controller_nr}",
+                ).put(reading)
+            temperatures.cryo_temperature_closed_loop.put(1)
             temperatures.temperature_update_time.put(now)
             temperatures.cryo_temperature_update_time.put(now)
             return temperatures

From 62b4b8d8faf89862b0d2cf3a47cd9401ee1a48a4 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 19:52:36 +0200
Subject: [PATCH 009/102] feat(omny): skip OSA/FZP moves when already at the
 target position

oosa_in(), oosa_out(), ofzp_in(), ofzp_out() used to unconditionally
re-move every axis (and, for FZP, unconditionally disable rt feedback)
even when already at the target -- visible as repeated no-op progress
bars on back-to-back calls. Ported the same "skip if already there"
optimization flomni's fosa_in()/ffzp_in() already have (and that lamni
already got too, see test_lamni_optics_skip_if_in_position.py).

For oosa_in()/oosa_out() the "already there" check has to run *before*
_oosa_check_y(), since that call unconditionally parks oosay at 0.9 --
never the real in/out position for either near- or far-field mode -- so
checking afterward would always miss the match. oosa_out()'s "out"
targets are hardcoded literals in the existing code (no user_parameter
for out, unlike oosa_in's far_field_in/near_field_in), so the skip
check compares against those same literals.

New tests/tests_bec_ipython_client/test_omny_optics_skip_if_in_position.py
(9 tests, mirroring the lamni test's structure): skip-vs-move for both
near/far field on oosa_in/oosa_out, and skip-vs-move-and-disable-feedback
for ofzp_in/ofzp_out.
---
 .../plugins/omny/omny_optics_mixin.py         |  72 +++++--
 .../test_omny_optics_skip_if_in_position.py   | 204 ++++++++++++++++++
 2 files changed, 264 insertions(+), 12 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_optics_skip_if_in_position.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_optics_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_optics_mixin.py
index 0023308e..3faf811f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_optics_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_optics_mixin.py
@@ -129,16 +129,44 @@ class OMNYOpticsMixin:
         if np.fabs(omny_oosa_currentx + 2) > 0.1:
             raise OMNYError("oosax did not reach target position. Not moving in z.\n")
 
+    def _oosa_is_at(self, x_pos, y_pos, z_pos, tol=0.05) -> bool:
+        """True if oosax/oosay/oosaz are all within tol of the given position."""
+        dev.oosaz.read(cached=False)
+        return (
+            np.fabs(dev.oosax.get().readback - x_pos) < tol
+            and np.fabs(dev.oosay.get().readback - y_pos) < tol
+            and np.fabs(dev.oosaz.get().readback - z_pos) < tol
+        )
+
     def oosa_in(self):
+        # Compute the target *before* touching anything: _oosa_check_y() below
+        # unconditionally parks oosay at 0.9, which is not the "in" position for
+        # either mode, so the "already there" check must happen first or it
+        # would never see the real (pre-park) oosay reading.
+        if self.near_field == False:
+            mode, x_in_pos, y_in_pos, z_in_pos = (
+                "far-field",
+                self._get_user_param_safe("oosax", "far_field_in"),
+                self._get_user_param_safe("oosay", "far_field_in"),
+                self._get_user_param_safe("oosaz", "far_field_in"),
+            )
+        else:
+            mode, x_in_pos, y_in_pos, z_in_pos = (
+                "near-field",
+                self._get_user_param_safe("oosax", "near_field_in"),
+                self._get_user_param_safe("oosay", "near_field_in"),
+                self._get_user_param_safe("oosaz", "near_field_in"),
+            )
+        if self._oosa_is_at(x_in_pos, y_in_pos, z_in_pos):
+            self.OMNYTools.printgreen(f"OSA is already at the IN position ({mode}).")
+            return
+
         self._oosa_check_y()
         dev.oshield.read(cached=False)
         omny_oshield_current = dev.oshield.get().readback
         if omny_oshield_current < 15:
             self._oshield_ST_close()
         if self.near_field == False:
-            x_in_pos = self._get_user_param_safe("oosax", "far_field_in")
-            y_in_pos = self._get_user_param_safe("oosay", "far_field_in")
-            z_in_pos = self._get_user_param_safe("oosaz", "far_field_in")
             print("OSA movement in far-field mode.")
             dev.oosaz.read(cached=False)
             omny_oosa_currentz = dev.oosaz.get().readback
@@ -154,9 +182,6 @@ class OMNYOpticsMixin:
             #  umv oosay 0.386015
 
         if self.near_field == True:
-            x_in_pos = self._get_user_param_safe("oosax", "near_field_in")
-            y_in_pos = self._get_user_param_safe("oosay", "near_field_in")
-            z_in_pos = self._get_user_param_safe("oosaz", "near_field_in")
             print("OSA movement in near-field mode.")
             dev.oosaz.read(cached=False)
             omny_oosa_currentz = dev.oosaz.get().readback
@@ -178,14 +203,26 @@ class OMNYOpticsMixin:
         # rt_feedback_enable
 
     def oosa_out(self):
+        # oosa_out() doesn't move oosay, so "already out" only depends on x/z;
+        # read it before _oosa_check_y() parks oosay at 0.9 below (same reason
+        # as in oosa_in()).
+        omny_oosay_current = dev.oosay.get().readback
+        if self.near_field == False:
+            mode, z_out_pos = "far-field", 6.5
+        else:
+            mode, z_out_pos = "near-field", -0.45
+        if self._oosa_is_at(-2, omny_oosay_current, z_out_pos):
+            self.OMNYTools.printgreen(f"OSA is already at the OUT position ({mode}).")
+            return
+
         self._oosa_check_y()
         dev.oshield.read(cached=False)
         omny_oshield_current = dev.oshield.get().readback
         if omny_oshield_current < 15:
             self._oshield_ST_close()
-        omny_oosaz_current = dev.oosaz.get().readback
         if self.near_field == False:
             print("OSA movement in far-field mode.")
+            omny_oosaz_current = dev.oosaz.get().readback
             if omny_oosaz_current < 6.4:
                 self._oosa_to_move_corridor()
             dev.oosaz.limits = [6.4, 6.6]
@@ -193,6 +230,7 @@ class OMNYOpticsMixin:
             umv(dev.oosax, -2)
         if self.near_field == True:
             print("OSA movement in near-field mode.")
+            omny_oosaz_current = dev.oosaz.get().readback
             if omny_oosaz_current > 0:
                 self._oosa_to_move_corridor()
             dev.oosaz.limits = [-0.4, -0.6]
@@ -217,18 +255,28 @@ class OMNYOpticsMixin:
         self.OMNYTools.printgreen("OSA is out of shield.")
 
     def ofzp_out(self):
+        y_out_pos = self._get_user_param_safe("ofzpy", "out")
+        needs_move = np.fabs(dev.ofzpy.get().readback - y_out_pos) > 0.02
+        if not needs_move:
+            self.OMNYTools.printgreen("FZP is already at the out position")
+            return
         if "rtx" in dev and dev.rtx.enabled:
             dev.rtx.controller.feedback_disable()
-        y_out_pos = self._get_user_param_safe("ofzpy", "out")
-        if np.fabs(dev.ofzpy.get().readback - y_out_pos) > 0.02:
-            umv(dev.ofzpy, y_out_pos)
+        umv(dev.ofzpy, y_out_pos)
         self.OMNYTools.printgreen("FZP at out position")
 
     def ofzp_in(self):
-        if "rtx" in dev and dev.rtx.enabled:
-            dev.rtx.controller.feedback_disable()
         x_in_pos = self._get_user_param_safe("ofzpx", "in")
         y_in_pos = self._get_user_param_safe("ofzpy", "in")
+        needs_move = (
+            np.fabs(dev.ofzpy.get().readback - y_in_pos) > 0.02
+            or np.fabs(dev.ofzpx.get().readback - x_in_pos) > 0.02
+        )
+        if not needs_move:
+            self.OMNYTools.printgreen("FZP is already at the in position")
+            return
+        if "rtx" in dev and dev.rtx.enabled:
+            dev.rtx.controller.feedback_disable()
         if np.fabs(dev.ofzpy.get().readback - y_in_pos) > 0.02:
             umv(dev.ofzpy, y_in_pos)
 
diff --git a/tests/tests_bec_ipython_client/test_omny_optics_skip_if_in_position.py b/tests/tests_bec_ipython_client/test_omny_optics_skip_if_in_position.py
new file mode 100644
index 00000000..bbbc5700
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_optics_skip_if_in_position.py
@@ -0,0 +1,204 @@
+"""Tests for omny's "skip if already in position" optics optimization for
+oosa_in()/oosa_out()/ofzp_in()/ofzp_out(), ported from flomni's
+fosa_in()/ffzp_in() (same optimization already done for lamni, see
+test_lamni_optics_skip_if_in_position.py).
+
+Methods under test (omny_optics_mixin.py) reference module-level `dev`/`umv`
+globals (resolved from this module's own namespace, not an instance
+attribute), so tests monkeypatch those module globals directly.
+"""
+
+import types
+
+import pytest
+
+import csaxs_bec.bec_ipython_client.plugins.omny.omny_optics_mixin as optics_mixin_module
+from csaxs_bec.bec_ipython_client.plugins.omny.omny_optics_mixin import OMNYOpticsMixin
+
+# far-field in: oosax=3.022, oosay=0.4122, oosaz=6.5 (out)
+# near-field in: oosax=3.2044, oosay=0.531, oosaz=-0.4452
+FAR_IN = {"oosax": 3.022, "oosay": 0.4122, "oosaz": 6.5}
+NEAR_IN = {"oosax": 3.2044, "oosay": 0.531, "oosaz": -0.4452}
+
+
+class FakeAxis:
+    def __init__(self, value, in_pos=None, out_pos=None):
+        self.value = value
+        self.readback = types.SimpleNamespace(get=lambda: self.value)
+        self.user_parameter = {}
+        if in_pos is not None:
+            self.user_parameter["in"] = in_pos
+        if out_pos is not None:
+            self.user_parameter["out"] = out_pos
+
+    def read(self, cached=True):
+        return self.value
+
+    def get(self):
+        return types.SimpleNamespace(readback=self.value)
+
+
+class FakeController:
+    def __init__(self):
+        self.calls = []
+
+    def feedback_disable(self):
+        self.calls.append("disable")
+
+    def feedback_enable_with_reset(self):
+        self.calls.append("enable_with_reset")
+
+
+class FakeDev:
+    def __init__(self, oosay=0.9, oshield=20.0, osamy=0.0):
+        self.oosax = FakeAxis(0.0, in_pos=FAR_IN["oosax"])
+        self.oosax.user_parameter = {
+            "far_field_in": FAR_IN["oosax"],
+            "near_field_in": NEAR_IN["oosax"],
+        }
+        self.oosay = FakeAxis(oosay)
+        self.oosay.user_parameter = {
+            "far_field_in": FAR_IN["oosay"],
+            "near_field_in": NEAR_IN["oosay"],
+        }
+        self.oosaz = FakeAxis(0.0)
+        self.oosaz.limits = None
+        self.oosaz.user_parameter = {
+            "far_field_in": FAR_IN["oosaz"],
+            "near_field_in": NEAR_IN["oosaz"],
+        }
+        self.oshield = FakeAxis(oshield)
+        self.osamy = FakeAxis(osamy)
+        self.ofzpx = FakeAxis(-0.5, in_pos=-0.5)
+        self.ofzpy = FakeAxis(0.3, in_pos=0.3, out_pos=0.0)
+        self.rtx = types.SimpleNamespace(enabled=True, controller=FakeController())
+
+    def __contains__(self, name):
+        return hasattr(self, name)
+
+    def __getitem__(self, name):
+        return getattr(self, name)
+
+
+@pytest.fixture
+def fake_dev(monkeypatch):
+    # omny_optics_mixin.py has no module-level `dev`/`umv` names of its own --
+    # it resolves them via the builtins fallback at call time, so the module
+    # attribute must be force-created (raising=False) rather than assumed to
+    # pre-exist.
+    dev = FakeDev()
+    monkeypatch.setattr(optics_mixin_module, "dev", dev, raising=False)
+    return dev
+
+
+@pytest.fixture
+def umv_calls(monkeypatch):
+    calls = []
+    monkeypatch.setattr(optics_mixin_module, "umv", lambda *args: calls.append(args), raising=False)
+    return calls
+
+
+def make_optics(near_field=False):
+    optics = OMNYOpticsMixin()
+    optics.near_field = near_field
+    optics.OMNYTools = types.SimpleNamespace(printgreen=print)
+    return optics
+
+
+def test_oosa_in_skips_move_when_already_in_position_far_field(fake_dev, umv_calls, capsys):
+    fake_dev.oosax.value = FAR_IN["oosax"]
+    fake_dev.oosay.value = FAR_IN["oosay"]
+    fake_dev.oosaz.value = FAR_IN["oosaz"]
+    optics = make_optics(near_field=False)
+
+    optics.oosa_in()
+
+    assert umv_calls == []
+    assert "already at the IN position" in capsys.readouterr().out
+    # _oosa_check_y()/shield-close must not run either -- oosay untouched
+    assert fake_dev.oosay.value == FAR_IN["oosay"]
+
+
+def test_oosa_in_moves_when_out_of_position(fake_dev, umv_calls):
+    fake_dev.oosax.value = -2.0  # not at far-field "in"
+    optics = make_optics(near_field=False)
+
+    optics.oosa_in()
+
+    assert (fake_dev.oosaz, FAR_IN["oosaz"]) in umv_calls
+    assert (fake_dev.oosax, FAR_IN["oosax"]) in umv_calls
+    assert (fake_dev.oosay, FAR_IN["oosay"]) in umv_calls
+
+
+def test_oosa_in_skips_move_when_already_in_position_near_field(fake_dev, umv_calls, capsys):
+    fake_dev.oosax.value = NEAR_IN["oosax"]
+    fake_dev.oosay.value = NEAR_IN["oosay"]
+    fake_dev.oosaz.value = NEAR_IN["oosaz"]
+    optics = make_optics(near_field=True)
+
+    optics.oosa_in()
+
+    assert umv_calls == []
+    assert "already at the IN position" in capsys.readouterr().out
+
+
+def test_oosa_out_skips_move_when_already_out(fake_dev, umv_calls, capsys):
+    fake_dev.oosax.value = -2.0
+    fake_dev.oosaz.value = 6.5
+    optics = make_optics(near_field=False)
+
+    optics.oosa_out()
+
+    assert umv_calls == []
+    assert "already at the OUT position" in capsys.readouterr().out
+
+
+def test_oosa_out_moves_when_not_out(fake_dev, umv_calls):
+    fake_dev.oosax.value = FAR_IN["oosax"]
+    fake_dev.oosaz.value = FAR_IN["oosaz"]
+    optics = make_optics(near_field=False)
+
+    optics.oosa_out()
+
+    assert (fake_dev.oosaz, 6.5) in umv_calls
+    assert (fake_dev.oosax, -2) in umv_calls
+
+
+def test_ofzp_in_skips_move_and_feedback_disable_when_already_in(fake_dev, umv_calls, capsys):
+    optics = make_optics()
+
+    optics.ofzp_in()
+
+    assert umv_calls == []
+    assert fake_dev.rtx.controller.calls == []
+    assert "already at the in position" in capsys.readouterr().out
+
+
+def test_ofzp_in_moves_and_disables_feedback_when_out_of_position(fake_dev, umv_calls):
+    fake_dev.ofzpx.value = -1.0  # not at "in" (-0.5)
+    optics = make_optics()
+
+    optics.ofzp_in()
+
+    assert (fake_dev.ofzpx, -0.5) in umv_calls
+    assert fake_dev.rtx.controller.calls == ["disable"]
+
+
+def test_ofzp_out_skips_move_and_feedback_disable_when_already_out(fake_dev, umv_calls, capsys):
+    fake_dev.ofzpy.value = 0.0  # matches "out"
+    optics = make_optics()
+
+    optics.ofzp_out()
+
+    assert umv_calls == []
+    assert fake_dev.rtx.controller.calls == []
+    assert "already at the out position" in capsys.readouterr().out
+
+
+def test_ofzp_out_moves_and_disables_feedback_when_not_out(fake_dev, umv_calls):
+    optics = make_optics()  # ofzpy at 0.3, not "out" (0.0)
+
+    optics.ofzp_out()
+
+    assert (fake_dev.ofzpy, 0.0) in umv_calls
+    assert fake_dev.rtx.controller.calls == ["disable"]

From e08ac1a44be05c4bb0ffd49f03f75d44048b8dc7 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 20:15:25 +0200
Subject: [PATCH 010/102] fix(omny): make correction data global-var-backed,
 fix default file path

Two real bugs found while investigating a recurring AttributeError:
'OMNY' object has no attribute 'corr_pos_x' from tomo_scan_projection().

1. default_correction_file/default_correction_file_x were bare relative
   filenames ("correction_omny_202204.txt"), unlike flomni's equivalent
   which resolves an absolute path via Path(csaxs_bec.__file__). open()
   would only ever succeed if bec were launched from this exact plugin
   directory -- silently swallowed everywhere else by the existing
   FileNotFoundError handler in reset_correction(). The real correction
   files genuinely exist on disk next to the plugin code and were very
   likely never actually being loaded.

2. corr_pos_x/corr_angle_x/corr_pos_y/corr_angle_y/corr_pos_y_2/
   corr_angle_y_2 were plain instance attributes, only ever assigned
   inside reset_correction() (itself only called from
   otransfer_put_sample() during a sample transfer) -- hence the
   AttributeError when calling tomo_scan_projection() beforehand.
   Converted to global-var-backed properties defaulting to [] when unset,
   mirroring flomni's corr_pos_y/corr_angle_y/etc. exactly. This
   supersedes a shallower getattr()-based band-aid from an earlier,
   uncommitted attempt at this fix. As a bonus, correction data now
   persists across BEC client restarts, same as flomni's.

Note flomni has no x-correction concept at all (only corr_pos_y/
corr_pos_y_2) -- omny's x-correction is its own thing, not something
copied from flomni.

17 new/updated tests in test_omny_alignment_mixin.py, including an
end-to-end check that reset_correction(use_default_correction=True) now
actually loads the real correction_omny_202204*.txt files.
---
 .../plugins/omny/omny_alignment_mixin.py      |  88 ++++++++++-
 .../test_omny_alignment_mixin.py              | 143 ++++++++++++++++++
 2 files changed, 229 insertions(+), 2 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_alignment_mixin.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_alignment_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_alignment_mixin.py
index ae1f433b..df627113 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_alignment_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_alignment_mixin.py
@@ -1,6 +1,7 @@
 import time
 import numpy as np
 import os
+from pathlib import Path
 
 from rich import box
 from rich.console import Console
@@ -17,8 +18,87 @@ class OMNYAlignmentError(Exception):
 
 
 class OMNYAlignmentMixin:
-    default_correction_file = "correction_omny_202204.txt"
-    default_correction_file_x = "correction_omny_202204_x.txt"
+    # Resolved to an absolute path (mirrors Flomni's default_correction_file
+    # setup) -- a bare relative filename would only ever be found if bec were
+    # launched from this exact plugin directory, silently failing (caught by
+    # the FileNotFoundError handler below) everywhere else.
+    import csaxs_bec
+
+    _csaxs_bec_basepath = Path(csaxs_bec.__file__).parent
+    default_correction_file = (
+        _csaxs_bec_basepath
+        / "bec_ipython_client"
+        / "plugins"
+        / "omny"
+        / "correction_omny_202204.txt"
+    ).resolve()
+    default_correction_file_x = (
+        _csaxs_bec_basepath
+        / "bec_ipython_client"
+        / "plugins"
+        / "omny"
+        / "correction_omny_202204_x.txt"
+    ).resolve()
+    del csaxs_bec
+
+    # additional x/y-correction curves: global-var-backed so they survive a
+    # BEC client restart, same pattern as every other persistent setting in
+    # this class (and matching Flomni's corr_pos_y/corr_angle_y/etc.). NOTE:
+    # must NOT be pre-assigned in OMNY.__init__ -- doing so would overwrite
+    # the persisted value with [] on every restart.
+    @property
+    def corr_pos_x(self):
+        val = self.client.get_global_var("corr_pos_x")
+        return [] if val is None else val
+
+    @corr_pos_x.setter
+    def corr_pos_x(self, val: list):
+        self.client.set_global_var("corr_pos_x", val)
+
+    @property
+    def corr_angle_x(self):
+        val = self.client.get_global_var("corr_angle_x")
+        return [] if val is None else val
+
+    @corr_angle_x.setter
+    def corr_angle_x(self, val: list):
+        self.client.set_global_var("corr_angle_x", val)
+
+    @property
+    def corr_pos_y(self):
+        val = self.client.get_global_var("corr_pos_y")
+        return [] if val is None else val
+
+    @corr_pos_y.setter
+    def corr_pos_y(self, val: list):
+        self.client.set_global_var("corr_pos_y", val)
+
+    @property
+    def corr_angle_y(self):
+        val = self.client.get_global_var("corr_angle_y")
+        return [] if val is None else val
+
+    @corr_angle_y.setter
+    def corr_angle_y(self, val: list):
+        self.client.set_global_var("corr_angle_y", val)
+
+    @property
+    def corr_pos_y_2(self):
+        val = self.client.get_global_var("corr_pos_y_2")
+        return [] if val is None else val
+
+    @corr_pos_y_2.setter
+    def corr_pos_y_2(self, val: list):
+        self.client.set_global_var("corr_pos_y_2", val)
+
+    @property
+    def corr_angle_y_2(self):
+        val = self.client.get_global_var("corr_angle_y_2")
+        return [] if val is None else val
+
+    @corr_angle_y_2.setter
+    def corr_angle_y_2(self, val: list):
+        self.client.set_global_var("corr_angle_y_2", val)
 
     def reset_correction(self, use_default_correction=True):
         """
@@ -215,6 +295,10 @@ class OMNYAlignmentMixin:
         return self._compute_additional_correction(angle, iteration="y2")
 
     def _compute_additional_correction(self, angle, iteration="y1"):
+        # corr_pos_x/corr_pos_y/corr_pos_y_2 etc. are global-var-backed
+        # properties that default to [] -- never AttributeError, even before
+        # reset_correction() has ever run (e.g. testing scan mechanics before
+        # any sample transfer).
         if iteration == "x1":
             corr_pos = self.corr_pos_x
             corr_angle = self.corr_angle_x
diff --git a/tests/tests_bec_ipython_client/test_omny_alignment_mixin.py b/tests/tests_bec_ipython_client/test_omny_alignment_mixin.py
new file mode 100644
index 00000000..9ef20684
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_alignment_mixin.py
@@ -0,0 +1,143 @@
+"""Regression test for OMNYAlignmentMixin's correction data.
+
+corr_pos_x/corr_angle_x/corr_pos_y/etc. used to be plain instance attributes,
+only ever assigned inside reset_correction() -- calling
+_compute_additional_correction() before reset_correction() had ever run (e.g.
+tomo_scan_projection() called to test scan mechanics without first doing a
+sample transfer, the only place reset_correction() gets called, see
+omny_sample_transfer_mixin.py's otransfer_put_sample()) raised
+'OMNY' object has no attribute 'corr_pos_x'.
+
+They are now global-var-backed properties (mirroring Flomni's
+corr_pos_y/corr_angle_y/etc.), defaulting to [] when unset -- matching the
+graceful "no data available" handling _compute_additional_correction()
+already had for an empty (but present) list, and persisting across BEC
+client restarts like every other setting in this class.
+
+Also regression-guards default_correction_file/default_correction_file_x
+being resolved to an absolute path (a bare relative filename would only ever
+be found if bec were launched from this exact plugin directory).
+"""
+
+import os
+
+import pytest
+
+from csaxs_bec.bec_ipython_client.plugins.omny.omny_alignment_mixin import OMNYAlignmentMixin
+
+
+class FakeClient:
+    """Minimal in-memory stand-in for BEC's global-var store."""
+
+    def __init__(self):
+        self._vars = {}
+
+    def get_global_var(self, key):
+        return self._vars.get(key)
+
+    def set_global_var(self, key, value):
+        self._vars[key] = value
+
+
+def make_alignment():
+    # bare instance, deliberately never calling reset_correction() -- mirrors
+    # a fresh OMNY session where no sample has been transferred in yet
+    align = OMNYAlignmentMixin()
+    align.client = FakeClient()
+    return align
+
+
+def test_default_correction_files_are_absolute_and_exist():
+    assert os.path.isabs(OMNYAlignmentMixin.default_correction_file)
+    assert os.path.isabs(OMNYAlignmentMixin.default_correction_file_x)
+    assert os.path.exists(OMNYAlignmentMixin.default_correction_file)
+    assert os.path.exists(OMNYAlignmentMixin.default_correction_file_x)
+
+
+@pytest.mark.parametrize(
+    "attr",
+    ["corr_pos_x", "corr_angle_x", "corr_pos_y", "corr_angle_y", "corr_pos_y_2", "corr_angle_y_2"],
+)
+def test_correction_properties_default_to_empty_list(attr):
+    align = make_alignment()
+
+    assert getattr(align, attr) == []
+
+
+@pytest.mark.parametrize("iteration", ["x1", "y1", "y2"])
+def test_compute_additional_correction_returns_zero_when_never_reset(iteration, capsys):
+    align = make_alignment()
+
+    result = align._compute_additional_correction(45.0, iteration=iteration)
+
+    assert result == 0
+    assert "No data available" in capsys.readouterr().out
+
+
+def test_compute_additional_correction_x_does_not_raise():
+    align = make_alignment()
+
+    assert align.compute_additional_correction_x(0.0) == 0
+
+
+def test_compute_additional_correction_y_does_not_raise():
+    align = make_alignment()
+
+    assert align.compute_additional_correction_y(0.0) == 0
+
+
+def test_compute_additional_correction_y_2_does_not_raise():
+    align = make_alignment()
+
+    assert align.compute_additional_correction_y_2(0.0) == 0
+
+
+def test_compute_additional_correction_still_works_after_reset():
+    """Once corr_pos_x/corr_angle_x etc. are actually set (mirrors what
+    reset_correction() -> read_additional_correction_x() would do), the
+    normal closest-angle lookup still works."""
+    align = make_alignment()
+    align.corr_pos_x = [1.0, 2.0, 3.0]
+    align.corr_angle_x = [0.0, 90.0, 180.0]
+
+    result = align._compute_additional_correction(85.0, iteration="x1")
+
+    assert result == 2.0
+
+
+def test_correction_properties_persist_across_instances_via_shared_client():
+    """Global-var-backed: two instances sharing the same client see the same
+    value, unlike a plain instance attribute."""
+    client = FakeClient()
+    align_a = OMNYAlignmentMixin()
+    align_a.client = client
+    align_b = OMNYAlignmentMixin()
+    align_b.client = client
+
+    align_a.corr_pos_x = [5.0]
+
+    assert align_b.corr_pos_x == [5.0]
+
+
+def test_reset_correction_with_default_loads_real_file_data():
+    """End-to-end check of the path-resolution fix: reset_correction(True)
+    must actually find and load the real correction_omny_202204*.txt files
+    (previously silently failed everywhere except when bec happened to be
+    launched from this exact plugin directory)."""
+    align = make_alignment()
+
+    align.reset_correction(use_default_correction=True)
+
+    assert len(align.corr_pos_x) > 0
+    assert len(align.corr_pos_y) > 0
+
+
+def test_reset_correction_without_default_clears_to_empty():
+    align = make_alignment()
+    align.corr_pos_x = [1.0]
+    align.corr_angle_x = [0.0]
+
+    align.reset_correction(use_default_correction=False)
+
+    assert align.corr_pos_x == []
+    assert align.corr_angle_x == []

From 68896a8ea237f863ecdf146f092ec2c7c1892274 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 20:27:57 +0200
Subject: [PATCH 011/102] fix(omny): let OmnyFermatScan.corridor_size accept
 None, auto-estimate

omny_fermat_scan.py's corridor_size was Annotated[float] = 3, never
updated to accept None the way flomni_fermat_scan.py's already does.
But omny.py's tomo_scan_projection() calling code passes
corridor_size=None whenever omny.corridor_size (a property defaulting
to -1) hasn't been set to a positive value -- producing
ScanInputValidationError: Invalid type for scan argument 'corridor_size':
None is neither float or int.

Ported flomni's fix directly: corridor_size is now
Annotated[float | None] = None, capped at the new MAX_CORRIDOR_SIZE
(3 um) class constant if a caller passes something larger, and
prepare_scan() now calls the same _estimate_corridor_size() static
method flomni uses (median nearest-neighbor distance * 1.5, capped at
MAX_CORRIDOR_SIZE) to pick a sensible corridor size from the actual
scan positions whenever corridor_size is None, instead of crashing.

2 new tests for _estimate_corridor_size() in test_omny_fermat_scan.py.
---
 csaxs_bec/scans/omny_fermat_scan.py        | 39 ++++++++++++++++++++--
 tests/tests_scans/test_omny_fermat_scan.py | 23 +++++++++++++
 2 files changed, 59 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/scans/omny_fermat_scan.py b/csaxs_bec/scans/omny_fermat_scan.py
index 55a7a391..0a40d64b 100644
--- a/csaxs_bec/scans/omny_fermat_scan.py
+++ b/csaxs_bec/scans/omny_fermat_scan.py
@@ -20,6 +20,8 @@ import time
 from typing import Annotated
 
 import numpy as np
+from scipy.spatial import cKDTree
+
 from bec_lib import messages
 from bec_lib.logger import bec_logger
 from bec_lib.scan_args import DefaultArgType, ScanArgument, Units
@@ -44,6 +46,8 @@ class OmnyFermatScan(ScanBase):
     # It must be a valid Python identifier, that is, it can only contain letters, numbers, and underscores, and must not start with a number.
     scan_name = "omny_fermat_scan"
 
+    MAX_CORRIDOR_SIZE = 3  # Corridor size is capped at this value (in um) for stability
+
     gui_config = {
         "Scan Parameters": [
             "fovx",
@@ -68,7 +72,7 @@ class OmnyFermatScan(ScanBase):
         step: Annotated[float, ScanArgument(display_name="Step", description="Step size.", units=Units.µm)],
         zshift: Annotated[float, ScanArgument(display_name="Zshift", description="Shift in z.", units=Units.µm)],
         angle: Annotated[float | None, ScanArgument(display_name="Angle", description="Rotation angle (will rotate first)", units=Units.deg)] = None,
-        corridor_size: Annotated[float, ScanArgument(display_name="Corridor Size", description="Corridor size for the corridor optimization. ", units=Units.µm)] = 3,
+        corridor_size: Annotated[float | None, ScanArgument(display_name="Corridor Size", description="Corridor size for the corridor optimization. ", units=Units.µm)] = None,
         exp_time: DefaultArgType.ExposureTime = 0,
         frames_per_trigger: DefaultArgType.FramesPerTrigger = 1,
         readout_time: DefaultArgType.ReadoutTime = 0,
@@ -86,7 +90,7 @@ class OmnyFermatScan(ScanBase):
             step (float): Step size.
             zshift (float): Shift in z.
             angle (float | None): Rotation angle (will rotate first)
-            corridor_size (float): Corridor size for the corridor optimization.
+            corridor_size (float | None): Corridor size for the corridor optimization.
             exp_time (float): Exposure time in seconds
             frames_per_trigger (int): Number of frames per trigger for devices that support configurable frame counts per trigger.
             readout_time (float): Configuration for devices that support configurable readout times.
@@ -115,6 +119,13 @@ class OmnyFermatScan(ScanBase):
             logger.warning("The zshift is smaller than -100 um. It will be limited to -100 um.")
             self.zshift = -100
 
+        if self.corridor_size is not None and self.corridor_size > self.MAX_CORRIDOR_SIZE:
+            logger.warning(
+                f"The corridor_size is larger than {self.MAX_CORRIDOR_SIZE} um. It will be"
+                f" limited to {self.MAX_CORRIDOR_SIZE} um."
+            )
+            self.corridor_size = self.MAX_CORRIDOR_SIZE
+
         self.update_scan_info(
             exp_time=exp_time, frames_per_trigger=frames_per_trigger, readout_time=readout_time
         )
@@ -144,8 +155,12 @@ class OmnyFermatScan(ScanBase):
                 f"The number of positions must exceed 20. Currently: {len(positions)}."
             )
 
+        corridor_size = self.corridor_size
+        if corridor_size is None:
+            corridor_size = min(self._estimate_corridor_size(positions), self.MAX_CORRIDOR_SIZE)
+
         self.positions = self.components.optimize_trajectory(
-            positions=positions, corridor_size=self.corridor_size, optimization_type="corridor"
+            positions=positions, corridor_size=corridor_size, optimization_type="corridor"
         )
         flip_axes = self.reverse_trajectory()
         if flip_axes:
@@ -330,6 +345,24 @@ class OmnyFermatScan(ScanBase):
         positions.append(right_upper_corner)
         return np.array(positions)
 
+    @staticmethod
+    def _estimate_corridor_size(positions: np.ndarray, factor: float = 1.5) -> float:
+        """
+        Estimate the corridor size based on the median nearest-neighbor distance
+        of the positions, matching the estimation used by the corridor path
+        optimizer if no corridor_size is provided.
+
+        Args:
+            positions (np.ndarray): Array of positions
+            factor (float): Scaling factor for the median distance
+
+        Returns:
+            float: Estimated corridor size
+        """
+        tree = cKDTree(positions[:, :2])
+        dists, _ = tree.query(positions[:, :2], k=2)  # k=1 is itself
+        return factor * np.median(dists[:, 1])
+
     def prepare_setup(self):
         self.dev.rtx.controller.clear_trajectory_generator()
 
diff --git a/tests/tests_scans/test_omny_fermat_scan.py b/tests/tests_scans/test_omny_fermat_scan.py
index 089afd71..a7187b55 100644
--- a/tests/tests_scans/test_omny_fermat_scan.py
+++ b/tests/tests_scans/test_omny_fermat_scan.py
@@ -1,5 +1,7 @@
 from unittest import mock
 
+import numpy as np
+
 from csaxs_bec.scans.omny_fermat_scan import OmnyFermatScan
 
 
@@ -42,3 +44,24 @@ def test_omny_rotation_moves_when_setpoint_matches_but_readback_far_off():
     OmnyFermatScan.omny_rotation(scan, 10.0)
 
     scan.actions.set.assert_called_once()
+
+
+def test_estimate_corridor_size_returns_positive_value_for_regular_grid():
+    # 10x10 grid, 1 um spacing -> nearest-neighbor distance is 1 um everywhere
+    xs, ys = np.meshgrid(np.arange(10), np.arange(10))
+    positions = np.column_stack([xs.ravel(), ys.ravel(), np.zeros(xs.size)])
+
+    result = OmnyFermatScan._estimate_corridor_size(positions)
+
+    assert result > 0
+    assert np.isclose(result, 1.5, atol=1e-6)  # factor=1.5 * median nn-distance (1.0)
+
+
+def test_estimate_corridor_size_scales_with_factor():
+    xs, ys = np.meshgrid(np.arange(5), np.arange(5))
+    positions = np.column_stack([xs.ravel(), ys.ravel(), np.zeros(xs.size)])
+
+    default_factor = OmnyFermatScan._estimate_corridor_size(positions)
+    doubled_factor = OmnyFermatScan._estimate_corridor_size(positions, factor=3.0)
+
+    assert np.isclose(doubled_factor, 2 * default_factor)

From 5281812b6992e545db0530e2887b06b27c8d5aa2 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 20:39:20 +0200
Subject: [PATCH 012/102] feat(omny): start osamroy sim at logical 0, speed up
 all sim stages 4x

- osamroy's sim_initial_position is now -25 (raw), so the simulated
  logical readback (raw + 25, per the controller's calibration-mark
  offset) starts at ~0 deg instead of 25 -- no rotation-to-zero needed
  just from starting a session.
- All 21 SimOMNYGalilMotor axes now have an explicit sim_velocity, set
  to 4x their previous implicit default (the _SimGalilAxis fallback of
  5.0 * 25600 = 128000 steps/s). 10.0 for the 20 translation axes
  (stppermm=51200); 5.716463414632019 for osamroy specifically, since
  its stppermm=89565.8666667 differs -- both correspond to the same
  512000 steps/s, i.e. a genuine 4x speedup for every stage.
---
 .../simulated_omny/simulated_omny.yaml        | 23 ++++++++++++++++++-
 1 file changed, 22 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index aaa710ab..ab2abaa7 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -163,6 +163,7 @@ ofzpx:
     - 0
     port: 8081
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: -0.4317
   enabled: true
   onFailure: buffer
@@ -185,6 +186,7 @@ ofzpy:
     - 0
     port: 8081
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0.7944
   enabled: true
   onFailure: buffer
@@ -207,6 +209,7 @@ ofzpz:
     - 0
     port: 8081
     sign: -1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -228,6 +231,7 @@ otransx:
     - 0
     port: 8081
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -249,6 +253,7 @@ otransy:
     - 0
     port: 8081
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -271,6 +276,7 @@ otransz:
     - 0
     port: 8081
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -292,6 +298,7 @@ osamx:
     - 0
     port: 8082
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: -0.1
   enabled: true
   onFailure: buffer
@@ -313,6 +320,7 @@ osamz:
     - 0
     port: 8082
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: false
   onFailure: buffer
@@ -334,6 +342,7 @@ oosay:
     - 0
     port: 8082
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -356,6 +365,7 @@ oosax:
     - 0
     port: 8082
     sign: -1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -378,6 +388,7 @@ oosaz:
     - 0
     port: 8082
     sign: -1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -400,6 +411,7 @@ oparkz:
     - 0
     port: 8082
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -421,6 +433,7 @@ oshuttleopen:
     - 0
     port: 8082
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -442,6 +455,7 @@ oshuttlealign:
     - 0
     port: 8082
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -463,6 +477,7 @@ osamy:
     - 0
     port: 8083
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -484,6 +499,7 @@ otracky:
     - 0
     port: 8083
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -505,7 +521,8 @@ osamroy:
     - 0
     port: 8083
     sign: 1
-    sim_initial_position: 0
+    sim_velocity: 5.716463414632019
+    sim_initial_position: -25
   enabled: true
   onFailure: buffer
   readOnly: false
@@ -526,6 +543,7 @@ otrackz:
     - 0
     port: 8083
     sign: -1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -547,6 +565,7 @@ oeyex:
     - 0
     port: 8083
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -568,6 +587,7 @@ oeyez:
     - 0
     port: 8083
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -589,6 +609,7 @@ oeyey:
     - 0
     port: 8083
     sign: 1
+    sim_velocity: 10.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer

From 68a56607b8a0f816e4c6c9271b66710914120bbd Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 21:27:43 +0200
Subject: [PATCH 013/102] fix(omny): fix scan hang -- RT flyer typo, add
 missing tracker-signal guard

Two bugs found by comparing omny's RT-flyer code against flomni's (per
Mirko, since flomni/lamni's fermat scans already work fine in sim).

1. Root cause of the reported scan hang (tomo_scan_projection() starts a
   scan but the progress bar freezes at 0% forever, no error):
   RtOMNYFlyer.read_positions_from_sampler() called self.get_scan_status()
   instead of self.controller.get_scan_status(). get_scan_status() only
   exists on RtOMNYController, never on RtOMNYFlyer -- so this line raised
   an AttributeError inside the background thread complete() spawns for
   readout. An uncaught exception in a thread target doesn't propagate;
   the thread just dies silently, before ever calling status.set_finished().
   scan_core()'s `while not status.done` loop then spins forever, and since
   the thread died before ever updating progress, the bar stays at 0%.
   Confirmed correct in both RtFlomniFlyer's and RtLamniFlyer's equivalents
   already; fixed to match.

2. RtOMNYSetpointSignal._socket_set() never had the laser-tracker-signal-
   strength guard RtFlomniSetpointSignal._socket_set() got in commit
   68320e1 ("check tracker signal before rt move, which is otherwise stuck
   forever") -- a real-hardware failure mode (a move issued with a weak
   interferometer signal never converges). OMNY has its own duplicate
   setpoint-signal class, so the fix never propagated. Ported using OMNY's
   own existing laser_tracker_check_and_wait_for_signalstrength() (a more
   capable, retrying/auto-readjusting check) rather than flomni's
   single-shot version, which OMNY doesn't have. Lower confidence this one
   is the actual cause of the reported *simulated* hang specifically --
   the sim doesn't model signal-dependent convergence -- but it's a real,
   confirmed gap worth closing for real-hardware safety regardless.

4 new regression tests in tests/tests_devices/test_rt_omny.py, including
one that directly confirms the fake stand-in used for bug #1's test would
have caught the original bug (raises AttributeError the same way the real
class would).
---
 csaxs_bec/devices/omny/rt/rt_omny_ophyd.py | 10 ++-
 tests/tests_devices/test_rt_omny.py        | 90 ++++++++++++++++++++++
 2 files changed, 99 insertions(+), 1 deletion(-)
 create mode 100644 tests/tests_devices/test_rt_omny.py

diff --git a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
index 70c905b1..ba69da8f 100644
--- a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
@@ -930,6 +930,12 @@ class RtOMNYSetpointSignal(RtSetpointSignal):
                 "The interferometer feedback is not running. Either it is turned off or and"
                 " interferometer error occured."
             )
+        # Mirrors flomni's RtFlomniSetpointSignal._socket_set() (commit 68320e1, "check
+        # tracker signal before rt move, which is otherwise stuck forever"): moving with a
+        # weak interferometer signal can leave the real stage never converging on target,
+        # hanging the caller forever. Reuses OMNY's own wait-and-auto-readjust check rather
+        # than flomni's single-shot version, which OMNY doesn't have.
+        self.parent.controller.laser_tracker_check_and_wait_for_signalstrength()
         self.set_with_feedback_disabled(val)
 
     def set_with_feedback_disabled(self, val):
@@ -1258,7 +1264,9 @@ class RtOMNYFlyer(Device):
         self.average_stdeviations_x_st_fzp = 0
         self.average_stdeviations_y_st_fzp = 0
 
-        mode, number_of_positions_planned, current_position_in_scan = self.get_scan_status()
+        mode, number_of_positions_planned, current_position_in_scan = (
+            self.controller.get_scan_status()
+        )
         while mode > 0 and not self.shutdown_event.wait(0.01):
             # logger.info(f"Current scan position {current_position_in_scan} out of {number_of_positions_planned}")
             mode, number_of_positions_planned, current_position_in_scan = (
diff --git a/tests/tests_devices/test_rt_omny.py b/tests/tests_devices/test_rt_omny.py
new file mode 100644
index 00000000..1cd48be4
--- /dev/null
+++ b/tests/tests_devices/test_rt_omny.py
@@ -0,0 +1,90 @@
+"""Regression tests for two RT-flyer bugs in rt_omny_ophyd.py, found by comparing
+against flomni's (working) equivalents:
+
+1. RtOMNYFlyer.read_positions_from_sampler() called self.get_scan_status() instead
+   of self.controller.get_scan_status() -- get_scan_status() only exists on
+   RtOMNYController, never on RtOMNYFlyer itself. This raised an AttributeError
+   inside the background readout thread started by complete(); since an
+   uncaught exception in a thread target doesn't propagate, the thread died
+   silently before ever calling status.set_finished(), hanging the scan
+   forever at 0% progress (scan_core()'s `while not status.done` loop never
+   exits). flomni's and lamni's equivalents were already correct.
+
+2. RtOMNYSetpointSignal._socket_set() never checked the interferometer signal
+   strength before moving, unlike RtFlomniSetpointSignal._socket_set() (added
+   in commit 68320e1, "check tracker signal before rt move, which is
+   otherwise stuck forever") -- a real-hardware failure mode where a move
+   issued with a weak signal never converges. OMNY has its own duplicate
+   setpoint-signal class, so the fix never propagated.
+"""
+
+from unittest import mock
+
+import pytest
+
+from csaxs_bec.devices.omny.rt.rt_omny_ophyd import RtOMNYFlyer, RtOMNYSetpointSignal
+
+
+class _FakeFlyerSelf:
+    """Minimal stand-in for RtOMNYFlyer -- deliberately has no get_scan_status of
+    its own (matching the real class), so a regression to `self.get_scan_status()`
+    (instead of `self.controller.get_scan_status()`) raises AttributeError here too,
+    the same way it would on the real class.
+    """
+
+    def __init__(self):
+        self.controller = mock.MagicMock()
+        self.shutdown_event = mock.MagicMock()
+        self.average_stdeviations_x_st_fzp = 0
+        self.average_stdeviations_y_st_fzp = 0
+        self.progress = mock.MagicMock()
+        self.data = mock.MagicMock()
+
+
+def test_read_positions_from_sampler_uses_controller_get_scan_status():
+    fake_self = _FakeFlyerSelf()
+    # mode=0 -> the `while mode > 0` loop body never runs; falls straight to the
+    # shutdown-event check below it
+    fake_self.controller.get_scan_status.return_value = (0, 0, 0)
+    fake_self.shutdown_event.wait.return_value = True
+    status = mock.MagicMock()
+
+    RtOMNYFlyer.read_positions_from_sampler(fake_self, status)
+
+    fake_self.controller.get_scan_status.assert_called_once()
+    status.set_finished.assert_called_once()
+
+
+def test_read_positions_from_sampler_would_have_raised_on_the_old_bug():
+    """Sanity-check that _FakeFlyerSelf actually catches the regression: calling
+    the buggy `self.get_scan_status()` form directly must raise AttributeError."""
+    fake_self = _FakeFlyerSelf()
+    with pytest.raises(AttributeError):
+        fake_self.get_scan_status()
+
+
+def test_socket_set_checks_laser_tracker_before_moving():
+    fake_self = mock.MagicMock()
+    fake_self.parent.controller.feedback_is_running.return_value = True
+    call_order = []
+    fake_self.parent.controller.laser_tracker_check_and_wait_for_signalstrength.side_effect = (
+        lambda: call_order.append("check")
+    )
+    fake_self.set_with_feedback_disabled.side_effect = lambda val: call_order.append("move")
+
+    RtOMNYSetpointSignal._socket_set(fake_self, 10.0)
+
+    assert call_order == ["check", "move"]
+    fake_self.parent.controller.laser_tracker_check_and_wait_for_signalstrength.assert_called_once()
+    fake_self.set_with_feedback_disabled.assert_called_once_with(10.0)
+
+
+def test_socket_set_raises_when_feedback_not_running():
+    fake_self = mock.MagicMock()
+    fake_self.parent.controller.feedback_is_running.return_value = False
+
+    with pytest.raises(Exception):
+        RtOMNYSetpointSignal._socket_set(fake_self, 10.0)
+
+    fake_self.parent.controller.laser_tracker_check_and_wait_for_signalstrength.assert_not_called()
+    fake_self.set_with_feedback_disabled.assert_not_called()

From 49ade7ce98829ad01ba73ea675057a5290e05f4c Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 21:51:46 +0200
Subject: [PATCH 014/102] feat(omny): modernize gui_tools.py to flomni's
 current dock/window API

OMNYGuiTools still used pre-modernization code: a gui_window handle that
was never actually populated (self.gui.windows["main"].widget always
raised/returned None), the old two-level add_dock().add_widget() API, and
bare `if self.figN is None` checks instead of an _is_deleted()-aware
guard. omnygui_show_progress() crashed with AttributeError as soon as it
was exercised live.

Ported OMNYGuiTools onto flomni's current single-level .new() pattern:
split __init__()/set_client(), a window-reuse check keyed on
self.gui.windows, _omnygui_is_missing() for dock-reuse (verbatim port of
flomni's _is_deleted()-based guard), the current RingProgressBar API for
omnygui_show_progress(), and new omnygui_show_xeyealign()/
omnygui_show_xeyealign_fittab()/omnygui_show_cameras() methods. cam_xeye
is not part of omny's device config (unlike flomni's), so the xeyealign
live-view toggle is guarded with an existence check instead of copied
unconditionally. omnygui_show_cameras() adds a hard-stop console targeting
otransy, the closest omny analog to flomni's ftransy.

Also fixes two independently-broken call sites in x_ray_eye_align.py
(self.lamni.lamnigui_show_xeyealign[_fittab]() -> the omny-side method
names actually defined on OMNYGuiTools -- self.lamni is really the OMNY
instance) that were raising AttributeError before the GUI code was even
reached. The rest of that file's LamNI-derived content is left alone; a
full rewrite is tracked separately.

omny.py's __init__ now calls OMNYGuiTools.__init__(self) + set_client(),
matching the split-constructor pattern instead of the old single-call
OMNYGuiTools.__init__(self, self.client).

Deliberately deferred: flomni's ETA/heartbeat progress fields
(tomo_start_time, heartbeat, estimated_remaining_time, etc.) are not
ported -- omny's self.progress dict only has 7 basic fields. Noted in
omny/AI_docs/OPEN_ISSUES.md so it isn't forgotten; not a crash risk since
omny_webpage_generator.py already reads these defensively.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  14 +
 .../plugins/omny/gui_tools.py                 | 285 +++++++++++-------
 .../bec_ipython_client/plugins/omny/omny.py   |   3 +-
 .../plugins/omny/x_ray_eye_align.py           |  46 +--
 .../test_omny_gui_tools.py                    | 106 +++++++
 5 files changed, 319 insertions(+), 135 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_gui_tools.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index ee91ca86..6dd51135 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -105,6 +105,20 @@ Still completely untested (not attempted yet, not known-broken — just unexplor
   yet — out of scope for the sim-validation work, in scope for the eventual macro-
   standardization pass.
 
+## gui_tools.py progress fields (deferred on purpose)
+
+`gui_tools.py` was modernized to flomni's current single-level `.new()` / `_is_deleted()`-guard
+pattern (window lifecycle, xray-eye-align GUI, cameras + hard-stop console, `RingProgressBar`).
+One piece was deliberately **not** ported: flomni's `self.progress` dict carries
+`tomo_start_time`/`heartbeat`/`estimated_remaining_time`/`estimated_finish_time` plus a
+`_describe_active_hook()` method feeding an ETA/heartbeat line in `_flomnigui_update_progress()`.
+omny's `self.progress` (set up in `OMNY.__init__`, `omny.py`) still only has the original 7 fields
+(`subtomo`, `subtomo_projection`, `subtomo_total_projections`, `projection`,
+`total_projections`, `angle`, `tomo_type`) and `_omnygui_update_progress()` was written against
+just those. Mirko's call: keep it simple for this pass, revisit later. Not a crash risk —
+`omny_webpage_generator.py` already reads the ETA-ish fields defensively via `.get()`, degrading
+to "N/A" when absent, and that file is unwired/dead code anyway (see below).
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index 89ef27f5..d2a41535 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -1,12 +1,16 @@
 import builtins
+import time
 
-# from csaxs_bec.bec_ipython_client.plugins.cSAXS import epics_get, epics_put, fshopen, fshclose
+from bec_lib import bec_logger
+
+logger = bec_logger.logger
 
 if builtins.__dict__.get("bec") is not None:
     bec = builtins.__dict__.get("bec")
     dev = builtins.__dict__.get("dev")
     scans = builtins.__dict__.get("scans")
 
+
 def umv(*args):
     return scans.umv(*args, relative=False)
 
@@ -16,76 +20,184 @@ class OMNYGuiToolsError(Exception):
 
 
 class OMNYGuiTools:
+    # Screen assumed 2560x1440. Window is right-aligned with a small margin
+    # from the top, matching flomni's gui_tools.py convention.
+    _SCREEN_WIDTH = 2560
+    _WINDOW_WIDTH = 1500
+    _WINDOW_HEIGHT = 850
+    _WINDOW_TOP_MARGIN = 50
 
-    def __init__(self, client):
-        self.gui = getattr(client, "gui", None)
-        # No "main" BEC-widgets window exists yet in --nogui sessions, or before
-        # a GUI has actually been opened; fall back to None like flomni's
-        # GuiTools does (self.flomni_window, lazily populated by
-        # flomnigui_show_gui()), instead of crashing OMNY's construction.
-        try:
-            self.gui_window = self.gui.windows["main"].widget
-        except (KeyError, AttributeError):
-            self.gui_window = None
+    def __init__(self):
+        self.omny_window = None
+        self.text_box = None
+        self.progressbar = None
+        self.xeyegui = None
+        self.idle_text_box = None
         self.fig200 = None
         self.fig201 = None
         self.fig202 = None
         self.fig203 = None
-        self.progressbar = None
-        self.text_box = None
-        self.idle_text_box = None
+        self.console = None
+
+    def set_client(self, client):
+        self.client = client
+        self.gui = getattr(client, "gui", None)
 
     def omnygui_show_gui(self):
-        self.gui_window.show()
+        if "omny" in self.gui.windows:
+            self.omny_window = self.gui.windows["omny"]
+            self.gui.omny.raise_window()
+        else:
+            # geometry: (pos_x, pos_y, w, h)
+            pos_x = self._SCREEN_WIDTH - self._WINDOW_WIDTH
+            geometry = (pos_x, self._WINDOW_TOP_MARGIN, self._WINDOW_WIDTH, self._WINDOW_HEIGHT)
+            self.omny_window = self.gui.new("omny", geometry=geometry)
+            time.sleep(1)
 
     def omnygui_stop_gui(self):
-        self.gui_window.hide()
+        self.gui.omny.hide()
+
+    def omnygui_raise(self):
+        self.gui.omny.raise_window()
+
+    def _omnygui_is_missing(self, attribute_name):
+        widget = getattr(self, attribute_name, None)
+        if widget is None:
+            return True
+        if hasattr(widget, "_is_deleted") and widget._is_deleted():
+            return True
+        return False
+
+    def _omnycam_check_device_exists(self, device):
+        try:
+            device
+        except:
+            return False
+        else:
+            return True
+
+    def omnygui_show_xeyealign(self):
+        self.omnygui_show_gui()
+        if self._omnygui_is_missing("xeyegui"):
+            self.omnygui_remove_all_docks()
+            self.xeyegui = self.gui.omny.new("OMNY_XRayEye", object_name="xrayeye")
+        # cam_xeye is not (yet) part of omny's device config -- guard rather
+        # than assume it exists, unlike flomni's unconditional version.
+        if "cam_xeye" in dev and not dev.cam_xeye.live_mode_enabled.get():
+            dev.cam_xeye.live_mode_enabled.put(True)
+        self.xeyegui.switch_tab("alignment")
+
+    def omnygui_show_xeyealign_fittab(self):
+        self.omnygui_show_gui()
+        if self._omnygui_is_missing("xeyegui"):
+            self.omnygui_remove_all_docks()
+            self.xeyegui = self.gui.omny.new("OMNY_XRayEye", object_name="xrayeye")
+        self.xeyegui.switch_tab("fit")
 
     def _omnycam_parking(self):
         self.omnygui_show_omnycam_parking()
 
     def omnygui_show_omnycam_parking(self):
         self.omnygui_show_gui()
-        if self.fig200 is None:
-            self._omnycam_clear()
-            self.fig200 = self.gui_window.add_dock(name="omnycam200").add_widget("BECImageWidget")
+        if self._omnygui_is_missing("fig200") or self._omnygui_is_missing("fig203"):
+            self.omnygui_remove_all_docks()
+            self.fig200 = self.gui.omny.new("BECImageWidget")
             if self._omnycam_check_device_exists(dev.cam200):
                 fig = self.fig200.image("cam200")
                 fig.set_rotation(deg_90=3)
                 self.fig200.lock_aspect_ratio(True)
             else:
                 print("Cannot open cam200. Device does not exist.")
-            self.fig203 = self.gui_window.add_dock(name="omnycam203").add_widget("BECImageWidget")
+            self.fig203 = self.gui.omny.new("BECImageWidget")
             if self._omnycam_check_device_exists(dev.cam203):
                 fig = self.fig203.image("cam203")
                 fig.set_rotation(deg_90=3)
                 self.fig203.lock_aspect_ratio(True)
             else:
                 print("Cannot open cam203. Device does not exist.")
-            try:
-                self.gui_window.remove_dock(name="default_figure")
-            except:
-                pass
+
+    def _omnycam_samplestage(self):
+        self.omnygui_show_omnycam_samplestage()
+
+    def omnygui_show_omnycam_samplestage(self):
+        self.omnygui_show_gui()
+        if self._omnygui_is_missing("fig201") or self._omnygui_is_missing("fig202"):
+            self.omnygui_remove_all_docks()
+            self.fig201 = self.gui.omny.new("BECImageWidget")
+            if self._omnycam_check_device_exists(dev.cam201):
+                fig = self.fig201.image("cam201")
+                fig.set_rotation(deg_90=3)
+                self.fig201.lock_aspect_ratio(True)
+            else:
+                print("Cannot open cam201. Device does not exist.")
+            self.fig202 = self.gui.omny.new("BECImageWidget")
+            if self._omnycam_check_device_exists(dev.cam202):
+                fig = self.fig202.image("cam202")
+                fig.set_rotation(deg_90=3)
+                self.fig202.lock_aspect_ratio(True)
+            else:
+                print("Cannot open cam202. Device does not exist.")
+
+    def omnygui_show_cameras(self):
+        """General camera view + hard-stop console, the omny analog of
+        flomni's flomnigui_show_cameras(). Distinct from
+        omnygui_show_omnycam_parking()/omnygui_show_omnycam_samplestage()
+        above, which are omny's own pre-existing, narrower parking/
+        samplestage-specific views -- left untouched.
+        """
+        self.omnygui_show_gui()
+        if (
+            self._omnygui_is_missing("fig200")
+            or self._omnygui_is_missing("fig203")
+            or self._omnygui_is_missing("console")
+        ):
+            self.omnygui_remove_all_docks()
+            self.fig200 = self.gui.omny.new("BECImageWidget")
+            if self._omnycam_check_device_exists(dev.cam200):
+                fig = self.fig200.image("cam200")
+                fig.set_rotation(deg_90=3)
+                self.fig200.lock_aspect_ratio(True)
+            else:
+                print("Cannot open cam200. Device does not exist.")
+            self.fig203 = self.gui.omny.new("BECImageWidget")
+            if self._omnycam_check_device_exists(dev.cam203):
+                fig = self.fig203.image("cam203")
+                fig.set_rotation(deg_90=3)
+                self.fig203.lock_aspect_ratio(True)
+            else:
+                print("Cannot open cam203. Device does not exist.")
+
+            # Hard-stop console, docked below the cameras. otransy is the
+            # closest omny analog to flomni's ftransy (both the transfer-Y
+            # axis) -- no secondary/extra stop device wired yet (Mirko's
+            # call, revisit once a second candidate is confirmed).
+            self.console = self.gui.omny.new(
+                "z_ConsoleButtonsWidget",
+                object_name="console",
+                where="bottom",
+                hard_stop_device_name="otransy",
+                hard_stop_label="OMNY Motion Stop",
+            )
+            self.gui.omny.set_layout_ratios(vertical=[5, 1])
 
     def omnygui_remove_all_docks(self):
-        self.gui_window.clear_all()
+        if hasattr(self.gui, "omny"):
+            self.gui.omny.delete_all()
+        self.progressbar = None
+        self.text_box = None
+        self.xeyegui = None
+        self.idle_text_box = None
         self.fig200 = None
         self.fig201 = None
         self.fig202 = None
         self.fig203 = None
-        self.progressbar = None
-        self.text_box = None
-        self.idle_text_box = None
+        self.console = None
 
     def omnygui_idle(self):
         self.omnygui_show_gui()
-        if self.idle_text_box is None:
+        if self._omnygui_is_missing("idle_text_box"):
             self.omnygui_remove_all_docks()
-            self.idle_text_box = self.gui_window.add_dock(name="idle_text").add_widget("TextBox")
-            try:
-                self.gui_window.remove_dock(name="default_figure")
-            except:
-                pass
+            self.idle_text_box = self.gui.omny.new("TextBox")
         text = (
             "<pre>"
             + "██████╗ ███████╗ ██████╗      ██████╗ ███╗   ███╗███╗   ██╗██╗   ██╗\n"
@@ -98,79 +210,50 @@ class OMNYGuiTools:
         )
         self.idle_text_box.set_html_text(text)
 
-    def _omnycam_clear(self):
-        self.omnygui_remove_all_docks()
-
-    def _omnycam_check_device_exists(self, device):
-        try:
-            device
-        except:
-            return False
-        else:
-            return True
-
-    def _omnycam_samplestage(self):
-        self.omnygui_show_omnycam_samplestage()
-
-    def omnygui_show_omnycam_samplestage(self):
-        self.omnygui_show_gui()
-        if self.fig201 is None:
-            self.omnygui_remove_all_docks()
-            self.fig201 = self.gui_window.add_dock(name="omnycam201").add_widget("BECImageWidget")
-            if self._omnycam_check_device_exists(dev.cam201):
-                fig = self.fig201.image("cam201")
-                fig.set_rotation(deg_90=3)
-                self.fig201.lock_aspect_ratio(True)
-            else:
-                print("Cannot open cam201. Device does not exist.")
-            self.fig202 = self.gui_window.add_dock(name="omnycam202").add_widget("BECImageWidget")
-            if self._omnycam_check_device_exists(dev.cam202):
-                fig = self.fig202.image("cam202")
-                fig.set_rotation(deg_90=3)
-                self.fig202.lock_aspect_ratio(True)
-            else:
-                print("Cannot open cam202. Device does not exist.")
-            try:
-                self.gui_window.remove_dock(name="default_figure")
-            except:
-                pass
-
     def omnygui_show_progress(self):
-        self.omnygui_show_gui()
-        if self.progressbar is None:
-            self.omnygui_remove_all_docks()
-            # Add a new dock with a RingProgressBar widget
-            self.progressbar = self.gui_window.add_dock(name="progress").add_widget(
-                "RingProgressBar"
-            )
-            # Customize the size of the progress ring
-            self.progressbar.set_line_widths(20)
-            # Disable automatic updates and manually set the self.progressbar value
-            self.progressbar.enable_auto_updates(False)
-            # Set precision for the self.progressbar display
-            self.progressbar.set_precision(1)  # Display self.progressbar with one decimal places
-            # Setting multiple rigns with different values
-            self.progressbar.set_number_of_bars(3)
-            self.progressbar.rings[2].set_update("scan")
-            # Set the values of the rings to 50, 75, and 25 from outer to inner ring
-            # self.progressbar.set_value([50, 75])
-            # Add a new dock with a TextBox widget
-            self.text_box = self.gui_window.add_dock(name="progress_text").add_widget("TextBox")
-            try:
-                self.gui_window.remove_dock(name="default_figure")
-            except:
-                pass
-        self._omnygui_update_progress()
+        try:
+            self.omnygui_show_gui()
+            if self._omnygui_is_missing("progressbar"):
+                self.omnygui_remove_all_docks()
+                self.progressbar = self.gui.omny.new("RingProgressBar")
+                # Two manually-updated rings: overall tomogram progress and
+                # subtomo progress. Unlike flomni's third, auto-updating
+                # "scan"-linked ring, and unlike flomni's ETA/heartbeat/
+                # active-hook text, omny's progress dict doesn't carry that
+                # data yet (see omny/AI_docs/OPEN_ISSUES.md) -- kept simple
+                # here on purpose, revisit once that's ported.
+                self.progressbar.add_ring().set_update("manual")
+                self.progressbar.add_ring().set_update("manual")
+            self._omnygui_update_progress()
+        except Exception as e:
+            logger.warning(f"Error in omnygui_show_progress: {e}")
 
     def _omnygui_update_progress(self):
-        if self.progressbar is not None:
+        try:
+            if self.progressbar is None:
+                logger.warning("OMNY progress GUI update skipped: progressbar is not available.")
+                return
+            main_progress_ring = self.progressbar.rings[0]
+            subtomo_progress_ring = self.progressbar.rings[1]
             progress = self.progress["projection"] / self.progress["total_projections"] * 100
-            subotmo_progress = (
+            subtomo_progress = (
                 self.progress["subtomo_projection"]
                 / self.progress["subtomo_total_projections"]
                 * 100
             )
-            self.progressbar.set_value([progress, subotmo_progress])
+            main_progress_ring.set_value(progress)
+            subtomo_progress_ring.set_value(subtomo_progress)
 
-            text = f"Progress report:\n Tomo type: ....................... {self.progress['tomo_type']}\n Projection: ...................... {self.progress['projection']:.0f}\n Total projections expected ....... {self.progress['total_projections']}\n Angle: ........................... {self.progress['angle']}\n Current subtomo: ................. {self.progress['subtomo']}\n Current projection within subtomo: {self.progress['subtomo_projection']}\n Total projections per subtomo: ... {self.progress['subtomo_total_projections']}"
-            self.text_box.set_plain_text(text)
+            text = (
+                f"Progress report:\n"
+                f" Tomo type:  {self.progress['tomo_type']}\n"
+                f" Projection:  {self.progress['projection']:.0f}\n"
+                f" Total projections expected  {self.progress['total_projections']:.1f}\n"
+                f" Angle:  {self.progress['angle']:.1f}\n"
+                f" Current subtomo:  {self.progress['subtomo']}\n"
+                f" Current projection within subtomo: {self.progress['subtomo_projection']}\n"
+                f" Total projections per subtomo:  {int(self.progress['subtomo_total_projections'])}"
+            )
+            self.progressbar.set_center_label(text)
+        except Exception as exc:
+            logger.warning(f"OMNY progress GUI update skipped: {exc}")
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index b8530a5b..b0df048f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -596,7 +596,8 @@ class OMNY(
         self.OMNYTools = OMNYTools(self.client)
         OMNY_rt_client.__init__(self)
         self.align = XrayEyeAlign(self.client, self)
-        OMNYGuiTools.__init__(self, self.client)
+        OMNYGuiTools.__init__(self)
+        self.set_client(self.client)
 
     def start_x_ray_eye_alignment(self):
         if self.OMNYTools.yesno(
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py b/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py
index 868d5c6f..55a1ee29 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/x_ray_eye_align.py
@@ -79,7 +79,7 @@ class XrayEyeAlign:
     # ------------------------------------------------------------------
 
     def _reset_init_values(self):
-        self.shift_xy = [0.0, 0.0]   # base shift to bring sample to beam centre [µm]
+        self.shift_xy = [0.0, 0.0]  # base shift to bring sample to beam centre [µm]
         self._xray_fov_xy = [0.0, 0.0]
 
     def tomo_rotate(self, val: float):
@@ -161,7 +161,7 @@ class XrayEyeAlign:
             Compute x/y offsets, push to GUI fit tab, wait for DAP fit,
             then load fit parameters into the global variable store.
         """
-        self.lamni.lamnigui_show_xeyealign()
+        self.lamni.omnygui_show_xeyealign()
         self.send_message("Getting things ready. Please wait...")
 
         self.gui.enable_submit_button(False)
@@ -188,14 +188,8 @@ class XrayEyeAlign:
         k = 0
         while True:
             if dev.omny_xray_gui.submit.get() == 1:
-                val_x = (
-                    getattr(dev.omny_xray_gui, f"xval_x_{k}").get()
-                    * self.PIXEL_CALIBRATION
-                )
-                val_y = (
-                    getattr(dev.omny_xray_gui, f"yval_y_{k}").get()
-                    * self.PIXEL_CALIBRATION
-                )
+                val_x = getattr(dev.omny_xray_gui, f"xval_x_{k}").get() * self.PIXEL_CALIBRATION
+                val_y = getattr(dev.omny_xray_gui, f"yval_y_{k}").get() * self.PIXEL_CALIBRATION
                 self.alignment_values[k] = [val_x, val_y]
                 print(
                     f"Clicked position {k}: "
@@ -242,15 +236,11 @@ class XrayEyeAlign:
                     self.gui.enable_submit_button(False)
 
                     self.scans.lamni_move_to_scan_center(
-                        self.shift_xy[0] / 1000,
-                        self.shift_xy[1] / 1000,
-                        self.get_tomo_angle(),
+                        self.shift_xy[0] / 1000, self.shift_xy[1] / 1000, self.get_tomo_angle()
                     ).wait()
                     time.sleep(1)
                     self.scans.lamni_move_to_scan_center(
-                        self.shift_xy[0] / 1000,
-                        self.shift_xy[1] / 1000,
-                        self.get_tomo_angle(),
+                        self.shift_xy[0] / 1000, self.shift_xy[1] / 1000, self.get_tomo_angle()
                     ).wait()
 
                     dev.omny_xray_gui.angle.set(self.get_tomo_angle())
@@ -274,16 +264,12 @@ class XrayEyeAlign:
                     self._disable_rt_feedback()
                     self.tomo_rotate(approach_angle)
                     self.scans.lamni_move_to_scan_center(
-                        self.shift_xy[0] / 1000,
-                        self.shift_xy[1] / 1000,
-                        self.get_tomo_angle(),
+                        self.shift_xy[0] / 1000, self.shift_xy[1] / 1000, self.get_tomo_angle()
                     ).wait()
                     self._disable_rt_feedback()
                     self.tomo_rotate(target_angle)
                     self.scans.lamni_move_to_scan_center(
-                        self.shift_xy[0] / 1000,
-                        self.shift_xy[1] / 1000,
-                        self.get_tomo_angle(),
+                        self.shift_xy[0] / 1000, self.shift_xy[1] / 1000, self.get_tomo_angle()
                     ).wait()
 
                     dev.omny_xray_gui.angle.set(self.get_tomo_angle())
@@ -317,9 +303,7 @@ class XrayEyeAlign:
                     self.shift_xy[0] += _mvx
                     self.shift_xy[1] += _mvy
                     self.scans.lamni_move_to_scan_center(
-                        self.shift_xy[0] / 1000,
-                        self.shift_xy[1] / 1000,
-                        self.get_tomo_angle(),
+                        self.shift_xy[0] / 1000, self.shift_xy[1] / 1000, self.get_tomo_angle()
                     ).wait()
                     print(
                         f"Current centre: "
@@ -350,7 +334,7 @@ class XrayEyeAlign:
         self.client.set_global_var("tomo_fov_offset", self.shift_xy)
 
         # Switch GUI to fit tab and wait for DAP to finish fitting
-        self.lamni.lamnigui_show_xeyealign_fittab()
+        self.lamni.omnygui_show_xeyealign_fittab()
         print("Waiting 5 s for DAP sinusoidal fit to converge...")
         time.sleep(5)
 
@@ -399,12 +383,8 @@ class XrayEyeAlign:
             f.write("angle\thorizontal\tvertical\n")
             for k in range(1, 9):
                 angle_deg = LAMNI_ALIGNMENT_ANGLES[k - 1]
-                x_off = (
-                    self.alignment_values[1][0] - self.alignment_values[k][0]
-                ) * 1000
-                y_off = (
-                    self.alignment_values[k][1] - self.alignment_values[1][1]
-                ) * 1000
+                x_off = (self.alignment_values[1][0] - self.alignment_values[k][0]) * 1000
+                y_off = (self.alignment_values[k][1] - self.alignment_values[1][1]) * 1000
                 f.write(f"{angle_deg}\t{x_off:.4f}\t{y_off:.4f}\n")
                 print(
                     f"  Angle {angle_deg:3d} deg: "
@@ -428,4 +408,4 @@ class XrayEyeAlign:
 
         # Push to XRayEye widget: feeds waveform_x (row 1) and waveform_y (row 2)
         self.gui.submit_fit_array(data)
-        print(f"Fit data submitted with shape {data.shape}:\n{data}")
\ No newline at end of file
+        print(f"Fit data submitted with shape {data.shape}:\n{data}")
diff --git a/tests/tests_bec_ipython_client/test_omny_gui_tools.py b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
new file mode 100644
index 00000000..4786e180
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
@@ -0,0 +1,106 @@
+"""Unit tests for OMNYGuiTools, ported to flomni's current set_client()/
+_is_deleted()-guard pattern. Focused on the pure-logic pieces that don't
+require a real bec_widgets/Qt GUI: the dock-reuse guard and the
+cam_xeye existence guard in omnygui_show_xeyealign() (omny's device config
+has no cam_xeye device, unlike flomni's)."""
+
+from unittest import mock
+
+from csaxs_bec.bec_ipython_client.plugins.omny.gui_tools import OMNYGuiTools
+
+# pylint: disable=protected-access
+
+GUI_TOOLS = "csaxs_bec.bec_ipython_client.plugins.omny.gui_tools"
+
+
+def _make_gui_tools():
+    tools = OMNYGuiTools()
+    client = mock.MagicMock()
+    tools.set_client(client)
+    return tools, client
+
+
+def test_omnygui_is_missing_true_when_never_set():
+    tools, _ = _make_gui_tools()
+    assert tools._omnygui_is_missing("xeyegui") is True
+
+
+def test_omnygui_is_missing_true_when_deleted():
+    tools, _ = _make_gui_tools()
+    widget = mock.MagicMock()
+    widget._is_deleted.return_value = True
+    tools.xeyegui = widget
+    assert tools._omnygui_is_missing("xeyegui") is True
+
+
+def test_omnygui_is_missing_false_for_live_widget():
+    tools, _ = _make_gui_tools()
+    widget = mock.MagicMock()
+    widget._is_deleted.return_value = False
+    tools.xeyegui = widget
+    assert tools._omnygui_is_missing("xeyegui") is False
+
+
+def test_omnygui_is_missing_false_when_no_is_deleted_method():
+    tools, _ = _make_gui_tools()
+    tools.xeyegui = object()
+    assert tools._omnygui_is_missing("xeyegui") is False
+
+
+def test_omnygui_show_xeyealign_skips_cam_xeye_when_not_configured():
+    """omny has no cam_xeye device configured -- must not raise when dev
+    lacks it, unlike flomni's unconditional live_mode_enabled toggle."""
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    new_widget = mock.MagicMock()
+    client.gui.omny.new.return_value = new_widget
+
+    dev_mock = mock.MagicMock()
+    dev_mock.__contains__ = mock.Mock(return_value=False)
+
+    with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
+        tools.omnygui_show_xeyealign()
+
+    new_widget.switch_tab.assert_called_once_with("alignment")
+
+
+def test_omnygui_show_xeyealign_enables_live_mode_when_cam_xeye_present():
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    new_widget = mock.MagicMock()
+    client.gui.omny.new.return_value = new_widget
+
+    dev_mock = mock.MagicMock()
+    dev_mock.__contains__ = mock.Mock(return_value=True)
+    dev_mock.cam_xeye.live_mode_enabled.get.return_value = False
+
+    with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
+        tools.omnygui_show_xeyealign()
+
+    dev_mock.cam_xeye.live_mode_enabled.put.assert_called_once_with(True)
+    new_widget.switch_tab.assert_called_once_with("alignment")
+
+
+def test_omnygui_show_gui_reuses_existing_window():
+    tools, client = _make_gui_tools()
+    existing_window = mock.MagicMock()
+    client.gui.windows = {"omny": existing_window}
+
+    tools.omnygui_show_gui()
+
+    client.gui.new.assert_not_called()
+    client.gui.omny.raise_window.assert_called_once()
+    assert tools.omny_window is existing_window
+
+
+def test_omnygui_show_gui_creates_new_window_when_absent():
+    tools, client = _make_gui_tools()
+    client.gui.windows = {}
+    new_window = mock.MagicMock()
+    client.gui.new.return_value = new_window
+
+    with mock.patch(f"{GUI_TOOLS}.time.sleep"):
+        tools.omnygui_show_gui()
+
+    client.gui.new.assert_called_once()
+    assert tools.omny_window is new_window

From c802104f6da10ce095103e0db7f0af58c4ed8350 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Tue, 1 Sep 2026 22:19:46 +0200
Subject: [PATCH 015/102] fix(omny): fix stale widget-API bugs in gui_tools.py
 cameras/xray-eye, add cam_xeye

Live testing of the previous gui_tools.py port (49ade7c) hit two further crashes:

1. omnygui_show_xeyealign() -> ValueError: Device 'cam_xeye' not found in current
   BEC session. The OMNY_XRayEye widget (shared verbatim with flomni) hardcodes
   CAMERA = ("cam_xeye", "image") as a module constant -- it isn't configurable
   per-beamline, so omny needs its own cam_xeye device or the widget can never be
   constructed. Added cam_xeye to simulated_omny.yaml (hand-added, duplicating
   flomni's real cam_xeye's camera_id/pixel_calibration as placeholders; SimIDSCamera
   already accepts both camera_id and the legacy camera_ID key omny's other cameras
   use). ptycho_omny.yaml intentionally left untouched -- the real hardware camera ID
   and pixel calibration for OMNY's x-ray-eye camera are unknown; noted as a followup
   in OPEN_ISSUES.md, including that a future regen of simulated_omny.yaml from
   ptycho_omny.yaml will drop this hand-added block until the real config has one too.

2. omnygui_show_omnycam_parking() -> ValueError: Unknown widget type: BECImageWidget.
   That string was carried over unmodified from omny's pre-modernization code, not
   from flomni's current gui_tools.py (whose current class name is "Image"). Beyond
   the widget name, the per-camera calls inside were also stale: fig.set_rotation(
   deg_90=3) doesn't exist on the current Image/ImageBase widget at all (replaced by
   the num_rotation_90 property), and self.figN.lock_aspect_ratio(True) called a
   property as a function. Ported omnygui_show_omnycam_parking()/
   omnygui_show_omnycam_samplestage() onto flomni's current per-camera pattern
   (image(device=, signal="preview"), num_rotation_90/lock_aspect_ratio as
   properties, start_live_mode()), preserving the existing 3x90 rotation for
   cam200/cam203 (physical mount) and no rotation for cam201/cam202, unchanged from
   before.

Also removed omnygui_show_cameras() (added last pass, modeled on flomni's single
generic camera view): redundant now that both existing parking/samplestage views got
the current API, since omny -- unlike flomni -- already has two purpose-built camera
views. Its hard-stop console (z_ConsoleButtonsWidget, targeting otransy) now lives
directly in both omnygui_show_omnycam_parking() and omnygui_show_omnycam_samplestage()
instead.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  20 ++++
 .../plugins/omny/gui_tools.py                 | 103 ++++++++----------
 .../simulated_omny/simulated_omny.yaml        |  24 ++++
 .../test_omny_gui_tools.py                    |  59 ++++++++++
 4 files changed, 149 insertions(+), 57 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 6dd51135..1f043c8d 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -119,6 +119,26 @@ just those. Mirko's call: keep it simple for this pass, revisit later. Not a cra
 `omny_webpage_generator.py` already reads the ETA-ish fields defensively via `.get()`, degrading
 to "N/A" when absent, and that file is unwired/dead code anyway (see below).
 
+## cam_xeye device (simulated only, real hardware config still needed)
+
+`omnygui_show_xeyealign()` uses the shared `OMNY_XRayEye` widget
+(`csaxs_bec/bec_widgets/widgets/xray_eye/x_ray_eye.py`), which hardcodes `CAMERA = ("cam_xeye",
+"image")` as a module-level constant -- the device name isn't configurable per-beamline. omny's
+config had no `cam_xeye` device at all, so simply calling `omnygui_show_xeyealign()` failed with
+`ValueError: Device 'cam_xeye' not found in current BEC session` as soon as the widget was
+constructed. Added a `cam_xeye` entry to `simulated_omny.yaml` (hand-added, not generated --
+`ptycho_omny.yaml`, the generator's source, has no such device), reusing flomni's real `cam_xeye`'s
+`camera_id`/`pixel_calibration` as placeholders (`SimIDSCamera` accepts both `camera_id` and the
+legacy `camera_ID` key omny's other sim cameras use). **Two follow-ups still needed before real
+hardware use:**
+- `ptycho_omny.yaml` needs a real `cam_xeye` entry with OMNY's actual x-ray-eye camera hardware
+  `camera_id` and measured `pixel_calibration` (mm/pixel) -- unknown to me, needs Mirko.
+- `simulated_omny.yaml` is regenerated by `bin/generate_simulated_configs.py` from
+  `ptycho_omny.yaml`; since `cam_xeye` isn't in the real config yet, a regen will drop this
+  hand-added block until the real config also has one (matches the existing pattern for
+  `sim_velocity`/`sim_initial_position` hand-additions elsewhere in this file, already present
+  before this session).
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index d2a41535..037a1eff 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -98,53 +98,6 @@ class OMNYGuiTools:
         self.omnygui_show_omnycam_parking()
 
     def omnygui_show_omnycam_parking(self):
-        self.omnygui_show_gui()
-        if self._omnygui_is_missing("fig200") or self._omnygui_is_missing("fig203"):
-            self.omnygui_remove_all_docks()
-            self.fig200 = self.gui.omny.new("BECImageWidget")
-            if self._omnycam_check_device_exists(dev.cam200):
-                fig = self.fig200.image("cam200")
-                fig.set_rotation(deg_90=3)
-                self.fig200.lock_aspect_ratio(True)
-            else:
-                print("Cannot open cam200. Device does not exist.")
-            self.fig203 = self.gui.omny.new("BECImageWidget")
-            if self._omnycam_check_device_exists(dev.cam203):
-                fig = self.fig203.image("cam203")
-                fig.set_rotation(deg_90=3)
-                self.fig203.lock_aspect_ratio(True)
-            else:
-                print("Cannot open cam203. Device does not exist.")
-
-    def _omnycam_samplestage(self):
-        self.omnygui_show_omnycam_samplestage()
-
-    def omnygui_show_omnycam_samplestage(self):
-        self.omnygui_show_gui()
-        if self._omnygui_is_missing("fig201") or self._omnygui_is_missing("fig202"):
-            self.omnygui_remove_all_docks()
-            self.fig201 = self.gui.omny.new("BECImageWidget")
-            if self._omnycam_check_device_exists(dev.cam201):
-                fig = self.fig201.image("cam201")
-                fig.set_rotation(deg_90=3)
-                self.fig201.lock_aspect_ratio(True)
-            else:
-                print("Cannot open cam201. Device does not exist.")
-            self.fig202 = self.gui.omny.new("BECImageWidget")
-            if self._omnycam_check_device_exists(dev.cam202):
-                fig = self.fig202.image("cam202")
-                fig.set_rotation(deg_90=3)
-                self.fig202.lock_aspect_ratio(True)
-            else:
-                print("Cannot open cam202. Device does not exist.")
-
-    def omnygui_show_cameras(self):
-        """General camera view + hard-stop console, the omny analog of
-        flomni's flomnigui_show_cameras(). Distinct from
-        omnygui_show_omnycam_parking()/omnygui_show_omnycam_samplestage()
-        above, which are omny's own pre-existing, narrower parking/
-        samplestage-specific views -- left untouched.
-        """
         self.omnygui_show_gui()
         if (
             self._omnygui_is_missing("fig200")
@@ -152,25 +105,61 @@ class OMNYGuiTools:
             or self._omnygui_is_missing("console")
         ):
             self.omnygui_remove_all_docks()
-            self.fig200 = self.gui.omny.new("BECImageWidget")
+            self.fig200 = self.gui.omny.new("Image")
             if self._omnycam_check_device_exists(dev.cam200):
-                fig = self.fig200.image("cam200")
-                fig.set_rotation(deg_90=3)
-                self.fig200.lock_aspect_ratio(True)
+                self.fig200.image(device="cam200", signal="preview")
+                self.fig200.num_rotation_90 = 3
+                self.fig200.lock_aspect_ratio = True
+                dev.cam200.start_live_mode()
             else:
                 print("Cannot open cam200. Device does not exist.")
-            self.fig203 = self.gui.omny.new("BECImageWidget")
+            self.fig203 = self.gui.omny.new("Image")
             if self._omnycam_check_device_exists(dev.cam203):
-                fig = self.fig203.image("cam203")
-                fig.set_rotation(deg_90=3)
-                self.fig203.lock_aspect_ratio(True)
+                self.fig203.image(device="cam203", signal="preview")
+                self.fig203.num_rotation_90 = 3
+                self.fig203.lock_aspect_ratio = True
+                dev.cam203.start_live_mode()
             else:
                 print("Cannot open cam203. Device does not exist.")
 
             # Hard-stop console, docked below the cameras. otransy is the
             # closest omny analog to flomni's ftransy (both the transfer-Y
-            # axis) -- no secondary/extra stop device wired yet (Mirko's
-            # call, revisit once a second candidate is confirmed).
+            # axis) -- no secondary/extra stop device wired yet.
+            self.console = self.gui.omny.new(
+                "z_ConsoleButtonsWidget",
+                object_name="console",
+                where="bottom",
+                hard_stop_device_name="otransy",
+                hard_stop_label="OMNY Motion Stop",
+            )
+            self.gui.omny.set_layout_ratios(vertical=[5, 1])
+
+    def _omnycam_samplestage(self):
+        self.omnygui_show_omnycam_samplestage()
+
+    def omnygui_show_omnycam_samplestage(self):
+        self.omnygui_show_gui()
+        if (
+            self._omnygui_is_missing("fig201")
+            or self._omnygui_is_missing("fig202")
+            or self._omnygui_is_missing("console")
+        ):
+            self.omnygui_remove_all_docks()
+            self.fig201 = self.gui.omny.new("Image")
+            if self._omnycam_check_device_exists(dev.cam201):
+                self.fig201.image(device="cam201", signal="preview")
+                self.fig201.lock_aspect_ratio = True
+                dev.cam201.start_live_mode()
+            else:
+                print("Cannot open cam201. Device does not exist.")
+            self.fig202 = self.gui.omny.new("Image")
+            if self._omnycam_check_device_exists(dev.cam202):
+                self.fig202.image(device="cam202", signal="preview")
+                self.fig202.lock_aspect_ratio = True
+                dev.cam202.start_live_mode()
+            else:
+                print("Cannot open cam202. Device does not exist.")
+
             self.console = self.gui.omny.new(
                 "z_ConsoleButtonsWidget",
                 object_name="console",
diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index ab2abaa7..46925f66 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -60,6 +60,30 @@ cam203:
   readoutPriority: async
   deviceTags:
     - simulated_omny
+# Hand-added (not part of the generated ptycho_omny.yaml source -- OMNY has no cam_xeye
+# entry in the real config yet). The OMNY_XRayEye widget hardcodes the device name
+# "cam_xeye", so omnygui_show_xeyealign() needs one to exist even in simulation.
+# camera_id/pixel_calibration are placeholders duplicated from flomni's real cam_xeye
+# (simulated_flomni.yaml); see omny/AI_docs/OPEN_ISSUES.md for the real-hardware follow-up.
+cam_xeye:
+  description: Camera OMNY Xray eye (simulated, placeholder)
+  deviceClass: csaxs_bec.devices.sim.sim_cameras.SimIDSCamera
+  deviceConfig:
+    camera_id: 11
+    bits_per_pixel: 24
+    num_rotation_90: 0
+    transpose: true
+    force_monochrome: true
+    m_n_colormode: 1
+    sim_noise_std: 0
+  enabled: true
+  onFailure: buffer
+  readOnly: false
+  readoutPriority: async
+  userParameter:
+    pixel_calibration: 0.00044247787610619477   # mm/pixel, placeholder (flomni's value)
+  deviceTags:
+    - simulated_omny
 rtx:
   description: OMNY rt
   deviceClass: csaxs_bec.devices.sim.sim_omny.SimRtOMNYMotor
diff --git a/tests/tests_bec_ipython_client/test_omny_gui_tools.py b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
index 4786e180..5e02edc7 100644
--- a/tests/tests_bec_ipython_client/test_omny_gui_tools.py
+++ b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
@@ -104,3 +104,62 @@ def test_omnygui_show_gui_creates_new_window_when_absent():
 
     client.gui.new.assert_called_once()
     assert tools.omny_window is new_window
+
+
+def test_omnygui_show_cameras_was_removed():
+    """omnygui_show_cameras() duplicated omnygui_show_omnycam_parking() (both just
+    showed cam200/cam203) and was dropped -- the console now lives directly in the
+    parking/samplestage views instead."""
+    assert not hasattr(OMNYGuiTools, "omnygui_show_cameras")
+
+
+def test_omnygui_show_omnycam_parking_uses_current_image_widget_api():
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    fig200 = mock.MagicMock()
+    fig203 = mock.MagicMock()
+    console = mock.MagicMock()
+    client.gui.omny.new.side_effect = [fig200, fig203, console]
+
+    dev_mock = mock.MagicMock()
+
+    with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
+        tools.omnygui_show_omnycam_parking()
+
+    client.gui.omny.new.assert_any_call("Image")
+    fig200.image.assert_called_once_with(device="cam200", signal="preview")
+    assert fig200.num_rotation_90 == 3
+    assert fig200.lock_aspect_ratio is True
+    dev_mock.cam200.start_live_mode.assert_called_once()
+    fig203.image.assert_called_once_with(device="cam203", signal="preview")
+    dev_mock.cam203.start_live_mode.assert_called_once()
+
+    client.gui.omny.new.assert_any_call(
+        "z_ConsoleButtonsWidget",
+        object_name="console",
+        where="bottom",
+        hard_stop_device_name="otransy",
+        hard_stop_label="OMNY Motion Stop",
+    )
+    assert tools.console is console
+
+
+def test_omnygui_show_omnycam_samplestage_uses_current_image_widget_api():
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    fig201 = mock.MagicMock()
+    fig202 = mock.MagicMock()
+    console = mock.MagicMock()
+    client.gui.omny.new.side_effect = [fig201, fig202, console]
+
+    dev_mock = mock.MagicMock()
+
+    with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
+        tools.omnygui_show_omnycam_samplestage()
+
+    fig201.image.assert_called_once_with(device="cam201", signal="preview")
+    assert fig201.lock_aspect_ratio is True
+    dev_mock.cam201.start_live_mode.assert_called_once()
+    fig202.image.assert_called_once_with(device="cam202", signal="preview")
+    dev_mock.cam202.start_live_mode.assert_called_once()
+    assert tools.console is console

From c37bfc76d62286a3b47d6895e70c2bc8a1db6f1f Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 03:46:52 +0200
Subject: [PATCH 016/102] fix(omny): set cam200-203/cam_xeye readoutPriority to
 on_request, fixes scan crash

omny.tomo_scan_projection(1) -> omny_fermat_scan crashed with ValueError: 'cam200'
is not in list once a scan actually did a readback-tracked osamroy rotation (the
first time this branch's testing got that far).

Root cause, traced through bec_server + bec_ipython_client core code: omny_fermat_scan's
add_scan_report_instruction_readback(devices=["osamroy"]) registers osamroy as requiring
a response; post_scan()'s complete_all_devices() then batches every enabled+claimable-owned
device into one end-of-scan instruction, including cam200 (readoutPriority: async +
enabled: true default to ownership_mode: "claimable", auto-acquired for any scan unless
readoutPriority is "on_request"). The batched instruction's response flag isn't scoped
per-device, so the server publishes a device-request-status message for cam200 too, under
the same RID the osamroy-only readback progressbar is listening on -- which then crashes
on an unrecognized device name.

cam200/201/202/203 (and cam_xeye, added last pass) are view-only GUI cameras never
referenced by any scan code (confirmed via repo-wide grep). Changing their readoutPriority
to on_request excludes them from the claimable/owned auto-acquire set entirely, fixing the
crash with a config-only change -- and matches flomni's own convention for this same
category of device (cam_flomni_gripper/cam_flomni_overview are both on_request already).
Live-mode GUI streaming (start_live_mode(), used by the parking/samplestage camera views)
is unaffected since it's a dedicated background thread, not driven by readout-priority
scheduling -- flomni's own cameras already prove on_request + live-mode works together.

Applied to both simulated_omny.yaml and the real ptycho_omny.yaml per Mirko: this brings
both configs in line with flomni's convention, not just a sim-only workaround.

The underlying bug (instruction-batch-scoped response flag in scan_actions.py:_send(),
plus missing per-device filtering in ReadbackDataHandler/DeviceProgressBar) is a genuine
bec-core issue, not omny-specific -- flomni's own cam_xeye has the same latent exposure,
untouched here since it's out of this branch's scope. Recorded in omny/AI_docs/OPEN_ISSUES.md
and reported upstream separately.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 37 +++++++++++++++++++
 csaxs_bec/device_configs/ptycho_omny.yaml     |  8 ++--
 .../simulated_omny/simulated_omny.yaml        | 10 ++---
 3 files changed, 46 insertions(+), 9 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 1f043c8d..7e5b3243 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -139,6 +139,43 @@ hardware use:**
   `sim_velocity`/`sim_initial_position` hand-additions elsewhere in this file, already present
   before this session).
 
+## cam200-203 readoutPriority: async caused a scan crash (fixed, bec-core bug found along the way)
+
+`omny.tomo_scan_projection(1)` -> `omny_fermat_scan` crashed with `ValueError: 'cam200' is not in
+list` in `bec_ipython_client`'s `DeviceProgressBar.set_finished()`, once a scan actually did a
+readback-tracked osamroy rotation (the first time this branch got that far). Root cause, traced
+through bec_server + bec_ipython_client core code:
+
+- `omny_fermat_scan.py`'s `add_scan_report_instruction_readback(devices=["osamroy"], ...)`
+  registers `osamroy` as requiring a response.
+- `post_scan()`'s `complete_all_devices()` batches **every enabled+claimable-owned device** into
+  one instruction -- including `cam200`, because `readoutPriority: async` + `enabled: true` default
+  to `ownership_mode: "claimable"`, and claimable async-priority devices are auto-acquired for any
+  scan **unless** their `readoutPriority` is `"on_request"` (`bec_server/.../scan_actions.py:
+  1148-1188`).
+- The batched instruction's `response=True` flag is set because *any* device in the batch needs a
+  response (`scan_actions.py:_send()`, not scoped per-device) -- so the server publishes a
+  `DeviceReqStatusMessage` for cam200 too, under the same RID the osamroy-only readback progressbar
+  is listening on.
+- `ReadbackDataHandler.on_req_status()` (`bec_ipython_client/.../move_device.py`) filters by RID
+  only, not by device, so it records cam200's status even though this progressbar only tracks
+  `["osamroy"]`, and `DeviceProgressBar.set_finished()` crashes on `self.devices.index("cam200")`.
+
+**Fixed** by changing `cam200`/`cam201`/`cam202`/`cam203` from `readoutPriority: async` to
+`on_request` in both `simulated_omny.yaml` and `ptycho_omny.yaml` (also applied to the `cam_xeye`
+added earlier this session) -- `on_request` is explicitly excluded from the claimable/owned
+auto-acquire set, and is also the semantically correct value for these view-only cameras (never
+referenced by any scan code), matching flomni's own `cam_flomni_gripper`/`cam_flomni_overview`
+convention. Live-mode GUI streaming (`start_live_mode()`) is unaffected -- it's a dedicated
+background thread, not driven by readout-priority scheduling.
+
+**Not fixed, out of scope here**: this is a genuine bec-core bug (steps 3-4 above -- an
+instruction-batch-scoped response flag combined with device-unfiltered status handling
+client-side), not something specific to omny. flomni's own `cam_xeye` (`ptycho_flomni.yaml`,
+`readoutPriority: async`, untouched by this session) has the exact same latent exposure and would
+hit the same crash the first time a flomni scan does an actual (non-"already at angle") rotation
+with cam_xeye enabled. Reported upstream as feedback; not something csaxs_bec can fix directly.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/device_configs/ptycho_omny.yaml b/csaxs_bec/device_configs/ptycho_omny.yaml
index 9580b7b1..d68d9aac 100755
--- a/csaxs_bec/device_configs/ptycho_omny.yaml
+++ b/csaxs_bec/device_configs/ptycho_omny.yaml
@@ -12,7 +12,7 @@ cam200:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - ptycho_omny
 
@@ -27,7 +27,7 @@ cam201:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - ptycho_omny
 
@@ -42,7 +42,7 @@ cam202:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - ptycho_omny
 
@@ -57,7 +57,7 @@ cam203:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - ptycho_omny
 
diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index 46925f66..199d010e 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -15,7 +15,7 @@ cam200:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - simulated_omny
 cam201:
@@ -29,7 +29,7 @@ cam201:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - simulated_omny
 cam202:
@@ -43,7 +43,7 @@ cam202:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - simulated_omny
 cam203:
@@ -57,7 +57,7 @@ cam203:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   deviceTags:
     - simulated_omny
 # Hand-added (not part of the generated ptycho_omny.yaml source -- OMNY has no cam_xeye
@@ -79,7 +79,7 @@ cam_xeye:
   enabled: true
   onFailure: buffer
   readOnly: false
-  readoutPriority: async
+  readoutPriority: on_request
   userParameter:
     pixel_calibration: 0.00044247787610619477   # mm/pixel, placeholder (flomni's value)
   deviceTags:

From bb5ff0cedf1d5ffa4e9d648d1b1e22460439c93a Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 04:28:50 +0200
Subject: [PATCH 017/102] fix(omny): rotate the root osamroy device, not its
 user_setpoint signal

Live-reproduced (local BEC deployment, real client) that the readoutPriority
fix (c37bfc7) didn't actually fix the readback-progressbar crash -- it just
moved it to a different device (rt_positions instead of cam200), confirming
the earlier diagnosis was incomplete.

Real root cause: omny_rotation() called
self.actions.set(self.dev.osamroy.user_setpoint, angle, wait=False),
passing the user_setpoint Signal sub-component instead of the root device.
ScanActions._normalize_device_name (bec_server) normalizes a sub-signal to
its dotted name ("osamroy.user_setpoint"), which never matches the plain
"osamroy" registered as requiring a response by the preceding
add_scan_report_instruction_readback(devices=["osamroy"], ...) call. So the
rotation's own completion is never reported, and the readback progressbar's
request-status listener stays subscribed for the rest of the scan -- until
post_scan()'s complete_all_devices() batches many unrelated owned devices
into one instruction later, which DOES trigger a response (since the literal
"osamroy" is also in that batch), reporting every device in it and crashing
the still-alive progressbar on whichever one happens to complete first.

Confirmed live this is omny-specific, not a flomni-shared exposure as
previously assumed: flomni_fermat_scan's equivalent flomni_rotation() calls
self.actions.set(self.dev.fsamroy, angle, wait=False) -- the whole root
device -- so its own completion reports correctly and the progressbar exits
cleanly well before complete_all_devices() runs. A live flomni_fermat_scan
run with cam_xeye still async+enabled completed without incident, disproving
the earlier "flomni has the same latent exposure" assumption.

Fixed by matching flomni's pattern exactly. OMNYGalilMotor.move()
(ogalil_ophyd.py) already does self.user_setpoint.put(...) plus proper
completion bookkeeping internally, so setting the root device is a strict
superset of the previous behavior, not a functional change to the move
itself. The readoutPriority change from the previous commit is kept (still
correct, matches flomni's camera convention) even though it wasn't the
actual fix.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 75 +++++++++++--------
 csaxs_bec/scans/omny_fermat_scan.py           |  4 +-
 tests/tests_scans/test_omny_fermat_scan.py    | 11 ++-
 3 files changed, 54 insertions(+), 36 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 7e5b3243..0a192188 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -139,42 +139,53 @@ hardware use:**
   `sim_velocity`/`sim_initial_position` hand-additions elsewhere in this file, already present
   before this session).
 
-## cam200-203 readoutPriority: async caused a scan crash (fixed, bec-core bug found along the way)
+## omny_fermat_scan rotation crashed on an arbitrary device (readback progressbar) (fixed)
 
-`omny.tomo_scan_projection(1)` -> `omny_fermat_scan` crashed with `ValueError: 'cam200' is not in
-list` in `bec_ipython_client`'s `DeviceProgressBar.set_finished()`, once a scan actually did a
-readback-tracked osamroy rotation (the first time this branch got that far). Root cause, traced
-through bec_server + bec_ipython_client core code:
+`omny.tomo_scan_projection(1)` -> `omny_fermat_scan` crashed with `ValueError: '<some device>' is
+not in list` in `bec_ipython_client`'s `DeviceProgressBar.set_finished()`, once a scan actually did
+a readback-tracked osamroy rotation. First seen as `cam200`; changing cam200-203/cam_xeye's
+`readoutPriority` to `on_request` (below) did **not** fix it -- it just changed which device the
+crash landed on (`rt_positions`, confirmed by live reproduction). The `readoutPriority` change is
+still correct/kept (matches flomni's convention for view-only cameras), but it was treating a
+symptom, not the actual bug.
 
-- `omny_fermat_scan.py`'s `add_scan_report_instruction_readback(devices=["osamroy"], ...)`
-  registers `osamroy` as requiring a response.
-- `post_scan()`'s `complete_all_devices()` batches **every enabled+claimable-owned device** into
-  one instruction -- including `cam200`, because `readoutPriority: async` + `enabled: true` default
-  to `ownership_mode: "claimable"`, and claimable async-priority devices are auto-acquired for any
-  scan **unless** their `readoutPriority` is `"on_request"` (`bec_server/.../scan_actions.py:
-  1148-1188`).
-- The batched instruction's `response=True` flag is set because *any* device in the batch needs a
-  response (`scan_actions.py:_send()`, not scoped per-device) -- so the server publishes a
-  `DeviceReqStatusMessage` for cam200 too, under the same RID the osamroy-only readback progressbar
-  is listening on.
-- `ReadbackDataHandler.on_req_status()` (`bec_ipython_client/.../move_device.py`) filters by RID
-  only, not by device, so it records cam200's status even though this progressbar only tracks
-  `["osamroy"]`, and `DeviceProgressBar.set_finished()` crashes on `self.devices.index("cam200")`.
+**Real root cause, confirmed via live reproduction (local BEC deployment, not just static
+reading)**: `omny_fermat_scan.py`'s `omny_rotation()` called
+`self.actions.set(self.dev.osamroy.user_setpoint, angle, wait=False)` -- passing the
+`user_setpoint` **signal sub-component**, not the root device. `ScanActions._normalize_device_name`
+(`bec_server/.../scan_actions.py:1106-1107`) normalizes a `DeviceBase` to its **dotted name** for a
+sub-signal, i.e. `"osamroy.user_setpoint"`, while `add_scan_report_instruction_readback(devices=
+["osamroy"], ...)` (line above) registers the plain string `"osamroy"` as requiring a response.
+Since `{"osamroy.user_setpoint"} & {"osamroy"}` is empty, `_send()` never sets `response=True` on
+the rotation's own instruction -- the device server never reports `"osamroy"` done, so the readback
+progressbar's `ReadbackDataHandler` never sees its request finish and stays subscribed to that RID
+for the rest of the scan. Later, `post_scan()`'s `complete_all_devices()` batches many unrelated
+owned devices into one instruction; because the literal string `"osamroy"` *is* in that later batch
+and still needs a response, `response=True` fires on the **whole batch**, and the device server
+reports every device in it -- which the still-alive progressbar (only tracking `["osamroy"]`)
+receives and crashes on, for whichever device happens to report first (arbitrary -- hence `cam200`
+for Mirko, `rt_positions` in the live repro here).
 
-**Fixed** by changing `cam200`/`cam201`/`cam202`/`cam203` from `readoutPriority: async` to
-`on_request` in both `simulated_omny.yaml` and `ptycho_omny.yaml` (also applied to the `cam_xeye`
-added earlier this session) -- `on_request` is explicitly excluded from the claimable/owned
-auto-acquire set, and is also the semantically correct value for these view-only cameras (never
-referenced by any scan code), matching flomni's own `cam_flomni_gripper`/`cam_flomni_overview`
-convention. Live-mode GUI streaming (`start_live_mode()`) is unaffected -- it's a dedicated
-background thread, not driven by readout-priority scheduling.
+**Confirmed this is omny-specific, not a general/flomni-shared bug** (contrary to my earlier
+assumption): `flomni_fermat_scan.py`'s equivalent `flomni_rotation()` calls
+`self.actions.set(self.dev.fsamroy, angle, wait=False)` -- the whole root device, not a sub-signal
+-- so `_normalize_device_name` returns `"fsamroy"`, matching the required-response registration
+exactly. Live-reproduced: `flomni_fermat_scan` with `cam_xeye` still `readoutPriority: async` and
+enabled completed cleanly (no crash), because the rotation's own completion reports correctly and
+the progressbar exits well before `complete_all_devices()` ever runs.
 
-**Not fixed, out of scope here**: this is a genuine bec-core bug (steps 3-4 above -- an
-instruction-batch-scoped response flag combined with device-unfiltered status handling
-client-side), not something specific to omny. flomni's own `cam_xeye` (`ptycho_flomni.yaml`,
-`readoutPriority: async`, untouched by this session) has the exact same latent exposure and would
-hit the same crash the first time a flomni scan does an actual (non-"already at angle") rotation
-with cam_xeye enabled. Reported upstream as feedback; not something csaxs_bec can fix directly.
+**Fixed** in `omny_fermat_scan.py`'s `omny_rotation()`: `self.actions.set(self.dev.osamroy, angle,
+wait=False)`, matching flomni's pattern exactly. `OMNYGalilMotor.move()`
+(`csaxs_bec/devices/omny/galil/ogalil_ophyd.py`) already does `self.user_setpoint.put(...)` plus
+proper completion bookkeeping internally, so setting the root device is a strict superset of the
+previous behavior, not a functional change to the move itself.
+
+**Not fixed, out of scope, reported upstream as feedback (defense-in-depth, framework-level)**:
+`ReadbackDataHandler.on_req_status()` and `DeviceProgressBar.set_finished()`
+(`bec_ipython_client`) should guard against/ignore a device outside their tracked list rather than
+crash, and `scan_actions.py`'s `_send()` should scope the `response` flag per-device rather than
+per-batched-instruction -- any scan with this same signal-vs-root-device mismatch pattern would hit
+the same failure mode.
 
 ## Environment note (not code, but will bite again if forgotten)
 
diff --git a/csaxs_bec/scans/omny_fermat_scan.py b/csaxs_bec/scans/omny_fermat_scan.py
index 0a40d64b..660bd588 100644
--- a/csaxs_bec/scans/omny_fermat_scan.py
+++ b/csaxs_bec/scans/omny_fermat_scan.py
@@ -391,9 +391,7 @@ class OmnyFermatScan(ScanBase):
         self.actions.add_scan_report_instruction_readback(
             devices=["osamroy"], start=[osamroy_current_setpoint], stop=[angle]
         )
-        self.omny_rotation_status = self.actions.set(
-            self.dev.osamroy.user_setpoint, angle, wait=False
-        )
+        self.omny_rotation_status = self.actions.set(self.dev.osamroy, angle, wait=False)
 
     def prepare_setup_part2(self):
         if self.omny_rotation_status is not None:
diff --git a/tests/tests_scans/test_omny_fermat_scan.py b/tests/tests_scans/test_omny_fermat_scan.py
index a7187b55..f403fcad 100644
--- a/tests/tests_scans/test_omny_fermat_scan.py
+++ b/tests/tests_scans/test_omny_fermat_scan.py
@@ -23,7 +23,16 @@ def test_omny_rotation_moves_when_setpoint_differs():
 
     scan.actions.set.assert_called_once()
     args, kwargs = scan.actions.set.call_args
-    assert args[0] is scan.dev.osamroy.user_setpoint
+    # Must target the root osamroy device, not the user_setpoint sub-signal:
+    # add_scan_report_instruction_readback(devices=["osamroy"]) registers the
+    # plain device name as requiring a response, but self.actions.set() on a
+    # Signal normalizes to a dotted name ("osamroy.user_setpoint") that never
+    # matches "osamroy" -- the rotation's own completion is never reported,
+    # leaving the readback progressbar's request-status listener alive until
+    # complete_all_devices() batches many unrelated devices together later
+    # and crashes on an arbitrary one of them (confirmed live; see
+    # omny/AI_docs/OPEN_ISSUES.md).
+    assert args[0] is scan.dev.osamroy
     assert args[1] == 10.0
     assert kwargs.get("wait") is False
 

From 37d3197f0389181fc13b91c769e9337458cda159 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 07:45:45 +0200
Subject: [PATCH 018/102] docs(omny): note readoutPriority: on_request was kept
 deliberately

Mirko confirmed keeping on_request (not reverting to the original async)
even though it turned out not to be what fixed the omny_fermat_scan crash
-- these cameras are only ever used for live GUI viewing, never read back
in scan code, so async's continuous per-scan logging was likely unused
anyway. Recorded so this doesn't read as leftover cruft later.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md                | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 0a192188..390c5689 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -187,6 +187,16 @@ crash, and `scan_actions.py`'s `_send()` should scope the `response` flag per-de
 per-batched-instruction -- any scan with this same signal-vs-root-device mismatch pattern would hit
 the same failure mode.
 
+**Note on the earlier `readoutPriority: on_request` change (commit `c37bfc7`)**: once this fix
+landed, that change was no longer load-bearing for this crash -- the rotation's own readback
+progressbar now closes out right after the move, so it's no longer still listening when
+`complete_all_devices()` broadcasts later, regardless of cam200-203/cam_xeye's readout priority.
+Asked Mirko whether to revert it back to `async` (original behavior, cameras' frames get
+continuously logged into every scan) now that it's not strictly needed; he chose to **keep
+`on_request`** -- these cameras are only ever used for live GUI viewing (`start_live_mode()`), never
+read back in any scan code, so continuous per-scan logging was likely never useful. Not reverted;
+this is a deliberate choice, not leftover cruft.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-

From e0213697bcf9c0e2c02af4966b9808f8a2c1944e Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 12:15:42 +0200
Subject: [PATCH 019/102] fix(omny): quiet laser tracker check, drop redundant
 call

laser_tracker_check_and_wait_for_signalstrength() used send_client_info()
for its "Checking laser tracker..."/"...completed." messages, which queues
onto the scan's client-message list -- exposing it to a bec_lib bug
(QueueItem.get_client_messages() mutates its list while iterating, so it
skips and later re-delivers leftover messages on an unrelated call; see
OPEN_ISSUES.md, reported upstream). flomni's equivalent,
laser_tracker_check_signalstrength(), has always used plain print()
instead, which never queues and so never hits that bug. Switched omny's
version to match exactly (Mirko's call).

Both check functions run once per RT axis set (via
Rt*SetpointSignal._socket_set()), so a single scan setup (rtx+rtz set
together) already triggered 2 checks; omny_fermat_scan.py's
prepare_setup_part2() had an additional explicit third call, pure
duplication of the same check. Removed it -- one less redundant
laser-tracker wait per scan setup, no loss of the actual safety check
(rtx/rtz are still individually checked via their own set() calls).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 25 +++++++++++++++++
 csaxs_bec/devices/omny/rt/rt_omny_ophyd.py    | 28 +++++++++----------
 csaxs_bec/scans/omny_fermat_scan.py           |  6 ++--
 3 files changed, 43 insertions(+), 16 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 390c5689..69553586 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -197,6 +197,31 @@ continuously logged into every scan) now that it's not strictly needed; he chose
 read back in any scan code, so continuous per-scan logging was likely never useful. Not reverted;
 this is a deliberate choice, not leftover cruft.
 
+## laser_tracker_check_and_wait_for_signalstrength() was chatty (fixed)
+
+Live testing of the first successful omny scan surfaced two odd things at once: a "Summary of
+client messages" printout Mirko had never seen, and client-info messages ("Checking laser
+tracker...") getting reprinted on a later, unrelated call (`tomo_parameters()`). Root cause of the
+*reprint*, live-diagnosed: a genuine `bec_lib` bug (`QueueItem.get_client_messages()` mutates its
+list while iterating -- reported upstream). But the reason it was even *noticeable* is
+omny-specific: `laser_tracker_check_and_wait_for_signalstrength()`
+(`csaxs_bec/devices/omny/rt/rt_omny_ophyd.py`) used `send_client_info()` for its
+"Checking..."/"...completed." pair, which queues onto the scan's client-message list (and is thus
+exposed to the `get_client_messages()` bug), whereas flomni's equivalent,
+`laser_tracker_check_signalstrength()` (`rt_flomni_ophyd.py`), has always used plain `print()`
+(server-side only, never queued, never exposed to that bug). Both mirror each other structurally
+in one other way too: `RtOMNYSetpointSignal._socket_set()`/`RtFlomniSetpointSignal._socket_set()`
+each run this check once per RT axis set -- so a single scan setup (rtx + rtz set together, plus,
+until this fix, an extra explicit call in `omny_fermat_scan.py`'s `prepare_setup_part2()`)
+triggered the check 2-3 times, each producing 2 messages on omny's chatty version vs 0 visible
+output on flomni's silent one.
+
+**Fixed**: switched `laser_tracker_check_and_wait_for_signalstrength()` to plain `print()`
+throughout (matching flomni exactly -- Mirko's explicit call), and removed the now-redundant
+explicit `laser_tracker_check_and_wait_for_signalstrength()` call in `prepare_setup_part2()`
+(pure duplication of the per-axis checks the rtx/rtz `set()` calls already trigger). Net effect:
+quieter output, one less redundant tracker-check wait per scan setup, same safety behavior.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
index ba69da8f..c9cfba05 100644
--- a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
@@ -268,9 +268,15 @@ class RtOMNYController(Controller):
         return self.mirror_parameters[channel]
 
     def laser_tracker_check_and_wait_for_signalstrength(self):
-        self.device_manager.connector.send_client_info(
-            "Checking laser tracker...", scope="", show_asap=True
-        )
+        # Plain print(), not send_client_info(): this runs on every RT setpoint move
+        # (RtOMNYSetpointSignal._socket_set()), so send_client_info() queued a "Checking
+        # laser tracker..."/"...completed." pair per move into the scan's client-message
+        # queue -- multiple times per scan setup -- which is both noisy for the user and
+        # triggers a bec_lib get_client_messages() bug that reprints leftover queued
+        # messages on a later, unrelated call (see omny/AI_docs/OPEN_ISSUES.md). Mirrors
+        # flomni's laser_tracker_check_signalstrength() (rt_flomni_ophyd.py), which has
+        # always used plain print() for this.
+        print("Checking laser tracker...")
         if not self.laser_tracker_check_enabled():
             print(
                 "laser_tracker_check_and_wait_for_signalstrength: The laser tracker is not even enabled."
@@ -285,10 +291,8 @@ class RtOMNYController(Controller):
         low_signal = rtx.user_parameter.get("low_signal")
         wait_counter = 0
         while signal < min_signal and wait_counter < 10:
-            self.device_manager.connector.send_client_info(
-                f"The signal of the tracker {signal} is below the minimum required signal of {min_signal}. Waiting...",
-                scope="laser_tracker_check_and_wait_for_signalstrength",
-                show_asap=True,
+            print(
+                f"The signal of the tracker {signal} is below the minimum required signal of {min_signal}. Waiting..."
             )
 
             wait_counter += 1
@@ -296,16 +300,12 @@ class RtOMNYController(Controller):
             signal = self._omny_interferometer_get_signalsample("ssi_4", 0.1)
 
         if signal < low_signal:
-            self.device_manager.connector.send_client_info(
-                f"\x1b[91mThe signal of the tracker {signal} is below the low limit of {low_signal}. Auto readjustment...\x1b[0m",
-                scope="laser_tracker_check_and_wait_for_signalstrength",
-                show_asap=True,
+            print(
+                f"\x1b[91mThe signal of the tracker {signal} is below the low limit of {low_signal}. Auto readjustment...\x1b[0m"
             )
 
             self.omny_interferometer_align_tracking()
-        self.device_manager.connector.send_client_info(
-            "Checking laser tracker completed.", scope="", show_asap=True
-        )
+        print("Checking laser tracker completed.")
 
     def omny_interferometer_align_tracking(self):
         mirror_channel = 6
diff --git a/csaxs_bec/scans/omny_fermat_scan.py b/csaxs_bec/scans/omny_fermat_scan.py
index 660bd588..11f84007 100644
--- a/csaxs_bec/scans/omny_fermat_scan.py
+++ b/csaxs_bec/scans/omny_fermat_scan.py
@@ -397,12 +397,14 @@ class OmnyFermatScan(ScanBase):
         if self.omny_rotation_status is not None:
             self.omny_rotation_status.wait()
 
+        # No separate laser_tracker_check_and_wait_for_signalstrength() call here: setting
+        # rtx/rtz below already runs it once per axis via
+        # RtOMNYSetpointSignal._socket_set() -- an explicit third call here was pure
+        # duplication (same check, same signal), not an extra safety margin.
         rt_move_status = self.actions.set(
             device=["rtx", "rtz"], value=[self.positions[0][0], self.positions[0][2]], wait=False
         )
 
-        self.dev.rtx.controller.laser_tracker_check_and_wait_for_signalstrength()
-
         rt_move_status.wait()
 
         self.dev.rtx.controller.add_pos_to_scan(self.positions.tolist())

From bd129b6313618168e30da520fb9f8429c632239b Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 12:37:01 +0200
Subject: [PATCH 020/102] feat(omny): add holler to tomo superuser accounts;
 refresh OPEN_ISSUES.md

Mirko is testing live from his own machine as OS user "holler" with no
active_account set, so the superuser fallback (os.getenv("USER")) needs
"holler" in the allow-list to see the advanced tomo_parameters() options.

OPEN_ISSUES.md had gone stale relative to everything fixed this session:
the rotation-offset section still described it as an open, hardware-review
-only question (resolved days ago once the real DMC controller source
confirmed the real hardware code was always correct -- only the simulator
was missing the offset), and the checklist still said scans were blocked
entirely (a full omny_fermat_scan now runs end to end). Rewrote both
sections to reflect current reality, added a "Current status" summary at
the top so a fresh session can orient in one read, and noted the
_SUPERUSER_ACCOUNTS change and that advanced tomo mode testing is next.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 136 ++++++++++--------
 .../bec_ipython_client/plugins/omny/omny.py   |   9 +-
 2 files changed, 85 insertions(+), 60 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 69553586..78b7fd81 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -1,11 +1,34 @@
-# OMNY open issues (as of 2026-08-26)
+# OMNY open issues (as of 2026-09-02)
 
-Tracks what the first OMNY live-smoke-test session found: bugs (fixed and unfixed) and
-what's still untested. Written so a future session can pick this up without re-deriving
-it. Companion docs: `../../flomni/AI_docs/SIMULATED_ENDSTATIONS.md` (the sim architecture
-and the fullest write-up of the rotation-offset bug below) and
-`../../flomni/AI_docs/FLOMNI_TO_LAMNI_COMPARISON.md` (the flomni→lamni migration this
-OMNY work is meant to mirror).
+Tracks the live-testing effort for bringing OMNY up to flomni's/BEC's current standards on
+branch `update-omny`: bugs found (fixed and unfixed) and what's still untested. Written so a
+future session can pick this up without re-deriving it. Companion docs:
+`../../flomni/AI_docs/SIMULATED_ENDSTATIONS.md` (the sim architecture) and
+`../../flomni/AI_docs/FLOMNI_TO_LAMNI_COMPARISON.md` (the flomni→lamni migration this OMNY work
+is meant to mirror).
+
+## Current status
+
+A full `omny_fermat_scan` (via `omny.tomo_scan_projection(<angle>)`) now runs end to end against
+`simulated_omny.yaml` without crashing — rotation, feedback, and the scan itself all complete.
+Getting there took several rounds of live-tested fixes; see the dated sections below for the
+full trace of each. GUI flows (`omny.omnygui_show_progress()`, `omnygui_show_xeyealign()`,
+`omnygui_show_omnycam_parking()`/`omnygui_show_omnycam_samplestage()`) also work now, ported onto
+flomni's current `gui_tools.py` API.
+
+**Not yet started**: testing the advanced tomo modes (golden ratio, 4/8 sub-tomogram) added
+earlier this branch — this is the next thing being tested live. `holler` (Mirko's account) was
+added to `_SUPERUSER_ACCOUNTS` (`omny.py`) alongside `gac-x01dc` so `tomo_parameters()` shows the
+advanced options when testing from his own machine, where `bec.active_account` is unset and the
+superuser check falls back to the OS login.
+
+**Still open / deferred** (unchanged from before, not touched this pass):
+- `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
+  that unblocked the GUI-open crash — see its own section below. The GUI itself opens fine now;
+  the alignment *logic* underneath it is still wrong for OMNY.
+- The full gripper sample-transfer chain (`otransfer_put_sample()`/`otransfer_get_sample()`),
+  dewar/temperature methods, sample storage bookkeeping, and `omny_alignment_mixin.py`/
+  `omny_optics_mixin.py` beyond what scans exercise — see "Checklist" section below.
 
 ## Standing question: OMNY should follow flOMNI, not LamNI
 
@@ -18,41 +41,42 @@ like LamNI, and is a general lens to apply going forward: if fixing an OMNY bug
 choosing what the "correct" shape looks like, default to whatever flOMNI already does,
 not whatever LamNI does — a LamNI-shaped OMNY file is more likely a leftover copy-paste
 than a deliberate design choice. See the `x_ray_eye_align.py` finding below for a concrete
-example already found this way.
+example already found this way, and the `omny_fermat_scan` rotation-crash section further
+down for a case where following flomni's exact pattern was the fix.
 
-## Bug found, NOT fixed — needs Mirko's call before touching it
+## `osamroy` rotation offset — resolved (real hardware code was correct; only the simulator was wrong)
 
-**`osamroy` (rotation axis) permanently fails every `.move()`/`umv()` call.** Full
-technical write-up: `SIMULATED_ENDSTATIONS.md`'s OMNY live-test section. Short version:
-`OMNYGalilReadbackSignal._socket_get()` (`devices/omny/galil/ogalil_ophyd.py:56-60`) adds
-a documented `+25`° offset on *read* only ("we introduce an offset of 25 to the rotation
-axis... that way we just do tomography from 0 to 180 degrees"). Nothing subtracts it back
-out on the *write* side (`OMNYGalilMotor.move()`, same file) or in that method's own
-success check, so `readback (= raw + 25)` is compared against the raw target passed to
-`.move()` — always off by exactly 25, for any target. This is real, unmodified hardware-
-facing code (not a sim artifact — the sim just relays it faithfully), and it
-unconditionally blocks `feedback_enable_with_reset()` (`rt_omny_ophyd.py:526-533`), which
-blocks every scan needing interferometer feedback, i.e. effectively all of them.
+Originally logged here as an unresolved, hardware-review-only question: whether
+`OMNYGalilMotor.move()` (`devices/omny/galil/ogalil_ophyd.py`) or `feedback_enable_with_reset()`
+(`rt_omny_ophyd.py`) had the wrong sign/space for the documented `+25`° read-side offset on the
+rotation axis (`OMNYGalilReadbackSignal._socket_get()`), since nothing appeared to subtract it
+back out on the write side. **Resolved once the real Galil DMC controller source became
+available** (`controller1.dmc`, `contrID=3` handler): the real controller firmware already
+applies `ntarget=ntarget-25` on write for this axis — `OMNYGalilMotor.move()` was never buggy.
+Only the **simulator** (`csaxs_bec/devices/sim/sim_galil.py`) was missing this, silently passing
+through raw un-offset moves. Fixed in `SimGalilState.start_move_from_newpar()`: applies the same
+`-25` when the port/axis matches the OMNY rotation stage, mirroring the real controller exactly.
+Also seeded `osamroy`'s `sim_initial_position: -25` in `simulated_omny.yaml` so a fresh sim
+session starts at displayed 0° instead of 25° (round-trips through the same offset via
+`OMNYGalilReadbackSignal`'s `+25` read-side conversion).
 
-Two plausible fixes, and only Mirko can say which matches real hardware intent:
-1. `OMNYGalilMotor.move()` should convert the caller's display-space target to raw
-   (subtract 25) before sending it over the wire, for this axis — i.e. `.move(0)` means
-   "go to displayed zero."
-2. Callers are expected to already pass raw targets, in which case
-   `feedback_enable_with_reset()`'s `osamroy.obj.move(0, wait=True)` and its
-   `np.fabs(readback) > 0.1` guard (which reads *display*-space) are the ones using the
-   wrong space, and should target/compare against `-25` instead of `0`.
+Separately, and unrelated to this offset: `omny_rotation()`'s own `.set()` call had a different,
+real bug (targeting `osamroy.user_setpoint` instead of the root `osamroy` device), which caused a
+readback-progressbar crash later in the scan. See the `omny_fermat_scan` section below — already
+fixed, do not confuse with this offset issue.
 
-Do not guess-fix this one — a wrong sign/direction on a real rotation-stage offset is the
-kind of thing that should get hardware-review, not silent inference from code reading.
-
-## `x_ray_eye_align.py` — worse than the crash that got fixed
+## `x_ray_eye_align.py` — GUI now opens, underlying logic still wrong
 
 The construction-time crash (`self.lamni.align.reset_correction()` called on an object
 still mid-construction) is fixed (matches the fix LamNI's own copy of this file already
-got — see its `__init__` for the rationale comment). But that only unblocks
-*construction*. The rest of `omny/x_ray_eye_align.py` is still an **unadapted copy of
-`LamNI/x_ray_eye_align.py`**, not code actually written for OMNY:
+got — see its `__init__` for the rationale comment). The two GUI-open call sites
+(`self.lamni.lamnigui_show_xeyealign()`/`lamnigui_show_xeyealign_fittab()` — LamNI-only method
+names that don't exist on `OMNYGuiTools`) were also fixed, renamed to
+`omnygui_show_xeyealign()`/`omnygui_show_xeyealign_fittab()`, so `omny.align.align()` now gets
+past the GUI-open step without crashing.
+
+The rest of `omny/x_ray_eye_align.py` is still an **unadapted copy of `LamNI/x_ray_eye_align.py`**,
+not code actually written for OMNY:
 - Docstring: `"""BEC-GUI-based X-ray eye alignment for LamNI. ... The key difference from
   the FlOMNI alignment is that LamNI needs *both* x and y fits..."""` — describes LamNI
   vs flOMNI, doesn't mention OMNY at all.
@@ -62,38 +86,36 @@ got — see its `__init__` for the rationale comment). But that only unblocks
 - `LAMNI_ALIGNMENT_ANGLES = [k * 45 for k in range(8)]` (8 angles, full 360°, laminography-
   specific) — presumably wrong for OMNY, which (per the flOMNI/LamNI comparison doc) is
   the kind of full-rotation tomography flOMNI's alignment already handles differently.
+- References devices/methods (`lsamrot`, `lfzp_in`, `omnyfsh`, `omny_xray_gui`) that mix LamNI
+  and OMNY naming conventions — needs a careful pass against OMNY's actual device inventory.
 
-None of this was exercised in the live smoke test beyond the constructor no longer
-crashing — `start_x_ray_eye_alignment()` / `xrayeye_update_frame()` were never called.
-Given the "OMNY ≈ flOMNI, not LamNI" principle above, the right fix is almost certainly to
-port OMNY's version from `flomni/x_ray_eye_align.py` (440 lines, the flOMNI-specific
-implementation) the way `LamNI/x_ray_eye_align.py` was itself adapted from flOMNI's,
-rather than patching the current LamNI-derived file in place.
+None of the alignment logic itself has been exercised live yet — only the constructor and the
+GUI-open step. Given the "OMNY ≈ flOMNI, not LamNI" principle above, the right fix is almost
+certainly to port OMNY's version from `flomni/x_ray_eye_align.py` (440 lines, the flOMNI-specific
+implementation) the way `LamNI/x_ray_eye_align.py` was itself adapted from flOMNI's, rather than
+patching the current LamNI-derived file in place. Not started.
 
-## Checklist items not yet run (smoke test only covered 3 of 4)
+## Checklist items not yet run
 
-From the live session against `simulated_omny.yaml` / `bec --session omny`:
-- **Passed**: config load, a translation-axis move (`osamx`, `osamy`), one lightweight
-  transfer (`omny.otransfer_park_slot(6)`).
-- **Blocked**: any scan (see rotation-offset bug above) — includes `omny.tomo_scan()`
-  itself, never reached.
+- **Passed** (live, against `simulated_omny.yaml` / `bec --session omny`): config load,
+  translation-axis moves (`osamx`, `osamy`), a lightweight transfer (`omny.otransfer_park_slot(6)`),
+  `feedback_enable_with_reset()`, a full `omny_fermat_scan` via `omny.tomo_scan_projection(<angle>)`
+  end to end, and the GUI flows listed under "Current status" above.
 
-Still completely untested (not attempted yet, not known-broken — just unexplored):
+Still untested (not attempted yet, not known-broken — just unexplored):
+- **Advanced tomo modes** (golden ratio, 4/8 sub-tomogram, `tomo_parameters()`'s superuser-gated
+  options) — about to be tested next.
 - The **full gripper sample-transfer chain**: `otransfer_put_sample()` /
   `otransfer_get_sample()` (the actual pin pickup/dropoff with the `confirm`/`atconfir`
-  handshake), as opposed to the lighter `otransfer_park_slot()` used for the smoke test.
-- **X-ray eye alignment** end-to-end (blocked in practice by the section above, but worth
-  retesting once that file is properly ported).
+  handshake), as opposed to the lighter `otransfer_park_slot()` used so far.
+- **X-ray eye alignment** end-to-end alignment logic (GUI now opens fine, see section above —
+  the actual click-through alignment procedure itself hasn't been exercised).
 - **Dewar / temperatures** (`omny_dewar`, `omny_temperatures` devices) — they load and
   construct (`SimOMNYDewar`/`SimOMNYTemperatures`), but no `omny.py`-level method that
-  reads/uses them was called.
+  reads/uses them has been called live.
 - **Sample storage** (`omny_samples`) beyond it loading with seeded slots — no
   `omny.py`-level storage-bookkeeping method exercised.
-- `omny_alignment_mixin.py`, `omny_optics_mixin.py`, and the rest of `omny_rt.py` beyond
-  `feedback_enable_with_reset`/`feedback_disable`/`feedback_status` — none of these were
-  called.
-- GUI-dependent flows (`omnygui_show_gui()` etc.) — the smoke test ran `--nogui`; nothing
-  that needs a real BEC-widgets window was exercised.
+- `omny_alignment_mixin.py`, `omny_optics_mixin.py` beyond what a fermat scan's own setup touches.
 
 ## Known, already-documented, separate from this session
 
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index b0df048f..35368497 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -46,9 +46,12 @@ class OMNYError(Exception):
 # modes (golden ratio, 4/8 sub-tomogram) in OMNY.tomo_parameters(). Regular users only
 # ever see "1: 2 equally spaced sub-tomograms". active_account is a Redis-backed
 # pgroup value, set explicitly via `bec-set-account <pgroup>` -- it is NOT derived
-# from the OS login, so testing as this account requires running
-# `bec-set-account gac-x01dc` first (or wiring pgroup "gac-x01dc" some other way).
-_SUPERUSER_ACCOUNTS: frozenset[str] = frozenset({"gac-x01dc"})
+# from the OS login, so testing as one of these accounts requires either running
+# `bec-set-account <name>` first, or (dev/test sessions where active_account is
+# unset) simply being logged in as that OS user, since _is_superuser_account()
+# falls back to os.getenv("USER") when active_account is blank. "holler" is
+# Mirko's account, used for live testing this branch.
+_SUPERUSER_ACCOUNTS: frozenset[str] = frozenset({"gac-x01dc", "holler"})
 
 
 class OMNYInitStagesMixin:

From 2fbaa6679f8df6e6e5ac01b984582e155b2ebcfc Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 13:32:19 +0200
Subject: [PATCH 021/102] feat(omny): drop redundant tomo auth code, cap type-3
 step at 2.5 deg

The "Enter authorization code" (x12sa) prompt gating advanced tomo modes
(types 2-5) predates the account-based _SUPERUSER_ACCOUNTS gate added
earlier this branch, and is now fully redundant with it -- Mirko asked to
remove it. Each mode still prints the existing "significant wear" warning
unconditionally instead of only after entering the code.

Also added a hard 2.5 degree ceiling on tomo type 3's angular step (golden
ratio starting angle mode), replacing its old minimum-100-projections floor
with an explicit wear-motivated cap; if the requested projection count
implies a larger step, it's clamped down to 2.5 degrees. Type 2's
golden_ratio_bunch_size minimum stays at 100 per Mirko's call -- wear
avoidance there is handled by the warning message, not a lower floor.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  40 +++++-
 .../bec_ipython_client/plugins/omny/omny.py   | 122 ++++++++----------
 .../test_omny_tomo_angles.py                  |  47 ++++++-
 3 files changed, 130 insertions(+), 79 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 78b7fd81..6f22ce7c 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -16,11 +16,15 @@ full trace of each. GUI flows (`omny.omnygui_show_progress()`, `omnygui_show_xey
 `omnygui_show_omnycam_parking()`/`omnygui_show_omnycam_samplestage()`) also work now, ported onto
 flomni's current `gui_tools.py` API.
 
-**Not yet started**: testing the advanced tomo modes (golden ratio, 4/8 sub-tomogram) added
-earlier this branch — this is the next thing being tested live. `holler` (Mirko's account) was
-added to `_SUPERUSER_ACCOUNTS` (`omny.py`) alongside `gac-x01dc` so `tomo_parameters()` shows the
-advanced options when testing from his own machine, where `bec.active_account` is unset and the
-superuser check falls back to the OS login.
+**Now being tested**: the advanced tomo modes (golden ratio, 4/8 sub-tomogram) added earlier this
+branch. `holler` (Mirko's account) was added to `_SUPERUSER_ACCOUNTS` (`omny.py`) alongside
+`gac-x01dc` so `tomo_parameters()` shows the advanced options when testing from his own machine,
+where `bec.active_account` is unset and the superuser check falls back to the OS login. The old
+`x12sa` authorization-code prompt gating tomo types 2-5 was removed — it predates the
+`_SUPERUSER_ACCOUNTS` account check and was fully redundant with it; see "Authorization code
+removed" below. Tomo type 3 also gained a hard cap of 2.5 degrees on the angular step (previously
+only a minimum-100-projections floor, which happened to already satisfy this but wasn't expressed
+as a wear limit).
 
 **Still open / deferred** (unchanged from before, not touched this pass):
 - `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
@@ -244,6 +248,32 @@ explicit `laser_tracker_check_and_wait_for_signalstrength()` call in `prepare_se
 (pure duplication of the per-axis checks the rtx/rtz `set()` calls already trigger). Net effect:
 quieter output, one less redundant tracker-check wait per scan setup, same safety behavior.
 
+## tomo_parameters(): authorization code removed, type-3 step cap added (fixed)
+
+Advanced tomo modes (types 2-5) used to require entering a hardcoded string (`x12sa`) at an "Enter
+authorization code" prompt, on top of already being hidden from non-superuser accounts by
+`_is_superuser_account()`/`_SUPERUSER_ACCOUNTS` (added earlier this branch). Once account-based
+gating existed, the code prompt was pure redundancy — Mirko pointed this out directly ("we can
+remove that now that it is based on the user account") — so it's been removed from all three
+blocks (types 2, 3, 4/5). Each block still prints the same "This mode causes significant wear in
+OMNY" wear warning as before (now unconditional, not gated behind entering the code), reworded
+slightly to explicitly address the power user.
+
+Also added: tomo type 3 (equally spaced tomography, golden ratio starting angle) now enforces a
+hard ceiling of 2.5 degrees on the angular step, in addition to just deriving the step from the
+requested projection count. Previously it only enforced a minimum-100-projections floor (step
+≤1.8°), which happened to already satisfy a 2.5° ceiling — but expressed the constraint as a
+projection-count floor rather than a wear-motivated angular ceiling. If the requested projection
+count yields a step above 2.5°, the step is clamped down to 2.5° and a message is printed; the
+actual number of projections used ends up higher than what was typed. Type 2's
+`golden_ratio_bunch_size` minimum was left at 100 (unchanged) — the wear-avoidance goal there is
+served by the warning message, not by loosening that floor.
+
+Test coverage: `tests/tests_bec_ipython_client/test_omny_tomo_angles.py`'s
+`test_tomo_parameters_allows_superuser_to_unlock_8_subtomo_mode` updated to drop the now-removed
+`"x12sa"` canned answer; new
+`test_tomo_parameters_clamps_type_3_step_size_to_max_2_5_degrees` covers the clamp.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 35368497..cc395088 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1448,85 +1448,69 @@ class OMNY(
                 print(f"The angular step in a subtomogram it will be {self.tomo_angle_stepsize}")
 
             if self.tomo_type == 2:
-                code = self._get_val(
-                    "This mode causes significant wear in OMNY. Enter authorization code.", 0, str
+                print(
+                    "This mode causes significant wear in OMNY. You are a power user -- please"
+                    " avoid unnecessarily many rotations and be gentle to the setup."
+                )
+                self.golden_ratio_bunch_size = self._get_val(
+                    "Number of projections sorted per bunch (minimum 100)",
+                    self.golden_ratio_bunch_size,
+                    int,
+                )
+                if self.golden_ratio_bunch_size < 100:
+                    print("Minimum of 100 selected.")
+                    self.golden_ratio_bunch_size = 100
+                self.golden_max_number_of_projections = self._get_val(
+                    "Stop after number of projections (zero for endless)",
+                    self.golden_max_number_of_projections,
+                    int,
+                )
+                self.golden_projections_at_0_deg_for_damage_estimation = self._get_val(
+                    "Repeat projections at 0 deg every second subtomo 1/0 ?",
+                    self.golden_projections_at_0_deg_for_damage_estimation,
+                    int,
                 )
-                if code == "x12sa":
-                    self.golden_ratio_bunch_size = self._get_val(
-                        "Number of projections sorted per bunch (minimum 100)",
-                        self.golden_ratio_bunch_size,
-                        int,
-                    )
-                    if self.golden_ratio_bunch_size < 100:
-                        print("Minimum of 100 selected.")
-                        self.golden_ratio_bunch_size = 100
-                    self.golden_max_number_of_projections = self._get_val(
-                        "Stop after number of projections (zero for endless)",
-                        self.golden_max_number_of_projections,
-                        int,
-                    )
-                    self.golden_projections_at_0_deg_for_damage_estimation = self._get_val(
-                        "Repeat projections at 0 deg every second subtomo 1/0 ?",
-                        self.golden_projections_at_0_deg_for_damage_estimation,
-                        int,
-                    )
-                else:
-                    print(
-                        "Wrong authorization code. Tomo type 1 selected: 2 sub-tomograms selected."
-                    )
-                    self.tomo_type = 1
 
             if self.tomo_type == 3:
-                code = self._get_val(
-                    "This mode causes significant wear in OMNY. Enter authorization code.", 0, str
+                print(
+                    "This mode causes significant wear in OMNY. You are a power user -- please"
+                    " avoid unnecessarily many rotations and be gentle to the setup."
                 )
-                if code == "x12sa":
-                    numprj = self._get_val(
-                        "Number of projections per sub-tomogram (minimum 100)",
-                        int(180 / self.tomo_angle_stepsize),
-                        int,
-                    )
-                    if numprj < 100:
-                        numprj = 100
-                        print("Minimum of 100 selected.")
-                    self.tomo_angle_stepsize = 180 / numprj
-                    self.golden_max_number_of_projections = self._get_val(
-                        "Stop after number of projections (zero for endless)",
-                        self.golden_max_number_of_projections,
-                        int,
-                    )
-                    self.golden_projections_at_0_deg_for_damage_estimation = self._get_val(
-                        "Repeat projections at 0 deg every second subtomo",
-                        self.golden_projections_at_0_deg_for_damage_estimation,
-                        int,
-                    )
-                else:
+                numprj = self._get_val(
+                    "Number of projections per sub-tomogram",
+                    int(180 / self.tomo_angle_stepsize),
+                    int,
+                )
+                self.tomo_angle_stepsize = 180 / numprj
+                if self.tomo_angle_stepsize > 2.5:
+                    self.tomo_angle_stepsize = 2.5
                     print(
-                        "Wrong authorization code. Tomo type 1 selected: 2 sub-tomograms selected."
+                        "Angular step exceeded the maximum of 2.5 degrees; clamped to 2.5 degrees"
+                        f" ({int(180 / 2.5)} projections per sub-tomogram)."
                     )
-                    self.tomo_type = 1
+                self.golden_max_number_of_projections = self._get_val(
+                    "Stop after number of projections (zero for endless)",
+                    self.golden_max_number_of_projections,
+                    int,
+                )
+                self.golden_projections_at_0_deg_for_damage_estimation = self._get_val(
+                    "Repeat projections at 0 deg every second subtomo",
+                    self.golden_projections_at_0_deg_for_damage_estimation,
+                    int,
+                )
 
             if self.tomo_type in (4, 5):
                 n_subtomos = {4: 4, 5: 8}[self.tomo_type]
-                code = self._get_val(
-                    "This mode causes significant wear in OMNY. Enter authorization code.", 0, str
+                print(
+                    "This mode causes significant wear in OMNY. You are a power user -- please"
+                    " avoid unnecessarily many rotations and be gentle to the setup."
                 )
-                if code == "x12sa":
-                    tomo_numberofprojections = self._get_val(
-                        "Total number of projections",
-                        180 / self.tomo_angle_stepsize * n_subtomos,
-                        int,
-                    )
-                    print(f"The angular step will be {180/tomo_numberofprojections}")
-                    self.tomo_angle_stepsize = 180 / tomo_numberofprojections * n_subtomos
-                    print(
-                        f"The angular step in a subtomogram it will be {self.tomo_angle_stepsize}"
-                    )
-                else:
-                    print(
-                        "Wrong authorization code. Tomo type 1 selected: 2 sub-tomograms selected."
-                    )
-                    self.tomo_type = 1
+                tomo_numberofprojections = self._get_val(
+                    "Total number of projections", 180 / self.tomo_angle_stepsize * n_subtomos, int
+                )
+                print(f"The angular step will be {180/tomo_numberofprojections}")
+                self.tomo_angle_stepsize = 180 / tomo_numberofprojections * n_subtomos
+                print(f"The angular step in a subtomogram it will be {self.tomo_angle_stepsize}")
 
     @staticmethod
     def _get_val(msg: str, default_value, data_type):
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
index f71e5184..8d28e579 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -244,8 +244,9 @@ def test_tomo_parameters_forces_type_1_for_non_superuser(monkeypatch, fake_bec):
 
 
 def test_tomo_parameters_allows_superuser_to_unlock_8_subtomo_mode(monkeypatch, fake_bec):
-    """A superuser account can select and unlock tomo_type 5 (8 sub-tomograms)
-    with the correct authorization code."""
+    """A superuser account can select and unlock tomo_type 5 (8 sub-tomograms).
+    No authorization code is required -- access is gated purely by the account
+    check (_is_superuser_account()), which is already exercised above."""
     monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
     fake_bec.active_account = "e99999"  # superuser
     omny = make_omny()
@@ -265,9 +266,9 @@ def test_tomo_parameters_allows_superuser_to_unlock_8_subtomo_mode(monkeypatch,
     omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
 
     # canned answers for: ctime, step, fovx, fovy, stitch_x, stitch_y,
-    # reconstruct_foldername, tomo_type (=5, 8 sub-tomograms), authorization
-    # code, total number of projections
-    canned = iter([1.0, 0.1, 20, 20, 1, 1, "queue", 5, "x12sa", 144])
+    # reconstruct_foldername, tomo_type (=5, 8 sub-tomograms), total number of
+    # projections
+    canned = iter([1.0, 0.1, 20, 20, 1, 1, "queue", 5, 144])
     monkeypatch.setattr(OMNY, "_get_val", staticmethod(lambda *a, **k: next(canned)))
 
     omny.tomo_parameters()
@@ -275,3 +276,39 @@ def test_tomo_parameters_allows_superuser_to_unlock_8_subtomo_mode(monkeypatch,
     assert omny.tomo_type == 5
     # 144 total projections / 8 sub-tomograms -> stepsize 180/(144/8) = 10.0
     assert omny.tomo_angle_stepsize == pytest.approx(10.0)
+
+
+def test_tomo_parameters_clamps_type_3_step_size_to_max_2_5_degrees(monkeypatch, fake_bec):
+    """tomo_type 3 (equally spaced, golden ratio starting angle) enforces a
+    maximum angular step of 2.5 degrees, to limit wear from too many
+    rotations. A superuser requesting too few projections per sub-tomogram
+    (i.e. too large a step) gets clamped down to 2.5 degrees."""
+    monkeypatch.setattr(omny_module, "_SUPERUSER_ACCOUNTS", frozenset({"e99999"}))
+    fake_bec.active_account = "e99999"  # superuser
+    omny = make_omny()
+    omny.tomo_countingtime = 1.0
+    omny.tomo_shellstep = 0.1
+    omny.fovx = 20
+    omny.fovy = 20
+    omny.stitch_x = 1
+    omny.stitch_y = 1
+    omny.ptycho_reconstruct_foldername = "queue"
+    omny.tomo_angle_stepsize = 10.0
+    omny.tomo_type = 1
+    fake_dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+    omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
+
+    # canned answers for: ctime, step, fovx, fovy, stitch_x, stitch_y,
+    # reconstruct_foldername, tomo_type (=3), projections per sub-tomogram
+    # (=10 -> would be an 18 degree step, far above the 2.5 degree cap),
+    # stop-after-projections, repeat-at-0-deg
+    canned = iter([1.0, 0.1, 20, 20, 1, 1, "queue", 3, 10, 0, 0])
+    monkeypatch.setattr(OMNY, "_get_val", staticmethod(lambda *a, **k: next(canned)))
+
+    omny.tomo_parameters()
+
+    assert omny.tomo_type == 3
+    assert omny.tomo_angle_stepsize == pytest.approx(2.5)

From 789c0dbf721ad82a9672494bf83d8a734683f6a0 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 13:43:08 +0200
Subject: [PATCH 022/102] test(omny): lock in equal spacing at every
 sub-tomogram combination stage

Mirko flagged that flomni previously had real, painful bugs where combined
sub-tomograms weren't actually equally spaced -- given that history, verify
(and permanently regression-guard) the same property for OMNY's tomo types
1/4/5, at the specific combination granularity he described: type 4's 1+2
and 3+4 pairings individually, not just the full 1-2-3-4 combination already
covered; and type 5's progressive 1+2 / 1+2+3+4 / 1..8 doubling stages,
matching flomni's own documented interlacing design.

Verified offline against the exact production function
(_equally_spaced_subtomo_angles) across several step sizes including ones
that don't divide 180 evenly; for n_subtomos=8 its bit-reversal phase index
was also cross-checked to reproduce flomni's hardcoded, already-proven-
correct phase_eighths table exactly (already covered by the existing
test_bit_reversal_matches_flomnis_hardcoded_phase_eighths_table, unchanged).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../test_omny_tomo_angles.py                  | 54 +++++++++++++++++++
 1 file changed, 54 insertions(+)

diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
index 8d28e579..dba9bd18 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -117,6 +117,60 @@ def test_phase_offset_uses_achievable_step_not_raw_stepsize(stepsize):
     assert np.isclose(new[0], achievable_step_start, atol=1e-9)
 
 
+def _combined_angles(subtomo_numbers, n_subtomos, stepsize):
+    angles = []
+    for s in subtomo_numbers:
+        angles.extend(_angles(s, n_subtomos, stepsize).tolist())
+    return np.sort(np.asarray(angles))
+
+
+def _assert_evenly_spaced(angles, expected_step, label):
+    diffs = np.diff(angles)
+    assert np.allclose(
+        diffs, expected_step, atol=1e-6
+    ), f"{label} are not evenly spaced by {expected_step}: got {diffs}"
+
+
+@pytest.mark.parametrize("stepsize", STEPSIZES)
+def test_type4_intermediate_pairings_equally_spaced(stepsize):
+    """tomo_type 4 (4 equally spaced sub-tomograms) must be equally spaced not
+    only in the full 1-2-3-4 combination (already covered by
+    test_combined_subtomos_cover_180_degrees_without_duplicates), but also at
+    each natural intermediate pairing: sub-tomo 1+2 combined, and sub-tomo 3+4
+    combined. flomni previously shipped a bug where combined sub-tomograms
+    were NOT actually equally spaced (fixed via the bit-reversal phase table
+    this function reuses, see test_bit_reversal_matches_flomnis_hardcoded_
+    phase_eighths_table below) -- guard the same property at this
+    finer-grained level, per Mirko's request given that history.
+    """
+    n_points = int(180.0 / stepsize)
+    step = 180.0 / n_points
+
+    _assert_evenly_spaced(_combined_angles([1, 2], 4, stepsize), step / 2, "sub-tomos 1+2")
+    _assert_evenly_spaced(_combined_angles([3, 4], 4, stepsize), step / 2, "sub-tomos 3+4")
+    _assert_evenly_spaced(
+        _combined_angles([1, 2, 3, 4], 4, stepsize), step / 4, "sub-tomos 1+2+3+4"
+    )
+
+
+@pytest.mark.parametrize("stepsize", STEPSIZES)
+def test_type5_progressive_combinations_equally_spaced(stepsize):
+    """tomo_type 5 (8 equally spaced sub-tomograms, akin to flomni's own
+    8-sub-tomogram scheme) must be equally spaced at every progressive
+    doubling stage of combination, matching flomni's documented interlacing
+    design (_subtomo_angle_plan()'s docstring): 1+2, 1+2+3+4, and the full
+    1..8 each independently form a finer evenly spaced grid.
+    """
+    n_points = int(180.0 / stepsize)
+    step = 180.0 / n_points
+
+    _assert_evenly_spaced(_combined_angles([1, 2], 8, stepsize), step / 2, "sub-tomos 1+2")
+    _assert_evenly_spaced(
+        _combined_angles([1, 2, 3, 4], 8, stepsize), step / 4, "sub-tomos 1+2+3+4"
+    )
+    _assert_evenly_spaced(_combined_angles(range(1, 9), 8, stepsize), step / 8, "sub-tomos 1..8")
+
+
 def test_bit_reversal_matches_flomnis_hardcoded_phase_eighths_table():
     """flomni.py hardcodes the N=8 bit-reversal permutation as a literal dict
     (phase_eighths = {1:0, 2:4, 3:2, 4:6, 5:1, 6:5, 7:3, 8:7}). The generalized

From ea9519ff205a7238332e7428cf7ad58b039f01c0 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 13:48:51 +0200
Subject: [PATCH 023/102] test(omny): check combined sub-tomogram spacing adds
 up to 180 degrees

Mirko recalled that flomni/lamni check the combined angular spacing adds up
to 180 (360 for lamni) -- found the precise existing pattern in lamni's own
test suite (test_lamni_tomo_angles.py's _assert_equally_spaced(): sort the
combined angles, append a wraparound point at first_angle + range, and
assert every gap including that seam is uniform). This is strictly stronger
than checking the total span alone -- it also catches a double-wide or
missing gap right at the seam, which is exactly the shape of bug flomni's
historical fixes (e.g. 6acaadb, "fix angular start in even subtomos")
addressed.

Ported the same wraparound-inclusive check into OMNY's tests: the existing
full-combination test now asserts it directly, and the intermediate-pairing
helper (_assert_evenly_spaced, used by the type-4 and type-5 pairwise/
progressive combination tests added previously) now includes it too.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../test_omny_tomo_angles.py                  | 25 +++++++++++++++++--
 1 file changed, 23 insertions(+), 2 deletions(-)

diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
index dba9bd18..a9671af1 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -72,6 +72,20 @@ def test_combined_subtomos_cover_180_degrees_without_duplicates(stepsize, n_subt
         diffs, combined_step, atol=1e-6
     ), f"combined angles are not evenly spaced by {combined_step}: got {diffs}"
 
+    # The wraparound gap (last angle back to the first angle + 180) must be
+    # the SAME size as every other gap -- not just that the angles span 180
+    # in total, but that the seam itself isn't a double-wide gap or an
+    # overlap. Mirrors lamni's _assert_equally_spaced() in
+    # test_lamni_tomo_angles.py (there: %360, +360 wraparound; here: 180,
+    # since OMNY only ever scans a 180 degree range) and is the same
+    # "combined spacing adds up to 180" invariant flomni's
+    # test_180_mode_regression checks via its min>=0/max<180 bounds.
+    wrapped_diffs = np.diff(np.concatenate([sorted_angles, [sorted_angles[0] + 180.0]]))
+    assert np.allclose(wrapped_diffs, combined_step, atol=1e-6), (
+        f"combined sub-tomograms are not evenly spaced by {combined_step} once the"
+        f" 0/180 wraparound gap is included: got {wrapped_diffs}"
+    )
+
 
 # stepsizes that divide 180 evenly, where the old code's raw-stepsize-based
 # phase offset happens to coincide with the achievable-step-based one below
@@ -125,10 +139,17 @@ def _combined_angles(subtomo_numbers, n_subtomos, stepsize):
 
 
 def _assert_evenly_spaced(angles, expected_step, label):
-    diffs = np.diff(angles)
+    """Checks every gap between consecutive (sorted) angles, INCLUDING the
+    wraparound gap from the last angle back to the first angle + 180 -- not
+    just that the angles are internally evenly spaced, but that they add up
+    to exactly 180 degrees with no double-wide or missing gap at the seam.
+    Mirrors lamni's _assert_equally_spaced() in test_lamni_tomo_angles.py
+    (there: %360, +360 wraparound, since lamni scans a full circle)."""
+    wrapped = np.concatenate([angles, [angles[0] + 180.0]])
+    diffs = np.diff(wrapped)
     assert np.allclose(
         diffs, expected_step, atol=1e-6
-    ), f"{label} are not evenly spaced by {expected_step}: got {diffs}"
+    ), f"{label} are not evenly spaced by {expected_step} once the 0/180 wraparound gap is included: got {diffs}"
 
 
 @pytest.mark.parametrize("stepsize", STEPSIZES)

From 906e9f5318d0aec5bc0cb48635eca433f79931f6 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 14:42:35 +0200
Subject: [PATCH 024/102] feat(omny): port tomo-queue backend from flomni/lamni
 (Phase 1 of 2)

Mirko wants the tomo params GUI widget available for OMNY before running
real tomo scans. That widget (Phase 2, separate follow-up) needs a working
job queue and scan progress visible outside the CLI session that started
it -- neither existed for OMNY. OMNY now inherits TomoQueueMixin
(OMNY_shared/tomo_queue_mixin.py), the same shared backend flomni/lamni
already use, giving it tomo_queue_add/delete/move/clear/show/execute/
reacquire, at_each_angle_hook registration, and tomo_scan_resume() for the
first time.

self.progress is now a global-var-backed proxy (_ProgressProxy, byte-for-
byte port of flomni's/lamni's own), not a plain in-memory dict -- the
load-bearing change the queue mixin and the eventual widget's busy-banner
both depend on. tomo_queue_mixin.py's tomo_queue_reacquire() hardcoded
tomo_type == 1; generalized via a new _TOMO_TYPE_1_LIKE class attribute
(default frozenset({1}), flomni/lamni unaffected) since OMNY has three
"equally spaced sub-tomograms" flavors (types 1/4/5), not just one.

Along the way, fixed several real bugs in tomo_scan()/write_pdf_report()
that predate this session and would have crashed on a real account/
real energy read (bec.active_account.decode() -- active_account is str
not bytes; dev.mokev doesn't exist for OMNY, only dev.ccm_energy; an
unguarded logbook send; a stale "LamNI" logo/tag copy-paste leftover) --
all direct ports of fixes flomni/lamni already needed and got. Also added
the missing unconditional omnygui_show_progress() call and heartbeat-
clearing try/finally in tomo_scan(), matching both.

Verification: 23 new tests (test_omny_tomo_queue.py, test_omny_tomo_scan.py)
covering the mixin wiring, hook dispatch/resolution, tomo_scan_resume()/
_resolve_type1_projection()/reacquire() across all three sub-tomogram
flavors, account handling, and heartbeat clearing on both normal completion
and a mid-scan exception. Full suite: 702 passed. Not yet live-tested
against a running session (the local bec-server may be in active use by
Mirko's own parallel session) -- next step is his own pull-and-test.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/OMNY_shared/tomo_queue_mixin.py   |  29 +-
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 126 ++++-
 .../bec_ipython_client/plugins/omny/omny.py   | 529 ++++++++++++++----
 .../test_omny_tomo_queue.py                   | 317 +++++++++++
 .../test_omny_tomo_scan.py                    | 183 ++++++
 5 files changed, 1051 insertions(+), 133 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_tomo_queue.py
 create mode 100644 tests/tests_bec_ipython_client/test_omny_tomo_scan.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
index 927c546a..c26f7fa2 100644
--- a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
@@ -27,10 +27,15 @@ Consumers (e.g. ``Flomni``, ``LamNI``) must:
       ``flomni_at_each_angle`` builtins hook, single-point acquisition -- that
       it stays out of this mixin)
     - implement their own ``_resolve_type1_projection()`` (dispatched
-      generically by ``tomo_queue_reacquire()``), mapping a flat tomo_type-1
-      projection number to a ``(subtomo_start, start_angle)`` pair -- the
-      angle math is setup-specific (see each setup's own
-      ``_subtomo_angle_plan()``), same reasoning as ``tomo_scan()`` above
+      generically by ``tomo_queue_reacquire()`` for any tomo_type in
+      ``_TOMO_TYPE_1_LIKE``), mapping a flat projection number to a
+      ``(subtomo_start, start_angle)`` pair -- the angle math is
+      setup-specific (see each setup's own ``_subtomo_angle_plan()``/
+      ``_equally_spaced_subtomo_angles()``), same reasoning as
+      ``tomo_scan()`` above
+    - optionally override ``_TOMO_TYPE_1_LIKE`` (default ``frozenset({1})``)
+      if their setup has more than one "equally spaced sub-tomograms"
+      tomo_type flavor (e.g. OMNY's types 1/4/5 -- 2/4/8 sub-tomograms)
 """
 
 from __future__ import annotations
@@ -210,6 +215,13 @@ class TomoQueueMixin:
     _TOMO_QUEUE_ACTIONS: dict = {}
     _TOMO_QUEUE_MOVE_DEVICES: dict = {}
 
+    # tomo_type values that behave like "type 1" for tomo_queue_reacquire()'s
+    # purposes -- i.e. resolved via _resolve_type1_projection() rather than a
+    # flat projection_number. Default matches flomni/lamni (type 1 only, their
+    # only "equally spaced sub-tomograms" flavor); OMNY overrides this to
+    # {1, 4, 5} since it has three such flavors (2/4/8 sub-tomograms).
+    _TOMO_TYPE_1_LIKE: frozenset = frozenset({1})
+
     # Name of a registered at_each_angle hook (see register_at_each_angle_hook()),
     # or None for the default per-projection behaviour.
     at_each_angle_hook = _GlobalVarParam(None)
@@ -1012,10 +1024,9 @@ class TomoQueueMixin:
             job_index: Position of the job to reopen, in the *current*
                 queue order (same indexing as ``tomo_queue_show()``/
                 ``tomo_queue_delete()``).
-            projection_number: Flat 0-indexed projection to resume from,
-                for any tomo_type (1, 2, or 3) -- see
-                ``_resolve_type1_projection()`` for how this maps onto a
-                tomo_type-1 job's (subtomo, angle).
+            projection_number: Flat 0-indexed projection to resume from, for
+                any tomo_type -- see ``_resolve_type1_projection()`` for how
+                this maps onto a ``_TOMO_TYPE_1_LIKE`` job's (subtomo, angle).
 
         Raises:
             TomoQueueError: ``job_index`` is out of range, the job at that
@@ -1049,7 +1060,7 @@ class TomoQueueMixin:
         for name, value in job["params"].items():
             setattr(self, name, value)
 
-        if self.tomo_type == 1:
+        if self.tomo_type in self._TOMO_TYPE_1_LIKE:
             subtomo_start, start_angle = self._resolve_type1_projection(projection_number)
             self.progress["subtomo"] = subtomo_start
             self.progress["angle"] = start_angle
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 6f22ce7c..971f1d3f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -26,6 +26,12 @@ removed" below. Tomo type 3 also gained a hard cap of 2.5 degrees on the angular
 only a minimum-100-projections floor, which happened to already satisfy this but wasn't expressed
 as a wear limit).
 
+**Just landed**: the tomo-queue backend (Phase 1 of 2 of porting the tomo params GUI widget to
+OMNY) — `OMNY` now has a real job queue, `at_each_angle_hook` registration, `tomo_scan_resume()`,
+and scan progress visible outside the CLI session (previously a plain in-memory dict). See "Tomo-
+queue backend ported to OMNY" below. Phase 2 (the widget itself) is a separate follow-up, not yet
+started — not live-tested against a running session yet either; that's next, once Mirko pulls.
+
 **Still open / deferred** (unchanged from before, not touched this pass):
 - `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
   that unblocked the GUI-open crash — see its own section below. The GUI itself opens fine now;
@@ -33,6 +39,7 @@ as a wear limit).
 - The full gripper sample-transfer chain (`otransfer_put_sample()`/`otransfer_get_sample()`),
   dewar/temperature methods, sample storage bookkeeping, and `omny_alignment_mixin.py`/
   `omny_optics_mixin.py` beyond what scans exercise — see "Checklist" section below.
+- The `TomoParamsWidget`/`OMNY_TomoParams` GUI widget itself (Phase 2 of the tomo-queue port).
 
 ## Standing question: OMNY should follow flOMNI, not LamNI
 
@@ -126,24 +133,29 @@ Still untested (not attempted yet, not known-broken — just unexplored):
 - `omny_webpage_generator.py` (2957 lines) is dead/unwired code — never instantiated by
   `omny.py`, per `FLOMNI_TO_LAMNI_COMPARISON.md`'s note ("omny was left untouched...
   separate future task if omny ever needs a real one"). Not touched this session either.
-- The tomo-queue / `TomoParamsWidget` generalization done for LamNI
-  (`LamNI/AI_docs/TOMO_QUEUE_PORT.md`, `TOMO_PARAMS_GUI_PORT.md`) has no OMNY counterpart
-  yet — out of scope for the sim-validation work, in scope for the eventual macro-
-  standardization pass.
+- **Tomo-queue backend: ported, Phase 1 of 2 (this session).** `OMNY` now inherits
+  `TomoQueueMixin` (`OMNY_shared/tomo_queue_mixin.py`), the same shared backend flomni/lamni
+  use — `tomo_queue_add/delete/move/clear/show/execute/reacquire`,
+  `register_at_each_angle_hook`/`at_each_angle_hook`, `tomo_scan_resume()`. See "Tomo-queue
+  backend ported to OMNY" below for the full detail. **Not yet done (Phase 2, separate
+  follow-up)**: the `TomoParamsWidget`/`OMNY_TomoParams` GUI widget itself
+  (`bec_widgets/widgets/tomo_params/tomo_params.py`) still has no `SETUP_PROFILES["omny"]`
+  entry and its tomo-type selector/job-display logic is hardcoded to 3 tomo types (flomni's
+  and lamni's), not OMNY's 5 — needs its own plan once Phase 1 is live-tested.
 
-## gui_tools.py progress fields (deferred on purpose)
+## gui_tools.py progress ETA/heartbeat line (still not rendered, data now exists)
 
 `gui_tools.py` was modernized to flomni's current single-level `.new()` / `_is_deleted()`-guard
 pattern (window lifecycle, xray-eye-align GUI, cameras + hard-stop console, `RingProgressBar`).
-One piece was deliberately **not** ported: flomni's `self.progress` dict carries
-`tomo_start_time`/`heartbeat`/`estimated_remaining_time`/`estimated_finish_time` plus a
-`_describe_active_hook()` method feeding an ETA/heartbeat line in `_flomnigui_update_progress()`.
-omny's `self.progress` (set up in `OMNY.__init__`, `omny.py`) still only has the original 7 fields
-(`subtomo`, `subtomo_projection`, `subtomo_total_projections`, `projection`,
-`total_projections`, `angle`, `tomo_type`) and `_omnygui_update_progress()` was written against
-just those. Mirko's call: keep it simple for this pass, revisit later. Not a crash risk —
-`omny_webpage_generator.py` already reads the ETA-ish fields defensively via `.get()`, degrading
-to "N/A" when absent, and that file is unwired/dead code anyway (see below).
+As of the tomo-queue backend port (see below), `self.progress` now DOES carry
+`tomo_start_time`/`heartbeat`/`estimated_remaining_time`/`estimated_finish_time` (global-var-backed,
+same shape as flomni's/lamni's) — what's still not ported is purely a `gui_tools.py` rendering
+detail: `_omnygui_update_progress()` was never updated to display an ETA/heartbeat line the way
+flomni's `_flomnigui_update_progress()`/`_describe_active_hook()` do, and still only builds its
+text from the original 7 fields. Not a crash risk either way — `_omnygui_update_progress()`
+ignores fields it doesn't read, and `omny_webpage_generator.py` (unwired/dead code, see below)
+already reads the ETA-ish fields defensively via `.get()`, degrading to "N/A" when absent. Revisit
+whenever the progress ring GUI itself gets an ETA line, independent of the Phase 2 widget work.
 
 ## cam_xeye device (simulated only, real hardware config still needed)
 
@@ -274,6 +286,92 @@ Test coverage: `tests/tests_bec_ipython_client/test_omny_tomo_angles.py`'s
 `"x12sa"` canned answer; new
 `test_tomo_parameters_clamps_type_3_step_size_to_max_2_5_degrees` covers the clamp.
 
+## Tomo-queue backend ported to OMNY (Phase 1 of 2)
+
+Mirko wants the tomo params GUI widget available for OMNY before starting real tomo scans. That
+widget (Phase 2, separate follow-up) depends on a working tomo-queue backend and on scan progress
+being visible outside the CLI session that started it -- neither existed for OMNY before this pass.
+Same shared infrastructure and pattern as the flomni -> lamni port
+(`LamNI/AI_docs/TOMO_QUEUE_PORT.md`, `TOMO_PARAMS_GUI_PORT.md`), done as the same two-phase split
+per Mirko's explicit choice.
+
+**`OMNY` now inherits `TomoQueueMixin`** (`OMNY_shared/tomo_queue_mixin.py`, first in the MRO,
+matching flomni/lamni), giving it `tomo_queue_add/add_command/delete/move/clear/show/execute/
+resume/reacquire`, `register_at_each_angle_hook`/`unregister_at_each_angle_hook`/
+`list_at_each_angle_hooks`/`at_each_angle_hook` for the first time. New class attributes:
+`_TOMO_SCAN_PARAM_NAMES` (mirrors flomni's names exactly -- OMNY's properties already mirror
+flomni's 1:1, no `tomo_angle_range`/`single_point_*`/`zero_deg_reference_at_each_subtomo`/
+`frames_per_trigger` since none of these exist as OMNY properties), `_TOMO_QUEUE_MOVE_DEVICES`
+(`ccm_energy`+`idgap`, **not** `mokev` -- OMNY has no `mokev` device in any config, real or
+simulated), `_TOMO_QUEUE_ACTIONS` (same `move`/`optimize_idgap` registry as flomni/lamni,
+`optimize_idgap` still a stub).
+
+**`self.progress` is now a global-var-backed proxy, not a plain dict.** Before this pass, OMNY's
+`self.progress = {}` was a plain in-memory instance dict -- invisible to any other BEC client
+session, a GUI process included. New `_ProgressProxy` class (direct, byte-for-byte port of
+flomni's/lamni's own, backed by `client.get_global_var("tomo_progress")`, same global-var key --
+only one tomography setup is ever live per BEC session, no collision risk), with `progress` now a
+`@property`. Carries the original 7 fields (`subtomo`, `subtomo_projection`,
+`subtomo_total_projections`, `projection`, `total_projections`, `angle`, `tomo_type`) plus
+`tomo_start_time`/`estimated_remaining_time`/`estimated_finish_time`/`heartbeat`/
+`accumulated_idle_time`, matching flomni's/lamni's `_DEFAULTS` shape.
+
+**`tomo_queue_mixin.py`'s `tomo_queue_reacquire()` generalized (small, additive, behavior-
+preserving change to shared code)**: it hardcoded `if self.tomo_type == 1:` to decide when to
+resolve via `_resolve_type1_projection()`. OMNY has three "equally spaced sub-tomograms" flavors
+(types 1/4/5 -- 2/4/8 sub-tomograms), not just type 1. Added `_TOMO_TYPE_1_LIKE: frozenset`
+(default `frozenset({1})`, so flomni/lamni are unaffected -- confirmed via their existing test
+suites, unchanged and passing), which OMNY overrides to `frozenset({1, 4, 5})`.
+
+**New OMNY methods, direct ports generalized for 3 sub-tomogram counts**: `tomo_scan_resume()`
+(dispatches subtomo/angle for tomo_type in `_TOMO_TYPE_1_LIKE`, projection_number for 2/3) and
+`_resolve_type1_projection()` (reuses the already-verified `_equally_spaced_subtomo_angles()` --
+does not re-derive the angle grid a second way).
+
+**Real, pre-existing bugs fixed along the way** (same shapes flomni/lamni already needed and got,
+found by reading `tomo_scan()`/`write_pdf_report()` against the mixin's needs, not newly
+introduced):
+- `bec.active_account.decode()` in `tomo_scan()` -- `active_account` is a plain `str`, not
+  `bytes`; crashed on every real account. Removed (OMNY's existing `if bec.active_account != "":
+  ... else: tomo_id = 0` branch structure kept as-is, unlike flomni's/lamni's "always attempt,
+  let add_sample_database() decide" pattern -- OMNY's own `add_sample_database()` has no
+  test-server/empty-account fallback to lean on).
+- `dev.mokev.read()['mokev']['value']` in `write_pdf_report()` -- OMNY has no `mokev` device in
+  any config. Fixed to `dev.ccm_energy` (from `bl_optics_hutch.yaml`, always included regardless
+  of active endstation) with a try/except -> `"N/A"` fallback, matching lamni's identical fix.
+  Confirmed `ccm_energy` is *not* in the local simulated OMNY config either (`simulated_omny.yaml`/
+  `simulated_bl_endstation.yaml` have no such device), so live sim testing will exercise the
+  fallback path, not a real energy read -- still correct/safe behavior, just not the success path.
+- `bec.logbook.LogbookMessage()`/`send_logbook_message()` in `write_pdf_report()` was unguarded --
+  wrapped in try/except, matching `write_to_scilog()`'s existing tolerance one method up.
+- `write_pdf_report()`'s scilog logo/tags still said `"LamNI"`/pointed at a nonexistent
+  `LamNI_logo.png` (omny's plugin directory only has `OMNY.png`) -- `msg.add_file(logo_path)`
+  would have raised unguarded (now inside the same try/except above regardless). Fixed to
+  `OMNY.png`/`"OMNY"`.
+- `tomo_scan()` never called `self.omnygui_show_progress()` unconditionally at scan start (only
+  per-angle inside `_tomo_scan_at_angle()`) and had no try/finally to clear `heartbeat` on exit --
+  both fixed, matching flomni's/lamni's identical pattern.
+- `_at_each_angle()` now checks `self.at_each_angle_hook` (mixin-provided) first, falling through
+  to the pre-existing `omny_at_each_angle` builtins-global hook, then the default
+  `tomo_scan_projection()` + `tomo_reconstruct()` -- same 3-tier structure as flomni's, minus its
+  single-point branch (OMNY has none).
+
+**Verification**: new `tests/tests_bec_ipython_client/test_omny_tomo_queue.py` (17 tests --
+param-name snapshotting, queue add/show/execute/resume/reacquire, add-command move validation,
+`at_each_angle_hook` dispatch/default/legacy-builtins-fallback/unregistered-name,
+`tomo_scan_resume()`/`_resolve_type1_projection()`/`tomo_queue_reacquire()` correctness across all
+three sub-tomogram flavors) and `test_omny_tomo_scan.py` (6 tests -- account handling, progress-GUI
+auto-show, heartbeat clearing on normal completion and mid-scan exception, new-scan timing-field
+resets). `write_pdf_report()`'s `ccm_energy` fallback has no dedicated unit test, matching
+flomni's/lamni's own precedent (neither has one either -- verified live only, real file I/O and
+device reads make it impractical to unit test in isolation). Full suite: 702 passed. Confirmed via
+plain Python (no live client needed) that `OMNY`'s MRO resolves cleanly with `TomoQueueMixin`
+first, no conflicts. **Not yet live-verified against a real running session** (deliberately --
+the local bec-server may be in active use by Mirko's own parallel session; a full live
+`tomo_scan()`/`tomo_queue_execute()` run moves real simulated hardware and consumes real scan
+numbers) -- next step is Mirko pulling and testing live himself, same pattern as this whole
+engagement.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index cc395088..c40e74b1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -21,6 +21,7 @@ from csaxs_bec.bec_ipython_client.plugins.omny.omny_sample_transfer_mixin import
     OMNYSampleTransferMixin,
 )
 from csaxs_bec.bec_ipython_client.plugins.omny.x_ray_eye_align import XrayEyeAlign
+from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.tomo_queue_mixin import TomoQueueMixin
 
 logger = bec_logger.logger
 
@@ -54,6 +55,81 @@ class OMNYError(Exception):
 _SUPERUSER_ACCOUNTS: frozenset[str] = frozenset({"gac-x01dc", "holler"})
 
 
+class _ProgressProxy:
+    """Dict-like proxy that persists the OMNY progress dict as a BEC global variable.
+
+    Every read (`proxy["key"]`) fetches the current dict from the global var store,
+    and every write (`proxy["key"] = val`) fetches, updates, and saves it back.
+    This makes the progress state visible to all BEC client sessions via
+    ``client.get_global_var("tomo_progress")`` -- same key and shape as
+    flomni's/lamni's own progress proxy, since only one tomography setup is
+    ever live against a given BEC session. Direct port of
+    ``flomni.py``'s/``lamni.py``'s identical class.
+    """
+
+    _GLOBAL_VAR_KEY = "tomo_progress"
+    _DEFAULTS: dict = {
+        "subtomo": 0,
+        "subtomo_projection": 0,
+        "subtomo_total_projections": 1,
+        "projection": 0,
+        "total_projections": 1,
+        "angle": 0,
+        "tomo_type": 0,
+        "tomo_start_time": None,
+        "estimated_remaining_time": None,
+        "estimated_finish_time": None,
+        "heartbeat": None,
+        "accumulated_idle_time": 0.0,
+    }
+
+    def __init__(self, client):
+        self._client = client
+
+    # ------------------------------------------------------------------
+    # Internal helpers
+    # ------------------------------------------------------------------
+    def _load(self) -> dict:
+        val = self._client.get_global_var(self._GLOBAL_VAR_KEY)
+        if val is None:
+            return dict(self._DEFAULTS)
+        return val
+
+    def _save(self, data: dict) -> None:
+        self._client.set_global_var(self._GLOBAL_VAR_KEY, data)
+
+    # ------------------------------------------------------------------
+    # Dict-like interface
+    # ------------------------------------------------------------------
+    def __getitem__(self, key):
+        return self._load()[key]
+
+    def __setitem__(self, key, value) -> None:
+        data = self._load()
+        data[key] = value
+        self._save(data)
+
+    def __repr__(self) -> str:
+        return f"{self.__class__.__name__}({self._load()!r})"
+
+    def get(self, key, default=None):
+        return self._load().get(key, default)
+
+    def update(self, *args, **kwargs) -> None:
+        """Update multiple fields in a single round-trip."""
+        data = self._load()
+        data.update(*args, **kwargs)
+        self._save(data)
+
+    def reset(self) -> None:
+        """Reset all progress fields to their default values."""
+        self._save(dict(self._DEFAULTS))
+
+    def as_dict(self) -> dict:
+        """Return a plain copy of the current progress state."""
+        return self._load()
+
+
 class OMNYInitStagesMixin:
 
     def enable_all_devices(self):
@@ -560,6 +636,7 @@ class OMNYInitStagesMixin:
 
 
 class OMNY(
+    TomoQueueMixin,
     OMNYInitStagesMixin,
     OMNYSampleTransferMixin,
     OMNYAlignmentMixin,
@@ -568,6 +645,73 @@ class OMNY(
     OMNY_rt_client,
     OMNYGuiTools,
 ):
+    # tomo_type values that behave like "type 1" for tomo_queue_reacquire()
+    # (TomoQueueMixin) -- OMNY has three "equally spaced sub-tomograms"
+    # flavors (1/4/5 -> 2/4/8 sub-tomograms), unlike flomni/lamni's single
+    # type-1 flavor (the mixin's default, frozenset({1})).
+    _TOMO_TYPE_1_LIKE: frozenset = frozenset({1, 4, 5})
+
+    # Property names a tomo_queue_add() job snapshots (TomoQueueMixin
+    # contract). Mirrors flomni's own tuple exactly, since OMNY's properties
+    # already mirror flomni's names 1:1 -- no tomo_angle_range/single_point_*/
+    # zero_deg_reference_at_each_subtomo/frames_per_trigger, since OMNY has
+    # no such properties.
+    _TOMO_SCAN_PARAM_NAMES = (
+        "tomo_countingtime",
+        "tomo_shellstep",
+        "fovx",
+        "fovy",
+        "stitch_x",
+        "stitch_y",
+        "tomo_stitch_overlap",
+        "ptycho_reconstruct_foldername",
+        "manual_shift_y",
+        "tomo_type",
+        "tomo_angle_stepsize",
+        "golden_ratio_bunch_size",
+        "golden_max_number_of_projections",
+        "golden_projections_at_0_deg_for_damage_estimation",
+        "corridor_size",
+        "at_each_angle_hook",
+    )
+
+    # Curated allow-list for the "move" queue action -- same shape as
+    # flomni's/lamni's own (TomoQueueMixin contract). "ccm_energy", not
+    # "mokev" -- OMNY has no mokev device in any config (real or
+    # simulated); ccm_energy (bl_optics_hutch.yaml) is always present
+    # regardless of active endstation.
+    _TOMO_QUEUE_MOVE_DEVICES = {
+        "ccm_energy": {"label": "Energy", "unit": "keV"},
+        "idgap": {"label": "Undulator gap", "unit": "mm"},
+    }
+
+    # Same move/optimize_idgap registry as flomni/lamni (TomoQueueMixin
+    # contract) -- optimize_idgap stays a stub (TomoQueueMixin.optimize_idgap
+    # is a no-op), matching both.
+    _TOMO_QUEUE_ACTIONS = {
+        "move": {
+            "func": "_queue_action_move",
+            "idempotent": True,  # absolute moves re-run harmlessly
+            "help": "Move device(s) to absolute position(s).",
+            "params": {"positions": {"type": "device_positions"}},
+        },
+        "optimize_idgap": {
+            "func": "optimize_idgap",
+            "idempotent": True,
+            "help": "Scan idgap over a search range and move to the peak. STUB: no-op.",
+            "params": {
+                "search_range": {
+                    "type": "float",
+                    "default": 0.5,
+                    "min": 0.0,
+                    "max": 2.0,
+                    "unit": "mm",
+                    "label": "Search range",
+                }
+            },
+        },
+    }
+
     def __init__(self, client):
         super().__init__()
         self.client = client
@@ -588,20 +732,69 @@ class OMNY(
         self.corr_angle_y = []
         self.corr_pos_y_2 = []
         self.corr_angle_y_2 = []
-        self.progress = {}
-        self.progress["subtomo"] = 0
-        self.progress["subtomo_projection"] = 0
-        self.progress["subtomo_total_projections"] = 1
-        self.progress["projection"] = 0
-        self.progress["total_projections"] = 1
-        self.progress["angle"] = 0
-        self.progress["tomo_type"] = 0
+        # Progress tracking, persisted via the BEC global variable
+        # "tomo_progress" so it survives a client restart -- deliberately NOT
+        # reset here: this proxy is constructed every time OMNY() is
+        # instantiated (i.e. every new client session), and resetting
+        # unconditionally on every instantiation would wipe tomo_start_time
+        # (and everything else) on exactly the restarts where recovering
+        # scan state matters most. A genuinely new tomo_scan() call resets
+        # the relevant fields itself (see the "new scan" branch in
+        # tomo_scan()).
+        self._progress_proxy = _ProgressProxy(self.client)
         self.OMNYTools = OMNYTools(self.client)
+        self._init_tomo_queue()
         OMNY_rt_client.__init__(self)
         self.align = XrayEyeAlign(self.client, self)
         OMNYGuiTools.__init__(self)
         self.set_client(self.client)
 
+    @property
+    def progress(self) -> _ProgressProxy:
+        """Proxy dict backed by the BEC global variable ``tomo_progress``.
+
+        Readable from any BEC client session via::
+
+            client.get_global_var("tomo_progress")
+
+        Individual fields can be read and written just like a regular dict::
+
+            omny.progress["projection"]          # read
+            omny.progress["projection"] = 42     # write (persists immediately)
+
+        To update multiple fields atomically use :py:meth:`_ProgressProxy.update`::
+
+            omny.progress.update(projection=42, angle=90.0)
+
+        To reset all fields to their defaults::
+
+            omny.progress.reset()
+        """
+        return self._progress_proxy
+
+    @progress.setter
+    def progress(self, val: dict) -> None:
+        """Replace the entire progress dict.
+
+        Accepts a plain :class:`dict` and persists it to the global var store.
+        """
+        if not isinstance(val, dict):
+            raise TypeError(f"progress must be a dict, got {type(val).__name__!r}")
+        self._progress_proxy._save(val)
+
+    def tomo_progress_reset(self) -> None:
+        """Explicitly clear the persisted tomo progress (start time, ETA,
+        current angle/subtomo/projection, accumulated idle time, ...).
+
+        Not called automatically on OMNY() startup -- that would wipe an
+        in-progress scan's state on every kernel restart. Call this by hand
+        if you want a clean progress display without it being tied to
+        starting a new tomo_scan() (which already resets the relevant
+        fields itself).
+        """
+        self._progress_proxy.reset()
+        print("Tomo progress reset.")
+
     def start_x_ray_eye_alignment(self):
         if self.OMNYTools.yesno(
             "Starting Xrayeye alignment. Deleting any potential existing alignment for this sample.",
@@ -1055,6 +1248,8 @@ class OMNY(
 
     def tomo_scan(self, subtomo_start=1, start_angle=None, projection_number=None):
         """start a tomo scan"""
+        self.omnygui_show_progress()
+
         bec = builtins.__dict__.get("bec")
         scans = builtins.__dict__.get("scans")
         self._current_special_angles = self.special_angles.copy()
@@ -1066,11 +1261,13 @@ class OMNY(
         ):
 
             # pylint: disable=undefined-variable
+            # bec.active_account is a plain str, not bytes -- .decode() used
+            # to crash with AttributeError on every real account.
             if bec.active_account != "":
                 self.tomo_id = self.add_sample_database(
                     self.sample_name,
                     str(datetime.date.today()),
-                    bec.active_account.decode(),
+                    bec.active_account,
                     bec.queue.next_scan_number,
                     "OMNY",
                     "test additional info",
@@ -1079,111 +1276,201 @@ class OMNY(
                 self.write_pdf_report()
             else:
                 self.tomo_id = 0
+            self.progress["tomo_start_time"] = datetime.datetime.now().isoformat()
+            # reset stale estimates from any previous scan, otherwise the GUI
+            # would keep showing a leftover ETA from before this scan has
+            # accumulated enough projections to compute a fresh one
+            self.progress["estimated_remaining_time"] = None
+            self.progress["estimated_finish_time"] = None
+            self.progress["accumulated_idle_time"] = 0.0
+            self.progress["heartbeat"] = None
 
-        with scans.dataset_id_on_hold:
-            if self.tomo_type in (1, 4, 5):
-                # equally spaced sub-tomograms (2, 4, or 8)
-                n_subtomos = {1: 2, 4: 4, 5: 8}[self.tomo_type]
-                self.progress["tomo_type"] = f"Equally spaced sub-tomograms ({n_subtomos})"
-                for ii in range(subtomo_start, n_subtomos + 1):
-                    self.sub_tomo_scan(ii, n_subtomos=n_subtomos, start_angle=start_angle)
-                    start_angle = None
+        try:
+            with scans.dataset_id_on_hold:
+                if self.tomo_type in (1, 4, 5):
+                    # equally spaced sub-tomograms (2, 4, or 8)
+                    n_subtomos = {1: 2, 4: 4, 5: 8}[self.tomo_type]
+                    self.progress["tomo_type"] = f"Equally spaced sub-tomograms ({n_subtomos})"
+                    for ii in range(subtomo_start, n_subtomos + 1):
+                        self.sub_tomo_scan(ii, n_subtomos=n_subtomos, start_angle=start_angle)
+                        start_angle = None
 
-            elif self.tomo_type == 2:
-                # Golden ratio tomography
-                previous_subtomo_number = -1
-                if projection_number == None:
-                    ii = 0
-                else:
-                    ii = projection_number
-                while True:
-                    angle, subtomo_number = self._golden(ii, self.golden_ratio_bunch_size, 180, 1)
-                    if previous_subtomo_number != subtomo_number:
-                        self._write_subtomo_to_scilog(subtomo_number)
+                elif self.tomo_type == 2:
+                    # Golden ratio tomography
+                    previous_subtomo_number = -1
+                    if projection_number == None:
+                        ii = 0
+                    else:
+                        ii = projection_number
+                    while True:
+                        angle, subtomo_number = self._golden(
+                            ii, self.golden_ratio_bunch_size, 180, 1
+                        )
+                        if previous_subtomo_number != subtomo_number:
+                            self._write_subtomo_to_scilog(subtomo_number)
+                            if (
+                                subtomo_number % 2 == 1
+                                and ii > 10
+                                and self.golden_projections_at_0_deg_for_damage_estimation == 1
+                            ):
+                                self._tomo_scan_at_angle(0, subtomo_number)
+                            previous_subtomo_number = subtomo_number
+                        self.progress["tomo_type"] = "Golden ratio tomography"
+                        self.progress["subtomo"] = subtomo_number
+                        self.progress["projection"] = ii
+                        self.progress["angle"] = angle
+                        if self.golden_ratio_bunch_size > 0:
+                            self.progress["subtomo_total_projections"] = (
+                                self.golden_ratio_bunch_size
+                            )
+                            self.progress["subtomo_projection"] = (
+                                ii - (subtomo_number - 1) * self.golden_ratio_bunch_size
+                            )
+                        else:
+                            self.progress["subtomo_total_projections"] = 0
+                            self.progress["subtomo_projection"] = 0
+
+                        if self.golden_max_number_of_projections > 0:
+                            self.progress["total_projections"] = (
+                                self.golden_max_number_of_projections
+                            )
+                        else:
+                            self.progress["total_projections"] = 0
+
+                        self._tomo_scan_at_angle(angle, subtomo_number)
+                        ii += 1
                         if (
-                            subtomo_number % 2 == 1
-                            and ii > 10
-                            and self.golden_projections_at_0_deg_for_damage_estimation == 1
+                            ii > self.golden_max_number_of_projections
+                            and self.golden_max_number_of_projections > 0
                         ):
-                            self._tomo_scan_at_angle(0, subtomo_number)
-                        previous_subtomo_number = subtomo_number
-                    self.progress["tomo_type"] = "Golden ratio tomography"
-                    self.progress["subtomo"] = subtomo_number
-                    self.progress["projection"] = ii
-                    self.progress["angle"] = angle
-                    if self.golden_ratio_bunch_size > 0:
-                        self.progress["subtomo_total_projections"] = self.golden_ratio_bunch_size
+                            print(
+                                f"Golden ratio tomography stopped automatically after the requested {self.golden_max_number_of_projections} projections"
+                            )
+                            break
+
+                elif self.tomo_type == 3:
+                    # Equally spaced tomography, golden ratio starting angle
+                    previous_subtomo_number = -1
+                    if projection_number == None:
+                        ii = 0
+                    else:
+                        ii = projection_number
+                    while True:
+                        angle, subtomo_number = self._golden_equally_spaced(
+                            ii, int(180 / self.tomo_angle_stepsize), 180, 1, 0
+                        )
+                        if previous_subtomo_number != subtomo_number:
+                            self._write_subtomo_to_scilog(subtomo_number)
+                            if (
+                                subtomo_number % 2 == 1
+                                and ii > 10
+                                and self.golden_projections_at_0_deg_for_damage_estimation == 1
+                            ):
+                                self._tomo_scan_at_angle(0, subtomo_number)
+                            previous_subtomo_number = subtomo_number
+                        self.progress["tomo_type"] = (
+                            "Equally spaced tomography, golden ratio starting angle"
+                        )
+                        self.progress["subtomo"] = subtomo_number
+                        self.progress["projection"] = ii
+                        self.progress["angle"] = angle
+
+                        self.progress["subtomo_total_projections"] = 180 / self.tomo_angle_stepsize
                         self.progress["subtomo_projection"] = (
-                            ii - (subtomo_number - 1) * self.golden_ratio_bunch_size
+                            ii - (subtomo_number - 1) * self.progress["subtomo_total_projections"]
                         )
-                    else:
-                        self.progress["subtomo_total_projections"] = 0
-                        self.progress["subtomo_projection"] = 0
 
-                    if self.golden_max_number_of_projections > 0:
-                        self.progress["total_projections"] = self.golden_max_number_of_projections
-                    else:
-                        self.progress["total_projections"] = 0
-
-                    self._tomo_scan_at_angle(angle, subtomo_number)
-                    ii += 1
-                    if (
-                        ii > self.golden_max_number_of_projections
-                        and self.golden_max_number_of_projections > 0
-                    ):
-                        print(
-                            f"Golden ratio tomography stopped automatically after the requested {self.golden_max_number_of_projections} projections"
-                        )
-                        break
-
-            elif self.tomo_type == 3:
-                # Equally spaced tomography, golden ratio starting angle
-                previous_subtomo_number = -1
-                if projection_number == None:
-                    ii = 0
-                else:
-                    ii = projection_number
-                while True:
-                    angle, subtomo_number = self._golden_equally_spaced(
-                        ii, int(180 / self.tomo_angle_stepsize), 180, 1, 0
-                    )
-                    if previous_subtomo_number != subtomo_number:
-                        self._write_subtomo_to_scilog(subtomo_number)
+                        if self.golden_max_number_of_projections > 0:
+                            self.progress["total_projections"] = (
+                                self.golden_max_number_of_projections
+                            )
+                        else:
+                            self.progress["total_projections"] = 0
+                        self._tomo_scan_at_angle(angle, subtomo_number)
+                        ii += 1
                         if (
-                            subtomo_number % 2 == 1
-                            and ii > 10
-                            and self.golden_projections_at_0_deg_for_damage_estimation == 1
+                            ii > self.golden_max_number_of_projections
+                            and self.golden_max_number_of_projections > 0
                         ):
-                            self._tomo_scan_at_angle(0, subtomo_number)
-                        previous_subtomo_number = subtomo_number
-                    self.progress["tomo_type"] = (
-                        "Equally spaced tomography, golden ratio starting angle"
-                    )
-                    self.progress["subtomo"] = subtomo_number
-                    self.progress["projection"] = ii
-                    self.progress["angle"] = angle
+                            print(
+                                f"Golden ratio tomography stopped automatically after the requested {self.golden_max_number_of_projections} projections"
+                            )
+                            break
+                else:
+                    raise OMNYError("undefined tomo type")
+        finally:
+            # Cleared on every exit path (normal completion, exception, or
+            # interrupt) -- not just at the next scan's start above -- so the
+            # GUI's busy-detectors see this immediately on their next poll
+            # instead of waiting out the heartbeat-staleness timeout after a
+            # tomogram that's actually already done. Mirrors flomni's/lamni's
+            # identical fix.
+            self.progress["heartbeat"] = None
 
-                    self.progress["subtomo_total_projections"] = 180 / self.tomo_angle_stepsize
-                    self.progress["subtomo_projection"] = (
-                        ii - (subtomo_number - 1) * self.progress["subtomo_total_projections"]
-                    )
+    def tomo_scan_resume(self) -> None:
+        """Resume a tomo_scan() that crashed or was interrupted, picking up
+        automatically from wherever ``progress`` last reported -- no need to
+        read the last subtomo/angle/projection off the progress printout by
+        hand and pass it to tomo_scan() yourself.
 
-                    if self.golden_max_number_of_projections > 0:
-                        self.progress["total_projections"] = self.golden_max_number_of_projections
-                    else:
-                        self.progress["total_projections"] = 0
-                    self._tomo_scan_at_angle(angle, subtomo_number)
-                    ii += 1
-                    if (
-                        ii > self.golden_max_number_of_projections
-                        and self.golden_max_number_of_projections > 0
-                    ):
-                        print(
-                            f"Golden ratio tomography stopped automatically after the requested {self.golden_max_number_of_projections} projections"
-                        )
-                        break
-            else:
-                raise OMNYError("undefined tomo type")
+        Re-attempts the exact angle/projection that was in progress at the
+        moment of interruption, rather than skipping ahead to the next one:
+        from here we can't be sure whether that last point was actually
+        acquired before the crash, and re-acquiring one extra projection is
+        harmless.
+
+        Works standalone for a normal tomo_scan(), independent of the tomo
+        queue. tomo_queue_execute() (see TomoQueueMixin) also calls this
+        internally when resuming a job that previously failed partway
+        through, so a failed queue job picks up mid-scan rather than
+        restarting from subtomo 1 / angle 0. Direct port of flomni's/lamni's
+        identical method, generalized to OMNY's three equally-spaced-
+        sub-tomogram flavors (tomo_type 1/4/5) via _TOMO_TYPE_1_LIKE.
+        """
+        if self.progress.get("tomo_start_time") is None:
+            print("No tomo scan in progress to resume -- nothing to do.")
+            return
+
+        if self.tomo_type in self._TOMO_TYPE_1_LIKE:
+            subtomo_start = self.progress["subtomo"]
+            start_angle = self.progress["angle"]
+            if subtomo_start < 1:
+                print("No tomo scan in progress to resume -- nothing to do.")
+                return
+            print(f"Resuming tomo scan at subtomo {subtomo_start}, angle {start_angle:.3f} deg.")
+            self.tomo_scan(subtomo_start=subtomo_start, start_angle=start_angle)
+        elif self.tomo_type in (2, 3):
+            projection_number = self.progress["projection"]
+            print(f"Resuming tomo scan at projection {projection_number}.")
+            self.tomo_scan(projection_number=projection_number)
+        else:
+            raise OMNYError("undefined tomo type")
+
+    def _resolve_type1_projection(self, projection_number: int) -> tuple[int, float]:
+        """Map a flat 0-indexed projection number to (subtomo_start,
+        start_angle), for tomo_queue_reacquire() (TomoQueueMixin) on any
+        tomo_type in _TOMO_TYPE_1_LIKE (1/4/5).
+
+        Reuses _equally_spaced_subtomo_angles() (the single, already-verified
+        source of truth for this angle grid -- see
+        omny/AI_docs/OPEN_ISSUES.md) rather than re-deriving the math here.
+        """
+        n_subtomos = {1: 2, 4: 4, 5: 8}[self.tomo_type]
+        N = int(180.0 / self.tomo_angle_stepsize)
+        total = N * n_subtomos
+        if not 0 <= projection_number < total:
+            raise ValueError(
+                f"projection_number must be in [0, {total}) for tomo_type "
+                f"{self.tomo_type} ({n_subtomos} sub-tomograms, {N} projections each), "
+                f"got {projection_number}."
+            )
+        subtomo_start = projection_number // N + 1
+        projection_within_subtomo = projection_number % N
+        angles = self._equally_spaced_subtomo_angles(
+            subtomo_start, n_subtomos, self.tomo_angle_stepsize
+        )
+        start_angle = float(angles[projection_within_subtomo])
+        return subtomo_start, start_angle
 
     def _print_progress(self):
         print("\x1b[95mProgress report:")
@@ -1210,6 +1497,12 @@ class OMNY(
         return tomo_number
 
     def _at_each_angle(self, angle: float) -> None:
+        hook_name = self.at_each_angle_hook
+        if hook_name:
+            hook = self._resolve_at_each_angle_hook(hook_name, OMNYError)
+            hook(self, angle)
+            return
+
         if "omny_at_each_angle" in builtins.__dict__:
             # pylint: disable=undefined-variable
             omny_at_each_angle(self, angle)
@@ -1555,6 +1848,15 @@ class OMNY(
             fzp_details = self._get_user_param_safe("ofzpx", "fzp_details")
         except Exception:
             fzp_details = "N/A"
+        # The energy readback device is "ccm_energy", not "mokev" -- OMNY has
+        # no mokev device in any config (real or simulated). Read it
+        # defensively so a missing/misbehaving device doesn't crash the
+        # whole report instead of just omitting one line.
+        try:
+            energy_kev = dev.ccm_energy.read(cached=True)[dev.ccm_energy.name]["value"]
+            energy_str = f"{energy_kev:>{padding}.4f}"
+        except Exception:
+            energy_str = f"{'N/A':>{padding}}"
         content = [
             f"{'Sample Name:':<{padding}}{self.sample_name:>{padding}}\n",
             f"{'Measurement ID:':<{padding}}{str(self.tomo_id):>{padding}}\n",
@@ -1564,7 +1866,7 @@ class OMNY(
             f"{'Number of projections:':<{padding}}{int(180 / self.tomo_angle_stepsize * 8):>{padding}}\n",
             f"{'First scan number:':<{padding}}{self.client.queue.next_scan_number:>{padding}}\n",
             f"{'Last scan number approx.:':<{padding}}{self.client.queue.next_scan_number + int(180 / self.tomo_angle_stepsize * 8) + 10:>{padding}}\n",
-            f"{'Current photon energy:':<{padding}}{dev.mokev.read()['mokev']['value']:>{padding}.4f}\n",
+            f"{'Current photon energy:':<{padding}}{energy_str}\n",
             f"{'Exposure time:':<{padding}}{self.tomo_countingtime:>{padding}.2f}\n",
             f"{'Fermat spiral step size:':<{padding}}{self.tomo_shellstep:>{padding}.2f}\n",
             f"{'FOV:':<{padding}}{fovxy:>{padding}}\n",
@@ -1583,12 +1885,19 @@ class OMNY(
             "xterm /work/sls/spec/local/XOMNY/bin/upload/upload_last_pon.sh &", shell=True
         )
         # status = subprocess.run(f"cp /tmp/spec-e20131-specES1.pdf {user_target}", shell=True)
-        msg = bec.logbook.LogbookMessage()
-        logo_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "LamNI_logo.png")
-        msg.add_file(logo_path).add_text("".join(content).replace("\n", "</p><p>")).add_tag(
-            ["BEC", "tomo_parameters", f"dataset_id_{dataset_id}", "LamNI", self.sample_name]
-        )
-        self.client.logbook.send_logbook_message(msg)
+        # Same tolerance as write_to_scilog(): a session without scilog/
+        # logbook configured (e.g. a dev/sim session) must not crash report
+        # generation over the logbook upload -- the PDF itself is already
+        # written above.
+        try:
+            msg = bec.logbook.LogbookMessage()
+            logo_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "OMNY.png")
+            msg.add_file(logo_path).add_text("".join(content).replace("\n", "</p><p>")).add_tag(
+                ["BEC", "tomo_parameters", f"dataset_id_{dataset_id}", "OMNY", self.sample_name]
+            )
+            self.client.logbook.send_logbook_message(msg)
+        except Exception:
+            logger.warning("Failed to write PDF report to scilog.")
 
     def vcs_show_all():
         dev.omny_vcs.show_all()
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
new file mode 100644
index 00000000..6ad9cca9
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
@@ -0,0 +1,317 @@
+"""Unit tests for the tomo-queue / at-each-angle-hook backend ported to
+OMNY from flomni/lamni (see TomoQueueMixin in
+csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py).
+
+Builds an OMNY instance without running __init__'s heavy side effects
+(device init, gui_tools, x-ray-eye alignment, ...) -- only what the
+tomo-queue backend actually needs: self.client + _init_tomo_queue().
+Mirrors test_lamni_tomo_queue.py's structure exactly, plus OMNY-specific
+coverage for its three "equally spaced sub-tomograms" tomo_type flavors
+(1/4/5, via _TOMO_TYPE_1_LIKE) that flomni/lamni don't have.
+"""
+
+import types
+
+import numpy as np
+
+import csaxs_bec.bec_ipython_client.plugins.omny.omny as omny_module
+import csaxs_bec.bec_ipython_client.plugins.OMNY_shared.tomo_queue_mixin as tomo_queue_mixin
+from csaxs_bec.bec_ipython_client.plugins.omny.omny import OMNY, OMNYError, _ProgressProxy
+
+
+class FakeClient:
+    """Minimal in-memory stand-in for BEC's global-var store."""
+
+    def __init__(self):
+        self._vars = {}
+
+    def get_global_var(self, key):
+        return self._vars.get(key)
+
+    def set_global_var(self, key, value):
+        self._vars[key] = value
+
+
+class FakeOMNYTools:
+    def __init__(self, answer=True):
+        self.answer = answer
+
+    def yesno(self, *args, **kwargs):
+        return self.answer
+
+
+def make_omny(fake_client=None):
+    # sample_name reads the module-level `dev` (set at import time inside a
+    # real BEC session only) -- stand in a fake so tomo_queue_execute()'s
+    # confirmation prompt (which reads self.sample_name) doesn't NameError.
+    omny_module.dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+
+    obj = object.__new__(OMNY)
+    obj.client = fake_client or FakeClient()
+    obj.OMNYTools = FakeOMNYTools()
+    obj._progress_proxy = _ProgressProxy(obj.client)
+    obj._init_tomo_queue()
+    return obj
+
+
+def test_tomo_scan_param_names_have_no_flomni_only_concepts():
+    """OMNY mirrors flomni's names for shared concepts, but has no
+    180/360 toggle, no single-point acquisition, no zero-deg reference,
+    and no frames_per_trigger -- none of these exist as OMNY properties."""
+    names = OMNY._TOMO_SCAN_PARAM_NAMES
+    assert "tomo_angle_range" not in names
+    assert "single_point_instead_of_fermat_scan" not in names
+    assert "single_point_random_shift_max" not in names
+    assert "zero_deg_reference_at_each_subtomo" not in names
+    assert "frames_per_trigger" not in names
+    # shared-with-flomni names are present, using OMNY's own property names
+    assert "fovx" in names
+    assert "stitch_x" in names
+    assert "tomo_angle_stepsize" in names
+
+
+def test_tomo_queue_add_snapshots_all_param_names():
+    omny = make_omny()
+    omny.tomo_countingtime = 0.2
+    omny.fovx = 42.0
+
+    index = omny.tomo_queue_add(label="my job")
+
+    assert index == 0
+    jobs = omny._tomo_queue_proxy.as_list()
+    assert len(jobs) == 1
+    job = jobs[0]
+    assert job["label"] == "my job"
+    assert job["kind"] == "tomo"
+    assert job["status"] == "pending"
+    assert set(job["params"]) == set(OMNY._TOMO_SCAN_PARAM_NAMES)
+    assert job["params"]["tomo_countingtime"] == 0.2
+    assert job["params"]["fovx"] == 42.0
+
+
+def test_tomo_queue_show_survives_missing_param_key(capsys):
+    """A job snapshotted before some key existed in _TOMO_SCAN_PARAM_NAMES
+    won't carry it in its persisted params dict -- tomo_queue_show() must
+    still print a line for it instead of raising KeyError."""
+    omny = make_omny()
+    omny.fovx = 15.0
+    omny.tomo_queue_add(label="job1")
+    jobs = omny._tomo_queue_proxy.as_list()
+    del jobs[0]["params"]["fovx"]
+    omny.client.set_global_var("tomo_queue", jobs)
+
+    result = omny.tomo_queue_show()
+
+    assert result[0]["label"] == "job1"
+    capsys.readouterr()  # just confirm no crash while printing
+
+
+def test_tomo_queue_execute_runs_fresh_job_then_marks_done():
+    omny = make_omny()
+    calls = []
+    omny.tomo_scan = lambda *a, **k: calls.append(("scan", a, k))
+    omny.tomo_scan_resume = lambda *a, **k: calls.append(("resume", a, k))
+
+    omny.tomo_queue_add(label="job1")
+    omny.tomo_queue_execute()
+
+    assert calls == [("scan", (), {"interactive": False})]
+    job = omny._tomo_queue_proxy.as_list()[0]
+    assert job["status"] == "done"
+
+
+def test_tomo_queue_execute_resumes_incomplete_job():
+    omny = make_omny()
+    calls = []
+    omny.tomo_scan = lambda *a, **k: calls.append(("scan", a, k))
+    omny.tomo_scan_resume = lambda *a, **k: calls.append(("resume", a, k))
+
+    index = omny.tomo_queue_add(label="job1")
+    omny._tomo_queue_proxy.update(index, status="incomplete")
+
+    omny.tomo_queue_execute()
+
+    assert calls == [("resume", (), {})]
+    job = omny._tomo_queue_proxy.as_list()[0]
+    assert job["status"] == "done"
+
+
+def test_tomo_queue_add_command_move_action(monkeypatch):
+    omny = make_omny()
+    fake_dev = {"ccm_energy": "ccm-energy-device"}
+    moved = []
+    monkeypatch.setattr(tomo_queue_mixin, "dev", fake_dev, raising=False)
+    monkeypatch.setattr(tomo_queue_mixin, "umv", lambda *a: moved.append(a), raising=False)
+
+    omny.tomo_queue_add_command(
+        {"action": "move", "kwargs": {"positions": {"ccm_energy": 6.2}}}, label="reconfigure"
+    )
+    omny.tomo_queue_execute()
+
+    assert moved == [("ccm-energy-device", 6.2)]
+    job = omny._tomo_queue_proxy.as_list()[0]
+    assert job["kind"] == "command"
+    assert job["status"] == "done"
+
+
+def test_tomo_queue_add_command_rejects_non_movable_device():
+    omny = make_omny()
+    try:
+        omny.tomo_queue_add_command({"action": "move", "kwargs": {"positions": {"fzp": 1.0}}})
+        assert False, "expected ValueError for a non-allow-listed device"
+    except ValueError as exc:
+        assert "not queue-movable" in str(exc)
+
+
+def test_register_at_each_angle_hook_dispatches_from_at_each_angle():
+    omny = make_omny()
+    seen = []
+    omny.register_at_each_angle_hook("record", lambda self, angle: seen.append(angle))
+    omny.at_each_angle_hook = "record"
+
+    omny._at_each_angle(12.5)
+
+    assert seen == [12.5]
+    assert omny.client.get_global_var("tomo_at_each_angle_hooks") == ["record"]
+
+
+def test_at_each_angle_default_path_unchanged_without_hook():
+    """No hook registered -- must fall through to the exact same default
+    behaviour omny had before this port: tomo_scan_projection + tomo_reconstruct."""
+    omny = make_omny()
+    calls = []
+    omny.tomo_scan_projection = lambda angle: calls.append(("projection", angle))
+    omny.tomo_reconstruct = lambda: calls.append(("reconstruct",))
+
+    omny._at_each_angle(30.0)
+
+    assert calls == [("projection", 30.0), ("reconstruct",)]
+
+
+def test_at_each_angle_falls_through_to_legacy_builtins_hook(monkeypatch):
+    """The pre-existing omny_at_each_angle builtins hook must still work as
+    the second-tier fallback, when no at_each_angle_hook is registered."""
+    import builtins
+
+    omny = make_omny()
+    calls = []
+    monkeypatch.setitem(
+        builtins.__dict__, "omny_at_each_angle", lambda setup, angle: calls.append(angle)
+    )
+
+    omny._at_each_angle(7.0)
+
+    assert calls == [7.0]
+
+
+def test_at_each_angle_raises_for_unregistered_hook_name():
+    omny = make_omny()
+    omny.at_each_angle_hook = "missing_hook"
+    try:
+        omny._at_each_angle(0.0)
+        assert False, "expected OMNYError for an unregistered hook name"
+    except OMNYError as exc:
+        assert "missing_hook" in str(exc)
+        assert "not registered" in str(exc)
+
+
+# --- OMNY-specific: tomo_scan_resume() over three sub-tomogram flavors -------
+
+
+def test_tomo_scan_resume_dispatches_subtomo_angle_for_type_1_4_5():
+    for tomo_type, expected_subtomo, expected_angle in [(1, 2, 55.0), (4, 3, 20.0), (5, 7, 90.0)]:
+        omny = make_omny()
+        omny.tomo_type = tomo_type
+        omny.progress["tomo_start_time"] = "2026-01-01T00:00:00"
+        omny.progress["subtomo"] = expected_subtomo
+        omny.progress["angle"] = expected_angle
+        calls = []
+        omny.tomo_scan = lambda *a, **k: calls.append(("scan", a, k))
+
+        omny.tomo_scan_resume()
+
+        assert calls == [
+            ("scan", (), {"subtomo_start": expected_subtomo, "start_angle": expected_angle})
+        ], tomo_type
+
+
+def test_tomo_scan_resume_dispatches_projection_number_for_type_2_3():
+    for tomo_type in (2, 3):
+        omny = make_omny()
+        omny.tomo_type = tomo_type
+        omny.progress["tomo_start_time"] = "2026-01-01T00:00:00"
+        omny.progress["projection"] = 42
+        calls = []
+        omny.tomo_scan = lambda *a, **k: calls.append(("scan", a, k))
+
+        omny.tomo_scan_resume()
+
+        assert calls == [("scan", (), {"projection_number": 42})], tomo_type
+
+
+def test_tomo_scan_resume_noop_when_nothing_in_progress(capsys):
+    omny = make_omny()
+    calls = []
+    omny.tomo_scan = lambda *a, **k: calls.append(a)
+
+    omny.tomo_scan_resume()
+
+    assert calls == []
+    assert "nothing to do" in capsys.readouterr().out
+
+
+# --- OMNY-specific: _resolve_type1_projection() for n_subtomos in {2,4,8} ---
+
+
+def test_resolve_type1_projection_matches_equally_spaced_subtomo_angles():
+    """Cross-check against _equally_spaced_subtomo_angles() itself -- the
+    single source of truth for this angle grid -- rather than
+    re-deriving/duplicating the math in the test."""
+    for tomo_type, n_subtomos in [(1, 2), (4, 4), (5, 8)]:
+        omny = make_omny()
+        omny.tomo_type = tomo_type
+        omny.tomo_angle_stepsize = 10.0
+        N = int(180.0 / omny.tomo_angle_stepsize)
+
+        for projection_number in range(N * n_subtomos):
+            subtomo_start, start_angle = omny._resolve_type1_projection(projection_number)
+            expected_subtomo = projection_number // N + 1
+            expected_angle = OMNY._equally_spaced_subtomo_angles(
+                expected_subtomo, n_subtomos, omny.tomo_angle_stepsize
+            )[projection_number % N]
+            assert subtomo_start == expected_subtomo
+            assert np.isclose(start_angle, expected_angle)
+
+
+def test_resolve_type1_projection_rejects_out_of_range():
+    omny = make_omny()
+    omny.tomo_type = 1
+    omny.tomo_angle_stepsize = 10.0
+    N = int(180.0 / omny.tomo_angle_stepsize)
+    total = N * 2  # n_subtomos=2 for tomo_type 1
+
+    try:
+        omny._resolve_type1_projection(total)
+        assert False, "expected ValueError for an out-of-range projection number"
+    except ValueError:
+        pass
+
+
+def test_tomo_queue_reacquire_dispatches_type1_like_for_types_1_4_5():
+    """tomo_queue_reacquire() (TomoQueueMixin) hardcodes tomo_type == 1 by
+    default; OMNY overrides _TOMO_TYPE_1_LIKE to {1, 4, 5} so reacquiring a
+    type-4/5 job also resolves via _resolve_type1_projection() instead of
+    hitting the mixin's "unknown tomo_type" branch."""
+    for tomo_type, n_subtomos in [(1, 2), (4, 4), (5, 8)]:
+        omny = make_omny()
+        omny.tomo_type = tomo_type
+        omny.tomo_angle_stepsize = 10.0
+        omny.tomo_queue_add(label="job1")
+
+        omny.tomo_queue_reacquire(0, projection_number=1)
+
+        job = omny._tomo_queue_proxy.as_list()[0]
+        assert job["status"] == "incomplete", tomo_type
+        assert omny.progress["subtomo"] in range(1, n_subtomos + 1), tomo_type
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
new file mode 100644
index 00000000..ade871ba
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -0,0 +1,183 @@
+"""Unit tests for tomo_scan()'s new-scan account handling, progress-GUI
+auto-show, and heartbeat-clearing -- all part of porting the tomo-queue
+backend (TomoQueueMixin) to OMNY. Mirrors test_lamni_tomo_angles.py's
+equivalent tests exactly (same bug shapes, same fixes, direct ports of
+flomni's/lamni's already-fixed code).
+
+bec.active_account used to be passed through .decode() (as if it were
+bytes) -- it's a plain str, so this raised AttributeError on every real
+tomo_scan() call with a real account. Unlike flomni/lamni (which always
+attempt sample-database registration, letting it decide the empty-account
+case), OMNY's existing "if bec.active_account != '': ... else: tomo_id = 0"
+branch structure is preserved as-is here -- only the .decode() bug itself
+is fixed, not the branch structure (no TomoIDManager/test-server fallback
+exists in OMNY's own add_sample_database()).
+"""
+
+import builtins
+import types
+
+import pytest
+
+import csaxs_bec.bec_ipython_client.plugins.omny.omny as omny_module
+from csaxs_bec.bec_ipython_client.plugins.omny.omny import OMNY, _ProgressProxy
+
+
+class FakeGlobalVarClient:
+    """Minimal in-memory stand-in for BEC's global-var store."""
+
+    def __init__(self):
+        self._vars = {}
+
+    def get_global_var(self, key):
+        return self._vars.get(key)
+
+    def set_global_var(self, key, value):
+        self._vars[key] = value
+
+
+class _FakeContextManager:
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *exc_info):
+        return False
+
+
+class _FakeScans:
+    dataset_id_on_hold = _FakeContextManager()
+
+
+def make_omny_for_tomo_scan(monkeypatch, tomo_angle_stepsize: float, active_account: str) -> OMNY:
+    """Bare OMNY instance with tomo_scan()'s "new scan" branch reachable,
+    everything downstream of it stubbed out (sample database, PDF report,
+    per-sub-tomogram scanning) so only the logic under test actually runs."""
+    # sample_name reads the module-level `dev` (set at import time inside a
+    # real BEC session only) -- stand in a fake so tomo_scan()'s sample-
+    # database registration (which reads self.sample_name) doesn't NameError.
+    omny_module.dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+
+    obj = object.__new__(OMNY)
+    obj.client = FakeGlobalVarClient()
+    obj._progress_proxy = _ProgressProxy(obj.client)
+    obj.tomo_type = 1
+    obj.tomo_angle_stepsize = tomo_angle_stepsize
+    obj.special_angles = []
+    obj._current_special_angles = []
+    obj.write_pdf_report = lambda: None
+    obj.sub_tomo_scan = lambda subtomo_number, n_subtomos=2, start_angle=None: None
+    obj.omnygui_show_progress = lambda: None
+    monkeypatch.setitem(
+        builtins.__dict__,
+        "bec",
+        types.SimpleNamespace(
+            active_account=active_account, queue=types.SimpleNamespace(next_scan_number=1)
+        ),
+    )
+    monkeypatch.setitem(builtins.__dict__, "scans", _FakeScans())
+    return obj
+
+
+def test_tomo_scan_skips_sample_database_without_active_account(monkeypatch):
+    """Empty active_account (e.g. a dev/sim session) must not crash and must
+    not attempt sample-database registration -- OMNY's own add_sample_database()
+    has no test-server/empty-account fallback, unlike flomni's/lamni's."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    called = []
+    omny.add_sample_database = lambda *a, **k: called.append(a) or 99
+
+    omny.tomo_scan()
+
+    assert called == []
+    assert omny.tomo_id == 0
+
+
+def test_tomo_scan_registers_sample_with_plain_string_account(monkeypatch):
+    """A real active_account must be passed through as-is -- calling
+    .decode() on it (a plain str, not bytes) raises AttributeError."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="e12345")
+    recorded = {}
+
+    def _fake_add_sample_database(samplename, date, eaccount, scan_number, setup, info, user):
+        recorded["eaccount"] = eaccount
+        return 42
+
+    omny.add_sample_database = _fake_add_sample_database
+
+    omny.tomo_scan()
+
+    assert recorded["eaccount"] == "e12345"
+    assert omny.tomo_id == 42
+
+
+def test_tomo_scan_shows_progress_gui(monkeypatch):
+    """tomo_scan() must open/show the progress GUI unconditionally at the
+    start of every scan -- previously only shown per-angle inside
+    _tomo_scan_at_angle(), never at scan start."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    calls = []
+    omny.omnygui_show_progress = lambda: calls.append("shown")
+
+    omny.tomo_scan()
+
+    assert calls == ["shown"]
+
+
+def test_tomo_scan_clears_heartbeat_on_normal_completion(monkeypatch):
+    """The busy-detector heartbeat must be cleared as soon as the scan
+    finishes, not left for the next poll to time out before the GUI stops
+    showing "beamline busy" for an already-finished scan.
+
+    sub_tomo_scan() is stubbed to set a fresh heartbeat before returning,
+    the same way the real _tomo_scan_at_angle() does at the start of every
+    projection -- without that, this test would pass even without the fix,
+    since tomo_scan()'s own "new scan" branch already resets the heartbeat
+    to None *before* the scan body runs.
+    """
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+
+    def _fake_sub_tomo_scan(subtomo_number, n_subtomos=2, start_angle=None):
+        omny.progress["heartbeat"] = "2026-01-01T00:00:00"
+
+    omny.sub_tomo_scan = _fake_sub_tomo_scan
+
+    omny.tomo_scan()
+
+    assert omny.progress["heartbeat"] is None
+
+
+def test_tomo_scan_clears_heartbeat_even_if_scan_raises(monkeypatch):
+    """The heartbeat must be cleared on every exit path, including a
+    mid-scan exception -- otherwise a crashed scan looks permanently "busy"
+    to the GUI until the staleness timeout, or forever if polled more often
+    than that."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+
+    def _boom(subtomo_number, n_subtomos=2, start_angle=None):
+        omny.progress["heartbeat"] = "2026-01-01T00:00:00"
+        raise RuntimeError("simulated crash mid-scan")
+
+    omny.sub_tomo_scan = _boom
+
+    with pytest.raises(RuntimeError):
+        omny.tomo_scan()
+
+    assert omny.progress["heartbeat"] is None
+
+
+def test_tomo_scan_sets_timing_fields_on_new_scan(monkeypatch):
+    """A fresh tomo_scan() must stamp tomo_start_time and reset stale
+    ETA/idle-time estimates from any previous scan."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.progress["estimated_remaining_time"] = "stale"
+    omny.progress["estimated_finish_time"] = "stale"
+    omny.progress["accumulated_idle_time"] = 123.0
+
+    omny.tomo_scan()
+
+    assert omny.progress["tomo_start_time"] is not None
+    assert omny.progress["estimated_remaining_time"] is None
+    assert omny.progress["estimated_finish_time"] is None
+    assert omny.progress["accumulated_idle_time"] == 0.0

From 2eaa609d296b516077d5a58c937c7d091fa50e13 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 17:46:14 +0200
Subject: [PATCH 025/102] fix(omny): migrate scilog writes to
 bec.messaging.scilog, checking _enabled

write_to_scilog()/write_pdf_report() used the old bec.logbook/client.logbook.
send_logbook_message() API, which has no "is scilog even configured" check.
Confirmed live: on a session without scilog credentials (this dev deployment
has no /etc/bec/secrets/.scilog.env at all), send() blocks indefinitely
instead of failing fast -- a real tomo_scan() hung inside
_write_subtomo_to_scilog() for 29+ minutes during Phase 1 live testing.

flomni already migrated off this API to bec.messaging.scilog, which gates
every send behind scilog._enabled (published from the deployment's actual
scilog config) -- per Mirko's direction, ported the same mechanism to both
OMNY call sites, matching flomni's write_pdf_report()/_scilog_write()
exactly rather than merely adding an active_account check.

Added 3 unit tests locking in the _enabled gate (skip when disabled, send
when enabled, tolerate a send() exception).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../bec_ipython_client/plugins/omny/omny.py   | 71 ++++++++++++------
 .../test_omny_tomo_scan.py                    | 74 +++++++++++++++++++
 2 files changed, 123 insertions(+), 22 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index c40e74b1..231194a4 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1066,17 +1066,36 @@ class OMNY(
     def sample_name(self):
         return dev.omny_samples.get_sample_name_in_samplestage()
 
-    def write_to_scilog(self, content, tags: list = None):
+    def write_to_scilog(self, content, tags: list = None) -> bool:
+        """Write a text entry to scilog, tolerating scilog being disabled or
+        unreachable. Mirrors flomni's _scilog_write(): checks
+        scilog._enabled before attempting a send, rather than trying and
+        catching whatever exception (or hang) an unconfigured/unreachable
+        scilog produces -- the old bec.logbook/client.logbook.
+        send_logbook_message() API used here previously had no such check,
+        so a session without scilog credentials configured would block
+        indefinitely on send() instead of failing fast (confirmed live: a
+        real tomo_scan() hung inside _write_subtomo_to_scilog() on a
+        session with no /etc/bec/secrets/.scilog.env at all).
+
+        Returns True if the entry was sent, False if it was skipped/failed
+        (already logged as a warning either way -- callers that don't care
+        about the outcome can ignore the return value).
+        """
+        scilog = getattr(bec.messaging, "scilog", None)
+        if scilog is None or not getattr(scilog, "_enabled", False):
+            logger.warning("scilog is not enabled; skipping scilog entry.")
+            return False
+        if tags is not None:
+            tags.append("BEC")
+        else:
+            tags = ["BEC"]
         try:
-            if tags is not None:
-                tags.append("BEC")
-            else:
-                tags = ["BEC"]
-            msg = bec.logbook.LogbookMessage()
-            msg.add_text(content).add_tag(tags)
-            self.client.logbook.send_logbook_message(msg)
-        except Exception:
-            logger.warning("Failed to write to scilog.")
+            scilog.new().add_text(content.replace("\n", "<br>")).add_tags(tags).send()
+            return True
+        except Exception as exc:
+            logger.warning(f"Failed to write to scilog: {exc}")
+            return False
 
     def tomo_alignment_scan(self):
         """
@@ -1885,19 +1904,27 @@ class OMNY(
             "xterm /work/sls/spec/local/XOMNY/bin/upload/upload_last_pon.sh &", shell=True
         )
         # status = subprocess.run(f"cp /tmp/spec-e20131-specES1.pdf {user_target}", shell=True)
-        # Same tolerance as write_to_scilog(): a session without scilog/
-        # logbook configured (e.g. a dev/sim session) must not crash report
-        # generation over the logbook upload -- the PDF itself is already
-        # written above.
-        try:
-            msg = bec.logbook.LogbookMessage()
+        # bec.logbook/client.logbook.send_logbook_message() was the old,
+        # pre-migration scilog API -- it has no "is scilog even configured"
+        # check, so on a session without scilog credentials (e.g. this dev
+        # sandbox has no /etc/bec/secrets/.scilog.env at all) the send()
+        # call blocks indefinitely instead of failing fast, hanging the
+        # whole tomo scan. flomni's write_pdf_report() uses
+        # bec.messaging.scilog instead, which is enabled/disabled based on
+        # the deployment's actual published scilog config -- mirrored here.
+        scilog = getattr(bec.messaging, "scilog", None)
+        if scilog is None or not getattr(scilog, "_enabled", False):
+            logger.warning("scilog is not enabled; skipping PDF report entry.")
+        else:
             logo_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "OMNY.png")
-            msg.add_file(logo_path).add_text("".join(content).replace("\n", "</p><p>")).add_tag(
-                ["BEC", "tomo_parameters", f"dataset_id_{dataset_id}", "OMNY", self.sample_name]
-            )
-            self.client.logbook.send_logbook_message(msg)
-        except Exception:
-            logger.warning("Failed to write PDF report to scilog.")
+            try:
+                scilog.new().add_attachment(logo_path, width=200).add_text(
+                    content.replace("\n", "<br>")
+                ).add_tags(
+                    ["BEC", "tomo_parameters", f"dataset_id_{dataset_id}", "OMNY", self.sample_name]
+                ).send()
+            except Exception as exc:
+                logger.warning(f"Failed to write PDF report to scilog: {exc}")
 
     def vcs_show_all():
         dev.omny_vcs.show_all()
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index ade871ba..202d3a20 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -181,3 +181,77 @@ def test_tomo_scan_sets_timing_fields_on_new_scan(monkeypatch):
     assert omny.progress["estimated_remaining_time"] is None
     assert omny.progress["estimated_finish_time"] is None
     assert omny.progress["accumulated_idle_time"] == 0.0
+
+
+# --- write_to_scilog(): checks scilog._enabled before attempting a send -----
+#
+# The old bec.logbook/client.logbook.send_logbook_message() API had no such
+# check -- on a session without scilog credentials configured (e.g. no
+# /etc/bec/secrets/.scilog.env at all) its send() call blocked indefinitely
+# instead of failing fast, hanging a real tomo_scan() inside
+# _write_subtomo_to_scilog() (confirmed live). Mirrors flomni's
+# _scilog_write(), which gates on bec.messaging.scilog._enabled instead.
+
+
+class _FakeSciLogMessage:
+    def __init__(self, calls):
+        self._calls = calls
+
+    def add_text(self, text):
+        self._calls.append(("add_text", text))
+        return self
+
+    def add_tags(self, tags):
+        self._calls.append(("add_tags", tags))
+        return self
+
+    def send(self):
+        self._calls.append(("send",))
+
+
+def _make_omny_with_scilog(monkeypatch, enabled: bool, raise_on_send: bool = False):
+    omny = object.__new__(OMNY)
+    calls = []
+
+    def _new():
+        if raise_on_send:
+
+            class _Boom(_FakeSciLogMessage):
+                def send(self):
+                    raise RuntimeError("scilog unreachable")
+
+            return _Boom(calls)
+        return _FakeSciLogMessage(calls)
+
+    fake_scilog = types.SimpleNamespace(_enabled=enabled, new=_new)
+    fake_bec = types.SimpleNamespace(messaging=types.SimpleNamespace(scilog=fake_scilog))
+    monkeypatch.setattr(omny_module, "bec", fake_bec, raising=False)
+    return omny, calls
+
+
+def test_write_to_scilog_skips_when_scilog_disabled(monkeypatch):
+    omny, calls = _make_omny_with_scilog(monkeypatch, enabled=False)
+
+    result = omny.write_to_scilog("hello")
+
+    assert result is False
+    assert calls == []
+
+
+def test_write_to_scilog_sends_when_scilog_enabled(monkeypatch):
+    omny, calls = _make_omny_with_scilog(monkeypatch, enabled=True)
+
+    result = omny.write_to_scilog("hello", tags=["mytag"])
+
+    assert result is True
+    assert ("add_text", "hello") in calls
+    assert ("add_tags", ["mytag", "BEC"]) in calls
+    assert ("send",) in calls
+
+
+def test_write_to_scilog_tolerates_send_exception(monkeypatch):
+    omny, calls = _make_omny_with_scilog(monkeypatch, enabled=True, raise_on_send=True)
+
+    result = omny.write_to_scilog("hello")
+
+    assert result is False

From f6fc8476fe13f0a5caa8c44a7c1ba6b51f68ad3c Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 17:48:08 +0200
Subject: [PATCH 026/102] feat(sample_storage): add OMNY support to
 OMNY_SampleStorage widget

Extends the sample-storage bookkeeping widget, previously FlOMNI-only, to
also work against dev.omny_samples: shuttles A/B/C (6 slots each), the
sparse fixed-O positions, stage, gripper, and a per-shuttle installed/active
parking status (mirrors the oparkz-driven "active parking slot" concept
from omny_sample_transfer_mixin.py). Setup detection follows the
SETUP_PROFILES/_detect_setup() convention already used by tomo_params.py.

Also fixes SimOMNYSampleStorage, which never cleared the fixed-O/shuttle-B-C
/parking slots, so they read back as the mock-PV default "0" instead of the
real empty sentinels ("-"/"none") -- SimFlomniSampleStorage already does
this correctly for the same reason.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../widgets/sample_storage/sample_storage.py  | 780 +++++++++++++++---
 csaxs_bec/devices/sim/sim_omny.py             |  26 +
 .../test_omny_sample_storage_widget_math.py   |  59 ++
 3 files changed, 761 insertions(+), 104 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py

diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index ac1c1304..0bec937c 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -1,21 +1,43 @@
 """
-OMNY_SampleStorage – BEC widget for viewing and correcting the FlOMNI
-sample-storage bookkeeping.
+OMNY_SampleStorage – BEC widget for viewing and correcting sample-storage
+bookkeeping.
 
-This widget is a GUI replacement for the ``ftransfer_show`` /
-``ftransfer_modify`` CLI commands.  It shows the sample magazine (slots
-1–20), the sample stage (slot 0) and the gripper (slot 100), and lets the
-user correct the stored records via a right-click context menu on each slot.
+This widget is a GUI replacement for the CLI sample-storage bookkeeping
+commands (FlOMNI's ``ftransfer_show``/``ftransfer_modify``, OMNY's
+``dev.omny_samples.show_all()``/``help()``). It supports two structurally
+different setups, detected at construction time (see ``SETUP_PROFILES``,
+``_detect_setup()``) — a BEC session is always exactly one setup, never
+both at once:
+
+FlOMNI (``dev.flomni_samples``)
+    A flat magazine: slots 1-20, the sample stage (slot 0) and the gripper
+    (slot 100). Each slot has a name *and* an owner, packed into one EPICS
+    DESC field (see ``sample_desc_codec``).
+
+OMNY (``dev.omny_samples``)
+    A richer structure: three shuttles (A/B/C) of 6 slots each, a sparse
+    set of "fixed O positions" ({10,11,12,13,14,32,33,34,100,101}), a
+    separate sample stage and gripper, and a 6-slot "parking" carousel
+    recording which shuttle letter is docked at each physical parking
+    position. No owner field -- names are raw strings. Whichever shuttle's
+    parking slot matches the ``oparkz`` motor's current readback is
+    "active", i.e. at the transfer-ready position (see
+    ``oparkz_active_parking_slot()``).
+
+A LamNI session has neither device; the widget shows a "no known setup
+detected" message in that case.
 
 IMPORTANT – bookkeeping only
 ----------------------------
-This widget never moves hardware.  It only reads and writes the sample
-*records* held on the ``flomni_samples`` device — exactly the same records
-that ``flomni_modify_storage_non_interactive()`` writes.  It does NOT perform
-sample transfers; those remain CLI-only (``flomni.ftransfer_sample_change``
-etc.), because they are blocking hardware sequences with interactive
-confirmations.  Editing a record here changes only what BEC *believes* is in
-a slot, so entries must be kept in sync with physical reality by the operator.
+This widget never moves hardware. It only reads and writes the sample
+*records* held on the setup's samples device — for FlOMNI, exactly the same
+records that ``flomni_modify_storage_non_interactive()`` writes. It does
+NOT perform sample transfers; those remain CLI-only, because they are
+blocking hardware sequences with interactive confirmations. Editing a
+record here changes only what BEC *believes* is in a slot, so entries must
+be kept in sync with physical reality by the operator. This also applies to
+OMNY's parking-slot assignments, which (like the sample slots) are pure
+bookkeeping never touched by the transfer code.
 
 Because a transfer and a manual record edit would both happen at the same
 workstation, there is deliberately no software interlock against editing
@@ -24,20 +46,22 @@ while a transfer they started is running).
 
 Backend
 -------
-All state lives on ``dev.flomni_samples`` (not BEC global vars), which is the
-single source of truth also consulted by the transfer state machine.  The
-widget reads/writes it directly, mirroring
-``Flomni.flomni_modify_storage_non_interactive()``:
+All state lives on the setup's samples device (not BEC global vars), which
+is the single source of truth also consulted by the transfer state machine.
+The widget reads/writes it directly:
 
-  slots 0–20 : sample_placed.sample{N}.set(used)
-               sample_names.sample{N}.set(name)
-  gripper    : sample_in_gripper.set(used)
-               sample_in_gripper_name.set(name)
+FlOMNI, slots 0-20 : sample_placed.sample{N}.set(used)
+                     sample_names.sample{N}.set(name)
+FlOMNI, gripper    : sample_in_gripper.set(used)
+                     sample_in_gripper_name.set(name)
+OMNY, stage/gripper/fixed-O/shuttle slots -- see ``_write_slot_omny()``.
+OMNY, parking      : parking_placed.parking{N}.set(used)
+                     parking_names.parking{N}.set(letter or "none")
 
 Polling
 -------
 BEC publishes no push notifications for these signals, so a ``QTimer`` polls
-every 2 s to reflect CLI-driven changes.  Writes are immediate (on the
+every 2 s to reflect CLI-driven changes. Writes are immediate (on the
 affirmative button of each context-menu dialog); there is no batched
 edit/submit — every mutating action is individually confirmed instead.
 """
@@ -48,7 +72,7 @@ import datetime
 import os
 import subprocess
 import tempfile
-from typing import Optional
+from typing import Any, Optional
 
 from bec_lib import bec_logger
 from bec_lib.pdf_writer import PDFWriter
@@ -57,6 +81,7 @@ from qtpy.QtCore import Qt, QTimer
 from qtpy.QtWidgets import (
     QFrame,
     QGridLayout,
+    QGroupBox,
     QHBoxLayout,
     QInputDialog,
     QLabel,
@@ -75,7 +100,7 @@ logger = bec_logger.logger
 
 # ── constants ────────────────────────────────────────────────────────────────
 
-# Magazine slot numbers, laid out to match the CLI printout:
+# FlOMNI magazine slot numbers, laid out to match the CLI printout:
 #   1  2  3  4  5
 #   6  7  8  9 10
 #  11 12 13 14 15
@@ -84,12 +109,21 @@ STORAGE_ROWS = 4
 STORAGE_COLS = 5
 STORAGE_SLOTS = tuple(range(1, STORAGE_ROWS * STORAGE_COLS + 1))  # 1..20
 
-STAGE_SLOT = 0  # sample stage (in the beam)
-GRIPPER_SLOT = 100  # gripper pseudo-slot
+STAGE_SLOT = 0  # FlOMNI sample stage (in the beam)
+GRIPPER_SLOT = 100  # FlOMNI gripper pseudo-slot
 
-EMPTY_NAME = "-"  # backend convention for an empty slot's name
+EMPTY_NAME = "-"  # backend convention for an empty sample slot's name (both setups)
 EMPTY_LABEL = "— empty —"  # what an empty cell shows in the GUI
 
+# OMNY-specific layout
+OMNY_SHUTTLE_LETTERS = ("A", "B", "C")
+OMNY_SHUTTLE_SLOTS = tuple(range(1, 7))
+OMNY_FIXED_POSITIONS = (10, 11, 12, 13, 14, 32, 33, 34, 100, 101)
+OMNY_PARKING_SLOTS = tuple(range(1, 7))
+# OMNYSampleStorage.unset_shuttle_slot()'s own empty sentinel -- unlike sample
+# slots (which use EMPTY_NAME = "-"), parking slots are cleared to "none".
+PARKING_EMPTY_SENTINEL = "none"
+
 # colours
 COLOR_OCCUPIED = "#1b1b1b"
 COLOR_EMPTY = "#9e9e9e"
@@ -103,6 +137,8 @@ COLOR_SLOT_BORDER = "#c0c0c0"
 # already-transferred template (confirmed working) -- NOT the generic
 # Text1/Text2/Text6 names that OMNY_shared/flomni.lbx's own objectName
 # attributes happen to use for its (different) template source file.
+# FlOMNI-only: OMNY has no measured-sample-log integration (see module
+# docstring), so it never drives this printer.
 PTOUCH_PRINTER_HOST = "BRN94DDF8AAB8EC.psi.ch"
 PTOUCH_TEMPLATE_NUMBER = 1
 PTOUCH_FIELD_ACCOUNT = "ACCOUNT"
@@ -114,13 +150,70 @@ PTOUCH_FIELD_SAMPLENAME = "SAMPLENAME"
 # call site handles the "queue not found" failure instead of pre-checking.
 PRINTER_NAME = "WSLA_X12SA"
 
+# Which setup's samples device is used to detect that setup, mirroring the
+# established multi-setup convention in
+# bec_widgets/widgets/tomo_params/tomo_params.py's SETUP_PROFILES. Unlike
+# tomo_params (which needs a separate proxy discriminator such as
+# "fsamroy", since it doesn't itself depend on the samples device), this
+# widget's whole purpose IS that device, so the discriminator is simply the
+# device this widget will go on to read/write.
+SETUP_PROFILES: dict[str, dict[str, str]] = {
+    "flomni": {"discriminator_attr": "flomni_samples"},
+    "omny": {"discriminator_attr": "omny_samples"},
+}
+
+# oparkz motor target positions (mm) for each drivable OMNY parking slot,
+# duplicated from omny_sample_transfer_mixin.py's _oparkz_slot_check() /
+# otransfer_park_slot() rather than imported -- that mixin is a
+# CLI-session-only plugin (module-level `dev`/`bec` builtins, OMNYTools
+# dependency) that would be a heavier and more fragile coupling to pull into
+# this widget's gui-server process, exactly like _MeasuredSampleLog below is
+# deliberately duplicated rather than imported from flomni.py. Slot 1 has no
+# drivable transfer target and is never "active".
+_OPARKZ_TARGET_POSITIONS: dict[int, float] = {
+    2: -0.9 - 29 * 3 - 42 - 0.05,
+    3: -0.9 - 29 * 3,
+    4: -0.9 - 29 * 2,
+    5: -0.9 - 29,
+    6: -0.9,
+}
+_OPARKZ_TOLERANCE = 0.05
+
+
+def oparkz_active_parking_slot(readback: float, tol: float = _OPARKZ_TOLERANCE) -> Optional[int]:
+    """Return which parking slot (2-6) the oparkz motor is currently sitting
+    at, i.e. ready for a sample transfer, or None if it's between positions
+    (or at slot 1, which has no drivable transfer target). Pure function --
+    see the module-level docstring above ``_OPARKZ_TARGET_POSITIONS`` for
+    why this duplicates rather than imports omny_sample_transfer_mixin.py's
+    ``_oparkz_slot_check()``.
+    """
+    for slot, target in _OPARKZ_TARGET_POSITIONS.items():
+        if abs(readback - target) < tol:
+            return slot
+    return None
+
+
+def shuttle_status(
+    letter: str, parking_assignment: dict[int, str], active_slot: Optional[int]
+) -> dict[str, Any]:
+    """Where OMNY shuttle `letter` is parked (if anywhere), and whether that
+    parking slot is currently the "active" one (oparkz is sitting there,
+    ready for a transfer). Pure function of a snapshot of the parking
+    carousel and the current active slot -- see ``oparkz_active_parking_slot()``.
+
+    Returns {"parked_at": Optional[int], "active": bool}.
+    """
+    parked_at = next((slot for slot, occupant in parking_assignment.items() if occupant == letter), None)
+    return {"parked_at": parked_at, "active": parked_at is not None and parked_at == active_slot}
+
 
 # ── measured-sample log ──────────────────────────────────────────────────────
 
 
 class _MeasuredSampleLog:
     """Tracks which flomni samples have been measured, for the P-touch
-    label-printing feature.
+    label-printing feature. FlOMNI-only -- OMNY has no equivalent yet.
 
     Deliberately duplicated here rather than imported from
     ``flomni.py``'s ``_MeasuredSampleLog`` -- pulling in that whole plugin
@@ -168,14 +261,24 @@ class _MeasuredSampleLog:
 
 class _SlotCell(QFrame):
     """A single storage slot: shows its number and either the sample name or
-    an "empty" placeholder.  Right-click opens a context menu whose actions
+    an "empty" placeholder. Right-click opens a context menu whose actions
     depend on whether the slot is currently occupied.
 
     The cell does not talk to the device itself; it calls back into the
-    parent widget's mutation methods, which own all backend access.
+    parent widget's mutation methods, which own all backend access. `slot`
+    is an opaque key: FlOMNI cells use a plain int (0-20, 100); OMNY cells
+    use a tuple identifying which underlying signal pair to hit (see
+    ``OMNY_SampleStorage._write_slot_omny()``). Only one setup's cells are
+    ever live on a given widget instance.
     """
 
-    def __init__(self, slot: int, owner: "OMNY_SampleStorage", border_color: str):
+    def __init__(
+        self,
+        slot: int | tuple,
+        owner: "OMNY_SampleStorage",
+        border_color: str,
+        caption: Optional[str] = None,
+    ):
         super().__init__()
         self._slot = slot
         self._owner = owner
@@ -193,7 +296,7 @@ class _SlotCell(QFrame):
         layout.setContentsMargins(6, 4, 6, 4)
         layout.setSpacing(2)
 
-        self._lbl_num = QLabel(self._slot_caption())
+        self._lbl_num = QLabel(caption if caption is not None else self._slot_caption())
         self._lbl_num.setStyleSheet("color: #888888; font-size: 10px;")
         self._lbl_num.setAlignment(Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignTop)
 
@@ -221,6 +324,11 @@ class _SlotCell(QFrame):
     # ── labels ────────────────────────────────────────────────────────────────
 
     def _slot_caption(self) -> str:
+        """Fallback caption for FlOMNI's plain-int keys when no explicit
+        `caption` was given. OMNY cells always pass an explicit caption
+        (see OMNY_SampleStorage._build_ui_omny()), so this int-only logic
+        never runs for them.
+        """
         if self._slot == STAGE_SLOT:
             return "Stage (0)"
         if self._slot == GRIPPER_SLOT:
@@ -234,6 +342,9 @@ class _SlotCell(QFrame):
 
         `measured_status` is "started"/"completed" (from `_MeasuredSampleLog`)
         or None if this slot's current occupant has no measured record.
+        OMNY cells always pass owner="" and measured_status=None (no owner
+        field, no measured-sample log for OMNY), which the owner/measured
+        labels below already render as blank.
         """
         self._occupied = occupied
         self._name = name if name else EMPTY_NAME
@@ -279,18 +390,74 @@ class _SlotCell(QFrame):
                 self._owner.action_new_sample(self._slot)
 
 
+# ── OMNY shuttle status label ────────────────────────────────────────────────
+
+
+class _ShuttleStatusLabel(QLabel):
+    """Shows where one OMNY shuttle is installed (which parking slot, if
+    any) and whether that slot is currently "active" (oparkz is sitting
+    there, ready for a transfer). Right-click lets the operator assign or
+    clear this shuttle's parking-slot bookkeeping -- a different action
+    pair from the sample-cell context menu, since a parking assignment is a
+    single enum-like field (a shuttle letter, or none), not an
+    occupied+name+owner record; see OMNY_SampleStorage.action_set_parking()/
+    action_clear_parking().
+    """
+
+    def __init__(self, letter: str, owner: "OMNY_SampleStorage"):
+        super().__init__("not parked")
+        self._letter = letter
+        self._owner = owner
+        self._parked_at: Optional[int] = None
+        self.setStyleSheet("color: #888888; font-size: 11px;")
+        self.setContextMenuPolicy(Qt.ContextMenuPolicy.CustomContextMenu)
+        self.customContextMenuRequested.connect(self._show_menu)
+
+    def set_status(self, parked_at: Optional[int], active: bool) -> None:
+        self._parked_at = parked_at
+        if parked_at is None:
+            self.setText("not parked")
+            self.setStyleSheet("color: #888888; font-size: 11px;")
+        elif active:
+            self.setText(f"Slot {parked_at} — ● ACTIVE (ready for transfer)")
+            self.setStyleSheet("color: #2e7d32; font-size: 11px; font-weight: bold;")
+        else:
+            self.setText(f"Slot {parked_at}")
+            self.setStyleSheet("color: #555555; font-size: 11px;")
+
+    def _show_menu(self, pos) -> None:
+        menu = QMenu(self)
+        act_set = menu.addAction("Set parking slot…")
+        act_clear = menu.addAction("Clear parking assignment")
+        act_clear.setEnabled(self._parked_at is not None)
+        chosen = menu.exec_(self.mapToGlobal(pos))
+        if chosen == act_set:
+            self._owner.action_set_parking(self._letter, self._parked_at)
+        elif chosen == act_clear:
+            self._owner.action_clear_parking(self._letter, self._parked_at)
+
+
 # ── main widget ──────────────────────────────────────────────────────────────
 
 
 class OMNY_SampleStorage(BECWidget, QWidget):
     """
-    View and correct the FlOMNI sample-storage records.
+    View and correct the sample-storage records for whichever setup (FlOMNI
+    or OMNY -- see ``SETUP_PROFILES``) is active in this BEC session.
 
     Layout
     ------
+    FlOMNI:
       - Header: Stage (slot 0) and Gripper (slot 100), right-click correctable
       - 4×5 grid: magazine slots 1–20, right-click correctable
       - Caveat line: records only, not hardware
+    OMNY:
+      - Header: Stage and Gripper, right-click correctable
+      - Grid: the 10 fixed O positions, right-click correctable
+      - Three shuttle sections (A/B/C): installed/active status line
+        (right-click to assign/clear a parking slot) + a 6-slot grid,
+        right-click correctable
+      - Caveat line: records only, not hardware
 
     All mutations go through a right-click context menu; each mutating action
     is confirmed by its own dialog and written to the device immediately.
@@ -305,44 +472,54 @@ class OMNY_SampleStorage(BECWidget, QWidget):
     def __init__(self, parent=None, **kwargs):
         super().__init__(parent=parent, **kwargs)
         self.get_bec_shortcuts()
-        self._cells: dict[int, _SlotCell] = {}
+        self._cells: dict[Any, _SlotCell] = {}
         # last-seen (occupied, name, owner, measured_status) per slot, for
         # change-detection in refresh()
-        self._last_state: dict[int, tuple[bool, str, str, Optional[str]]] = {}
+        self._last_state: dict[Any, tuple[bool, str, str, Optional[str]]] = {}
+        self._shuttle_status_labels: dict[str, _ShuttleStatusLabel] = {}
         self.measured_log = _MeasuredSampleLog(self.client)
         self.label_printer = PTouchLabelPrinter(
             host=PTOUCH_PRINTER_HOST, template_number=PTOUCH_TEMPLATE_NUMBER
         )
-        self._flomni_available = self._check_flomni_available()
+        self._setup = self._detect_setup()
         self._build_ui()
         self._poll_timer = QTimer(self)
         self._poll_timer.setInterval(self._POLL_INTERVAL_MS)
         self._poll_timer.timeout.connect(self.refresh)
-        if self._flomni_available:
+        if self._setup is not None:
             self._poll_timer.start()
             self.refresh()
 
     # ── setup detection ──────────────────────────────────────────────────────
 
-    def _check_flomni_available(self) -> bool:
+    def _detect_setup(self) -> Optional[str]:
         """
-        Return True if the FlOMNI setup is active in this BEC session.
-        Uses ``fsamroy`` (the FlOMNI-specific rotation stage) as the
-        discriminator — it is absent in OMNY and LamNI sessions.
+        Return the key of whichever known sample-storage setup (see
+        ``SETUP_PROFILES``) is active in this BEC session, or None if
+        neither is present (e.g. a LamNI session, which has no
+        sample-storage device at all). A BEC session is always exactly one
+        setup, never more than one at a time -- confirmed across every
+        device_configs/*.yaml, dev.flomni_samples and dev.omny_samples
+        never coexist.
         """
-        try:
-            return getattr(self.dev, "fsamroy", None) is not None
-        except Exception:
-            return False
+        for setup, profile in SETUP_PROFILES.items():
+            try:
+                if getattr(self.dev, profile["discriminator_attr"], None) is not None:
+                    return setup
+            except Exception:
+                continue
+        return None
 
     # ── device access ────────────────────────────────────────────────────────
 
     @property
     def _samples(self):
-        """The flomni_samples device (single source of truth)."""
+        """The active setup's sample-storage device (single source of truth)."""
+        if self._setup == "omny":
+            return self.dev.omny_samples
         return self.dev.flomni_samples
 
-    def _read_all_slots(self) -> dict[int, tuple[bool, str, str, Optional[str]]]:
+    def _read_all_slots_flomni(self) -> dict[int, tuple[bool, str, str, Optional[str]]]:
         """Return {slot: (occupied, name, owner, measured_status)} for every
         slot 0–20 and the gripper from a SINGLE bulk
         ``dev.flomni_samples.read()`` round-trip plus a single bulk
@@ -413,9 +590,100 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
         return result
 
+    def _bulk_read_omny(self) -> Optional[dict]:
+        """Single cached bulk read of dev.omny_samples, shared by
+        _refresh_omny() and _build_report_pdf_omny() so a report build
+        never issues a second round of signal access on top of the poll.
+        Every underlying signal is auto_monitor=True (see
+        ``OMNYSampleStorage``), so ``cached=True`` returns the monitored
+        values instead of a live EPICS round-trip per signal -- same
+        rationale as _read_all_slots_flomni().
+        """
+        try:
+            return self._samples.read(cached=True)
+        except Exception as exc:
+            logger.warning(f"OMNY_SampleStorage: bulk read failed: {exc}")
+            return None
+
+    def _parse_sample_state_omny(self, data: dict) -> dict[tuple, tuple[bool, str, str, Optional[str]]]:
+        """Parse a dev.omny_samples.read(cached=True) dict into
+        {key: (occupied, name, owner, measured_status)} for every
+        sample-kind slot -- stage, gripper, the 10 fixed O positions, and
+        the 18 shuttle slots. OMNY has no owner field and no
+        measured-sample-log equivalent (see module docstring), so those two
+        are always ""/None -- this keeps the tuple shape identical to
+        FlOMNI's so _SlotCell.set_state() and _draw_report_cell() need no
+        OMNY-specific branch.
+        """
+
+        def _val(key, default=None):
+            entry = data.get(key)
+            if isinstance(entry, dict):
+                return entry.get("value", default)
+            return default
+
+        state: dict[tuple, tuple[bool, str, str, Optional[str]]] = {}
+
+        used = bool(_val("omny_samples_sample_in_samplestage", 0))
+        name = _val("omny_samples_sample_in_samplestage_name", EMPTY_NAME) or EMPTY_NAME
+        state[("stage",)] = (used, name, "", None)
+
+        used = bool(_val("omny_samples_sample_in_gripper", 0))
+        name = _val("omny_samples_sample_in_gripper_name", EMPTY_NAME) or EMPTY_NAME
+        state[("gripper",)] = (used, name, "", None)
+
+        for n in OMNY_FIXED_POSITIONS:
+            used = bool(_val(f"omny_samples_sample_placed_sample{n}", 0))
+            name = _val(f"omny_samples_sample_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
+            state[("O", n)] = (used, name, "", None)
+
+        for letter in OMNY_SHUTTLE_LETTERS:
+            for n in OMNY_SHUTTLE_SLOTS:
+                used = bool(_val(f"omny_samples_sample_shuttle_{letter}_placed_sample{n}", 0))
+                name = _val(f"omny_samples_sample_shuttle_{letter}_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
+                state[("shuttle", letter, n)] = (used, name, "", None)
+
+        return state
+
+    def _parse_parking_assignment_omny(self, data: dict) -> dict[int, str]:
+        """{parking_slot_nr: shuttle_letter} for parking slots that
+        currently have a shuttle recorded, from the same bulk-read dict as
+        _parse_sample_state_omny(). Treats unset_shuttle_slot()'s "none"
+        sentinel (and, defensively, "-"/EMPTY_NAME) as "not parked".
+        """
+
+        def _val(key, default=None):
+            entry = data.get(key)
+            if isinstance(entry, dict):
+                return entry.get("value", default)
+            return default
+
+        assignment: dict[int, str] = {}
+        for n in OMNY_PARKING_SLOTS:
+            raw = _val(f"omny_samples_parking_names_parking{n}", "")
+            letter = str(raw).strip() if raw else ""
+            if letter and letter not in (PARKING_EMPTY_SENTINEL, EMPTY_NAME, ""):
+                assignment[n] = letter
+        return assignment
+
+    def _read_active_parking_slot(self) -> Optional[int]:
+        """Which parking slot (2-6) the oparkz motor is currently sitting
+        at, i.e. ready for a sample transfer -- see
+        ``oparkz_active_parking_slot()``. A separate cached device read
+        from ``_bulk_read_omny()`` since it lives on a different device
+        (``dev.oparkz``, not ``dev.omny_samples``).
+        """
+        try:
+            readback = self.dev.oparkz.readback.get(cached=True)
+        except Exception as exc:
+            logger.warning(f"OMNY_SampleStorage: oparkz readback failed: {exc}")
+            return None
+        return oparkz_active_parking_slot(readback)
+
     def _offer_print_label_for_previous_occupant(self, slot: int) -> None:
         """If `slot` currently holds a measured sample, offer to print an
         account/date/name label for it before its record gets overwritten.
+        FlOMNI-only (see module docstring); never called for OMNY writes.
 
         Unlike flomni.py's equivalent check, this can run unconditionally
         for every slot ``_write_slot()`` touches (stage, gripper, and
@@ -482,8 +750,9 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def _write_slot(self, slot: int, used: int, name: str, owner: str = "") -> bool:
         """
-        Write (used, name, owner) to a storage slot 0–20 or the gripper,
-        mirroring ``Flomni.flomni_modify_storage_non_interactive()`` exactly.
+        Write (used, name, owner) to a FlOMNI storage slot 0–20 or the
+        gripper, mirroring ``Flomni.flomni_modify_storage_non_interactive()``
+        exactly.
         """
         self._offer_print_label_for_previous_occupant(slot)
         try:
@@ -508,8 +777,91 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             )
             return False
 
-    @staticmethod
-    def _slot_title(slot: int) -> str:
+    def _write_slot_omny(self, key: tuple, used: int, name: str) -> bool:
+        """Write (used, name) to an OMNY sample-kind slot -- stage, gripper,
+        a fixed O position, or a shuttle slot -- mirroring the direct-signal
+        style of ``_write_slot()``. No owner field and no measured-sample-log
+        integration exist for OMNY (see module docstring), so unlike
+        ``_write_slot`` this never offers to print a P-touch label for the
+        previous occupant.
+        """
+        try:
+            kind = key[0]
+            if kind == "stage":
+                self._samples.sample_in_samplestage.set(used)
+                self._samples.sample_in_samplestage_name.set(name)
+            elif kind == "gripper":
+                self._samples.sample_in_gripper.set(used)
+                self._samples.sample_in_gripper_name.set(name)
+            elif kind == "O":
+                _, n = key
+                getattr(self._samples.sample_placed, f"sample{n}").set(used)
+                getattr(self._samples.sample_names, f"sample{n}").set(name)
+            elif kind == "shuttle":
+                _, letter, n = key
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_placed"), f"sample{n}").set(used)
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_names"), f"sample{n}").set(name)
+            else:
+                raise ValueError(f"unknown OMNY slot key {key!r}")
+            self._last_state.pop(key, None)
+            return True
+        except Exception as exc:
+            logger.warning(f"OMNY_SampleStorage: write of slot {key} failed: {exc}")
+            QMessageBox.critical(
+                self,
+                "Write failed",
+                f"Could not write slot {self._slot_title(key)} to the device:\n{exc}",
+            )
+            return False
+
+    def _write_parking_omny(self, slot_nr: int, letter: Optional[str]) -> bool:
+        """Assign (or clear) which shuttle letter is recorded as parked at
+        OMNY parking slot `slot_nr` (1-6), mirroring
+        ``OMNYSampleStorage.set_shuttle_slot()``/``unset_shuttle_slot()``
+        field-for-field -- including its own empty sentinel, "none", which
+        differs from sample slots' "-" (see ``PARKING_EMPTY_SENTINEL``).
+        Pure operator bookkeeping: never touched by the transfer code, so
+        (like ``flomni_modify_storage_non_interactive()``) there's no
+        interlock against editing a slot that's also being changed by an
+        in-progress transfer.
+        """
+        try:
+            used = 1 if letter else 0
+            value = letter if letter else PARKING_EMPTY_SENTINEL
+            getattr(self._samples.parking_placed, f"parking{slot_nr}").set(used)
+            getattr(self._samples.parking_names, f"parking{slot_nr}").set(value)
+            return True
+        except Exception as exc:
+            logger.warning(f"OMNY_SampleStorage: write of parking slot {slot_nr} failed: {exc}")
+            QMessageBox.critical(
+                self,
+                "Write failed",
+                f"Could not write parking slot {slot_nr} to the device:\n{exc}",
+            )
+            return False
+
+    def _write_sample(self, slot, used: int, name: str, owner: str = "") -> bool:
+        """Shared write dispatcher used by the sample-cell mutation actions
+        (action_change_name/action_new_sample/action_clear) for both
+        setups: OMNY keys are tuples (see _SlotCell), FlOMNI keys are
+        plain ints.
+        """
+        if isinstance(slot, tuple):
+            return self._write_slot_omny(slot, used, name)
+        return self._write_slot(slot, used, name, owner)
+
+    def _slot_title(self, slot) -> str:
+        if isinstance(slot, tuple):
+            kind = slot[0]
+            if kind == "stage":
+                return "stage"
+            if kind == "gripper":
+                return "gripper"
+            if kind == "O":
+                return f"O:{slot[1]}"
+            if kind == "shuttle":
+                return f"shuttle {slot[1]}, slot {slot[2]}"
+            return str(slot)
         if slot == STAGE_SLOT:
             return "stage (0)"
         if slot == GRIPPER_SLOT:
@@ -518,16 +870,15 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     # ── UI construction ───────────────────────────────────────────────────────
 
-    def _build_ui(self):
+    def _build_ui(self) -> None:
         root = QVBoxLayout(self)
         root.setSpacing(8)
 
-        if not self._flomni_available:
+        if self._setup is None:
             lbl = QLabel(
-                "⚠ FlOMNI setup not detected in this BEC session.\n\n"
-                "This widget is only meaningful when the FlOMNI\n"
-                "BEC session is active (fsamroy device present).\n\n"
-                "OMNY support is not implemented yet."
+                "⚠ No known sample-storage setup detected in this BEC session.\n\n"
+                "This widget needs dev.flomni_samples (FlOMNI) or\n"
+                "dev.omny_samples (OMNY) to be present."
             )
             lbl.setAlignment(Qt.AlignmentFlag.AlignCenter)
             lbl.setWordWrap(True)
@@ -536,6 +887,12 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             root.addStretch()
             return
 
+        if self._setup == "flomni":
+            self._build_ui_flomni(root)
+        else:
+            self._build_ui_omny(root)
+
+    def _build_ui_flomni(self, root: QVBoxLayout) -> None:
         # header: stage + gripper
         header = QHBoxLayout()
         header.setSpacing(8)
@@ -560,7 +917,61 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             grid.addWidget(cell, r, c)
         root.addWidget(grid_box, stretch=1)
 
-        # caveat line
+        self._build_caveat(root)
+        self._build_button_row(root)
+
+    def _build_ui_omny(self, root: QVBoxLayout) -> None:
+        # header: stage + gripper
+        header = QHBoxLayout()
+        header.setSpacing(8)
+        self._cells[("stage",)] = _SlotCell(("stage",), self, COLOR_STAGE_BORDER, caption="Stage")
+        self._cells[("gripper",)] = _SlotCell(("gripper",), self, COLOR_GRIPPER_BORDER, caption="Gripper")
+        header.addWidget(self._cells[("stage",)])
+        header.addWidget(self._cells[("gripper",)])
+        root.addLayout(header)
+
+        # fixed O positions
+        fixed_box = QFrame()
+        fixed_grid = QGridLayout(fixed_box)
+        fixed_grid.setSpacing(6)
+        fixed_grid.setContentsMargins(0, 0, 0, 0)
+        for idx, n in enumerate(OMNY_FIXED_POSITIONS):
+            r, c = divmod(idx, 5)
+            key = ("O", n)
+            cell = _SlotCell(key, self, COLOR_SLOT_BORDER, caption=f"O:{n}")
+            self._cells[key] = cell
+            fixed_grid.addWidget(cell, r, c)
+        root.addWidget(fixed_box)
+
+        # shuttles A/B/C: each a status line (installed/active, editable)
+        # plus a 6-slot grid
+        shuttle_row = QHBoxLayout()
+        shuttle_row.setSpacing(8)
+        for letter in OMNY_SHUTTLE_LETTERS:
+            group = QGroupBox(f"Shuttle {letter}")
+            group_layout = QVBoxLayout(group)
+
+            status_label = _ShuttleStatusLabel(letter, self)
+            self._shuttle_status_labels[letter] = status_label
+            group_layout.addWidget(status_label)
+
+            slot_grid = QGridLayout()
+            slot_grid.setSpacing(4)
+            for idx, n in enumerate(OMNY_SHUTTLE_SLOTS):
+                r, c = divmod(idx, 3)
+                key = ("shuttle", letter, n)
+                cell = _SlotCell(key, self, COLOR_SLOT_BORDER, caption=f"{letter}-{n}")
+                self._cells[key] = cell
+                slot_grid.addWidget(cell, r, c)
+            group_layout.addLayout(slot_grid)
+
+            shuttle_row.addWidget(group)
+        root.addLayout(shuttle_row, stretch=1)
+
+        self._build_caveat(root)
+        self._build_button_row(root)
+
+    def _build_caveat(self, root: QVBoxLayout) -> None:
         caveat = QLabel(
             "Records only — this does not move any hardware. "
             "Ensure the entries here match physical reality."
@@ -569,7 +980,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         caveat.setStyleSheet("color: #FF9800; font-size: 11px;")
         root.addWidget(caveat)
 
-        # button row
+    def _build_button_row(self, root: QVBoxLayout) -> None:
         button_row = QHBoxLayout()
         button_row.addStretch()
         self.print_button = QPushButton("Print")
@@ -581,18 +992,23 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     @SafeSlot()
     def refresh(self) -> None:
-        """Re-read all slots (one bulk device round-trip) and update only the
-        cells whose state actually changed.
+        """Re-read all slots (one bulk device round-trip) and update only
+        the cells whose state actually changed. Dispatches to the active
+        setup's own refresh method.
+        """
+        if self._setup == "flomni":
+            self._refresh_flomni()
+        elif self._setup == "omny":
+            self._refresh_omny()
 
-        Repainting every cell on every 2 s poll — even when nothing changed,
+    def _refresh_flomni(self) -> None:
+        """Repainting every cell on every 2 s poll — even when nothing changed,
         which is almost always the case for a sample magazine — was needless
         work on the GUI thread. We diff against the last-seen state and only
         call set_state() on cells that differ, so a steady-state poll does no
         UI work at all.
         """
-        if not self._flomni_available:
-            return
-        state = self._read_all_slots()
+        state = self._read_all_slots_flomni()
         if not state:
             return  # bulk read failed; leave the current display untouched
         for slot, (occupied, name, owner, measured_status) in state.items():
@@ -603,10 +1019,39 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 cell.set_state(occupied, name, owner, measured_status)
             self._last_state[slot] = (occupied, name, owner, measured_status)
 
+    def _refresh_omny(self) -> None:
+        """Same diff-and-repaint-only-what-changed approach as
+        ``_refresh_flomni()``, for the sample-kind cells, plus an update of
+        each shuttle's installed/active status label.
+        """
+        data = self._bulk_read_omny()
+        if data is None:
+            return  # bulk read failed; leave the current display untouched
+
+        state = self._parse_sample_state_omny(data)
+        for key, entry in state.items():
+            if self._last_state.get(key) == entry:
+                continue
+            cell = self._cells.get(key)
+            if cell is not None:
+                cell.set_state(*entry)
+            self._last_state[key] = entry
+
+        parking_assignment = self._parse_parking_assignment_omny(data)
+        active_slot = self._read_active_parking_slot()
+        for letter in OMNY_SHUTTLE_LETTERS:
+            status = shuttle_status(letter, parking_assignment, active_slot)
+            label = self._shuttle_status_labels.get(letter)
+            if label is not None:
+                label.set_status(status["parked_at"], status["active"])
+
     # ── mutation actions (called from _SlotCell context menu) ─────────────────
 
-    def action_change_name(self, slot: int, current_name: str, current_owner: str = "") -> None:
-        """Rename an occupied slot (stays occupied)."""
+    def action_change_name(self, slot, current_name: str, current_owner: str = "") -> None:
+        """Rename an occupied slot (stays occupied). Shared by both setups
+        (see ``_SlotCell``); the owner prompt only applies to FlOMNI's
+        plain-int keys -- OMNY has no owner field.
+        """
         name, ok = QInputDialog.getText(
             self,
             "Change sample name",
@@ -624,25 +1069,29 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 "Use “Clear (set empty)” to empty the slot instead.",
             )
             return
-        owner, ok = QInputDialog.getText(
-            self,
-            "Sample owner",
-            f"Owner for slot {self._slot_title(slot)}:",
-            text=current_owner,
-        )
-        if not ok:
-            return
-        owner = owner.strip()
-        if not owner:
-            QMessageBox.warning(
-                self, "Invalid owner", "An occupied slot needs a non-empty owner."
+        owner = current_owner
+        if not isinstance(slot, tuple):
+            owner, ok = QInputDialog.getText(
+                self,
+                "Sample owner",
+                f"Owner for slot {self._slot_title(slot)}:",
+                text=current_owner,
             )
-            return
-        if self._write_slot(slot, 1, name, owner):
+            if not ok:
+                return
+            owner = owner.strip()
+            if not owner:
+                QMessageBox.warning(
+                    self, "Invalid owner", "An occupied slot needs a non-empty owner."
+                )
+                return
+        if self._write_sample(slot, 1, name, owner):
             self.refresh()
 
-    def action_new_sample(self, slot: int) -> None:
-        """Mark an empty slot occupied and give it a name."""
+    def action_new_sample(self, slot) -> None:
+        """Mark an empty slot occupied and give it a name. Shared by both
+        setups (see ``action_change_name``).
+        """
         name, ok = QInputDialog.getText(
             self, "New sample", f"Sample name for slot {self._slot_title(slot)}:"
         )
@@ -652,22 +1101,26 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if not name or name == EMPTY_NAME:
             QMessageBox.warning(self, "Invalid name", "Please enter a non-empty sample name.")
             return
-        owner, ok = QInputDialog.getText(
-            self, "Sample owner", f"Owner for slot {self._slot_title(slot)}:"
-        )
-        if not ok:
-            return
-        owner = owner.strip()
-        if not owner:
-            QMessageBox.warning(
-                self, "Invalid owner", "An occupied slot needs a non-empty owner."
+        owner = ""
+        if not isinstance(slot, tuple):
+            owner, ok = QInputDialog.getText(
+                self, "Sample owner", f"Owner for slot {self._slot_title(slot)}:"
             )
-            return
-        if self._write_slot(slot, 1, name, owner):
+            if not ok:
+                return
+            owner = owner.strip()
+            if not owner:
+                QMessageBox.warning(
+                    self, "Invalid owner", "An occupied slot needs a non-empty owner."
+                )
+                return
+        if self._write_sample(slot, 1, name, owner):
             self.refresh()
 
-    def action_clear(self, slot: int) -> None:
-        """Mark a slot empty (destructive; confirmed)."""
+    def action_clear(self, slot) -> None:
+        """Mark a slot empty (destructive; confirmed). Shared by both
+        setups (see ``action_change_name``).
+        """
         reply = QMessageBox.question(
             self,
             "Clear slot",
@@ -678,7 +1131,48 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         )
         if reply != QMessageBox.StandardButton.Yes:
             return
-        if self._write_slot(slot, 0, EMPTY_NAME):
+        if self._write_sample(slot, 0, EMPTY_NAME):
+            self.refresh()
+
+    def action_set_parking(self, letter: str, current_slot: Optional[int]) -> None:
+        """Assign OMNY shuttle `letter` to a parking slot (1-6), via
+        ``_ShuttleStatusLabel``'s context menu. Overwrites that slot's
+        previous occupant, if any, without clearing wherever `letter` was
+        previously parked -- mirrors ``set_shuttle_slot()``'s own
+        semantics exactly; keeping the two in sync is operator discipline,
+        same as everywhere else in this widget (see module docstring).
+        """
+        slot_nr, ok = QInputDialog.getInt(
+            self,
+            "Set parking slot",
+            f"Parking slot (1-6) for shuttle {letter}:",
+            current_slot or 1,
+            1,
+            6,
+            1,
+        )
+        if not ok:
+            return
+        if self._write_parking_omny(slot_nr, letter):
+            self.refresh()
+
+    def action_clear_parking(self, letter: str, current_slot: Optional[int]) -> None:
+        """Clear OMNY shuttle `letter`'s parking-slot assignment (destructive;
+        confirmed), via ``_ShuttleStatusLabel``'s context menu.
+        """
+        if current_slot is None:
+            return
+        reply = QMessageBox.question(
+            self,
+            "Clear parking assignment",
+            f"Clear shuttle {letter}'s parking slot {current_slot}?\n\n"
+            "Confirm the shuttle has actually been removed from that slot — "
+            "this only changes the record, not the hardware.",
+            QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.Cancel,
+        )
+        if reply != QMessageBox.StandardButton.Yes:
+            return
+        if self._write_parking_omny(current_slot, None):
             self.refresh()
 
     # ── print report ─────────────────────────────────────────────────────────
@@ -727,14 +1221,20 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             return False
 
     def _build_report_pdf(self) -> str:
+        """Dispatch to the active setup's own report builder."""
+        if self._setup == "omny":
+            return self._build_report_pdf_omny()
+        return self._build_report_pdf_flomni()
+
+    def _build_report_pdf_flomni(self) -> str:
         """Render a page mirroring the on-screen grid (stage + gripper
-        header, 4x5 magazine, same layout/orientation as ``_build_ui()``)
-        from a fresh device read, and return the path of the temp PDF file
-        it was written to.
+        header, 4x5 magazine, same layout/orientation as
+        ``_build_ui_flomni()``) from a fresh device read, and return the
+        path of the temp PDF file it was written to.
         """
         from fpdf import XPos, YPos
 
-        state = self._read_all_slots()
+        state = self._read_all_slots_flomni()
         fd, path = tempfile.mkstemp(prefix="flomni_sample_storage_", suffix=".pdf")
         os.close(fd)
         with PDFWriter(path) as file:
@@ -759,7 +1259,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             )
 
             # magazine grid, same row/col + right-to-left mirroring as the
-            # on-screen grid (sample_storage.py's _build_ui())
+            # on-screen grid (sample_storage.py's _build_ui_flomni())
             grid_y0 = y0 + cell_h + 4
             for idx, slot in enumerate(STORAGE_SLOTS):
                 r, c = divmod(idx, STORAGE_COLS)
@@ -769,10 +1269,82 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 self._draw_report_cell(pdf, x, y, cell_w, cell_h, slot, state.get(slot))
         return path
 
+    def _build_report_pdf_omny(self) -> str:
+        """Render a page mirroring the on-screen OMNY layout (stage +
+        gripper header, fixed-O grid, 3 shuttle sections with their
+        installed/active status text) from a fresh device read, and return
+        the path of the temp PDF file it was written to.
+        """
+        from fpdf import XPos, YPos
+
+        data = self._bulk_read_omny()
+        state = self._parse_sample_state_omny(data) if data else {}
+        parking_assignment = self._parse_parking_assignment_omny(data) if data else {}
+        active_slot = self._read_active_parking_slot()
+
+        fd, path = tempfile.mkstemp(prefix="omny_sample_storage_", suffix=".pdf")
+        os.close(fd)
+        with PDFWriter(path) as file:
+            pdf = file._pdf
+            pdf.set_font("Helvetica", "B", 16)
+            pdf.cell(0, 10, "OMNY Sample Storage", new_x=XPos.LMARGIN, new_y=YPos.NEXT, align="C")
+            pdf.set_font("Helvetica", "", 10)
+            timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+            pdf.cell(0, 6, timestamp, new_x=XPos.LMARGIN, new_y=YPos.NEXT, align="C")
+            pdf.ln(6)
+
+            margin = pdf.l_margin
+            usable_w = pdf.w - 2 * margin
+            cell_w = usable_w / 5
+            cell_h = 28
+
+            # header: stage + gripper, same widths as two fixed-O cells
+            y0 = pdf.get_y()
+            self._draw_report_cell(pdf, margin, y0, cell_w, cell_h, ("stage",), state.get(("stage",)))
+            self._draw_report_cell(
+                pdf, margin + cell_w, y0, cell_w, cell_h, ("gripper",), state.get(("gripper",))
+            )
+
+            # fixed O positions, same 5-wide grid as the on-screen layout
+            fixed_y0 = y0 + cell_h + 4
+            for idx, n in enumerate(OMNY_FIXED_POSITIONS):
+                r, c = divmod(idx, 5)
+                x = margin + c * cell_w
+                y = fixed_y0 + r * cell_h
+                key = ("O", n)
+                self._draw_report_cell(pdf, x, y, cell_w, cell_h, key, state.get(key))
+
+            # shuttles A/B/C: status line + 3-wide slot grid, side by side
+            shuttle_y0 = fixed_y0 + 2 * cell_h + 8
+            shuttle_w = usable_w / 3
+            for si, letter in enumerate(OMNY_SHUTTLE_LETTERS):
+                x0 = margin + si * shuttle_w
+                status = shuttle_status(letter, parking_assignment, active_slot)
+                if status["parked_at"] is None:
+                    status_text = f"Shuttle {letter}: not parked"
+                else:
+                    status_text = f"Shuttle {letter}: slot {status['parked_at']}"
+                    if status["active"]:
+                        status_text += " (ACTIVE)"
+                pdf.set_xy(x0, shuttle_y0)
+                pdf.set_font("Helvetica", "B", 9)
+                pdf.cell(shuttle_w, 5, status_text, align="L")
+
+                slot_w = shuttle_w / 3
+                for idx, n in enumerate(OMNY_SHUTTLE_SLOTS):
+                    r, c = divmod(idx, 3)
+                    x = x0 + c * slot_w
+                    y = shuttle_y0 + 6 + r * cell_h
+                    key = ("shuttle", letter, n)
+                    self._draw_report_cell(pdf, x, y, slot_w, cell_h, key, state.get(key))
+        return path
+
     def _draw_report_cell(self, pdf, x, y, w, h, slot, entry) -> None:
         """Draw one slot's box, mirroring what ``_SlotCell.set_state()``
         shows on screen: slot caption, name (or "empty"), owner and measured
-        marker.
+        marker. Shared by both setups' report builders -- OMNY entries
+        always carry owner="" and measured_status=None, which render as
+        blank without any OMNY-specific branch here.
         """
         pdf.rect(x, y, w, h)
         occupied, name, owner, measured_status = entry if entry else (False, EMPTY_NAME, "", None)
@@ -839,4 +1411,4 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def cleanup(self) -> None:
         self._poll_timer.stop()
-        super().cleanup()
\ No newline at end of file
+        super().cleanup()
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index f0574620..d5e60ead 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -254,6 +254,32 @@ class SimOMNYSampleStorage(OMNYSampleStorage):
     def __new__(cls, *args, sim_samples: dict | None = None, **kwargs):
         with patched_device(OMNYSampleStorage, *args, **kwargs) as storage:
             samples = _DEFAULT_OMNY_SAMPLES if sim_samples is None else sim_samples
+            # patched_device()'s mock PVs default to the string "0", not the
+            # real backend's own empty sentinels ("-" for sample slots, "none"
+            # for parking) -- explicitly unset every slot first, the same way
+            # SimFlomniSampleStorage does, so untouched slots read back as
+            # genuinely empty instead of a stray "0" name/shuttle-letter.
+            #
+            # Writes go directly to the Dcpt signals rather than through
+            # unset_sample_slot()/set_sample_slot() -- those reject any
+            # slot_nr > 20 (a pre-existing bug: it's copied from Flomni's
+            # 0-20-only range check, but OMNY's own "O" fixed positions
+            # legitimately include 32-34/100/101), which would raise here
+            # for exactly the positions this needs to clear.
+            for shuttle_placed, shuttle_names in (
+                (storage.sample_shuttle_A_placed, storage.sample_shuttle_A_names),
+                (storage.sample_shuttle_B_placed, storage.sample_shuttle_B_names),
+                (storage.sample_shuttle_C_placed, storage.sample_shuttle_C_names),
+            ):
+                for slot_nr in shuttle_placed.component_names:
+                    getattr(shuttle_placed, slot_nr).set(0)
+                    getattr(shuttle_names, slot_nr).set("-")
+            for slot_nr in storage.sample_placed.component_names:
+                getattr(storage.sample_placed, slot_nr).set(0)
+                getattr(storage.sample_names, slot_nr).set("-")
+            for slot_nr in storage.parking_placed.component_names:
+                getattr(storage.parking_placed, slot_nr).set(0)
+                getattr(storage.parking_names, slot_nr).set("none")
             storage.unset_sample_in_gripper()
             storage.set_sample_in_samplestage("sim_stage_sample")
             for slot_nr, name in samples.items():
diff --git a/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py b/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py
new file mode 100644
index 00000000..b91c833c
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py
@@ -0,0 +1,59 @@
+"""Unit tests for OMNY_SampleStorage's OMNY-side pure helper functions:
+where a shuttle is "installed" (which parking slot) and whether that slot
+is the "active" one, i.e. the oparkz motor is currently sitting there,
+ready for a sample transfer.
+
+These duplicate omny_sample_transfer_mixin.py's _oparkz_slot_check() target
+-position table by design (see sample_storage.py's module docstring) --
+this test guards against that duplicated table silently drifting out of
+sync with the transfer mixin's own copy.
+"""
+
+import pytest
+
+from csaxs_bec.bec_widgets.widgets.sample_storage.sample_storage import (
+    oparkz_active_parking_slot,
+    shuttle_status,
+)
+
+
+@pytest.mark.parametrize(
+    "readback,expected_slot",
+    [
+        (-0.9, 6),
+        (-0.9 - 29, 5),
+        (-0.9 - 29 * 2, 4),
+        (-0.9 - 29 * 3, 3),
+        (-0.9 - 29 * 3 - 42 - 0.05, 2),
+    ],
+)
+def test_oparkz_active_parking_slot_matches_each_target(readback, expected_slot):
+    assert oparkz_active_parking_slot(readback) == expected_slot
+
+
+def test_oparkz_active_parking_slot_none_when_far_from_any_target():
+    assert oparkz_active_parking_slot(0.0) is None
+
+
+def test_oparkz_active_parking_slot_within_tolerance():
+    assert oparkz_active_parking_slot(-0.9 + 0.04) == 6
+
+
+def test_oparkz_active_parking_slot_outside_tolerance():
+    assert oparkz_active_parking_slot(-0.9 + 0.06) is None
+
+
+def test_shuttle_status_parked_and_active():
+    assert shuttle_status("A", {3: "A"}, active_slot=3) == {"parked_at": 3, "active": True}
+
+
+def test_shuttle_status_not_parked_anywhere():
+    assert shuttle_status("B", {3: "A"}, active_slot=3) == {"parked_at": None, "active": False}
+
+
+def test_shuttle_status_parked_but_not_active():
+    assert shuttle_status("A", {2: "A"}, active_slot=3) == {"parked_at": 2, "active": False}
+
+
+def test_shuttle_status_no_active_slot_at_all():
+    assert shuttle_status("A", {2: "A"}, active_slot=None) == {"parked_at": 2, "active": False}

From c79d3dc0a036b3055b69ff953a26f3aa49b92214 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 18:32:11 +0200
Subject: [PATCH 027/102] feat(omny): add otransfer_* CLI wrappers; fix widget
 contrast + add owner requirement

Adds omny.otransfer_show_all() (renamed from otransfer_storage) plus thin
otransfer_* wrappers for every dev.omny_samples command, so they all
tab-complete under omny.* the same way flomni.py's ftransfer_* commands do.

Also fixes two issues found in first widget testing:
- OMNY_SampleStorage's occupied-slot text was hardcoded to a near-black
  colour, invisible against BEC's dark theme -- now inherits the
  application palette's default text colour instead.
- OMNY sample slots now require a sample owner, same as FlOMNI, packed via
  the existing sample_desc_codec (name+owner in the one raw name field).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../omny/omny_sample_transfer_mixin.py        |  63 +++++++-
 .../widgets/sample_storage/sample_storage.py  | 144 ++++++++++--------
 docs/user/ptychography/omny.md                |   8 +-
 3 files changed, 141 insertions(+), 74 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index b0f59611..2c00948f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -882,7 +882,7 @@ class OMNYSampleTransferMixin:
         self._otransfer_check_sample_available_at_position(pin_position, 1)
         self._otransfer_shield_close(pin_position)
 
-        self.otransfer_storage()
+        self.otransfer_show_all()
 
     def _otransfer_stage_to_ST(self, pin_position):
         self._otransfer_gripper_to_park_z()
@@ -1064,9 +1064,64 @@ class OMNYSampleTransferMixin:
 
         # }'
 
-    def otransfer_storage(self):
+    def otransfer_show_all(self):
         dev.omny_samples.show_all()
 
+    # Thin dev.omny_samples wrappers below, so every sample-storage command
+    # tab-completes under omny.otransfer_* -- same reason flomni.py exposes
+    # dev.flomni_samples via ftransfer_* -- instead of only being reachable
+    # via dev.omny_samples.* directly.
+    def otransfer_is_sample_slot_used(self, container: str, slot_nr: int) -> bool:
+        return dev.omny_samples.is_sample_slot_used(container, slot_nr)
+
+    def otransfer_is_sample_in_gripper(self) -> bool:
+        return dev.omny_samples.is_sample_in_gripper()
+
+    def otransfer_set_sample_slot(self, container: str, slot_nr: int, name: str) -> bool:
+        return dev.omny_samples.set_sample_slot(container, slot_nr, name)
+
+    def otransfer_unset_sample_slot(self, container: str, slot_nr: int) -> bool:
+        return dev.omny_samples.unset_sample_slot(container, slot_nr)
+
+    def otransfer_set_sample_in_gripper(self, name: str) -> bool:
+        return dev.omny_samples.set_sample_in_gripper(name)
+
+    def otransfer_unset_sample_in_gripper(self) -> bool:
+        return dev.omny_samples.unset_sample_in_gripper()
+
+    def otransfer_set_sample_in_samplestage(self, name: str) -> bool:
+        return dev.omny_samples.set_sample_in_samplestage(name)
+
+    def otransfer_unset_sample_in_samplestage(self) -> bool:
+        return dev.omny_samples.unset_sample_in_samplestage()
+
+    def otransfer_get_sample_name_in_samplestage(self) -> str:
+        return dev.omny_samples.get_sample_name_in_samplestage()
+
+    def otransfer_get_sample_name_in_gripper(self) -> str:
+        return dev.omny_samples.get_sample_name_in_gripper()
+
+    def otransfer_get_sample_name(self, container: str, slot_nr: int) -> str:
+        return dev.omny_samples.get_sample_name(container, slot_nr)
+
+    def otransfer_is_sample_in_samplestage(self) -> bool:
+        return dev.omny_samples.is_sample_in_samplestage()
+
+    def otransfer_set_shuttle_slot(self, container: str, slot_nr: int) -> bool:
+        return dev.omny_samples.set_shuttle_slot(container, slot_nr)
+
+    def otransfer_unset_shuttle_slot(self, slot_nr: int) -> bool:
+        return dev.omny_samples.unset_shuttle_slot(slot_nr)
+
+    def otransfer_get_shuttle_name_slot(self, slot_nr: int) -> str:
+        return dev.omny_samples.get_shuttle_name_slot(slot_nr)
+
+    def otransfer_is_shuttle_slot_used(self, slot_nr: int) -> bool:
+        return dev.omny_samples.is_shuttle_slot_used(slot_nr)
+
+    def otransfer_search_shuttle_in_slot(self, shuttle: str) -> int:
+        return dev.omny_samples.search_shuttle_in_slot(shuttle)
+
     # def _otransfer_modify_sample(_ocontainer, _oposition, _ostatus, _oname):
     #   #_ocontainer is A, B, C for the pin containers
     #   #it can also be FZP, OSA and omny
@@ -1443,4 +1498,6 @@ class OMNYSampleTransferMixin:
         )
         print("omny.otransfer_get_sample(position)     pick with the gripper from <position>")
         print("omny.otransfer_put_sample(position)     put with the gripper to <position>")
-        print("To modify the storage information see            dev.omny_samples.help()")
+        print("omny.otransfer_show_all()               show the full sample storage overview")
+        print("For the other storage commands (set/unset slots, shuttles, gripper, sample")
+        print("stage) see the omny.otransfer_* commands, or dev.omny_samples.help()")
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 0bec937c..1501623a 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -9,20 +9,23 @@ different setups, detected at construction time (see ``SETUP_PROFILES``,
 ``_detect_setup()``) — a BEC session is always exactly one setup, never
 both at once:
 
+Both setups require every sample slot to carry a name *and* an owner,
+packed into one EPICS DESC field (see ``sample_desc_codec``) since neither
+backend has a separate owner PV.
+
 FlOMNI (``dev.flomni_samples``)
     A flat magazine: slots 1-20, the sample stage (slot 0) and the gripper
-    (slot 100). Each slot has a name *and* an owner, packed into one EPICS
-    DESC field (see ``sample_desc_codec``).
+    (slot 100).
 
 OMNY (``dev.omny_samples``)
     A richer structure: three shuttles (A/B/C) of 6 slots each, a sparse
     set of "fixed O positions" ({10,11,12,13,14,32,33,34,100,101}), a
     separate sample stage and gripper, and a 6-slot "parking" carousel
     recording which shuttle letter is docked at each physical parking
-    position. No owner field -- names are raw strings. Whichever shuttle's
-    parking slot matches the ``oparkz`` motor's current readback is
-    "active", i.e. at the transfer-ready position (see
-    ``oparkz_active_parking_slot()``).
+    position (parking slots are a shuttle-letter assignment, not a sample,
+    so they carry no name/owner). Whichever shuttle's parking slot matches
+    the ``oparkz`` motor's current readback is "active", i.e. at the
+    transfer-ready position (see ``oparkz_active_parking_slot()``).
 
 A LamNI session has neither device; the widget shows a "no known setup
 detected" message in that case.
@@ -125,7 +128,12 @@ OMNY_PARKING_SLOTS = tuple(range(1, 7))
 PARKING_EMPTY_SENTINEL = "none"
 
 # colours
-COLOR_OCCUPIED = "#1b1b1b"
+# An occupied slot's name label intentionally has no fixed foreground colour
+# here (see _SlotCell.set_state()) -- it was previously hardcoded to
+# "#1b1b1b" (near-black), which is fine on a light theme but is effectively
+# invisible against BEC's dark theme. Clearing the stylesheet instead lets
+# the label fall back to the application palette's default text colour,
+# which is correct in both themes.
 COLOR_EMPTY = "#9e9e9e"
 COLOR_STAGE_BORDER = "#2196F3"
 COLOR_GRIPPER_BORDER = "#FF9800"
@@ -342,16 +350,19 @@ class _SlotCell(QFrame):
 
         `measured_status` is "started"/"completed" (from `_MeasuredSampleLog`)
         or None if this slot's current occupant has no measured record.
-        OMNY cells always pass owner="" and measured_status=None (no owner
-        field, no measured-sample log for OMNY), which the owner/measured
-        labels below already render as blank.
+        OMNY cells always pass measured_status=None (no measured-sample log
+        for OMNY -- see module docstring), which the measured label below
+        already renders as blank.
         """
         self._occupied = occupied
         self._name = name if name else EMPTY_NAME
         self._sample_owner = owner
         if occupied:
             self._lbl_name.setText(self._name)
-            self._lbl_name.setStyleSheet(f"color: {COLOR_OCCUPIED};")
+            # no fixed colour here -- inherit the application palette's
+            # default text colour, which is correct in both light and dark
+            # themes (see the COLOR_EMPTY comment above)
+            self._lbl_name.setStyleSheet("")
             self._lbl_owner.setText(f"owner: {owner}" if owner else "")
             if measured_status == "completed":
                 self._lbl_measured.setText("✓ measured")
@@ -609,11 +620,10 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         """Parse a dev.omny_samples.read(cached=True) dict into
         {key: (occupied, name, owner, measured_status)} for every
         sample-kind slot -- stage, gripper, the 10 fixed O positions, and
-        the 18 shuttle slots. OMNY has no owner field and no
-        measured-sample-log equivalent (see module docstring), so those two
-        are always ""/None -- this keeps the tuple shape identical to
-        FlOMNI's so _SlotCell.set_state() and _draw_report_cell() need no
-        OMNY-specific branch.
+        the 18 shuttle slots. Like FlOMNI, OMNY has no separate owner PV, so
+        the name+owner pair is packed into the one raw name field (see
+        ``sample_desc_codec``); measured_status is always None -- OMNY has
+        no measured-sample-log equivalent (see module docstring).
         """
 
         def _val(key, default=None):
@@ -622,26 +632,32 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 return entry.get("value", default)
             return default
 
+        def _name_owner(raw):
+            name, owner = unpack_desc(raw if raw else EMPTY_NAME)
+            return (name if name else EMPTY_NAME), owner
+
         state: dict[tuple, tuple[bool, str, str, Optional[str]]] = {}
 
         used = bool(_val("omny_samples_sample_in_samplestage", 0))
-        name = _val("omny_samples_sample_in_samplestage_name", EMPTY_NAME) or EMPTY_NAME
-        state[("stage",)] = (used, name, "", None)
+        name, owner = _name_owner(_val("omny_samples_sample_in_samplestage_name", EMPTY_NAME))
+        state[("stage",)] = (used, name, owner, None)
 
         used = bool(_val("omny_samples_sample_in_gripper", 0))
-        name = _val("omny_samples_sample_in_gripper_name", EMPTY_NAME) or EMPTY_NAME
-        state[("gripper",)] = (used, name, "", None)
+        name, owner = _name_owner(_val("omny_samples_sample_in_gripper_name", EMPTY_NAME))
+        state[("gripper",)] = (used, name, owner, None)
 
         for n in OMNY_FIXED_POSITIONS:
             used = bool(_val(f"omny_samples_sample_placed_sample{n}", 0))
-            name = _val(f"omny_samples_sample_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
-            state[("O", n)] = (used, name, "", None)
+            name, owner = _name_owner(_val(f"omny_samples_sample_names_sample{n}", EMPTY_NAME))
+            state[("O", n)] = (used, name, owner, None)
 
         for letter in OMNY_SHUTTLE_LETTERS:
             for n in OMNY_SHUTTLE_SLOTS:
                 used = bool(_val(f"omny_samples_sample_shuttle_{letter}_placed_sample{n}", 0))
-                name = _val(f"omny_samples_sample_shuttle_{letter}_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
-                state[("shuttle", letter, n)] = (used, name, "", None)
+                name, owner = _name_owner(
+                    _val(f"omny_samples_sample_shuttle_{letter}_names_sample{n}", EMPTY_NAME)
+                )
+                state[("shuttle", letter, n)] = (used, name, owner, None)
 
         return state
 
@@ -777,30 +793,32 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             )
             return False
 
-    def _write_slot_omny(self, key: tuple, used: int, name: str) -> bool:
-        """Write (used, name) to an OMNY sample-kind slot -- stage, gripper,
-        a fixed O position, or a shuttle slot -- mirroring the direct-signal
-        style of ``_write_slot()``. No owner field and no measured-sample-log
-        integration exist for OMNY (see module docstring), so unlike
-        ``_write_slot`` this never offers to print a P-touch label for the
-        previous occupant.
+    def _write_slot_omny(self, key: tuple, used: int, name: str, owner: str = "") -> bool:
+        """Write (used, name, owner) to an OMNY sample-kind slot -- stage,
+        gripper, a fixed O position, or a shuttle slot -- mirroring the
+        direct-signal style of ``_write_slot()``, including packing
+        name+owner into the one raw name field the same way (see
+        ``sample_desc_codec``). No measured-sample-log integration exists
+        for OMNY (see module docstring), so unlike ``_write_slot`` this
+        never offers to print a P-touch label for the previous occupant.
         """
         try:
+            packed_name = pack_desc(name, owner)
             kind = key[0]
             if kind == "stage":
                 self._samples.sample_in_samplestage.set(used)
-                self._samples.sample_in_samplestage_name.set(name)
+                self._samples.sample_in_samplestage_name.set(packed_name)
             elif kind == "gripper":
                 self._samples.sample_in_gripper.set(used)
-                self._samples.sample_in_gripper_name.set(name)
+                self._samples.sample_in_gripper_name.set(packed_name)
             elif kind == "O":
                 _, n = key
                 getattr(self._samples.sample_placed, f"sample{n}").set(used)
-                getattr(self._samples.sample_names, f"sample{n}").set(name)
+                getattr(self._samples.sample_names, f"sample{n}").set(packed_name)
             elif kind == "shuttle":
                 _, letter, n = key
                 getattr(getattr(self._samples, f"sample_shuttle_{letter}_placed"), f"sample{n}").set(used)
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_names"), f"sample{n}").set(name)
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_names"), f"sample{n}").set(packed_name)
             else:
                 raise ValueError(f"unknown OMNY slot key {key!r}")
             self._last_state.pop(key, None)
@@ -847,7 +865,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         plain ints.
         """
         if isinstance(slot, tuple):
-            return self._write_slot_omny(slot, used, name)
+            return self._write_slot_omny(slot, used, name, owner)
         return self._write_slot(slot, used, name, owner)
 
     def _slot_title(self, slot) -> str:
@@ -1049,8 +1067,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def action_change_name(self, slot, current_name: str, current_owner: str = "") -> None:
         """Rename an occupied slot (stays occupied). Shared by both setups
-        (see ``_SlotCell``); the owner prompt only applies to FlOMNI's
-        plain-int keys -- OMNY has no owner field.
+        (see ``_SlotCell``) -- both require a name and an owner (see module
+        docstring).
         """
         name, ok = QInputDialog.getText(
             self,
@@ -1069,22 +1087,18 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 "Use “Clear (set empty)” to empty the slot instead.",
             )
             return
-        owner = current_owner
-        if not isinstance(slot, tuple):
-            owner, ok = QInputDialog.getText(
-                self,
-                "Sample owner",
-                f"Owner for slot {self._slot_title(slot)}:",
-                text=current_owner,
-            )
-            if not ok:
-                return
-            owner = owner.strip()
-            if not owner:
-                QMessageBox.warning(
-                    self, "Invalid owner", "An occupied slot needs a non-empty owner."
-                )
-                return
+        owner, ok = QInputDialog.getText(
+            self,
+            "Sample owner",
+            f"Owner for slot {self._slot_title(slot)}:",
+            text=current_owner,
+        )
+        if not ok:
+            return
+        owner = owner.strip()
+        if not owner:
+            QMessageBox.warning(self, "Invalid owner", "An occupied slot needs a non-empty owner.")
+            return
         if self._write_sample(slot, 1, name, owner):
             self.refresh()
 
@@ -1101,19 +1115,15 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if not name or name == EMPTY_NAME:
             QMessageBox.warning(self, "Invalid name", "Please enter a non-empty sample name.")
             return
-        owner = ""
-        if not isinstance(slot, tuple):
-            owner, ok = QInputDialog.getText(
-                self, "Sample owner", f"Owner for slot {self._slot_title(slot)}:"
-            )
-            if not ok:
-                return
-            owner = owner.strip()
-            if not owner:
-                QMessageBox.warning(
-                    self, "Invalid owner", "An occupied slot needs a non-empty owner."
-                )
-                return
+        owner, ok = QInputDialog.getText(
+            self, "Sample owner", f"Owner for slot {self._slot_title(slot)}:"
+        )
+        if not ok:
+            return
+        owner = owner.strip()
+        if not owner:
+            QMessageBox.warning(self, "Invalid owner", "An occupied slot needs a non-empty owner.")
+            return
         if self._write_sample(slot, 1, name, owner):
             self.refresh()
 
diff --git a/docs/user/ptychography/omny.md b/docs/user/ptychography/omny.md
index e910c811..8c5719d0 100644
--- a/docs/user/ptychography/omny.md
+++ b/docs/user/ptychography/omny.md
@@ -12,7 +12,7 @@ OMNY is a microscope setup for 3D mesurements via ptychographic X-ray computed t
 The sample storage, shuttles and parking positions are described in detail (here)[user.ptychography.omny.samples].
 
 1. `omny.otransfer_get_sample(0)` remove current sample from sample stage. Watch gripper action and be ready to ctrl+c in case something is wrong.  
-_If in doubt check that the correct sample shutte is in the active position by calling `omny.otransfer_storage()`. The slot can be selected by `omny.otransfer_park_slot(slot)`._
+_If in doubt check that the correct sample shutte is in the active position by calling `omny.otransfer_show_all()`. The slot can be selected by `omny.otransfer_park_slot(slot)`._
 1. `omny.otransfer_put_sample(position)` put the sample to the selected shuttle
 1. `omny.otransfer_get_sample(position) ` get the new sample from a shuttle
 1. `omny.otransfer_put_sample(0)`, mount the sample in the sample stage
@@ -57,7 +57,7 @@ Try moving up and down a bit `umvr(dev.otransy,0.5)`, `umvr(dev.otransy,-0.5)`,
 Then, `umv(dev.ootransy,-1.5)` followed by 
 `omny._otransfer_gripper_to_park_z()`, which will move the gripper to its parking position.
 
-If this error happens after a sample was mounted or unmounted, it is important to chech that the sample storage is correct `omny.otransfer_storage()`.
+If this error happens after a sample was mounted or unmounted, it is important to chech that the sample storage is correct `omny.otransfer_show_all()`.
 
 (user.ptychography.omny.samples)=
 ### Sample storage and transfer
@@ -88,7 +88,7 @@ This loading status is handled via a OMNY samples device: `dev.omny_samples`
 
 Within the BEC client session `dev.omny_samples.help()` will display all required commands with a short explanation.
 
-To get an overview use `dev.omny_samples.show_all()` or `omny.otransfer_storage()`
+To get an overview use `dev.omny_samples.show_all()` or `omny.otransfer_show_all()`
 
 Modify a slot position of systems "A", "B", "C", "O":  
 `dev.omny_samples.unset_sample_slot('system',position)` free a sample position.  
@@ -110,7 +110,7 @@ Here is an _example_: dev.omny_samples.set_shuttle_slot('A',2)
 
 #### Sample transfer
 
-Once the sample places are set correctly and checked by using `omny.otransfer_storage()`, the following commands are available for sample change. To pick a sample from a parking slot, the parking slot stage has to be moved to the correct parking slot position. If a parking position is active, this information is displayed in sample storage overview.
+Once the sample places are set correctly and checked by using `omny.otransfer_show_all()`, the following commands are available for sample change. To pick a sample from a parking slot, the parking slot stage has to be moved to the correct parking slot position. If a parking position is active, this information is displayed in sample storage overview.
 
 | Command | Explanation |
 | --- | --- |

From f9a1f4a7d2ad4e26447204d3daca7c98751147b0 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Wed, 2 Sep 2026 18:37:37 +0200
Subject: [PATCH 028/102] fix(omny): warn about too-few Fermat points; fix
 live-testing crashes

Live-testing findings from Mirko's own session, four real bugs:

- tomo_parameters() now warns when the current fovx/fovy/tomo_shellstep
  would yield fewer than OmnyFermatScan.MIN_POSITIONS (20) Fermat scan
  points, matching Flomni.tomo_parameters()'s identical warning -- the scan
  server already aborted (ScanAbortion) on too few points, but nothing told
  the user ahead of time. Needed converting
  OmnyFermatScan.get_omny_fermat_spiral_pos() to a @staticmethod (was an
  instance method reading self.cenx/ceny/zshift) so it's callable from
  tomo_parameters() without a full scan instance, matching flomni's
  already-static version. Also promoted the hardcoded "20" in
  prepare_scan()'s abort check to a MIN_POSITIONS class constant.

- OMNY.tomo_scan() didn't accept interactive=, so every
  tomo_queue_execute() run (which always calls tomo_scan(interactive=False)
  for unattended queued runs) failed immediately with TypeError. Added the
  parameter, accepted but unused, matching flomni's own docstring reasoning
  (no fine-alignment gate on either setup).

- write_to_scilog()/write_pdf_report() used the old bec.logbook API with no
  "is scilog configured" check, so a session without scilog credentials
  hung indefinitely instead of failing fast (confirmed live: 29+ minutes).
  Migrated both to bec.messaging.scilog, gated on _enabled, matching
  flomni's actual current mechanism.

- Stale ~/Data10/specES1/ paths (predating the current ~/data/raw/ deployment
  layout) crashed _write_tomo_scan_number() with FileNotFoundError on a
  fresh session. Fixed that plus write_pdf_report()'s PDF target and
  tomo_reconstruct()'s default base_path, all three sharing the same stale
  root -- now also explicitly create their target directory first, since
  flomni's own equivalents assume it already exists.

16 new tests across test_omny_fermat_scan.py, test_omny_tomo_angles.py, and
test_omny_tomo_scan.py. Full suite: 725 passed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 63 ++++++++++++++-
 .../bec_ipython_client/plugins/omny/omny.py   | 81 +++++++++++++++++--
 csaxs_bec/scans/omny_fermat_scan.py           | 30 +++----
 .../test_omny_tomo_angles.py                  | 63 +++++++++++++++
 .../test_omny_tomo_scan.py                    | 39 +++++++++
 tests/tests_scans/test_omny_fermat_scan.py    | 59 ++++++++++++++
 6 files changed, 312 insertions(+), 23 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 971f1d3f..34851dd5 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -30,7 +30,10 @@ as a wear limit).
 OMNY) — `OMNY` now has a real job queue, `at_each_angle_hook` registration, `tomo_scan_resume()`,
 and scan progress visible outside the CLI session (previously a plain in-memory dict). See "Tomo-
 queue backend ported to OMNY" below. Phase 2 (the widget itself) is a separate follow-up, not yet
-started — not live-tested against a running session yet either; that's next, once Mirko pulls.
+started. Live-tested by Mirko against his own session (not a sim harness), which surfaced and
+fixed several more real bugs — see "scilog writes hung / migrated to bec.messaging.scilog",
+"tomo_scan() rejected TomoQueueMixin's interactive= kwarg", "stale ~/Data10/ paths crashed on a
+fresh session", and "tomo_parameters() now warns about too few Fermat scan points" below.
 
 **Still open / deferred** (unchanged from before, not touched this pass):
 - `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
@@ -40,6 +43,10 @@ started — not live-tested against a running session yet either; that's next, o
   dewar/temperature methods, sample storage bookkeeping, and `omny_alignment_mixin.py`/
   `omny_optics_mixin.py` beyond what scans exercise — see "Checklist" section below.
 - The `TomoParamsWidget`/`OMNY_TomoParams` GUI widget itself (Phase 2 of the tomo-queue port).
+- `omny_alignment_mixin.py`/`x_ray_eye_align.py` still reference the old `~/Data10/specES1/internal/`
+  path for alignment-offset data (unlike the tomo-scan-path fixes below, these already tolerate a
+  missing path gracefully — confirmed live, no crash, just "No data available" -- so left alone for
+  now, but worth the same `~/data/raw/` treatment eventually for consistency).
 
 ## Standing question: OMNY should follow flOMNI, not LamNI
 
@@ -372,6 +379,60 @@ the local bec-server may be in active use by Mirko's own parallel session; a ful
 numbers) -- next step is Mirko pulling and testing live himself, same pattern as this whole
 engagement.
 
+## Live-testing findings after the Phase 1 port (fixed)
+
+Mirko live-tested Phase 1 against his own session (not a sim harness) and found four more real
+bugs, all fixed in a follow-up pass:
+
+**scilog writes hung indefinitely.** `write_to_scilog()`/`write_pdf_report()` used the old
+`bec.logbook`/`client.logbook.send_logbook_message()` API, which has no "is scilog even
+configured" check -- on a session without scilog credentials, `send()` blocks forever instead of
+failing fast. Confirmed live: a real `tomo_scan()` hung for 29+ minutes inside
+`_write_subtomo_to_scilog()`. Per Mirko's direction ("Scilog Messaging should check the account.
+In flomni we are doing this I believe"): flomni's actual mechanism turned out to be
+`bec.messaging.scilog._enabled` (not literally an account check, but the same effect -- gates the
+send behind whether scilog is actually configured/reachable). Migrated both OMNY call sites onto
+the same `bec.messaging.scilog` API, matching flomni's `_scilog_write()`/`write_pdf_report()`
+exactly. 3 new unit tests lock in the `_enabled` gate.
+
+**`tomo_scan()` didn't accept `interactive=`.** `TomoQueueMixin.tomo_queue_execute()`
+unconditionally calls `self.tomo_scan(interactive=False)` for unattended queued runs (the same
+call convention flomni/lamni already support) -- `OMNY.tomo_scan()`'s signature never had this
+parameter at all, so every `tomo_queue_execute()` run failed immediately with `TypeError: got an
+unexpected keyword argument 'interactive'`. Fixed by adding `interactive: bool = True`, accepted
+but currently unused -- matching flomni's own docstring reasoning exactly ("FlOMNI has no
+fine-alignment gate"; OMNY doesn't either).
+
+**Stale `~/Data10/specES1/` paths crashed on a fresh session.** Confirmed live (`FileNotFoundError`
+on Mirko's Mac): `_write_tomo_scan_number()` wrote to
+`~/Data10/specES1/dat-files/tomography_scannumbers.txt`, a layout that doesn't exist in the current
+deployment at all -- flomni's own equivalent method already uses `~/data/raw/logs/`. Same fix
+applied to `write_pdf_report()`'s PDF target (`~/Data10/documentation/` ->
+`~/data/raw/documentation/`) and `tomo_reconstruct()`'s default `base_path` (`~/Data10/specES1` ->
+`~/data/raw`), all three of which shared the identical stale root. Unlike flomni's own
+`_write_tomo_scan_number()`/`write_pdf_report()` (which assume the target directory already
+exists, and would hit this same crash on a machine where it doesn't), OMNY's versions now
+explicitly `os.makedirs(..., exist_ok=True)` first -- a small hardening beyond a pure mirror,
+directly motivated by this exact crash.
+
+**`tomo_parameters()` now warns about too few Fermat scan points.** `OmnyFermatScan.prepare_scan()`
+already aborted (`ScanAbortion`) when the fovx/fovy/step combination yields fewer than
+`MIN_POSITIONS` (20) points -- that abort was intentional, but nothing warned ahead of time; the
+scan would just silently fail once actually run. Direct port of `Flomni.tomo_parameters()`'s
+identical warning line, added right after "Stitching overlap" in the printout: "Estimated Fermat
+scan points per projection: N (WARNING: below the minimum of 20 -- the scan will abort when run)".
+Needed a small supporting refactor: `OmnyFermatScan.get_omny_fermat_spiral_pos()` was an instance
+method reading `self.cenx`/`self.ceny`/`self.zshift` (unlike flomni's already-`@staticmethod`
+version), so it couldn't be called from `tomo_parameters()` without constructing a full scan
+instance -- converted to a `@staticmethod` taking `cenx`/`ceny`/`zshift` as explicit keyword args
+(default `0.0`, behavior-preserving), matching flomni's signature exactly. Also promoted the
+hardcoded `20` in `prepare_scan()`'s abort check to a `MIN_POSITIONS = 20` class constant (mirrors
+`FlomniFermatScan.MIN_POSITIONS`), so the CLI warning and the scan server's actual enforcement can
+never drift out of sync. 13 new tests across `test_omny_fermat_scan.py` (scan-level:
+`MIN_POSITIONS` value, static-method callability, cenx/ceny/zshift not affecting the count,
+`prepare_scan()` still aborts) and `test_omny_tomo_angles.py` (CLI-level: warning appears/doesn't
+appear).
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 231194a4..4653fc98 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1265,8 +1265,18 @@ class OMNY(
             for scan_nr in range(start_scan_number, end_scan_number):
                 self._write_tomo_scan_number(scan_nr, angle, subtomo_number)
 
-    def tomo_scan(self, subtomo_start=1, start_angle=None, projection_number=None):
-        """start a tomo scan"""
+    def tomo_scan(
+        self, subtomo_start=1, start_angle=None, projection_number=None, interactive: bool = True
+    ):
+        """start a tomo scan
+
+        Args:
+            interactive: accepted for signature compatibility with
+                TomoQueueMixin.tomo_queue_execute(), which always calls
+                self.tomo_scan(interactive=False) for unattended queued runs
+                (matching flomni's/lamni's call convention) -- unused here,
+                OMNY has no fine-alignment gate.
+        """
         self.omnygui_show_progress()
 
         bec = builtins.__dict__.get("bec")
@@ -1578,7 +1588,7 @@ class OMNY(
 
         return angle, subtomo_number
 
-    def tomo_reconstruct(self, base_path="~/Data10/specES1"):
+    def tomo_reconstruct(self, base_path="~/data/raw"):
         """write the tomo reconstruct file for the reconstruction queue"""
         bec = builtins.__dict__.get("bec")
         base_path = os.path.expanduser(base_path)
@@ -1596,9 +1606,16 @@ class OMNY(
             queue_file.write("p.check_nextscan_started 1\n")
 
     def _write_tomo_scan_number(self, scan_number: int, angle: float, subtomo_number: int) -> None:
-        tomo_scan_numbers_file = os.path.expanduser(
-            "~/Data10/specES1/dat-files/tomography_scannumbers.txt"
-        )
+        # ~/data/raw/logs/ matches flomni's own _write_tomo_scan_number() --
+        # the old ~/Data10/specES1/dat-files/ layout doesn't exist in the
+        # current deployment (confirmed live: FileNotFoundError on a fresh
+        # session). Unlike flomni's version, explicitly create the
+        # directory here rather than assuming something else already has --
+        # flomni's own identical open("a+") call has the same latent
+        # assumption, just usually gets away with it because the directory
+        # already exists on deployed systems.
+        tomo_scan_numbers_file = os.path.expanduser("~/data/raw/logs/tomography_scannumbers.txt")
+        os.makedirs(os.path.dirname(tomo_scan_numbers_file), exist_ok=True)
         with open(tomo_scan_numbers_file, "a+") as out_file:
             # pylint: disable=undefined-variable
             out_file.write(
@@ -1672,6 +1689,39 @@ class OMNY(
             account = os.getenv("USER") or ""
         return bool(account) and account in _SUPERUSER_ACCOUNTS
 
+    def _expected_fermat_position_count(self) -> int:
+        """Estimate the number of Fermat scan points the current
+        fovx/fovy/tomo_shellstep settings would produce, so a
+        too-few-points configuration (which the scan server would only
+        catch by aborting with ScanAbortion once the scan actually starts)
+        can be caught here instead, while just looking at tomo_parameters().
+        Direct port of Flomni._expected_fermat_position_count().
+
+        cenx/ceny/zshift are deliberately left at their defaults: they only
+        shift the final position, applied after the FOV keep-or-discard
+        check, so they can never affect the resulting count.
+        """
+        from csaxs_bec.scans.omny_fermat_scan import OmnyFermatScan
+
+        positions = OmnyFermatScan.get_omny_fermat_spiral_pos(
+            -abs(self.fovx / 2),
+            abs(self.fovx / 2),
+            -abs(self.fovy / 2),
+            abs(self.fovy / 2),
+            step=self.tomo_shellstep,
+            spiral_type=0,
+            center=False,
+        )
+        return len(positions)
+
+    @staticmethod
+    def _fermat_min_positions() -> int:
+        """OmnyFermatScan's own minimum-position threshold -- see
+        _expected_fermat_position_count()."""
+        from csaxs_bec.scans.omny_fermat_scan import OmnyFermatScan
+
+        return OmnyFermatScan.MIN_POSITIONS
+
     def tomo_parameters(self):
         """print and update the tomo parameters"""
         print("Current settings:")
@@ -1680,6 +1730,16 @@ class OMNY(
         print(f"FOV (200/100)  <microns>         =  {self.fovx}, {self.fovy}")
         print(f"Stitching number x,y             =  {self.stitch_x}, {self.stitch_y}")
         print(f"Stitching overlap                =  {self.tomo_stitch_overlap}")
+        expected_positions = self._expected_fermat_position_count()
+        min_positions = self._fermat_min_positions()
+        if expected_positions < min_positions:
+            print(
+                f"Estimated Fermat scan points per projection: {expected_positions}  "
+                f"(WARNING: below the minimum of {min_positions} -- the scan will abort"
+                " when run)"
+            )
+        else:
+            print(f"Estimated Fermat scan points per projection: {expected_positions}")
         print(f"Reconstruction queue name        =  {self.ptycho_reconstruct_foldername}")
         print(f"   _manual_shift_y         <mm>  =  {self.manual_shift_y}")
         print("")
@@ -1896,7 +1956,14 @@ class OMNY(
             "Add current temperature and pressure status",
         ]
         content = "".join(content)
-        user_target = os.path.expanduser(f"~/Data10/documentation/tomo_scan_ID_{self.tomo_id}.pdf")
+        # ~/data/raw/documentation/ matches flomni's/lamni's own
+        # write_pdf_report() target -- the old ~/Data10/documentation/
+        # layout doesn't exist in the current deployment. PDFWriter doesn't
+        # create its own parent directory, so do it explicitly here.
+        user_target = os.path.expanduser(
+            f"~/data/raw/documentation/tomo_scan_ID_{self.tomo_id}.pdf"
+        )
+        os.makedirs(os.path.dirname(user_target), exist_ok=True)
         with PDFWriter(user_target) as file:
             file.write(header)
             file.write(content)
diff --git a/csaxs_bec/scans/omny_fermat_scan.py b/csaxs_bec/scans/omny_fermat_scan.py
index 11f84007..c5a92e19 100644
--- a/csaxs_bec/scans/omny_fermat_scan.py
+++ b/csaxs_bec/scans/omny_fermat_scan.py
@@ -46,6 +46,7 @@ class OmnyFermatScan(ScanBase):
     # It must be a valid Python identifier, that is, it can only contain letters, numbers, and underscores, and must not start with a number.
     scan_name = "omny_fermat_scan"
 
+    MIN_POSITIONS = 20  # Minimum number of positions required for a valid scan
     MAX_CORRIDOR_SIZE = 3  # Corridor size is capped at this value (in um) for stability
 
     gui_config = {
@@ -150,9 +151,10 @@ class OmnyFermatScan(ScanBase):
             center=False,
         )
 
-        if len(positions) < 20:
+        if len(positions) < self.MIN_POSITIONS:
             raise ScanAbortion(
-                f"The number of positions must exceed 20. Currently: {len(positions)}."
+                f"The number of positions must exceed {self.MIN_POSITIONS}. Currently:"
+                f" {len(positions)}."
             )
 
         corridor_size = self.corridor_size
@@ -285,8 +287,8 @@ class OmnyFermatScan(ScanBase):
         )
         return val
 
+    @staticmethod
     def get_omny_fermat_spiral_pos(
-        self,
         m1_start: float,
         m1_stop: float,
         m2_start: float,
@@ -294,6 +296,9 @@ class OmnyFermatScan(ScanBase):
         step: float = 1,
         spiral_type: int = 0,
         center: bool = False,
+        cenx: float = 0.0,
+        ceny: float = 0.0,
+        zshift: float = 0.0,
     ):
         """
         Calculate positions for a Fermat spiral scan.
@@ -306,6 +311,9 @@ class OmnyFermatScan(ScanBase):
             step(float): stepsize
             spiral_type(int): 0 for traditional Fermat spiral
             center(bool): whether to include the center position
+            cenx(float): center offset in x
+            ceny(float): center offset in y
+            zshift(float): shift in z
 
         Returns:
             positions(array): positions
@@ -319,7 +327,7 @@ class OmnyFermatScan(ScanBase):
         length_axis2 = np.abs(m2_stop - m2_start)
         n_max = int(length_axis1 * length_axis2 * 3.2 / step / step)
 
-        z_pos = self.zshift
+        z_pos = zshift
 
         for ii in range(start, n_max):
             radius = step * 0.57 * np.sqrt(ii)
@@ -330,17 +338,9 @@ class OmnyFermatScan(ScanBase):
                 continue
             x = radius * np.sin(ii * phi)
             y = radius * np.cos(ii * phi)
-            positions.append([x + self.cenx, y + self.ceny, z_pos])
-        left_lower_corner = [
-            min(m1_start, m1_stop) + self.cenx,
-            min(m2_start, m2_stop) + self.ceny,
-            z_pos,
-        ]
-        right_upper_corner = [
-            max(m1_start, m1_stop) + self.cenx,
-            max(m2_start, m2_stop) + self.ceny,
-            z_pos,
-        ]
+            positions.append([x + cenx, y + ceny, z_pos])
+        left_lower_corner = [min(m1_start, m1_stop) + cenx, min(m2_start, m2_stop) + ceny, z_pos]
+        right_upper_corner = [max(m1_start, m1_stop) + cenx, max(m2_start, m2_stop) + ceny, z_pos]
         positions.append(left_lower_corner)
         positions.append(right_upper_corner)
         return np.array(positions)
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
index a9671af1..a3e1a411 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -387,3 +387,66 @@ def test_tomo_parameters_clamps_type_3_step_size_to_max_2_5_degrees(monkeypatch,
 
     assert omny.tomo_type == 3
     assert omny.tomo_angle_stepsize == pytest.approx(2.5)
+
+
+# --- tomo_parameters(): warns early about too few Fermat scan points --------
+#
+# omny_fermat_scan.OmnyFermatScan.prepare_scan() aborts (ScanAbortion) when
+# the FOV/step combination yields fewer than MIN_POSITIONS points -- that was
+# already the intended behavior, but nothing warned the user ahead of time;
+# the scan would just silently fail once actually run. Direct port of
+# Flomni.tomo_parameters()'s identical warning line.
+
+
+def test_tomo_parameters_warns_when_fermat_positions_below_minimum(monkeypatch, fake_bec, capsys):
+    fake_bec.active_account = "e00001"
+    omny = make_omny()
+    omny.tomo_countingtime = 1.0
+    omny.tomo_shellstep = 50.0  # coarse step + tiny FOV -> too few points
+    omny.fovx = 1
+    omny.fovy = 1
+    omny.stitch_x = 0
+    omny.stitch_y = 0
+    omny.tomo_stitch_overlap = 0.2
+    omny.ptycho_reconstruct_foldername = "queue"
+    omny.manual_shift_y = 0.0
+    omny.tomo_angle_stepsize = 10.0
+    omny.tomo_type = 1
+    fake_dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+    omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: True)  # accept as-is, no edits
+
+    omny.tomo_parameters()
+
+    out = capsys.readouterr().out
+    assert "WARNING: below the minimum" in out
+    assert "the scan will abort when run" in out
+
+
+def test_tomo_parameters_no_warning_when_fermat_positions_sufficient(monkeypatch, fake_bec, capsys):
+    fake_bec.active_account = "e00001"
+    omny = make_omny()
+    omny.tomo_countingtime = 1.0
+    omny.tomo_shellstep = 0.5
+    omny.fovx = 20
+    omny.fovy = 20
+    omny.stitch_x = 0
+    omny.stitch_y = 0
+    omny.tomo_stitch_overlap = 0.2
+    omny.ptycho_reconstruct_foldername = "queue"
+    omny.manual_shift_y = 0.0
+    omny.tomo_angle_stepsize = 10.0
+    omny.tomo_type = 1
+    fake_dev = types.SimpleNamespace(
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+    omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: True)
+
+    omny.tomo_parameters()
+
+    out = capsys.readouterr().out
+    assert "WARNING: below the minimum" not in out
+    assert "Estimated Fermat scan points per projection:" in out
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 202d3a20..2bda299d 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -125,6 +125,18 @@ def test_tomo_scan_shows_progress_gui(monkeypatch):
     assert calls == ["shown"]
 
 
+def test_tomo_scan_accepts_interactive_kwarg(monkeypatch):
+    """TomoQueueMixin.tomo_queue_execute() always calls
+    self.tomo_scan(interactive=False) for unattended queued runs -- confirmed
+    live: OMNY.tomo_scan() didn't accept this kwarg at all, so every queued
+    job failed with 'got an unexpected keyword argument interactive'."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+
+    omny.tomo_scan(interactive=False)  # must not raise TypeError
+
+    assert omny.progress["tomo_start_time"] is not None
+
+
 def test_tomo_scan_clears_heartbeat_on_normal_completion(monkeypatch):
     """The busy-detector heartbeat must be cleared as soon as the scan
     finishes, not left for the next poll to time out before the GUI stops
@@ -255,3 +267,30 @@ def test_write_to_scilog_tolerates_send_exception(monkeypatch):
     result = omny.write_to_scilog("hello")
 
     assert result is False
+
+
+# --- _write_tomo_scan_number(): ~/data/raw/logs/, creating it if missing ----
+#
+# Confirmed live: the old ~/Data10/specES1/dat-files/ path didn't exist at
+# all on a fresh session (a Mac dev machine), crashing with
+# FileNotFoundError the moment a real tomo scan tried to log its first
+# projection. Moved to ~/data/raw/logs/ (matching flomni's own
+# _write_tomo_scan_number()) and, unlike flomni's identical open("a+") call,
+# explicitly create the directory first rather than assume it already
+# exists.
+
+
+def test_write_tomo_scan_number_creates_missing_directory(monkeypatch, tmp_path):
+    monkeypatch.setenv("HOME", str(tmp_path))
+    omny = object.__new__(OMNY)
+    omny.tomo_id = 1
+    fake_dev = types.SimpleNamespace(
+        osamroy=types.SimpleNamespace(read=lambda: {"osamroy": {"value": 12.5}}),
+        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample"),
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+
+    omny._write_tomo_scan_number(844, 12.5, 1)
+
+    written = (tmp_path / "data" / "raw" / "logs" / "tomography_scannumbers.txt").read_text()
+    assert written == "844 12.5 12.500 1 1 0 test_sample\n"
diff --git a/tests/tests_scans/test_omny_fermat_scan.py b/tests/tests_scans/test_omny_fermat_scan.py
index f403fcad..f17c7498 100644
--- a/tests/tests_scans/test_omny_fermat_scan.py
+++ b/tests/tests_scans/test_omny_fermat_scan.py
@@ -1,6 +1,7 @@
 from unittest import mock
 
 import numpy as np
+import pytest
 
 from csaxs_bec.scans.omny_fermat_scan import OmnyFermatScan
 
@@ -74,3 +75,61 @@ def test_estimate_corridor_size_scales_with_factor():
     doubled_factor = OmnyFermatScan._estimate_corridor_size(positions, factor=3.0)
 
     assert np.isclose(doubled_factor, 2 * default_factor)
+
+
+def test_min_positions_matches_flomni():
+    """OmnyFermatScan.MIN_POSITIONS must exist as a class constant (not a
+    hardcoded literal in prepare_scan()) so OMNY.tomo_parameters() can warn
+    early against the same threshold the scan server actually enforces,
+    mirroring FlomniFermatScan.MIN_POSITIONS."""
+    assert OmnyFermatScan.MIN_POSITIONS == 20
+
+
+def test_get_omny_fermat_spiral_pos_is_static_and_callable_without_an_instance():
+    """Ported to a @staticmethod (was an instance method reading
+    self.cenx/self.ceny/self.zshift) so OMNY.tomo_parameters() can call it
+    directly (via the class, like Flomni._expected_fermat_position_count()
+    does with FlomniFermatScan.get_flomni_fermat_spiral_pos()) without
+    constructing a full scan instance."""
+    positions = OmnyFermatScan.get_omny_fermat_spiral_pos(-5, 5, -5, 5, step=1, spiral_type=0)
+    assert len(positions) > 0
+
+
+def test_get_omny_fermat_spiral_pos_count_ignores_cenx_ceny_zshift():
+    """cenx/ceny/zshift only shift the final position (applied after the
+    FOV keep-or-discard check), so they must never change the resulting
+    position count -- same invariant flomni's version relies on."""
+    baseline = OmnyFermatScan.get_omny_fermat_spiral_pos(-5, 5, -5, 5, step=1, spiral_type=0)
+    shifted = OmnyFermatScan.get_omny_fermat_spiral_pos(
+        -5, 5, -5, 5, step=1, spiral_type=0, cenx=100.0, ceny=-50.0, zshift=7.0
+    )
+
+    assert len(shifted) == len(baseline)
+    # the offset is applied uniformly to every returned position
+    assert np.allclose(shifted[:, 0] - baseline[:, 0], 100.0)
+    assert np.allclose(shifted[:, 1] - baseline[:, 1], -50.0)
+    assert np.allclose(shifted[:, 2], 7.0)
+
+
+def test_prepare_scan_aborts_below_min_positions():
+    """Regression guard for the MIN_POSITIONS refactor: prepare_scan() must
+    still reject a too-small FOV/step combination the same way it did with
+    the old hardcoded literal."""
+    from bec_server.scan_server.errors import ScanAbortion
+
+    scan = mock.MagicMock()
+    scan.fovx = 1
+    scan.fovy = 1
+    scan.step = 1
+    scan.zshift = 0
+    scan.cenx = 0
+    scan.ceny = 0
+    scan.corridor_size = None
+    scan.MIN_POSITIONS = OmnyFermatScan.MIN_POSITIONS
+    # get_omny_fermat_spiral_pos is now a @staticmethod -- bind the real
+    # function so prepare_scan()'s self.get_omny_fermat_spiral_pos(...) call
+    # runs the actual math instead of an auto-mocked stand-in.
+    scan.get_omny_fermat_spiral_pos = OmnyFermatScan.get_omny_fermat_spiral_pos
+
+    with pytest.raises(ScanAbortion):
+        OmnyFermatScan.prepare_scan(scan)

From 52c1806fe22ba6e8e811591654d0d6ccef465190 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 02:35:34 +0200
Subject: [PATCH 029/102] fix(sample_storage): enforce unique sample names in
 the widget

Renaming or newly naming a slot now rejects a name already used by another
occupied slot in the active setup (FlOMNI or OMNY), so bookkeeping can't
end up with two same-named samples that are impossible to tell apart later
(including in the FlOMNI measured-sample log, which is keyed by name+owner).
Renaming a slot to its own existing name is still allowed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../widgets/sample_storage/sample_storage.py  | 46 ++++++++++++++++++-
 1 file changed, 44 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 1501623a..8b4bc0b1 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -1065,10 +1065,34 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     # ── mutation actions (called from _SlotCell context menu) ─────────────────
 
+    def _find_duplicate_name(self, slot, name: str):
+        """Return the slot key that already holds `name`, if any OTHER
+        occupied slot of the active setup currently has this exact name, or
+        None. Used by action_change_name()/action_new_sample() to enforce
+        that sample names are unique -- otherwise the measured-sample log
+        (FlOMNI, keyed by name+owner) and operators reading the storage
+        overview could no longer tell two same-named samples apart.
+
+        Reads from ``self._last_state``, the same poll-refreshed snapshot
+        the cells themselves are painted from, rather than issuing a fresh
+        device read -- consistent with the rest of this widget's
+        eventual-consistency model (a write immediately after a poll could
+        in principle race a concurrent CLI rename, same as any other
+        interaction here; see module docstring on operator discipline).
+        """
+        for key, entry in self._last_state.items():
+            if key == slot:
+                continue
+            occupied, existing_name = entry[0], entry[1]
+            if occupied and existing_name == name:
+                return key
+        return None
+
     def action_change_name(self, slot, current_name: str, current_owner: str = "") -> None:
         """Rename an occupied slot (stays occupied). Shared by both setups
         (see ``_SlotCell``) -- both require a name and an owner (see module
-        docstring).
+        docstring), and both require the name to be unique across the
+        active setup's slots (see ``_find_duplicate_name``).
         """
         name, ok = QInputDialog.getText(
             self,
@@ -1087,6 +1111,15 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 "Use “Clear (set empty)” to empty the slot instead.",
             )
             return
+        dup = self._find_duplicate_name(slot, name)
+        if dup is not None:
+            QMessageBox.warning(
+                self,
+                "Duplicate name",
+                f"'{name}' is already used by slot {self._slot_title(dup)}.\n"
+                "Sample names must be unique.",
+            )
+            return
         owner, ok = QInputDialog.getText(
             self,
             "Sample owner",
@@ -1104,7 +1137,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def action_new_sample(self, slot) -> None:
         """Mark an empty slot occupied and give it a name. Shared by both
-        setups (see ``action_change_name``).
+        setups (see ``action_change_name``), including the uniqueness check.
         """
         name, ok = QInputDialog.getText(
             self, "New sample", f"Sample name for slot {self._slot_title(slot)}:"
@@ -1115,6 +1148,15 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if not name or name == EMPTY_NAME:
             QMessageBox.warning(self, "Invalid name", "Please enter a non-empty sample name.")
             return
+        dup = self._find_duplicate_name(slot, name)
+        if dup is not None:
+            QMessageBox.warning(
+                self,
+                "Duplicate name",
+                f"'{name}' is already used by slot {self._slot_title(dup)}.\n"
+                "Sample names must be unique.",
+            )
+            return
         owner, ok = QInputDialog.getText(
             self, "Sample owner", f"Owner for slot {self._slot_title(slot)}:"
         )

From afc13df24ddf28e09918e090aa2d70ea72db0c3c Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 02:45:59 +0200
Subject: [PATCH 030/102] feat(omny): add third progress ring, idle-time
 tracking, timing summary

Mirko: "the flomni progress bar has three rings. here i am seing only
two... at the end of a tomogram in flomni a summary of the measurement
time and time lost is displayed. omny seems not to have that, maybe not
even measuring the time."

Both traced back to the same root gap left by the Phase-1 tomo-queue port:
nothing computed estimated_remaining_time/estimated_finish_time, and
nothing refreshed progress["heartbeat"] *during* a running scan (only
cleared it to None on completion) -- so accumulated_idle_time stayed 0.0
forever and there was no ETA data to show or summarize.

- _tomo_scan_at_angle() now refreshes the heartbeat every angle and
  attributes any gap beyond a normal-cadence heuristic to
  accumulated_idle_time (mirrors flomni's identical formula, minus its
  frames_per_trigger factor which OMNY has no property for).
- _print_progress() computes/stores/prints estimated_remaining_time and
  estimated_finish_time once the scan rate has stabilized.
- tomo_scan() prints an end-of-scan "Total measurement time"/"...excluding
  detected gaps"/"...lost to detected gaps" summary and sends it to scilog,
  direct port of flomni's block (minus its measured_log call, which OMNY
  has no equivalent of).
- gui_tools.py: omnygui_show_progress() adds flomni's third, scan-linked
  auto-updating ring; _omnygui_update_progress()'s center label now shows
  start time / ETA / estimated finish / active hook, matching flomni's
  _flomnigui_update_progress().

_describe_active_hook()/_active_hook_source() needed no porting -- already
provided by TomoQueueMixin since Phase 1. Not ported: flomni's separate
persistent timing-statistics-log subsystem (_log_tomogram_timing()) --
out of scope for what was actually asked (the printed summary + ring
count).

9 new tests (test_omny_tomo_scan.py, test_omny_gui_tools.py). Full suite:
731 passed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  77 +++++++++----
 .../plugins/omny/gui_tools.py                 |  67 +++++++++--
 .../bec_ipython_client/plugins/omny/omny.py   | 107 +++++++++++++++++-
 .../test_omny_gui_tools.py                    |  72 ++++++++++++
 .../test_omny_tomo_scan.py                    |  90 ++++++++++++++-
 5 files changed, 376 insertions(+), 37 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 34851dd5..4e69ef53 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -1,4 +1,4 @@
-# OMNY open issues (as of 2026-09-02)
+# OMNY open issues (as of 2026-09-03)
 
 Tracks the live-testing effort for bringing OMNY up to flomni's/BEC's current standards on
 branch `update-omny`: bugs found (fixed and unfixed) and what's still untested. Written so a
@@ -26,14 +26,19 @@ removed" below. Tomo type 3 also gained a hard cap of 2.5 degrees on the angular
 only a minimum-100-projections floor, which happened to already satisfy this but wasn't expressed
 as a wear limit).
 
-**Just landed**: the tomo-queue backend (Phase 1 of 2 of porting the tomo params GUI widget to
-OMNY) — `OMNY` now has a real job queue, `at_each_angle_hook` registration, `tomo_scan_resume()`,
-and scan progress visible outside the CLI session (previously a plain in-memory dict). See "Tomo-
-queue backend ported to OMNY" below. Phase 2 (the widget itself) is a separate follow-up, not yet
-started. Live-tested by Mirko against his own session (not a sim harness), which surfaced and
-fixed several more real bugs — see "scilog writes hung / migrated to bec.messaging.scilog",
-"tomo_scan() rejected TomoQueueMixin's interactive= kwarg", "stale ~/Data10/ paths crashed on a
-fresh session", and "tomo_parameters() now warns about too few Fermat scan points" below.
+**Just landed, confirmed working live**: the tomo-queue backend (Phase 1 of 2 of porting the tomo
+params GUI widget to OMNY) — `OMNY` now has a real job queue, `at_each_angle_hook` registration,
+`tomo_scan_resume()`, and scan progress visible outside the CLI session (previously a plain
+in-memory dict). See "Tomo-queue backend ported to OMNY" below. Live-tested by Mirko against his
+own session (not a sim harness), which surfaced and fixed several more real bugs along the way —
+see "scilog writes hung / migrated to bec.messaging.scilog", "tomo_scan() rejected
+TomoQueueMixin's interactive= kwarg", "stale ~/Data10/ paths crashed on a fresh session", and
+"tomo_parameters() now warns about too few Fermat scan points" below. Mirko confirmed: "tomo scan
+and tomo queue seems to work now for omny." Also just fixed following his feedback: the progress
+ring GUI only had 2 of flomni's 3 rings, and OMNY never tracked/printed measurement time or idle
+time the way flomni does at the end of a tomogram -- see "Progress ring GUI + ETA/idle-time
+tracking + end-of-scan timing summary" below. Phase 2 (the `TomoParamsWidget` GUI itself) is a
+separate follow-up, not yet started.
 
 **Still open / deferred** (unchanged from before, not touched this pass):
 - `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
@@ -150,19 +155,49 @@ Still untested (not attempted yet, not known-broken — just unexplored):
   entry and its tomo-type selector/job-display logic is hardcoded to 3 tomo types (flomni's
   and lamni's), not OMNY's 5 — needs its own plan once Phase 1 is live-tested.
 
-## gui_tools.py progress ETA/heartbeat line (still not rendered, data now exists)
+## Progress ring GUI + ETA/idle-time tracking + end-of-scan timing summary (fixed)
 
-`gui_tools.py` was modernized to flomni's current single-level `.new()` / `_is_deleted()`-guard
-pattern (window lifecycle, xray-eye-align GUI, cameras + hard-stop console, `RingProgressBar`).
-As of the tomo-queue backend port (see below), `self.progress` now DOES carry
-`tomo_start_time`/`heartbeat`/`estimated_remaining_time`/`estimated_finish_time` (global-var-backed,
-same shape as flomni's/lamni's) — what's still not ported is purely a `gui_tools.py` rendering
-detail: `_omnygui_update_progress()` was never updated to display an ETA/heartbeat line the way
-flomni's `_flomnigui_update_progress()`/`_describe_active_hook()` do, and still only builds its
-text from the original 7 fields. Not a crash risk either way — `_omnygui_update_progress()`
-ignores fields it doesn't read, and `omny_webpage_generator.py` (unwired/dead code, see below)
-already reads the ETA-ish fields defensively via `.get()`, degrading to "N/A" when absent. Revisit
-whenever the progress ring GUI itself gets an ETA line, independent of the Phase 2 widget work.
+Mirko live-tested Phase 1 and asked two related questions: why does OMNY's progress ring bar show
+only 2 rings where flomni shows 3, and why does OMNY not print a measurement-time/time-lost summary
+at the end of a tomogram the way flomni does. Both traced back to the same root gap: nothing in
+OMNY ever computed `estimated_remaining_time`/`estimated_finish_time`, and nothing ever refreshed
+`heartbeat` *during* a running scan (only cleared it to `None` on completion, from the Phase-1
+port) -- so `accumulated_idle_time` stayed `0.0` forever and there was no ETA data to show or
+summarize. All direct ports of flomni's already-working mechanism, all sharing the same underlying
+data (`self.progress`, global-var-backed since Phase 1):
+
+- **`_tomo_scan_at_angle()`** now refreshes `progress["heartbeat"]` at the start of every angle,
+  and -- if the gap since the previous heartbeat exceeds a normal-cadence heuristic
+  (`max(60s, 5 * tomo_countingtime)`, flomni's identical formula minus its `frames_per_trigger`
+  factor, which OMNY has no equivalent property for) -- attributes the excess to
+  `accumulated_idle_time` and prints a one-line note. This is what actually makes idle-time
+  tracking (and therefore both features below) possible; it didn't exist in Phase 1 at all.
+- **`_print_progress()`** now computes and stores `estimated_remaining_time`/
+  `estimated_finish_time` from elapsed time minus accumulated idle time (once past projection 9,
+  matching flomni's stabilization threshold), and prints them alongside the existing progress
+  report.
+- **`tomo_scan()`** now prints an end-of-scan summary ("Total measurement time", "... excluding
+  detected gaps", "... lost to detected gaps") after the try/finally, and sends the same content to
+  scilog via `write_to_scilog()` -- direct port of flomni's block, minus the flomni-only
+  `self.measured_log` sample-tracking call (OMNY has no equivalent).
+- **`gui_tools.py`**: `omnygui_show_progress()` now adds a third ring with `set_update("scan")`
+  (auto-updated from the currently running scan, no manual `.set_value()` needed -- matches
+  flomni's `flomnigui_show_progress()` exactly), and `_omnygui_update_progress()`'s center-label
+  text now includes start time / ETA / estimated finish / active-hook lines, matching flomni's
+  `_flomnigui_update_progress()`.
+
+`_format_duration()` (static, `"2h 03m 15s"`-style formatting) added to `omny.py` -- previously
+flomni-only. `_describe_active_hook()`/`_active_hook_source()` needed no porting: already provided
+by `TomoQueueMixin` since Phase 1.
+
+**Not ported**: flomni's separate `_log_tomogram_timing()`/persistent timing-statistics-log
+subsystem (writes a JSON record per tomogram to `~/data/raw/logs/timing_statistics`, backing
+`scilog_last_ptycho_scans()`/a timing overview command) -- Mirko asked specifically about the
+*printed* summary and the ring count, not this larger, separate logging feature. Flag if wanted.
+
+Test coverage: 9 new tests (`test_omny_tomo_scan.py`: idle-time-from-gap, no-idle-time-within-
+cadence, end-of-scan summary lines; `test_omny_gui_tools.py`: three-ring creation, center-label
+text with/without an active hook). Full suite: 731 passed.
 
 ## cam_xeye device (simulated only, real hardware config still needed)
 
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index 037a1eff..4a18db61 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -205,19 +205,26 @@ class OMNYGuiTools:
             if self._omnygui_is_missing("progressbar"):
                 self.omnygui_remove_all_docks()
                 self.progressbar = self.gui.omny.new("RingProgressBar")
-                # Two manually-updated rings: overall tomogram progress and
-                # subtomo progress. Unlike flomni's third, auto-updating
-                # "scan"-linked ring, and unlike flomni's ETA/heartbeat/
-                # active-hook text, omny's progress dict doesn't carry that
-                # data yet (see omny/AI_docs/OPEN_ISSUES.md) -- kept simple
-                # here on purpose, revisit once that's ported.
+                # Two manually-updated rings (overall tomogram progress and
+                # subtomo progress) plus a third ring auto-updated from the
+                # currently running scan itself -- matches flomni's
+                # flomnigui_show_progress() exactly.
                 self.progressbar.add_ring().set_update("manual")
                 self.progressbar.add_ring().set_update("manual")
+                self.progressbar.add_ring().set_update("scan")
             self._omnygui_update_progress()
         except Exception as e:
             logger.warning(f"Error in omnygui_show_progress: {e}")
 
     def _omnygui_update_progress(self):
+        """Update the progress ring bar and center label from the current progress state.
+
+        ``self.progress`` is backed by the BEC global variable ``tomo_progress``
+        (see :class:`_ProgressProxy` in ``omny.py``), so this method reflects
+        the live state that is also accessible from other BEC client sessions via::
+
+            client.get_global_var("tomo_progress")
+        """
         try:
             if self.progressbar is None:
                 logger.warning("OMNY progress GUI update skipped: progressbar is not available.")
@@ -233,6 +240,43 @@ class OMNYGuiTools:
             main_progress_ring.set_value(progress)
             subtomo_progress_ring.set_value(subtomo_progress)
 
+            # --- format start time for display --------------------------------
+            start_str = self.progress.get("tomo_start_time")
+            if start_str is not None:
+                import datetime as _dt
+
+                start_display = _dt.datetime.fromisoformat(start_str).strftime("%Y-%m-%d %H:%M:%S")
+            else:
+                start_display = "N/A"
+
+            # --- format estimated remaining time ------------------------------
+            remaining_s = self.progress.get("estimated_remaining_time")
+            if remaining_s is not None and remaining_s >= 0:
+                remaining_s = int(remaining_s)
+                h, rem = divmod(remaining_s, 3600)
+                m, s = divmod(rem, 60)
+                if h > 0:
+                    eta_display = f"{h}h {m:02d}m {s:02d}s"
+                elif m > 0:
+                    eta_display = f"{m}m {s:02d}s"
+                else:
+                    eta_display = f"{s}s"
+            else:
+                eta_display = "N/A"
+            # ------------------------------------------------------------------
+
+            # --- format estimated finish (wall-clock) time --------------------
+            finish_str = self.progress.get("estimated_finish_time")
+            if finish_str is not None:
+                import datetime as _dt
+
+                finish_display = _dt.datetime.fromisoformat(finish_str).strftime(
+                    "%Y-%m-%d %H:%M:%S"
+                )
+            else:
+                finish_display = "N/A"
+            # ------------------------------------------------------------------
+
             text = (
                 f"Progress report:\n"
                 f" Tomo type:  {self.progress['tomo_type']}\n"
@@ -241,8 +285,17 @@ class OMNYGuiTools:
                 f" Angle:  {self.progress['angle']:.1f}\n"
                 f" Current subtomo:  {self.progress['subtomo']}\n"
                 f" Current projection within subtomo: {self.progress['subtomo_projection']}\n"
-                f" Total projections per subtomo:  {int(self.progress['subtomo_total_projections'])}"
+                f" Total projections per subtomo:  {int(self.progress['subtomo_total_projections'])}\n"
+                f" Scan started:  {start_display}\n"
+                f" Est. remaining:  {eta_display}\n"
+                f" Est. finish:  {finish_display}"
             )
+            # self._describe_active_hook() comes from TomoQueueMixin (this
+            # is a mixin, always combined with it) -- shown only when a
+            # hook is actually active, same as tomo_parameters()'s CLI note.
+            hook_description = self._describe_active_hook()
+            if hook_description:
+                text += f"\n Hook:  {hook_description}"
             self.progressbar.set_center_label(text)
         except Exception as exc:
             logger.warning(f"OMNY progress GUI update skipped: {exc}")
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 4653fc98..7fdc04ba 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1230,6 +1230,31 @@ class OMNY(
         successful = False
         error_caught = False
         if 0 <= angle < 180.05:
+            now = datetime.datetime.now()
+            prev_heartbeat_str = self.progress.get("heartbeat")
+            if prev_heartbeat_str is not None:
+                gap = (now - datetime.datetime.fromisoformat(prev_heartbeat_str)).total_seconds()
+                # Normal cadence between consecutive projections is roughly the
+                # acquisition time plus motor/readout overhead. A gap well
+                # beyond that means something interrupted the scan in between
+                # (beamline-down interlock pause, a crash + manual restart,
+                # ...) -- attribute the excess to idle time so it doesn't drag
+                # down the apparent scan rate used for the ETA below. Mirrors
+                # flomni's identical heuristic (minus its frames_per_trigger
+                # factor -- OMNY has no such property). The 5x/60s margins
+                # are a heuristic, not a precise timing model -- tune if it
+                # over/under-triggers in practice.
+                normal_cadence = max(60.0, 5 * self.tomo_countingtime)
+                if gap > normal_cadence:
+                    idle = gap - normal_cadence
+                    self.progress["accumulated_idle_time"] = (
+                        self.progress.get("accumulated_idle_time", 0.0) + idle
+                    )
+                    print(
+                        f"Detected a {self._format_duration(gap)} gap since the last projection"
+                        f" -- excluding {self._format_duration(idle)} from the ETA estimate."
+                    )
+            self.progress["heartbeat"] = now.isoformat()
             print(f"Starting OMNY scan for angle {angle} in subtomo {subtomo_number}")
             self._print_progress()
             self.omnygui_show_progress()
@@ -1436,6 +1461,47 @@ class OMNY(
             # identical fix.
             self.progress["heartbeat"] = None
 
+        self.progress["projection"] = self.progress["total_projections"]
+        self.progress["subtomo_projection"] = self.progress["subtomo_total_projections"]
+        self._print_progress()
+        self.OMNYTools.printgreenbold("Tomoscan finished")
+
+        idle_s = self.progress.get("accumulated_idle_time", 0.0)
+        start_str = self.progress.get("tomo_start_time")
+        elapsed_s = None
+        if start_str is not None:
+            try:
+                elapsed_s = (
+                    datetime.datetime.now() - datetime.datetime.fromisoformat(start_str)
+                ).total_seconds()
+            except (ValueError, TypeError):
+                elapsed_s = None
+        timing_lines = [
+            "Tomoscan finished.",
+            f"Measurement ID: {self.tomo_id}",
+            f"Sample: {self.sample_name}",
+        ]
+        hook_description = self._describe_active_hook()
+        if hook_description:
+            timing_lines.append(f"At-each-angle hook: {hook_description}")
+        if elapsed_s is not None:
+            timing_lines.append(f"Total measurement time: {self._format_duration(elapsed_s)}")
+            timing_lines.append(
+                f"Total measurement time excluding detected gaps: {self._format_duration(elapsed_s - idle_s)}"
+            )
+        timing_lines.append(
+            f"Total measurement time lost to detected gaps: {self._format_duration(idle_s)}"
+        )
+        for line in timing_lines[3:]:
+            print(line)
+        timing_content = "\n".join(timing_lines)
+        hook_source = self._active_hook_source()
+        if hook_source:
+            timing_content += (
+                f"\n\nAt-each-angle hook source ('{self.at_each_angle_hook}'):\n{hook_source}"
+            )
+        self.write_to_scilog(timing_content, ["tomoscan"])
+
     def tomo_scan_resume(self) -> None:
         """Resume a tomo_scan() that crashed or was interrupted, picking up
         automatically from wherever ``progress`` last reported -- no need to
@@ -1501,7 +1567,42 @@ class OMNY(
         start_angle = float(angles[projection_within_subtomo])
         return subtomo_start, start_angle
 
+    @staticmethod
+    def _format_duration(seconds: float) -> str:
+        """Format a duration in seconds as a human-readable string, e.g. '2h 03m 15s'."""
+        seconds = int(seconds)
+        h, remainder = divmod(seconds, 3600)
+        m, s = divmod(remainder, 60)
+        if h > 0:
+            return f"{h}h {m:02d}m {s:02d}s"
+        if m > 0:
+            return f"{m}m {s:02d}s"
+        return f"{s}s"
+
     def _print_progress(self):
+        # --- compute and store estimated remaining time --------------------
+        start_str = self.progress.get("tomo_start_time")
+        projection = self.progress["projection"]
+        total = self.progress["total_projections"]
+        if start_str is not None and total > 0 and projection > 9:
+            now = datetime.datetime.now()
+            elapsed = (now - datetime.datetime.fromisoformat(start_str)).total_seconds()
+            # Exclude detected idle time (beamline-down pauses, a crash +
+            # restart gap, ...) so it doesn't make the scan look slower than
+            # it actually is while it's running.
+            elapsed -= self.progress.get("accumulated_idle_time", 0.0)
+            elapsed = max(elapsed, 1.0)  # guard against a degenerate/negative denominator
+            rate = projection / elapsed  # projections per second
+            remaining_s = (total - projection) / rate
+            self.progress["estimated_remaining_time"] = remaining_s
+            eta_str = self._format_duration(remaining_s)
+            finish_dt = now + datetime.timedelta(seconds=remaining_s)
+            self.progress["estimated_finish_time"] = finish_dt.isoformat()
+            finish_str = finish_dt.strftime("%Y-%m-%d %H:%M:%S")
+        else:
+            eta_str = "N/A"
+            finish_str = "N/A"
+        # ---------------------------------------------------------------------
         print("\x1b[95mProgress report:")
         print(f"Tomo type: ....................... {self.progress['tomo_type']}")
         print(f"Projection: ...................... {self.progress['projection']:.0f}")
@@ -1509,9 +1610,9 @@ class OMNY(
         print(f"Angle: ........................... {self.progress['angle']}")
         print(f"Current subtomo: ................. {self.progress['subtomo']}")
         print(f"Current projection within subtomo: {self.progress['subtomo_projection']}")
-        print(
-            f"Total projections per subtomo: ... {self.progress['subtomo_total_projections']}\x1b[0m"
-        )
+        print(f"Total projections per subtomo: ... {self.progress['subtomo_total_projections']}")
+        print(f"Estimated remaining time: ........ {eta_str}")
+        print(f"Estimated finish time: ........... {finish_str}\x1b[0m")
 
     def add_sample_database(
         self, samplename, date, eaccount, scan_number, setup, sample_additional_info, user
diff --git a/tests/tests_bec_ipython_client/test_omny_gui_tools.py b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
index 5e02edc7..55e54dd5 100644
--- a/tests/tests_bec_ipython_client/test_omny_gui_tools.py
+++ b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
@@ -144,6 +144,78 @@ def test_omnygui_show_omnycam_parking_uses_current_image_widget_api():
     assert tools.console is console
 
 
+def _fake_progress(**overrides):
+    base = {
+        "tomo_type": "Equally spaced sub-tomograms (2)",
+        "projection": 3,
+        "total_projections": 10,
+        "angle": 12.5,
+        "subtomo": 1,
+        "subtomo_projection": 3,
+        "subtomo_total_projections": 5,
+        "tomo_start_time": None,
+        "estimated_remaining_time": None,
+        "estimated_finish_time": None,
+    }
+    base.update(overrides)
+    return base
+
+
+def test_omnygui_show_progress_creates_three_rings_matching_flomni():
+    """Third ring is auto-updated from the running scan itself
+    (set_update("scan")), matching flomni's flomnigui_show_progress() --
+    omny previously only had the two manually-updated rings."""
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    progressbar = mock.MagicMock()
+    client.gui.omny.new.return_value = progressbar
+    ring1, ring2, ring3 = mock.MagicMock(), mock.MagicMock(), mock.MagicMock()
+    progressbar.add_ring.side_effect = [ring1, ring2, ring3]
+    progressbar.rings = [ring1, ring2, ring3]
+    tools.progress = _fake_progress()
+    tools._describe_active_hook = lambda: None
+
+    tools.omnygui_show_progress()
+
+    assert progressbar.add_ring.call_count == 3
+    ring1.set_update.assert_called_once_with("manual")
+    ring2.set_update.assert_called_once_with("manual")
+    ring3.set_update.assert_called_once_with("scan")
+
+
+def test_omnygui_update_progress_text_includes_start_eta_finish():
+    tools, _ = _make_gui_tools()
+    tools.progressbar = mock.MagicMock()
+    tools.progressbar.rings = [mock.MagicMock(), mock.MagicMock()]
+    tools.progress = _fake_progress(
+        tomo_start_time="2026-01-01T00:00:00",
+        estimated_remaining_time=125.0,
+        estimated_finish_time="2026-01-01T01:00:00",
+    )
+    tools._describe_active_hook = lambda: None
+
+    tools._omnygui_update_progress()
+
+    text = tools.progressbar.set_center_label.call_args[0][0]
+    assert "Scan started:  2026-01-01 00:00:00" in text
+    assert "Est. remaining:  2m 05s" in text
+    assert "Est. finish:  2026-01-01 01:00:00" in text
+    assert "Hook:" not in text  # no active hook
+
+
+def test_omnygui_update_progress_shows_active_hook():
+    tools, _ = _make_gui_tools()
+    tools.progressbar = mock.MagicMock()
+    tools.progressbar.rings = [mock.MagicMock(), mock.MagicMock()]
+    tools.progress = _fake_progress()
+    tools._describe_active_hook = lambda: "my_hook"
+
+    tools._omnygui_update_progress()
+
+    text = tools.progressbar.set_center_label.call_args[0][0]
+    assert "Hook:  my_hook" in text
+
+
 def test_omnygui_show_omnycam_samplestage_uses_current_image_widget_api():
     tools, client = _make_gui_tools()
     client.gui.windows = {"omny": mock.MagicMock()}
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 2bda299d..92ec7928 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -15,6 +15,7 @@ exists in OMNY's own add_sample_database()).
 """
 
 import builtins
+import datetime
 import types
 
 import pytest
@@ -64,18 +65,27 @@ def make_omny_for_tomo_scan(monkeypatch, tomo_angle_stepsize: float, active_acco
     obj._progress_proxy = _ProgressProxy(obj.client)
     obj.tomo_type = 1
     obj.tomo_angle_stepsize = tomo_angle_stepsize
+    obj.tomo_countingtime = 0.1
+    obj.tomo_id = 0
     obj.special_angles = []
     obj._current_special_angles = []
+    obj._at_each_angle_hooks = {}  # normally set by _init_tomo_queue()
     obj.write_pdf_report = lambda: None
     obj.sub_tomo_scan = lambda subtomo_number, n_subtomos=2, start_angle=None: None
     obj.omnygui_show_progress = lambda: None
-    monkeypatch.setitem(
-        builtins.__dict__,
-        "bec",
-        types.SimpleNamespace(
-            active_account=active_account, queue=types.SimpleNamespace(next_scan_number=1)
-        ),
+    obj.OMNYTools = types.SimpleNamespace(printgreenbold=lambda msg: None)
+
+    # write_to_scilog() reads the module-level `bec` (captured at import
+    # time), not builtins["bec"] -- both must point at the same fake so
+    # scilog._enabled resolves to False (no scilog configured) rather than
+    # AttributeError-ing on a stale/missing bec.messaging.
+    fake_bec = types.SimpleNamespace(
+        active_account=active_account,
+        queue=types.SimpleNamespace(next_scan_number=1),
+        messaging=types.SimpleNamespace(scilog=types.SimpleNamespace(_enabled=False)),
     )
+    monkeypatch.setitem(builtins.__dict__, "bec", fake_bec)
+    monkeypatch.setattr(omny_module, "bec", fake_bec, raising=False)
     monkeypatch.setitem(builtins.__dict__, "scans", _FakeScans())
     return obj
 
@@ -195,6 +205,74 @@ def test_tomo_scan_sets_timing_fields_on_new_scan(monkeypatch):
     assert omny.progress["accumulated_idle_time"] == 0.0
 
 
+# --- idle-time tracking + end-of-scan measurement-time summary --------------
+#
+# Mirrors flomni's identical _tomo_scan_at_angle() heartbeat-gap heuristic
+# and tomo_scan()'s end-of-scan timing summary -- omny previously tracked
+# neither (heartbeat was only ever cleared to None, never refreshed during
+# a running scan, so accumulated_idle_time stayed 0 forever and no summary
+# was ever printed).
+
+
+def test_tomo_scan_at_angle_tracks_idle_time_from_heartbeat_gap(monkeypatch, capsys):
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.tomo_countingtime = 0.1  # normal_cadence = max(60, 0.5) = 60s
+    old_heartbeat = datetime.datetime.now() - datetime.timedelta(seconds=200)
+    omny.progress["heartbeat"] = old_heartbeat.isoformat()
+    omny.progress["accumulated_idle_time"] = 0.0
+    omny._print_progress = lambda: None
+    omny.special_angles = []
+    omny._current_special_angles = []
+    omny._start_beam_check = lambda: None
+    omny._was_beam_okay = lambda: True
+    omny._at_each_angle = lambda angle: None
+    omny._write_tomo_scan_number = lambda *a: None
+
+    omny._tomo_scan_at_angle(10.0, 1)
+
+    idle = omny.progress["accumulated_idle_time"]
+    assert idle > 100  # ~200s gap - 60s normal cadence
+    assert "Detected a" in capsys.readouterr().out
+    # heartbeat refreshed to "now" so the busy-detector sees a running scan
+    assert omny.progress["heartbeat"] != old_heartbeat.isoformat()
+
+
+def test_tomo_scan_at_angle_no_idle_time_within_normal_cadence(monkeypatch, capsys):
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.tomo_countingtime = 0.1
+    recent_heartbeat = datetime.datetime.now() - datetime.timedelta(seconds=5)
+    omny.progress["heartbeat"] = recent_heartbeat.isoformat()
+    omny.progress["accumulated_idle_time"] = 0.0
+    omny._print_progress = lambda: None
+    omny.special_angles = []
+    omny._current_special_angles = []
+    omny._start_beam_check = lambda: None
+    omny._was_beam_okay = lambda: True
+    omny._at_each_angle = lambda angle: None
+    omny._write_tomo_scan_number = lambda *a: None
+
+    omny._tomo_scan_at_angle(10.0, 1)
+
+    assert omny.progress["accumulated_idle_time"] == 0.0
+    assert "Detected a" not in capsys.readouterr().out
+
+
+def test_tomo_scan_prints_measurement_time_summary(monkeypatch, capsys):
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+
+    def _fake_sub_tomo_scan(subtomo_number, n_subtomos=2, start_angle=None):
+        omny.progress["accumulated_idle_time"] = 10.0
+
+    omny.sub_tomo_scan = _fake_sub_tomo_scan
+
+    omny.tomo_scan()
+
+    out = capsys.readouterr().out
+    assert "Total measurement time:" in out
+    assert "Total measurement time excluding detected gaps:" in out
+    assert "Total measurement time lost to detected gaps:" in out
+
+
 # --- write_to_scilog(): checks scilog._enabled before attempting a send -----
 #
 # The old bec.logbook/client.logbook.send_logbook_message() API had no such

From 68801cd901f633568ffb2a6a6309a50e4c618a95 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 02:52:49 +0200
Subject: [PATCH 031/102] fix(omny): stop re-raising the progress window on
 every projection

Mirko, on macOS: the progress window "seems to close and recreate each
update, which is highly annoying" -- caused by _tomo_scan_at_angle()
calling self.omnygui_show_progress() (the full show-window-and-raise-to-
front routine) once per angle, on top of _print_progress(). flomni's own
_tomo_scan_at_angle() never does this: it only ever calls _print_progress(),
which calls self._flomnigui_update_progress() (values/text only) at its own
end -- the window is shown/raised exactly once, by tomo_scan()'s
unconditional call at scan start.

Mirrored that structure: _print_progress() now calls
self._omnygui_update_progress() itself, and the redundant per-angle
omnygui_show_progress() call was removed from _tomo_scan_at_angle().

1 new regression test. Full suite: 732 passed.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 17 +++++++++---
 .../bec_ipython_client/plugins/omny/omny.py   | 11 +++++++-
 .../test_omny_tomo_scan.py                    | 27 +++++++++++++++++++
 3 files changed, 51 insertions(+), 4 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 4e69ef53..d210c3ba 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -190,14 +190,25 @@ data (`self.progress`, global-var-backed since Phase 1):
 flomni-only. `_describe_active_hook()`/`_active_hook_source()` needed no porting: already provided
 by `TomoQueueMixin` since Phase 1.
 
+**Follow-up bug found while porting this**: Mirko reported that on macOS, the progress window
+appeared to close and reopen on every single projection during a scan -- "highly annoying".
+`_tomo_scan_at_angle()` was calling `self.omnygui_show_progress()` (the full show-window-and-raise-
+to-front routine) once per angle, not just `_print_progress()`/`_omnygui_update_progress()` (values
+and text only). flomni's own `_tomo_scan_at_angle()` never re-raises the window per angle either --
+it only ever calls `_print_progress()`, which internally calls `_flomnigui_update_progress()` at
+its own end. Fixed by mirroring that structure exactly: `_print_progress()` now calls
+`self._omnygui_update_progress()` itself, and the separate per-angle `omnygui_show_progress()` call
+was removed from `_tomo_scan_at_angle()` -- the window is still shown/raised exactly once, by
+`tomo_scan()`'s own unconditional call at scan start.
+
 **Not ported**: flomni's separate `_log_tomogram_timing()`/persistent timing-statistics-log
 subsystem (writes a JSON record per tomogram to `~/data/raw/logs/timing_statistics`, backing
 `scilog_last_ptycho_scans()`/a timing overview command) -- Mirko asked specifically about the
 *printed* summary and the ring count, not this larger, separate logging feature. Flag if wanted.
 
-Test coverage: 9 new tests (`test_omny_tomo_scan.py`: idle-time-from-gap, no-idle-time-within-
-cadence, end-of-scan summary lines; `test_omny_gui_tools.py`: three-ring creation, center-label
-text with/without an active hook). Full suite: 731 passed.
+Test coverage: 10 new tests (`test_omny_tomo_scan.py`: idle-time-from-gap, no-idle-time-within-
+cadence, end-of-scan summary lines, window not re-raised per angle; `test_omny_gui_tools.py`:
+three-ring creation, center-label text with/without an active hook). Full suite: 732 passed.
 
 ## cam_xeye device (simulated only, real hardware config still needed)
 
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 7fdc04ba..fbc4f402 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1256,8 +1256,16 @@ class OMNY(
                     )
             self.progress["heartbeat"] = now.isoformat()
             print(f"Starting OMNY scan for angle {angle} in subtomo {subtomo_number}")
+            # _print_progress() refreshes the progress GUI itself (via
+            # _omnygui_update_progress()) -- do NOT also call
+            # omnygui_show_progress() here: that re-raises the window to
+            # front on every single projection (confirmed live: on macOS
+            # this looks like the window closing and reopening every
+            # update), not just updates its values/text. tomo_scan()'s own
+            # unconditional call at scan start already shows/raises it
+            # once. Mirrors flomni's _tomo_scan_at_angle(), which likewise
+            # only ever calls _print_progress() per angle.
             self._print_progress()
-            self.omnygui_show_progress()
             while not successful:
                 self._start_beam_check()
                 if not self.special_angles:
@@ -1613,6 +1621,7 @@ class OMNY(
         print(f"Total projections per subtomo: ... {self.progress['subtomo_total_projections']}")
         print(f"Estimated remaining time: ........ {eta_str}")
         print(f"Estimated finish time: ........... {finish_str}\x1b[0m")
+        self._omnygui_update_progress()
 
     def add_sample_database(
         self, samplename, date, eaccount, scan_number, setup, sample_additional_info, user
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 92ec7928..80a11719 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -214,6 +214,33 @@ def test_tomo_scan_sets_timing_fields_on_new_scan(monkeypatch):
 # was ever printed).
 
 
+def test_tomo_scan_at_angle_updates_progress_without_reraising_window(monkeypatch):
+    """_tomo_scan_at_angle() must only refresh the progress GUI's values/text
+    (via _print_progress() -> _omnygui_update_progress()), never call
+    omnygui_show_progress() again per angle -- that re-raises the window to
+    front on every single projection (confirmed live: on macOS this looks
+    like the window closing and reopening on every update). tomo_scan()'s
+    own unconditional call at scan start already shows/raises it once,
+    matching flomni's _tomo_scan_at_angle(), which likewise only ever calls
+    _print_progress() per angle."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    show_calls = []
+    update_calls = []
+    omny.omnygui_show_progress = lambda: show_calls.append(1)
+    omny._omnygui_update_progress = lambda: update_calls.append(1)
+    omny.special_angles = []
+    omny._current_special_angles = []
+    omny._start_beam_check = lambda: None
+    omny._was_beam_okay = lambda: True
+    omny._at_each_angle = lambda angle: None
+    omny._write_tomo_scan_number = lambda *a: None
+
+    omny._tomo_scan_at_angle(10.0, 1)
+
+    assert show_calls == []
+    assert update_calls == [1]
+
+
 def test_tomo_scan_at_angle_tracks_idle_time_from_heartbeat_gap(monkeypatch, capsys):
     omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
     omny.tomo_countingtime = 0.1  # normal_cadence = max(60, 0.5) = 60s

From 127b35565be6f68ed5b39a4f34867b989bf397bb Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 03:17:08 +0200
Subject: [PATCH 032/102] feat(omny): add real EPICS owner + measured-status
 channel for sample storage
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Gives OMNY sample storage a dedicated owner + measured-status channel
(paired with the new SAMPLE_DB IOC record in OMNY/OMNY.git, one per sample
position: VAL=status enum none/started/completed, DESC=owner), replacing
the pack_desc/DESC-packing hack the widget briefly used for OMNY owner
support. FlOMNI is untouched this pass -- deferred.

- OMNYSampleStorage: new sample_status/sample_owners Dcpt/Cpt groups;
  set_sample_slot/set_sample_in_gripper/set_sample_in_samplestage take an
  owner param and reset status on every place/rename/clear; new
  set_sample_status/get_sample_status/get_sample_owner/
  get_sample_name_and_owner (+ gripper/stage equivalents); show_all()/
  help() updated.
- SimOMNYSampleStorage: seeding clears the new owner/status signals too.
- omny_sample_transfer_mixin.py: otransfer_* wrappers for all the new
  methods, existing set_sample_slot/set_sample_in_gripper/
  set_sample_in_samplestage wrappers pass owner through.
- sample_storage.py widget: OMNY cells read/write owner+status via the new
  signals instead of packing; the "✓ measured"/"◐ started" badge now works
  for OMNY too, plus a manual "Set measured status…" context-menu action.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../omny/omny_sample_transfer_mixin.py        |  42 ++-
 .../widgets/sample_storage/sample_storage.py  | 170 ++++++++---
 csaxs_bec/devices/omny/omny_sample_storage.py | 270 +++++++++++++++++-
 csaxs_bec/devices/sim/sim_omny.py             |  32 ++-
 4 files changed, 457 insertions(+), 57 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 2c00948f..05ac44fc 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1077,20 +1077,20 @@ class OMNYSampleTransferMixin:
     def otransfer_is_sample_in_gripper(self) -> bool:
         return dev.omny_samples.is_sample_in_gripper()
 
-    def otransfer_set_sample_slot(self, container: str, slot_nr: int, name: str) -> bool:
-        return dev.omny_samples.set_sample_slot(container, slot_nr, name)
+    def otransfer_set_sample_slot(self, container: str, slot_nr: int, name: str, owner: str = "") -> bool:
+        return dev.omny_samples.set_sample_slot(container, slot_nr, name, owner)
 
     def otransfer_unset_sample_slot(self, container: str, slot_nr: int) -> bool:
         return dev.omny_samples.unset_sample_slot(container, slot_nr)
 
-    def otransfer_set_sample_in_gripper(self, name: str) -> bool:
-        return dev.omny_samples.set_sample_in_gripper(name)
+    def otransfer_set_sample_in_gripper(self, name: str, owner: str = "") -> bool:
+        return dev.omny_samples.set_sample_in_gripper(name, owner)
 
     def otransfer_unset_sample_in_gripper(self) -> bool:
         return dev.omny_samples.unset_sample_in_gripper()
 
-    def otransfer_set_sample_in_samplestage(self, name: str) -> bool:
-        return dev.omny_samples.set_sample_in_samplestage(name)
+    def otransfer_set_sample_in_samplestage(self, name: str, owner: str = "") -> bool:
+        return dev.omny_samples.set_sample_in_samplestage(name, owner)
 
     def otransfer_unset_sample_in_samplestage(self) -> bool:
         return dev.omny_samples.unset_sample_in_samplestage()
@@ -1122,6 +1122,36 @@ class OMNYSampleTransferMixin:
     def otransfer_search_shuttle_in_slot(self, shuttle: str) -> int:
         return dev.omny_samples.search_shuttle_in_slot(shuttle)
 
+    def otransfer_get_sample_owner(self, container: str, slot_nr: int) -> str:
+        return dev.omny_samples.get_sample_owner(container, slot_nr)
+
+    def otransfer_get_sample_name_and_owner(self, container: str, slot_nr: int) -> tuple:
+        return dev.omny_samples.get_sample_name_and_owner(container, slot_nr)
+
+    def otransfer_set_sample_status(self, container: str, slot_nr: int, status: str) -> bool:
+        return dev.omny_samples.set_sample_status(container, slot_nr, status)
+
+    def otransfer_get_sample_status(self, container: str, slot_nr: int) -> str:
+        return dev.omny_samples.get_sample_status(container, slot_nr)
+
+    def otransfer_get_sample_owner_in_gripper(self) -> str:
+        return dev.omny_samples.get_sample_owner_in_gripper()
+
+    def otransfer_get_sample_owner_in_samplestage(self) -> str:
+        return dev.omny_samples.get_sample_owner_in_samplestage()
+
+    def otransfer_set_sample_status_in_gripper(self, status: str) -> bool:
+        return dev.omny_samples.set_sample_status_in_gripper(status)
+
+    def otransfer_get_sample_status_in_gripper(self) -> str:
+        return dev.omny_samples.get_sample_status_in_gripper()
+
+    def otransfer_set_sample_status_in_samplestage(self, status: str) -> bool:
+        return dev.omny_samples.set_sample_status_in_samplestage(status)
+
+    def otransfer_get_sample_status_in_samplestage(self) -> str:
+        return dev.omny_samples.get_sample_status_in_samplestage()
+
     # def _otransfer_modify_sample(_ocontainer, _oposition, _ostatus, _oname):
     #   #_ocontainer is A, B, C for the pin containers
     #   #it can also be FZP, OSA and omny
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 8b4bc0b1..e6120e13 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -9,13 +9,13 @@ different setups, detected at construction time (see ``SETUP_PROFILES``,
 ``_detect_setup()``) — a BEC session is always exactly one setup, never
 both at once:
 
-Both setups require every sample slot to carry a name *and* an owner,
-packed into one EPICS DESC field (see ``sample_desc_codec``) since neither
-backend has a separate owner PV.
+Both setups require every sample slot to carry a name *and* an owner, but
+via different backend mechanisms:
 
 FlOMNI (``dev.flomni_samples``)
     A flat magazine: slots 1-20, the sample stage (slot 0) and the gripper
-    (slot 100).
+    (slot 100). Name and owner are packed into one EPICS DESC field (see
+    ``sample_desc_codec``) since this backend has no separate owner PV.
 
 OMNY (``dev.omny_samples``)
     A richer structure: three shuttles (A/B/C) of 6 slots each, a sparse
@@ -23,9 +23,13 @@ OMNY (``dev.omny_samples``)
     separate sample stage and gripper, and a 6-slot "parking" carousel
     recording which shuttle letter is docked at each physical parking
     position (parking slots are a shuttle-letter assignment, not a sample,
-    so they carry no name/owner). Whichever shuttle's parking slot matches
-    the ``oparkz`` motor's current readback is "active", i.e. at the
-    transfer-ready position (see ``oparkz_active_parking_slot()``).
+    so they carry no name/owner/status). Unlike FlOMNI, OMNY has a
+    dedicated owner channel (and a measured-status channel -- see
+    ``OMNY_SampleStorage.STATUS_NONE``/``STATUS_STARTED``/
+    ``STATUS_COMPLETED``) next to each sample slot's existing placed/name
+    channels, so no packing is needed there. Whichever shuttle's parking
+    slot matches the ``oparkz`` motor's current readback is "active", i.e.
+    at the transfer-ready position (see ``oparkz_active_parking_slot()``).
 
 A LamNI session has neither device; the widget shows a "no known setup
 detected" message in that case.
@@ -127,6 +131,14 @@ OMNY_PARKING_SLOTS = tuple(range(1, 7))
 # slots (which use EMPTY_NAME = "-"), parking slots are cleared to "none".
 PARKING_EMPTY_SENTINEL = "none"
 
+# Mirrors OMNYSampleStorage.STATUS_NONE/STATUS_STARTED/STATUS_COMPLETED's
+# int<->str mapping, duplicated locally rather than reaching into that
+# class's own (private) _status_str_to_val()/_status_val_to_str()
+# classmethods -- this widget already duplicates other device-side
+# conventions the same way (see EMPTY_NAME/PARKING_EMPTY_SENTINEL above).
+OMNY_STATUS_OPTIONS = ("none", "started", "completed")
+OMNY_STATUS_STR_TO_VAL = {"none": 0, "started": 1, "completed": 2}
+
 # colours
 # An occupied slot's name label intentionally has no fixed foreground colour
 # here (see _SlotCell.set_state()) -- it was previously hardcoded to
@@ -388,10 +400,17 @@ class _SlotCell(QFrame):
         menu = QMenu(self)
         if self._occupied:
             act_rename = menu.addAction("Change name…")
+            # OMNY-only (tuple key): measured status has a real EPICS
+            # channel there (see OMNY_SampleStorage), unlike FlOMNI's
+            # scan-lifecycle-driven redis log, which isn't manually
+            # editable from here.
+            act_status = menu.addAction("Set measured status…") if isinstance(self._slot, tuple) else None
             act_clear = menu.addAction("Clear (set empty)")
             chosen = menu.exec_(self.mapToGlobal(pos))
             if chosen == act_rename:
                 self._owner.action_change_name(self._slot, self._name, self._sample_owner)
+            elif act_status is not None and chosen == act_status:
+                self._owner.action_set_status(self._slot)
             elif chosen == act_clear:
                 self._owner.action_clear(self._slot)
         else:
@@ -620,10 +639,11 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         """Parse a dev.omny_samples.read(cached=True) dict into
         {key: (occupied, name, owner, measured_status)} for every
         sample-kind slot -- stage, gripper, the 10 fixed O positions, and
-        the 18 shuttle slots. Like FlOMNI, OMNY has no separate owner PV, so
-        the name+owner pair is packed into the one raw name field (see
-        ``sample_desc_codec``); measured_status is always None -- OMNY has
-        no measured-sample-log equivalent (see module docstring).
+        the 18 shuttle slots. Owner and measured status each have their own
+        dedicated OMNYSampleStorage signal (added alongside the existing
+        placed/name signals -- see that class's ``STATUS_NONE``/
+        ``STATUS_STARTED``/``STATUS_COMPLETED``), unlike FlOMNI which packs
+        name+owner into one field via ``sample_desc_codec``.
         """
 
         def _val(key, default=None):
@@ -632,32 +652,43 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 return entry.get("value", default)
             return default
 
-        def _name_owner(raw):
-            name, owner = unpack_desc(raw if raw else EMPTY_NAME)
-            return (name if name else EMPTY_NAME), owner
+        def _status_str(raw) -> Optional[str]:
+            # mirrors OMNYSampleStorage._status_val_to_str(), without a live
+            # device round-trip: this widget only has the bulk-read dict.
+            try:
+                val = int(round(float(raw)))
+            except (TypeError, ValueError):
+                return None
+            return {1: "started", 2: "completed"}.get(val)  # 0 ("none") -> None: no badge
 
         state: dict[tuple, tuple[bool, str, str, Optional[str]]] = {}
 
         used = bool(_val("omny_samples_sample_in_samplestage", 0))
-        name, owner = _name_owner(_val("omny_samples_sample_in_samplestage_name", EMPTY_NAME))
-        state[("stage",)] = (used, name, owner, None)
+        name = _val("omny_samples_sample_in_samplestage_name", EMPTY_NAME) or EMPTY_NAME
+        owner = _val("omny_samples_sample_in_samplestage_owner", "") or ""
+        status = _status_str(_val("omny_samples_sample_in_samplestage_status", 0))
+        state[("stage",)] = (used, name, owner, status)
 
         used = bool(_val("omny_samples_sample_in_gripper", 0))
-        name, owner = _name_owner(_val("omny_samples_sample_in_gripper_name", EMPTY_NAME))
-        state[("gripper",)] = (used, name, owner, None)
+        name = _val("omny_samples_sample_in_gripper_name", EMPTY_NAME) or EMPTY_NAME
+        owner = _val("omny_samples_sample_in_gripper_owner", "") or ""
+        status = _status_str(_val("omny_samples_sample_in_gripper_status", 0))
+        state[("gripper",)] = (used, name, owner, status)
 
         for n in OMNY_FIXED_POSITIONS:
             used = bool(_val(f"omny_samples_sample_placed_sample{n}", 0))
-            name, owner = _name_owner(_val(f"omny_samples_sample_names_sample{n}", EMPTY_NAME))
-            state[("O", n)] = (used, name, owner, None)
+            name = _val(f"omny_samples_sample_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
+            owner = _val(f"omny_samples_sample_owners_sample{n}", "") or ""
+            status = _status_str(_val(f"omny_samples_sample_status_sample{n}", 0))
+            state[("O", n)] = (used, name, owner, status)
 
         for letter in OMNY_SHUTTLE_LETTERS:
             for n in OMNY_SHUTTLE_SLOTS:
                 used = bool(_val(f"omny_samples_sample_shuttle_{letter}_placed_sample{n}", 0))
-                name, owner = _name_owner(
-                    _val(f"omny_samples_sample_shuttle_{letter}_names_sample{n}", EMPTY_NAME)
-                )
-                state[("shuttle", letter, n)] = (used, name, owner, None)
+                name = _val(f"omny_samples_sample_shuttle_{letter}_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
+                owner = _val(f"omny_samples_sample_shuttle_{letter}_owners_sample{n}", "") or ""
+                status = _status_str(_val(f"omny_samples_sample_shuttle_{letter}_status_sample{n}", 0))
+                state[("shuttle", letter, n)] = (used, name, owner, status)
 
         return state
 
@@ -796,29 +827,41 @@ class OMNY_SampleStorage(BECWidget, QWidget):
     def _write_slot_omny(self, key: tuple, used: int, name: str, owner: str = "") -> bool:
         """Write (used, name, owner) to an OMNY sample-kind slot -- stage,
         gripper, a fixed O position, or a shuttle slot -- mirroring the
-        direct-signal style of ``_write_slot()``, including packing
-        name+owner into the one raw name field the same way (see
-        ``sample_desc_codec``). No measured-sample-log integration exists
-        for OMNY (see module docstring), so unlike ``_write_slot`` this
-        never offers to print a P-touch label for the previous occupant.
+        direct-signal style of ``_write_slot()``. Unlike FlOMNI, OMNY has a
+        dedicated owner signal (added alongside placed/name -- see
+        ``OMNYSampleStorage``), so name and owner are written separately,
+        no packing needed. Measured status is reset to "none" on every
+        write here, mirroring ``OMNYSampleStorage.set_sample_slot()``'s/
+        ``unset_sample_slot()``'s own behavior -- a fresh name (even a
+        rename) or a cleared slot isn't mid-measurement. No P-touch
+        label-printing offer for the previous occupant (FlOMNI-only, see
+        module docstring).
         """
         try:
-            packed_name = pack_desc(name, owner)
+            status_none = self._samples.STATUS_NONE
             kind = key[0]
             if kind == "stage":
                 self._samples.sample_in_samplestage.set(used)
-                self._samples.sample_in_samplestage_name.set(packed_name)
+                self._samples.sample_in_samplestage_name.set(name)
+                self._samples.sample_in_samplestage_owner.set(owner)
+                self._samples.sample_in_samplestage_status.set(status_none)
             elif kind == "gripper":
                 self._samples.sample_in_gripper.set(used)
-                self._samples.sample_in_gripper_name.set(packed_name)
+                self._samples.sample_in_gripper_name.set(name)
+                self._samples.sample_in_gripper_owner.set(owner)
+                self._samples.sample_in_gripper_status.set(status_none)
             elif kind == "O":
                 _, n = key
                 getattr(self._samples.sample_placed, f"sample{n}").set(used)
-                getattr(self._samples.sample_names, f"sample{n}").set(packed_name)
+                getattr(self._samples.sample_names, f"sample{n}").set(name)
+                getattr(self._samples.sample_owners, f"sample{n}").set(owner)
+                getattr(self._samples.sample_status, f"sample{n}").set(status_none)
             elif kind == "shuttle":
                 _, letter, n = key
                 getattr(getattr(self._samples, f"sample_shuttle_{letter}_placed"), f"sample{n}").set(used)
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_names"), f"sample{n}").set(packed_name)
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_names"), f"sample{n}").set(name)
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_owners"), f"sample{n}").set(owner)
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_status"), f"sample{n}").set(status_none)
             else:
                 raise ValueError(f"unknown OMNY slot key {key!r}")
             self._last_state.pop(key, None)
@@ -832,6 +875,39 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             )
             return False
 
+    def _write_status_omny(self, key: tuple, status: str) -> bool:
+        """Write just the measured-status signal for an OMNY sample-kind
+        slot, leaving used/name/owner untouched -- the counterpart to
+        ``_write_slot_omny()`` resetting status on every name/owner write,
+        for the manual "Set measured status…" action (see
+        ``action_set_status``).
+        """
+        try:
+            val = OMNY_STATUS_STR_TO_VAL[status]
+            kind = key[0]
+            if kind == "stage":
+                self._samples.sample_in_samplestage_status.set(val)
+            elif kind == "gripper":
+                self._samples.sample_in_gripper_status.set(val)
+            elif kind == "O":
+                _, n = key
+                getattr(self._samples.sample_status, f"sample{n}").set(val)
+            elif kind == "shuttle":
+                _, letter, n = key
+                getattr(getattr(self._samples, f"sample_shuttle_{letter}_status"), f"sample{n}").set(val)
+            else:
+                raise ValueError(f"unknown OMNY slot key {key!r}")
+            self._last_state.pop(key, None)
+            return True
+        except Exception as exc:
+            logger.warning(f"OMNY_SampleStorage: write of status for slot {key} failed: {exc}")
+            QMessageBox.critical(
+                self,
+                "Write failed",
+                f"Could not write status for slot {self._slot_title(key)} to the device:\n{exc}",
+            )
+            return False
+
     def _write_parking_omny(self, slot_nr: int, letter: Optional[str]) -> bool:
         """Assign (or clear) which shuttle letter is recorded as parked at
         OMNY parking slot `slot_nr` (1-6), mirroring
@@ -1186,6 +1262,32 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if self._write_sample(slot, 0, EMPTY_NAME):
             self.refresh()
 
+    def action_set_status(self, slot: tuple) -> None:
+        """Manually set an OMNY sample-kind slot's measured status. OMNY
+        only (tuple key) -- see ``_SlotCell._show_menu``. FlOMNI's status
+        stays a separate, scan-lifecycle-driven redis log (see module
+        docstring), not exposed for manual editing here.
+        """
+        if not isinstance(slot, tuple):
+            return
+        current = self._last_state.get(slot, (False, "", "", None))[3] or "none"
+        try:
+            current_index = OMNY_STATUS_OPTIONS.index(current)
+        except ValueError:
+            current_index = 0
+        status, ok = QInputDialog.getItem(
+            self,
+            "Set measured status",
+            f"Status for slot {self._slot_title(slot)}:",
+            OMNY_STATUS_OPTIONS,
+            current_index,
+            False,
+        )
+        if not ok:
+            return
+        if self._write_status_omny(slot, status):
+            self.refresh()
+
     def action_set_parking(self, letter: str, current_slot: Optional[int]) -> None:
         """Assign OMNY shuttle `letter` to a parking slot (1-6), via
         ``_ShuttleStatusLabel``'s context menu. Overwrites that slot's
diff --git a/csaxs_bec/devices/omny/omny_sample_storage.py b/csaxs_bec/devices/omny/omny_sample_storage.py
index 4675176f..000cb19a 100644
--- a/csaxs_bec/devices/omny/omny_sample_storage.py
+++ b/csaxs_bec/devices/omny/omny_sample_storage.py
@@ -23,7 +23,17 @@ class OMNYSampleStorage(Device):
         "unset_sample_in_samplestage",
         "get_sample_name_in_samplestage",
         "get_sample_name_in_gripper",
+        "get_sample_owner_in_samplestage",
+        "get_sample_owner_in_gripper",
+        "set_sample_status_in_samplestage",
+        "get_sample_status_in_samplestage",
+        "set_sample_status_in_gripper",
+        "get_sample_status_in_gripper",
         "get_sample_name",
+        "get_sample_owner",
+        "get_sample_name_and_owner",
+        "set_sample_status",
+        "get_sample_status",
         "is_sample_in_samplestage",
         "set_shuttle_slot",
         "unset_shuttle_slot",
@@ -36,6 +46,18 @@ class OMNYSampleStorage(Device):
     SUB_VALUE = "value"
     _default_sub = SUB_VALUE
 
+    # Measured status, one of these three -- an "ai" record's VAL (see
+    # omny_samples_status.template in the OMNY/OMNY.git IOC repo), not a
+    # proper EPICS enum: this IOC's sample DB uses plain "ai" records
+    # uniformly even for boolean-ish fields (see the placed-flag records),
+    # so the new STATUS record follows the same convention rather than
+    # introducing an mbbo/mbbi record type used nowhere else here. The
+    # int<->str mapping lives entirely in this class.
+    STATUS_NONE = 0
+    STATUS_STARTED = 1
+    STATUS_COMPLETED = 2
+    _STATUS_LABELS = {STATUS_NONE: "none", STATUS_STARTED: "started", STATUS_COMPLETED: "completed"}
+
     sample_shuttle_A_placed = {
         f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}", {"auto_monitor": True}) for i in range(1, 7)
     }
@@ -97,6 +119,75 @@ class OMNYSampleStorage(Device):
     }
     sample_names = Dcpt(sample_names)
 
+    # Measured status (VAL) + owner (DESC) -- one new record per sample
+    # position, added alongside the existing placed/name records (see
+    # STATUS_NONE/STARTED/COMPLETED above and omny_samples_status.template
+    # in OMNY/OMNY.git). Parking slots have no equivalent -- they hold a
+    # shuttle letter, not a sample.
+    sample_shuttle_A_status = {
+        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}:STATUS", {"auto_monitor": True})
+        for i in range(1, 7)
+    }
+    sample_shuttle_A_status = Dcpt(sample_shuttle_A_status)
+
+    sample_shuttle_B_status = {
+        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_B:{i}:STATUS", {"auto_monitor": True})
+        for i in range(1, 7)
+    }
+    sample_shuttle_B_status = Dcpt(sample_shuttle_B_status)
+
+    sample_shuttle_C_status = {
+        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_C:{i}:STATUS", {"auto_monitor": True})
+        for i in range(1, 7)
+    }
+    sample_shuttle_C_status = Dcpt(sample_shuttle_C_status)
+
+    sample_status = {
+        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_omny:{i}:STATUS", {"auto_monitor": True})
+        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]
+    }
+    sample_status = Dcpt(sample_status)
+
+    sample_shuttle_A_owners = {
+        f"sample{i}": (
+            EpicsSignal,
+            f"XOMNY-SAMPLE_DB_shuttle_A:{i}:STATUS.DESC",
+            {"string": True, "auto_monitor": True},
+        )
+        for i in range(1, 7)
+    }
+    sample_shuttle_A_owners = Dcpt(sample_shuttle_A_owners)
+
+    sample_shuttle_B_owners = {
+        f"sample{i}": (
+            EpicsSignal,
+            f"XOMNY-SAMPLE_DB_shuttle_B:{i}:STATUS.DESC",
+            {"string": True, "auto_monitor": True},
+        )
+        for i in range(1, 7)
+    }
+    sample_shuttle_B_owners = Dcpt(sample_shuttle_B_owners)
+
+    sample_shuttle_C_owners = {
+        f"sample{i}": (
+            EpicsSignal,
+            f"XOMNY-SAMPLE_DB_shuttle_C:{i}:STATUS.DESC",
+            {"string": True, "auto_monitor": True},
+        )
+        for i in range(1, 7)
+    }
+    sample_shuttle_C_owners = Dcpt(sample_shuttle_C_owners)
+
+    sample_owners = {
+        f"sample{i}": (
+            EpicsSignal,
+            f"XOMNY-SAMPLE_DB_omny:{i}:STATUS.DESC",
+            {"string": True, "auto_monitor": True},
+        )
+        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]
+    }
+    sample_owners = Dcpt(sample_owners)
+
     sample_in_gripper = Cpt(
         EpicsSignal, name="sample_in_gripper", read_pv="XOMNY-SAMPLE_DB_omny:110.VAL", auto_monitor=True
     )
@@ -119,6 +210,28 @@ class OMNYSampleStorage(Device):
         auto_monitor=True
     )
 
+    sample_in_gripper_status = Cpt(
+        EpicsSignal, name="sample_in_gripper_status", read_pv="XOMNY-SAMPLE_DB_omny:110:STATUS", auto_monitor=True
+    )
+    sample_in_gripper_owner = Cpt(
+        EpicsSignal,
+        name="sample_in_gripper_owner",
+        read_pv="XOMNY-SAMPLE_DB_omny:110:STATUS.DESC",
+        string=True,
+        auto_monitor=True,
+    )
+
+    sample_in_samplestage_status = Cpt(
+        EpicsSignal, name="sample_in_samplestage_status", read_pv="XOMNY-SAMPLE_DB_omny:0:STATUS", auto_monitor=True
+    )
+    sample_in_samplestage_owner = Cpt(
+        EpicsSignal,
+        name="sample_in_samplestage_owner",
+        read_pv="XOMNY-SAMPLE_DB_omny:0:STATUS.DESC",
+        string=True,
+        auto_monitor=True,
+    )
+
     def __init__(self, prefix="", *, name, **kwargs):
         super().__init__(prefix, name=name, **kwargs)
         self.sample_shuttle_A_placed.sample1.subscribe(self._emit_value)
@@ -128,41 +241,114 @@ class OMNYSampleStorage(Device):
         self.wait_for_connection()
         self._run_subs(sub_type=self.SUB_VALUE, timestamp=timestamp, obj=self)
 
-    def set_sample_slot(self, container: str, slot_nr: int, name: str) -> bool:
+    @classmethod
+    def _status_str_to_val(cls, status: str) -> int:
+        status = (status or "none").strip().lower()
+        for val, label in cls._STATUS_LABELS.items():
+            if label == status:
+                return val
+        raise OMNYSampleStorageError(
+            f"Invalid status {status!r}; expected one of {sorted(cls._STATUS_LABELS.values())}."
+        )
+
+    @classmethod
+    def _status_val_to_str(cls, val) -> str:
+        try:
+            return cls._STATUS_LABELS.get(int(round(float(val))), "none")
+        except (TypeError, ValueError):
+            return "none"
+
+    def set_sample_slot(self, container: str, slot_nr: int, name: str, owner: str = "") -> bool:
         if slot_nr > 20:
             raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
 
+        status = self._status_str_to_val("none")
         if container == "A":
             getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").set(1)
             getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").set(name)
+            getattr(self.sample_shuttle_A_owners, f"sample{slot_nr}").set(owner)
+            getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(status)
         elif container == "B":
             getattr(self.sample_shuttle_B_placed, f"sample{slot_nr}").set(1)
             getattr(self.sample_shuttle_B_names, f"sample{slot_nr}").set(name)
+            getattr(self.sample_shuttle_B_owners, f"sample{slot_nr}").set(owner)
+            getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").set(status)
         elif container == "C":
             getattr(self.sample_shuttle_C_placed, f"sample{slot_nr}").set(1)
             getattr(self.sample_shuttle_C_names, f"sample{slot_nr}").set(name)
+            getattr(self.sample_shuttle_C_owners, f"sample{slot_nr}").set(owner)
+            getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").set(status)
         elif container == "O":
             getattr(self.sample_placed, f"sample{slot_nr}").set(1)
             getattr(self.sample_names, f"sample{slot_nr}").set(name)
-
+            getattr(self.sample_owners, f"sample{slot_nr}").set(owner)
+            getattr(self.sample_status, f"sample{slot_nr}").set(status)
 
     def unset_sample_slot(self, container: str, slot_nr: int) -> bool:
         if slot_nr > 20:
             raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
 
+        status = self._status_str_to_val("none")
         if container == "A":
             getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").set(0)
             getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").set("-")
+            getattr(self.sample_shuttle_A_owners, f"sample{slot_nr}").set("")
+            getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(status)
         elif container == "B":
             getattr(self.sample_shuttle_B_placed, f"sample{slot_nr}").set(0)
             getattr(self.sample_shuttle_B_names, f"sample{slot_nr}").set("-")
+            getattr(self.sample_shuttle_B_owners, f"sample{slot_nr}").set("")
+            getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").set(status)
         elif container == "C":
             getattr(self.sample_shuttle_C_placed, f"sample{slot_nr}").set(0)
             getattr(self.sample_shuttle_C_names, f"sample{slot_nr}").set("-")
+            getattr(self.sample_shuttle_C_owners, f"sample{slot_nr}").set("")
+            getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").set(status)
         elif container == "O":
             getattr(self.sample_placed, f"sample{slot_nr}").set(0)
             getattr(self.sample_names, f"sample{slot_nr}").set("-")
+            getattr(self.sample_owners, f"sample{slot_nr}").set("")
+            getattr(self.sample_status, f"sample{slot_nr}").set(status)
 
+    def set_sample_status(self, container: str, slot_nr: int, status: str) -> bool:
+        val = self._status_str_to_val(status)
+        if container == "A":
+            getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(val)
+        elif container == "B":
+            getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").set(val)
+        elif container == "C":
+            getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").set(val)
+        elif container == "O":
+            getattr(self.sample_status, f"sample{slot_nr}").set(val)
+
+    def get_sample_status(self, container: str, slot_nr: int) -> str:
+        if container == "A":
+            val = getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").get()
+        elif container == "B":
+            val = getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").get()
+        elif container == "C":
+            val = getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").get()
+        elif container == "O":
+            val = getattr(self.sample_status, f"sample{slot_nr}").get()
+        else:
+            return "none"
+        return self._status_val_to_str(val)
+
+    def get_sample_owner(self, container: str, slot_nr: int) -> str:
+        if container == "A":
+            val = getattr(self.sample_shuttle_A_owners, f"sample{slot_nr}").get()
+        elif container == "B":
+            val = getattr(self.sample_shuttle_B_owners, f"sample{slot_nr}").get()
+        elif container == "C":
+            val = getattr(self.sample_shuttle_C_owners, f"sample{slot_nr}").get()
+        elif container == "O":
+            val = getattr(self.sample_owners, f"sample{slot_nr}").get()
+        else:
+            return ""
+        return str(val) if val else ""
+
+    def get_sample_name_and_owner(self, container: str, slot_nr: int) -> tuple:
+        return self.get_sample_name(container, slot_nr), self.get_sample_owner(container, slot_nr)
 
     def set_shuttle_slot(self, container: str, slot_nr: int) -> bool:
         if slot_nr > 6:
@@ -176,21 +362,49 @@ class OMNYSampleStorage(Device):
         getattr(self.parking_placed, f"parking{slot_nr}").set(0)
         getattr(self.parking_names, f"parking{slot_nr}").set("none")
 
-    def set_sample_in_gripper(self, name: str) -> bool:
+    def set_sample_in_gripper(self, name: str, owner: str = "") -> bool:
         self.sample_in_gripper.set(1)
         self.sample_in_gripper_name.set(name)
+        self.sample_in_gripper_owner.set(owner)
+        self.sample_in_gripper_status.set(self._status_str_to_val("none"))
 
     def unset_sample_in_gripper(self) -> bool:
         self.sample_in_gripper.set(0)
         self.sample_in_gripper_name.set("-")
+        self.sample_in_gripper_owner.set("")
+        self.sample_in_gripper_status.set(self._status_str_to_val("none"))
 
-    def set_sample_in_samplestage(self, name: str) -> bool:
+    def set_sample_in_samplestage(self, name: str, owner: str = "") -> bool:
         self.sample_in_samplestage.set(1)
         self.sample_in_samplestage_name.set(name)
+        self.sample_in_samplestage_owner.set(owner)
+        self.sample_in_samplestage_status.set(self._status_str_to_val("none"))
 
     def unset_sample_in_samplestage(self) -> bool:
         self.sample_in_samplestage.set(0)
         self.sample_in_samplestage_name.set("-")
+        self.sample_in_samplestage_owner.set("")
+        self.sample_in_samplestage_status.set(self._status_str_to_val("none"))
+
+    def get_sample_owner_in_gripper(self) -> str:
+        val = self.sample_in_gripper_owner.get()
+        return str(val) if val else ""
+
+    def get_sample_owner_in_samplestage(self) -> str:
+        val = self.sample_in_samplestage_owner.get()
+        return str(val) if val else ""
+
+    def set_sample_status_in_gripper(self, status: str) -> bool:
+        self.sample_in_gripper_status.set(self._status_str_to_val(status))
+
+    def get_sample_status_in_gripper(self) -> str:
+        return self._status_val_to_str(self.sample_in_gripper_status.get())
+
+    def set_sample_status_in_samplestage(self, status: str) -> bool:
+        self.sample_in_samplestage_status.set(self._status_str_to_val(status))
+
+    def get_sample_status_in_samplestage(self) -> str:
+        return self._status_val_to_str(self.sample_in_samplestage_status.get())
 
     def is_sample_slot_used(self, container, slot_nr: int) -> bool:
         if container == "A":
@@ -247,6 +461,23 @@ class OMNYSampleStorage(Device):
                 returnvalue = i
         return returnvalue
 
+    def _describe_slot(self, container: str, slot_nr: int) -> str:
+        """Sample name, plus owner/measured-status suffix when occupied --
+        e.g. "sample1 (bob)  ◐ started". Used by show_all() so the
+        overview surfaces owner+status without changing get_sample_name()'s
+        own plain-name contract (still used elsewhere, e.g. transfers)."""
+        name = self.get_sample_name(container, slot_nr)
+        if not self.is_sample_slot_used(container, slot_nr):
+            return name
+        owner = self.get_sample_owner(container, slot_nr)
+        status = self.get_sample_status(container, slot_nr)
+        suffix = f" ({owner})" if owner else ""
+        if status == "started":
+            suffix += "  ◐ started"
+        elif status == "completed":
+            suffix += "  ✓ completed"
+        return name + suffix
+
     def show_all(self):
         t = PrettyTable()
         red = "\x1b[91m"
@@ -262,22 +493,32 @@ class OMNYSampleStorage(Device):
             field_names = [""]
             for ax in [1, 3, 5]:
                 row = []
-                row.extend([self.get_sample_name(ch, ax)])
+                row.extend([self._describe_slot(ch, ax)])
                 row.extend(str(ax))
                 row.extend(str(ax + 1))
-                row.extend([self.get_sample_name(ch, ax + 1)])
+                row.extend([self._describe_slot(ch, ax + 1)])
                 t.add_row(row)
             t.header = False
             t.vrules = FRAME
             print(t)
 
         if self.is_sample_in_samplestage():
-            print(f"\n\n  Sample stage:   {self.get_sample_name_in_samplestage()}")
+            name = self.get_sample_name_in_samplestage()
+            owner = self.get_sample_owner_in_samplestage()
+            status = self.get_sample_status_in_samplestage()
+            suffix = f" ({owner})" if owner else ""
+            if status == "started":
+                suffix += "  ◐ started"
+            elif status == "completed":
+                suffix += "  ✓ completed"
+            print(f"\n\n  Sample stage:   {name}{suffix}")
         else:
             print(f"\n\n  Sample stage:   no sample")
 
         if self.is_sample_in_gripper():
-            print(f"\n  Gripper:        {self.get_sample_name_in_gripper()}\n")
+            name = self.get_sample_name_in_gripper()
+            owner = self.get_sample_owner_in_gripper()
+            print(f"\n  Gripper:        {name}" + (f" ({owner})" if owner else "") + "\n")
         else:
             print(f"\n  Gripper:        no sample\n")
 
@@ -287,8 +528,7 @@ class OMNYSampleStorage(Device):
             row = []
             row.extend([f"Position {i:3d}"])
             if self.is_sample_slot_used("O", i):
-                name = self.get_sample_name("O", i)
-                row.extend([name])
+                row.extend([self._describe_slot("O", i)])
             else:
                 row.extend(["free"])
             t.add_row(row)
@@ -301,10 +541,14 @@ class OMNYSampleStorage(Device):
         print(" To get an overview use dev.omny_samples.show_all()")
         print(" Modify a slot:")
         print(" dev.omny_samples.unset_sample_slot('system',position)")
-        print(" dev.omny_samples.set_sample_slot('system',position,'name')")
+        print(" dev.omny_samples.set_sample_slot('system',position,'name','owner')")
         print("   system can be A, B, C, O")
-        print(" dev.omny_samples.set_sample_in_gripper('name') / unset_sample_in_gripper()")
-        print(" dev.omny_samples.set_sample_in_samplestage('name'), unset_sample_in_samplestage()")
+        print(" dev.omny_samples.get_sample_owner('system',position)")
+        print(" dev.omny_samples.set_sample_status('system',position,'status')")
+        print("   status is one of 'none', 'started', 'completed'")
+        print(" dev.omny_samples.get_sample_status('system',position)")
+        print(" dev.omny_samples.set_sample_in_gripper('name','owner') / unset_sample_in_gripper()")
+        print(" dev.omny_samples.set_sample_in_samplestage('name','owner'), unset_sample_in_samplestage()")
         print(" dev.omny_samples.set_shuttle_slot(container, slot_nr) / unset_shuttle_slot(slot_nr)")
         print(" dev.omny_samples.set_shuttle_slot('A',2)")
         print(" omny.otransfer_help()")
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index d5e60ead..19a6015e 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -266,17 +266,41 @@ class SimOMNYSampleStorage(OMNYSampleStorage):
             # 0-20-only range check, but OMNY's own "O" fixed positions
             # legitimately include 32-34/100/101), which would raise here
             # for exactly the positions this needs to clear.
-            for shuttle_placed, shuttle_names in (
-                (storage.sample_shuttle_A_placed, storage.sample_shuttle_A_names),
-                (storage.sample_shuttle_B_placed, storage.sample_shuttle_B_names),
-                (storage.sample_shuttle_C_placed, storage.sample_shuttle_C_names),
+            # Same clearing for the owner/status signals added alongside
+            # placed/names -- untouched positions should read owner="" and
+            # status="none", not the mock-PV "0" default (an invalid status
+            # string, would fail _status_val_to_str's lookup silently back
+            # to "none" anyway, but owner would show a stray "0").
+            for shuttle_placed, shuttle_names, shuttle_owners, shuttle_status in (
+                (
+                    storage.sample_shuttle_A_placed,
+                    storage.sample_shuttle_A_names,
+                    storage.sample_shuttle_A_owners,
+                    storage.sample_shuttle_A_status,
+                ),
+                (
+                    storage.sample_shuttle_B_placed,
+                    storage.sample_shuttle_B_names,
+                    storage.sample_shuttle_B_owners,
+                    storage.sample_shuttle_B_status,
+                ),
+                (
+                    storage.sample_shuttle_C_placed,
+                    storage.sample_shuttle_C_names,
+                    storage.sample_shuttle_C_owners,
+                    storage.sample_shuttle_C_status,
+                ),
             ):
                 for slot_nr in shuttle_placed.component_names:
                     getattr(shuttle_placed, slot_nr).set(0)
                     getattr(shuttle_names, slot_nr).set("-")
+                    getattr(shuttle_owners, slot_nr).set("")
+                    getattr(shuttle_status, slot_nr).set(OMNYSampleStorage.STATUS_NONE)
             for slot_nr in storage.sample_placed.component_names:
                 getattr(storage.sample_placed, slot_nr).set(0)
                 getattr(storage.sample_names, slot_nr).set("-")
+                getattr(storage.sample_owners, slot_nr).set("")
+                getattr(storage.sample_status, slot_nr).set(OMNYSampleStorage.STATUS_NONE)
             for slot_nr in storage.parking_placed.component_names:
                 getattr(storage.parking_placed, slot_nr).set(0)
                 getattr(storage.parking_names, slot_nr).set("none")

From 28eac31ab0a8821bb997129613fa4ab2e369db47 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 03:28:08 +0200
Subject: [PATCH 033/102] feat(omny): add OMNY support to OMNY_TomoParams
 widget (Phase 2 of 2)

Mirko, once Phase 1 (tomo-queue backend) was live-confirmed working: "is
the way to move to the widget phase" -- this adds OMNY as a third setup to
the tomo params GUI widget, alongside flomni/lamni.

Key design decision: replaced the module-level TOMO_TYPES dict (shared
across setups, couldn't express "type 1 means 2 sub-tomograms here but 8
there") with a per-profile "tomo_types" dict:
{tomo_type_int: {"label": str, "n_subtomos": int | None}}. n_subtomos is
not None became the single, uniform test for "is this an equally-spaced
type" everywhere (combo box, section visibility, validation, queue-table
projections display), since OMNY has three such flavors (types 1/4/5 --
2/4/8 sub-tomograms) instead of flomni's/lamni's one (always 8).

Critical bug caught by verifying the design against the live file, not by
the initial design itself: _validate() hardcoded
`tomo_type not in (1, 2, 3)` -- would have made the rest of Phase 2 look
like it worked (types 4/5 selectable, sections visible, math correct)
while silently rejecting every actual submit/queue attempt for an OMNY
type-4/5 job. Fixed to check profile membership instead. Also fixed three
UI strings that hardcoded "8 equal sub-tomograms" to read the active
type's real count.

New _compute_type1_omny/_requested_to_stepsize_omny (parameterized by
tomo_type via {1:2,4:4,5:8}, matching
OMNY._equally_spaced_subtomo_angles()'s own mapping exactly) and
_compute_fermat_positions_omny (calls OmnyFermatScan's real static
method, same pattern as flomni's). _format_projections() gained a 3-way
setup duck-type (OMNY's param set is a strict subset of flomni's -- no
positively-unique OMNY-only key exists, so a negative-then-positive check
is necessary) that resolves into SETUP_PROFILES rather than duplicating
the type-count mapping a third time.

Confirmed needing zero changes (verified, not assumed): _job_tooltip(),
_build_type23_section(), compute_fermat_positions call sites,
_detect_setup() (osamroy as OMNY's discriminator), the busy-banner
detection methods (already generic via the shared tomo_progress global
var from Phase 1), and the Qt Designer plugin registration files.

New test_omny_tomo_params_widget_math.py (29 pure-function tests, no
QApplication/QWidget, same style as the existing flomni/lamni test
files). Full suite: 761 passed. Not live-tested (needs a real display,
same as every GUI change this branch) -- next step is Mirko trying it
against a real OMNY session.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  84 ++++-
 .../widgets/tomo_params/tomo_params.py        | 299 +++++++++++++++---
 .../test_omny_tomo_params_widget_math.py      | 199 ++++++++++++
 3 files changed, 532 insertions(+), 50 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index d210c3ba..086c1ad1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -37,8 +37,13 @@ TomoQueueMixin's interactive= kwarg", "stale ~/Data10/ paths crashed on a fresh
 and tomo queue seems to work now for omny." Also just fixed following his feedback: the progress
 ring GUI only had 2 of flomni's 3 rings, and OMNY never tracked/printed measurement time or idle
 time the way flomni does at the end of a tomogram -- see "Progress ring GUI + ETA/idle-time
-tracking + end-of-scan timing summary" below. Phase 2 (the `TomoParamsWidget` GUI itself) is a
-separate follow-up, not yet started.
+tracking + end-of-scan timing summary" below.
+
+**Just landed, not yet live-tested**: Phase 2 -- the `OMNY_TomoParams` GUI widget itself now
+supports OMNY as a third setup (5 tomo types, not just flomni's/lamni's 3). See "TomoParamsWidget
+ported to OMNY (Phase 2 of 2)" below. Mirko: "is the way to move to the widget phase" -- this is
+that. No live GUI verification yet (needs a real display, same as every other GUI change this
+branch) -- next step is Mirko trying it against a real OMNY session.
 
 **Still open / deferred** (unchanged from before, not touched this pass):
 - `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
@@ -47,7 +52,6 @@ separate follow-up, not yet started.
 - The full gripper sample-transfer chain (`otransfer_put_sample()`/`otransfer_get_sample()`),
   dewar/temperature methods, sample storage bookkeeping, and `omny_alignment_mixin.py`/
   `omny_optics_mixin.py` beyond what scans exercise — see "Checklist" section below.
-- The `TomoParamsWidget`/`OMNY_TomoParams` GUI widget itself (Phase 2 of the tomo-queue port).
 - `omny_alignment_mixin.py`/`x_ray_eye_align.py` still reference the old `~/Data10/specES1/internal/`
   path for alignment-offset data (unlike the tomo-scan-path fixes below, these already tolerate a
   missing path gracefully — confirmed live, no crash, just "No data available" -- so left alone for
@@ -145,15 +149,14 @@ Still untested (not attempted yet, not known-broken — just unexplored):
 - `omny_webpage_generator.py` (2957 lines) is dead/unwired code — never instantiated by
   `omny.py`, per `FLOMNI_TO_LAMNI_COMPARISON.md`'s note ("omny was left untouched...
   separate future task if omny ever needs a real one"). Not touched this session either.
-- **Tomo-queue backend: ported, Phase 1 of 2 (this session).** `OMNY` now inherits
+- **Tomo-queue backend + widget: both ported (Phase 1 and 2, this branch).** `OMNY` inherits
   `TomoQueueMixin` (`OMNY_shared/tomo_queue_mixin.py`), the same shared backend flomni/lamni
   use — `tomo_queue_add/delete/move/clear/show/execute/reacquire`,
-  `register_at_each_angle_hook`/`at_each_angle_hook`, `tomo_scan_resume()`. See "Tomo-queue
-  backend ported to OMNY" below for the full detail. **Not yet done (Phase 2, separate
-  follow-up)**: the `TomoParamsWidget`/`OMNY_TomoParams` GUI widget itself
-  (`bec_widgets/widgets/tomo_params/tomo_params.py`) still has no `SETUP_PROFILES["omny"]`
-  entry and its tomo-type selector/job-display logic is hardcoded to 3 tomo types (flomni's
-  and lamni's), not OMNY's 5 — needs its own plan once Phase 1 is live-tested.
+  `register_at_each_angle_hook`/`at_each_angle_hook`, `tomo_scan_resume()`. The
+  `OMNY_TomoParams` GUI widget (`bec_widgets/widgets/tomo_params/tomo_params.py`) now has a
+  `SETUP_PROFILES["omny"]` entry and its tomo-type selector/job-display logic supports OMNY's 5
+  tomo types (flomni/lamni only ever had 3). See "Tomo-queue backend ported to OMNY" and
+  "TomoParamsWidget ported to OMNY (Phase 2 of 2)" below for the full detail.
 
 ## Progress ring GUI + ETA/idle-time tracking + end-of-scan timing summary (fixed)
 
@@ -479,6 +482,67 @@ never drift out of sync. 13 new tests across `test_omny_fermat_scan.py` (scan-le
 `prepare_scan()` still aborts) and `test_omny_tomo_angles.py` (CLI-level: warning appears/doesn't
 appear).
 
+## TomoParamsWidget ported to OMNY (Phase 2 of 2)
+
+Mirko, once Phase 1 was live-confirmed working: "is the way to move to the widget phase" -- this
+is Phase 2, adding OMNY as a third setup to the `OMNY_TomoParams` GUI widget
+(`bec_widgets/widgets/tomo_params/tomo_params.py`). The widget was already almost entirely
+`SETUP_PROFILES`-driven (two research passes plus a verification pass against the live 2476-line
+file found essentially everything generalizes mechanically), with one real complication: flomni
+and lamni each have exactly one "equally spaced sub-tomograms" tomo type (type 1, always 8
+sub-tomograms); OMNY has three (types 1/4/5 -- 2/4/8 sub-tomograms).
+
+**Key design decision**: replaced the module-level `TOMO_TYPES` dict (shared across all setups,
+couldn't express "type 1 means 2 sub-tomograms here but 8 there") with a per-profile
+`"tomo_types"` dict: `{tomo_type_int: {"label": str, "n_subtomos": int | None}}`.
+`n_subtomos is not None` became the single, uniform test for "is this an equally-spaced type"
+everywhere in the file (combo box, section visibility, validation, queue-table projections
+display) instead of duplicating an `{1,4,5}`-shaped literal two or three times.
+
+**Critical bug caught by a verification pass, not the initial design**: `_validate()` had
+`if params.get("tomo_type") not in (1, 2, 3): return "tomo_type must be 1, 2, or 3"` -- a
+hardcoded closed-enumeration check that the rest of Phase 2 would have sailed past (types 4/5
+selectable, sections visible, math correct) while **silently rejecting every actual submit/queue
+attempt** for an OMNY type-4/5 job. Fixed to check `self._profile["tomo_types"]` membership
+instead. Also caught: three UI strings hardcoded "8" ("must be divisible into 8 equal
+sub-tomograms" in the projection-preview tooltip and both confirmation dialogs) -- all three now
+read the active type's real `n_subtomos`.
+
+**New module-level OMNY math functions** (`_compute_type1_omny`/`_requested_to_stepsize_omny`),
+mirroring `_compute_type1`/`_requested_to_stepsize` but parameterized by `tomo_type` (using
+`{1:2, 4:4, 5:8}`, matching `OMNY._equally_spaced_subtomo_angles()`'s own mapping in omny.py
+exactly) instead of a hardcoded `*8`. `_compute_fermat_positions_omny` calls
+`OmnyFermatScan.get_omny_fermat_spiral_pos()`/`MIN_POSITIONS` directly, same pattern as flomni's.
+`_format_projections()` (module-level, only has a job's raw `params` dict, not `self._profile`)
+gained a 3-way setup duck-type: `"tomo_angle_range" in params` -> flomni; else `"fovx" in params`
+-> omny (OMNY's param set is a strict subset of flomni's -- no positively-unique OMNY-only key
+exists, so this negative-then-positive check is necessary, not a shortcut); else -> lamni. Once
+resolved, it looks up `SETUP_PROFILES[setup]["tomo_types"]` rather than hand-picking a compute
+function, avoiding a third copy of the type-count mapping.
+
+**Confirmed needing zero changes** (verified against the live file, not assumed): `_job_tooltip()`/
+`_irrelevant_params_for_type()` (OMNY's params never overlap the flomni-only keys they filter on,
+so the existing `!= 1` check has no observable effect for OMNY regardless); `_build_type23_section()`
+(golden-ratio-only, already type-count-agnostic); `compute_fermat_positions` call sites (fermat math
+never depends on tomo_type); `_detect_setup()` (purely `discriminator_attr`-driven, `"osamroy"` for
+OMNY); the busy-banner detection methods (already read the shared `tomo_progress` global var/
+scan-queue-status generically, Phase 1 already made OMNY use the same key); the Qt Designer plugin
+registration files (already fully generic, self-detect setup at construction).
+
+Test coverage: new `test_omny_tomo_params_widget_math.py` (29 tests, pure-function -- no
+`QApplication`/`QWidget`, same style as the existing flomni/lamni widget-math test files),
+covering the new compute functions against the reference formula, `tomo_types` n_subtomos mapping,
+`param_names`/`defaults` parity with `OMNY._TOMO_SCAN_PARAM_NAMES`, `_format_projections()`'s 3-way
+dispatch (including a regression guard that it still correctly distinguishes flomni/lamni jobs),
+`_compute_fermat_positions_omny` against the real scan class, and a standalone regression guard for
+the `_validate()` fix. Full suite: 761 passed.
+
+**Not live-tested**: needs a real display (same as every GUI change this branch) -- next step is
+Mirko trying it against a real OMNY session: switching between all 5 tomo types (confirm the
+equally-spaced section shows/hides correctly and the new sub-tomogram-count label updates),
+submitting/queueing a type-4 or type-5 job (confirms the `_validate()` fix specifically), and
+checking a queued job's tooltip/Projections column in the queue dialog.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
index 0c6341c6..bab239fd 100644
--- a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
+++ b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
@@ -79,12 +79,6 @@ logger = bec_logger.logger
 
 # ── constants ────────────────────────────────────────────────────────────────
 
-TOMO_TYPES = {
-    1: "8 equally spaced sub-tomograms",
-    2: "Golden ratio (sorted in bunches)",
-    3: "Equally spaced, golden ratio start",
-}
-
 # Mirrors _update_type_visibility()'s section/field gating (_sec_type1 shown
 # only for type 1, golden_ratio_bunch_size shown only for type 2 within
 # _sec_type23, the rest of _sec_type23 shown for type 2/3) -- reused by
@@ -228,6 +222,48 @@ LAMNI_DEFAULTS: dict[str, Any] = {
     "at_each_angle_hook": None,
 }
 
+# Exact tuple from OMNY._TOMO_SCAN_PARAM_NAMES (source of truth in omny.py).
+# No tomo_angle_range/single_point_*/zero_deg_reference_at_each_subtomo/
+# frames_per_trigger -- none of these exist as OMNY properties.
+OMNY_QUEUE_PARAM_NAMES = (
+    "tomo_countingtime",
+    "tomo_shellstep",
+    "fovx",
+    "fovy",
+    "stitch_x",
+    "stitch_y",
+    "tomo_stitch_overlap",
+    "ptycho_reconstruct_foldername",
+    "manual_shift_y",
+    "tomo_type",
+    "tomo_angle_stepsize",
+    "golden_ratio_bunch_size",
+    "golden_max_number_of_projections",
+    "golden_projections_at_0_deg_for_damage_estimation",
+    "corridor_size",
+    "at_each_angle_hook",
+)
+
+# Read directly off each OMNY property getter's None-fallback in omny.py.
+OMNY_DEFAULTS: dict[str, Any] = {
+    "tomo_countingtime": 0.1,
+    "tomo_shellstep": 1,
+    "fovx": 20.0,
+    "fovy": 20.0,
+    "stitch_x": 0,
+    "stitch_y": 0,
+    "tomo_stitch_overlap": 0.2,
+    "ptycho_reconstruct_foldername": "ptycho_reconstruct",
+    "manual_shift_y": 0.0,
+    "tomo_type": 1,
+    "tomo_angle_stepsize": 10.0,
+    "golden_ratio_bunch_size": 20,
+    "golden_max_number_of_projections": 1000.0,
+    "golden_projections_at_0_deg_for_damage_estimation": 0,
+    "corridor_size": -1,
+    "at_each_angle_hook": None,
+}
+
 
 def _hline() -> QFrame:
     line = QFrame()
@@ -438,8 +474,8 @@ class OMNY_TomoParams(BECWidget, QWidget):
         type_row = QHBoxLayout()
         type_row.addWidget(QLabel("Tomo type:"))
         self._pw["tomo_type"] = QComboBox()
-        for tid, label in TOMO_TYPES.items():
-            self._pw["tomo_type"].addItem(f"{tid} – {label}", tid)
+        for tid, info in self._profile["tomo_types"].items():
+            self._pw["tomo_type"].addItem(f"{tid} – {info['label']}", tid)
         self._pw["tomo_type"].currentIndexChanged.connect(self._on_type_changed)
         type_row.addWidget(self._pw["tomo_type"], stretch=1)
         vbox.addLayout(type_row)
@@ -599,7 +635,11 @@ class OMNY_TomoParams(BECWidget, QWidget):
         form.addRow("At-each-angle hook:", self._pw["at_each_angle_hook"])
 
     def _build_type1_section(self) -> QGroupBox:
-        box = QGroupBox("Type 1 – sub-tomogram settings")
+        # Generic title, not "Type 1" -- this section is shared by every
+        # "equally spaced sub-tomograms" type_flavor a profile defines (see
+        # SETUP_PROFILES[...]["tomo_types"]), which for OMNY is types 1/4/5
+        # (2/4/8 sub-tomograms), not just type 1 like flomni/lamni.
+        box = QGroupBox("Equally spaced sub-tomograms – settings")
         form = QFormLayout(box)
         form.setLabelAlignment(Qt.AlignmentFlag.AlignRight)
 
@@ -614,6 +654,12 @@ class OMNY_TomoParams(BECWidget, QWidget):
             )
             form.addRow("Angle range:", self._pw["tomo_angle_range"])
 
+        # read-only: how many sub-tomograms the currently selected type uses
+        # (2/4/8 for OMNY's types 1/4/5, always 8 for flomni/lamni's type 1)
+        # -- updated from _update_type_visibility() whenever the type changes.
+        self._lbl_subtomo_count = QLabel("---")
+        form.addRow("Sub-tomograms:", self._lbl_subtomo_count)
+
         # requested total projections (user entry in edit mode)
         self._pw["_requested_total"] = QSpinBox()
         self._pw["_requested_total"].setRange(8, 10000)
@@ -752,7 +798,7 @@ class OMNY_TomoParams(BECWidget, QWidget):
         # derive requested_total from stored tomo_angle_stepsize
         angle_range = int(params.get("tomo_angle_range", 180))
         stepsize = float(params.get("tomo_angle_stepsize", 10.0))
-        actual_total, _, _ = self._profile["compute_type1"](angle_range, stepsize)
+        actual_total, _, _ = self._profile["compute_type1"](angle_range, stepsize, type_val)
         self._pw["_requested_total"].blockSignals(True)
         self._pw["_requested_total"].setValue(actual_total)
         self._pw["_requested_total"].blockSignals(False)
@@ -820,7 +866,9 @@ class OMNY_TomoParams(BECWidget, QWidget):
         # derive tomo_angle_stepsize from requested_total + angle_range (type 1)
         angle_range = int(params.get("tomo_angle_range", 180))
         requested = self._pw["_requested_total"].value()
-        stepsize = self._profile["requested_to_stepsize"](angle_range, requested)
+        stepsize = self._profile["requested_to_stepsize"](
+            angle_range, requested, params.get("tomo_type")
+        )
         params["tomo_angle_stepsize"] = stepsize
 
         # type 3: override tomo_angle_stepsize from projections-per-subtomo
@@ -849,8 +897,8 @@ class OMNY_TomoParams(BECWidget, QWidget):
         fpt = params.get("frames_per_trigger", 1)
         if not isinstance(fpt, int) or fpt < 1 or isinstance(fpt, bool):
             return "frames_per_trigger must be a positive integer"
-        if params.get("tomo_type") not in (1, 2, 3):
-            return "tomo_type must be 1, 2, or 3"
+        if params.get("tomo_type") not in self._profile["tomo_types"]:
+            return f"tomo_type must be one of {sorted(self._profile['tomo_types'])}"
         if self._profile["has_180_mode"] and params.get("tomo_angle_range") not in (180, 360):
             return "tomo_angle_range must be 180 or 360"
         if self._profile["has_single_point"]:
@@ -869,7 +917,17 @@ class OMNY_TomoParams(BECWidget, QWidget):
     # ── type visibility ───────────────────────────────────────────────────────
 
     def _update_type_visibility(self, tomo_type: int) -> None:
-        self._sec_type1.setVisible(tomo_type == 1)
+        # "Equally spaced sub-tomograms" section: shown for whichever
+        # tomo_type(s) this profile marks as such (flomni/lamni: type 1
+        # only; OMNY: types 1/4/5 -- 2/4/8 sub-tomograms) rather than a bare
+        # `== 1` check, which would blank the panel entirely for OMNY's
+        # types 4/5.
+        type_info = self._profile["tomo_types"].get(tomo_type, {})
+        n_subtomos = type_info.get("n_subtomos")
+        self._sec_type1.setVisible(n_subtomos is not None)
+        if n_subtomos is not None:
+            self._lbl_subtomo_count.setText(str(n_subtomos))
+            self._pw["_requested_total"].setSingleStep(n_subtomos)
         self._sec_type23.setVisible(tomo_type in (2, 3))
         # _numprj_type3: only visible for type 3
         _w__numprj_type3 = self._pw.get("_numprj_type3")
@@ -905,18 +963,22 @@ class OMNY_TomoParams(BECWidget, QWidget):
         # entirely, so any fallback here is a no-op, not a guess.
         angle_range_widget = self._pw.get("tomo_angle_range")
         angle_range = int(angle_range_widget.currentData() or 180) if angle_range_widget else 180
+        tomo_type = self._pw["tomo_type"].currentData()
         requested = self._pw["_requested_total"].value()
-        stepsize = self._profile["requested_to_stepsize"](angle_range, requested)
-        actual_total, achievable_step, _ = self._profile["compute_type1"](angle_range, stepsize)
+        stepsize = self._profile["requested_to_stepsize"](angle_range, requested, tomo_type)
+        actual_total, achievable_step, _ = self._profile["compute_type1"](
+            angle_range, stepsize, tomo_type
+        )
 
         self._lbl_actual_total.setText(str(actual_total))
         self._lbl_achievable_step.setText(f"{achievable_step:.4f}")
 
         if actual_total != requested:
+            n_subtomos = self._profile["tomo_types"].get(tomo_type, {}).get("n_subtomos")
             self._lbl_actual_total.setStyleSheet("color: orange;")
             self._lbl_actual_total.setToolTip(
                 f"Requested {requested} → actual {actual_total} "
-                f"(must be divisible into 8 equal sub-tomograms)"
+                f"(must be divisible into {n_subtomos} equal sub-tomograms)"
             )
         else:
             self._lbl_actual_total.setStyleSheet("")
@@ -1178,18 +1240,22 @@ class OMNY_TomoParams(BECWidget, QWidget):
             QMessageBox.warning(self, "Validation error", error)
             return
 
-        # Confirm if actual_total differs from requested (type-1)
-        if params.get("tomo_type") == 1:
+        # Confirm if actual_total differs from requested (equally-spaced types)
+        type_info = self._profile["tomo_types"].get(params.get("tomo_type"), {})
+        n_subtomos = type_info.get("n_subtomos")
+        if n_subtomos is not None:
             angle_range = int(params.get("tomo_angle_range", 180))
             requested = self._pw["_requested_total"].value()
             stepsize = params["tomo_angle_stepsize"]
-            actual_total, _, _ = self._profile["compute_type1"](angle_range, stepsize)
+            actual_total, _, _ = self._profile["compute_type1"](
+                angle_range, stepsize, params.get("tomo_type")
+            )
             if actual_total != requested:
                 reply = QMessageBox.question(
                     self,
                     "Projection count adjusted",
                     f"Requested {requested} projections → achievable: {actual_total}.\n"
-                    f"(Must be divisible into 8 equal sub-tomograms.)\n\n"
+                    f"(Must be divisible into {n_subtomos} equal sub-tomograms.)\n\n"
                     f"Submit with {actual_total} projections?",
                     QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.Cancel,
                 )
@@ -1235,17 +1301,21 @@ class OMNY_TomoParams(BECWidget, QWidget):
             QMessageBox.warning(self, "Validation error", error)
             return
 
-        if params.get("tomo_type") == 1:
+        type_info = self._profile["tomo_types"].get(params.get("tomo_type"), {})
+        n_subtomos = type_info.get("n_subtomos")
+        if n_subtomos is not None:
             angle_range = int(params.get("tomo_angle_range", 180))
             requested = self._pw["_requested_total"].value()
             stepsize = params["tomo_angle_stepsize"]
-            actual_total, _, _ = self._profile["compute_type1"](angle_range, stepsize)
+            actual_total, _, _ = self._profile["compute_type1"](
+                angle_range, stepsize, params.get("tomo_type")
+            )
             if actual_total != requested:
                 reply = QMessageBox.question(
                     self,
                     "Projection count adjusted",
                     f"Requested {requested} projections → achievable: {actual_total}.\n"
-                    f"(Must be divisible into 8 equal sub-tomograms.)\n\n"
+                    f"(Must be divisible into {n_subtomos} equal sub-tomograms.)\n\n"
                     f"Queue with {actual_total} projections?",
                     QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.Cancel,
                 )
@@ -2089,7 +2159,7 @@ class CommandJobBuilderDialog(QDialog):
 # ── module-level helpers ─────────────────────────────────────────────────────
 
 
-def _requested_to_stepsize(angle_range: int, requested_total: int) -> float:
+def _requested_to_stepsize(angle_range: int, requested_total: int, tomo_type: int = 1) -> float:
     """Convert a desired total projection count to tomo_angle_stepsize.
 
     angle_range is accepted for call-site compatibility but NOT used here:
@@ -2098,19 +2168,25 @@ def _requested_to_stepsize(angle_range: int, requested_total: int) -> float:
     sub-tomograms into low/high halves in 360 mode -- it doesn't change
     the total projection count or per-subtomo step). Mirrors
     Flomni._subtomo_angle_plan()'s docstring / _tomo_type1_actual_grid().
+
+    tomo_type is accepted for call-site uniformity with the OMNY sibling
+    (_requested_to_stepsize_omny(), which has more than one equally-spaced
+    flavor and needs it) -- unused here, flomni has only one.
     """
     if requested_total <= 0:
         return 180.0
     return (180.0 / requested_total) * 8
 
 
-def _compute_type1(angle_range: int, stepsize: float) -> tuple[int, float, float]:
+def _compute_type1(
+    angle_range: int, stepsize: float, tomo_type: int = 1
+) -> tuple[int, float, float]:
     """
     Given stored tomo_angle_stepsize, return:
       (actual_total, achievable_step, stepsize)
     Mirrors the CLI's internal computation exactly -- see
-    _requested_to_stepsize()'s docstring for why angle_range is accepted
-    but not used in the N/step/total math.
+    _requested_to_stepsize()'s docstring for why angle_range/tomo_type are
+    accepted but not used in the N/step/total math.
     """
     if stepsize <= 0:
         return 0, 0.0, 0.0
@@ -2122,7 +2198,9 @@ def _compute_type1(angle_range: int, stepsize: float) -> tuple[int, float, float
     return actual_total, achievable_step, stepsize
 
 
-def _lamni_requested_to_stepsize(angle_range: int, requested_total: int) -> float:
+def _lamni_requested_to_stepsize(
+    angle_range: int, requested_total: int, tomo_type: int = 1
+) -> float:
     """Lamni sibling of _requested_to_stepsize(): inverse of
     _lamni_compute_type1()'s N*8 grid -- mirrors
     LamNI._tomo_type1_actual_grid()'s inverse (lamni.py) exactly.
@@ -2130,13 +2208,16 @@ def _lamni_requested_to_stepsize(angle_range: int, requested_total: int) -> floa
     angle_range is accepted but ignored, for call-site symmetry with the
     flomni functions above -- lamni is laminography: always 360 degrees, no
     tomo_angle_range concept at all (see LamNI._TOMO_SCAN_PARAM_NAMES).
+    tomo_type likewise accepted but unused -- see _requested_to_stepsize().
     """
     if requested_total <= 0:
         return 360.0
     return (360.0 / requested_total) * 8
 
 
-def _lamni_compute_type1(angle_range: int, stepsize: float) -> tuple[int, float, float]:
+def _lamni_compute_type1(
+    angle_range: int, stepsize: float, tomo_type: int = 1
+) -> tuple[int, float, float]:
     """Lamni sibling of _compute_type1(): mirrors
     LamNI._tomo_type1_actual_grid() (lamni.py) exactly --
       N = int(360 / stepsize)     -- unique angles per sub-tomogram
@@ -2146,7 +2227,7 @@ def _lamni_compute_type1(angle_range: int, stepsize: float) -> tuple[int, float,
     A full 360-degree sweep's closing angle is the same physical angle as
     its start, so N (not N+1) is the real per-sub-tomogram count --
     sub_tomo_scan() generates it with endpoint=False for exactly this
-    reason. angle_range is accepted but ignored (see
+    reason. angle_range/tomo_type are accepted but ignored (see
     _lamni_requested_to_stepsize()).
     """
     if stepsize <= 0:
@@ -2159,6 +2240,46 @@ def _lamni_compute_type1(angle_range: int, stepsize: float) -> tuple[int, float,
     return actual_total, achievable_step, stepsize
 
 
+# OMNY has three "equally spaced sub-tomograms" flavors (tomo_type 1/4/5 --
+# 2/4/8 sub-tomograms), unlike flomni's/lamni's single always-8 flavor -- see
+# OMNY._TOMO_TYPE_1_LIKE / OMNY._equally_spaced_subtomo_angles() (omny.py).
+_OMNY_N_SUBTOMOS_FOR_TYPE = {1: 2, 4: 4, 5: 8}
+
+
+def _requested_to_stepsize_omny(
+    angle_range: int, requested_total: int, tomo_type: int = 1
+) -> float:
+    """OMNY sibling of _requested_to_stepsize(): same N/180-degree math, but
+    with a variable sub-tomogram multiplier depending on which of tomo_type
+    1/4/5 is active, instead of flomni's/lamni's fixed 8. angle_range is
+    accepted but ignored (OMNY has no 180/360 toggle, always 180).
+    """
+    n_subtomos = _OMNY_N_SUBTOMOS_FOR_TYPE.get(tomo_type, 2)
+    if requested_total <= 0:
+        return 180.0
+    return (180.0 / requested_total) * n_subtomos
+
+
+def _compute_type1_omny(
+    angle_range: int, stepsize: float, tomo_type: int = 1
+) -> tuple[int, float, float]:
+    """OMNY sibling of _compute_type1(): mirrors
+    OMNY._equally_spaced_subtomo_angles()'s own grid (omny.py) exactly --
+      N = int(180 / stepsize)
+      achievable_step = 180 / N
+      actual_total = N * n_subtomos(tomo_type)
+    """
+    if stepsize <= 0:
+        return 0, 0.0, 0.0
+    N = int(180.0 / stepsize)
+    if N <= 0:
+        return 0, 0.0, 0.0
+    n_subtomos = _OMNY_N_SUBTOMOS_FOR_TYPE.get(tomo_type, 2)
+    achievable_step = 180.0 / N
+    actual_total = N * n_subtomos
+    return actual_total, achievable_step, stepsize
+
+
 def _compute_fermat_positions_flomni(params: dict[str, Any]) -> tuple[int, int]:
     """Estimated Fermat-spiral point count for the currently edited flomni
     fields, plus the scan-server's own minimum threshold.
@@ -2189,6 +2310,30 @@ def _compute_fermat_positions_flomni(params: dict[str, Any]) -> tuple[int, int]:
     return len(positions), FlomniFermatScan.MIN_POSITIONS
 
 
+def _compute_fermat_positions_omny(params: dict[str, Any]) -> tuple[int, int]:
+    """OMNY sibling of _compute_fermat_positions_flomni(): calls
+    OmnyFermatScan.get_omny_fermat_spiral_pos() directly -- the exact same
+    algorithm the scan itself runs (and the same one OMNY.tomo_parameters()'s
+    CLI warning uses via OMNY._expected_fermat_position_count()), so the
+    estimate can never drift out of sync. cenx/ceny/zshift left at their
+    defaults -- they only shift the final position, never affect the count.
+
+    Returns:
+        (estimated_count, minimum_required)
+    """
+    from csaxs_bec.scans.omny_fermat_scan import OmnyFermatScan
+
+    fovx = params.get("fovx", 0.0)
+    fovy = params.get("fovy", 0.0)
+    step = params.get("tomo_shellstep", 0.0)
+    if step <= 0:
+        return 0, OmnyFermatScan.MIN_POSITIONS
+    positions = OmnyFermatScan.get_omny_fermat_spiral_pos(
+        -abs(fovx / 2), abs(fovx / 2), -abs(fovy / 2), abs(fovy / 2), step=step, spiral_type=0
+    )
+    return len(positions), OmnyFermatScan.MIN_POSITIONS
+
+
 def _compute_fermat_positions_lamni(params: dict[str, Any]) -> tuple[int, int]:
     """Lamni sibling of _compute_fermat_positions_flomni(): calls
     LamniFermatScan.get_lamni_fermat_spiral_pos() directly -- including its
@@ -2296,6 +2441,11 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         "fermat_position_fields": ["tomo_shellstep", "fovx", "fovy"],
         "sample_name_getter": lambda w: w.dev.flomni_samples.sample_names.sample0.get(),
         "cli_hint_name": "flomni",
+        "tomo_types": {
+            1: {"label": "8 equally spaced sub-tomograms", "n_subtomos": 8},
+            2: {"label": "Golden ratio (sorted in bunches)", "n_subtomos": None},
+            3: {"label": "Equally spaced, golden ratio start", "n_subtomos": None},
+        },
     },
     "lamni": {
         "label": "LamNI",
@@ -2356,6 +2506,59 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         ],
         "sample_name_getter": lambda w: w.client.get_global_var("sample_name"),
         "cli_hint_name": "lamni",
+        "tomo_types": {
+            1: {"label": "8 equally spaced sub-tomograms", "n_subtomos": 8},
+            2: {"label": "Golden ratio (sorted in bunches)", "n_subtomos": None},
+            3: {"label": "Equally spaced, golden ratio start", "n_subtomos": None},
+        },
+    },
+    "omny": {
+        "label": "OMNY",
+        "discriminator_attr": "osamroy",
+        "param_names": OMNY_QUEUE_PARAM_NAMES,
+        "defaults": OMNY_DEFAULTS,
+        "has_180_mode": False,
+        "has_single_point": False,
+        "has_zero_deg_reference": False,
+        "fov_fields": [
+            ("fovx", "FOV x (µm)", 0.1, 200.0, 2),
+            ("fovy", "FOV y (µm)", 0.1, 100.0, 2),
+        ],  # bounds copied from flomni's -- must match OMNY.fovx/fovy setters' ValueError bounds
+        "stitch_fields": [("stitch_x", "Stitch x", 0, 50), ("stitch_y", "Stitch y", 0, 50)],
+        "manual_shift_fields": [("manual_shift_y", "Manual shift y (µm)", -1000.0, 1000.0, 3)],
+        "piezo_range_fields": [],
+        "offset_fields": [],
+        "offset_getter": None,
+        "offset_setter": None,
+        # flomni's own field_order minus frames_per_trigger/single_point --
+        # OMNY has neither property.
+        "field_order": [
+            "tomo_countingtime",
+            "tomo_shellstep",
+            "fov",
+            "stitch",
+            "tomo_stitch_overlap",
+            "ptycho_reconstruct_foldername",
+            "manual_shift",
+            "at_each_angle_hook",
+        ],
+        "type1_base_angle": 180.0,
+        "compute_type1": _compute_type1_omny,
+        "requested_to_stepsize": _requested_to_stepsize_omny,
+        "compute_fermat_positions": _compute_fermat_positions_omny,
+        "fermat_position_fields": ["tomo_shellstep", "fovx", "fovy"],
+        "sample_name_getter": lambda w: w.dev.omny_samples.get_sample_name_in_samplestage(),
+        "cli_hint_name": "omny",
+        # OMNY has three "equally spaced sub-tomograms" flavors (2/4/8
+        # sub-tomograms), unlike flomni's/lamni's single always-8 flavor --
+        # see OMNY._TOMO_TYPE_1_LIKE / _equally_spaced_subtomo_angles() (omny.py).
+        "tomo_types": {
+            1: {"label": "2 equally spaced sub-tomograms", "n_subtomos": 2},
+            2: {"label": "Golden ratio (sorted in bunches)", "n_subtomos": None},
+            3: {"label": "Equally spaced, golden ratio start", "n_subtomos": None},
+            4: {"label": "4 equally spaced sub-tomograms", "n_subtomos": 4},
+            5: {"label": "8 equally spaced sub-tomograms", "n_subtomos": 8},
+        },
     },
 }
 
@@ -2364,25 +2567,41 @@ def _format_projections(params: dict) -> str:
     """
     Human-readable projection count for a queued job, mirroring the CLI's
     per-type logic. A job's own ``params`` dict is that setup's own param
-    snapshot, so ``"tomo_angle_range" in params`` distinguishes a flomni job
-    (fixed-180 base, mode-independent) from a lamni job (plain 360 base,
-    see ``_lamni_compute_type1``/``_lamni_requested_to_stepsize``) without
-    this module-level helper needing to know which setup is active:
-      - type 1: flomni int(180/stepsize)*8, lamni int(360/stepsize)*8
+    snapshot, so this module-level helper duck-types which setup it belongs
+    to without needing to know which one is currently active:
+      - ``"tomo_angle_range" in params`` -> flomni (fixed-180 base,
+        mode-independent).
+      - else ``"fovx" in params`` -> omny. OMNY's param set is a strict
+        subset of flomni's (no positively-unique OMNY-only key exists), so
+        this negative-then-positive check is the correct 3-way
+        discriminator, not just a shortcut.
+      - else -> lamni (plain 360 base, ``tomo_circfov`` instead of
+        ``fovx``).
+    Once the setup is known, ``SETUP_PROFILES[setup]["tomo_types"]`` is the
+    single source of truth for which tomo_type values are "equally spaced
+    sub-tomograms" (and how many) -- avoids a second/third hardcoded
+    ``{1, 4, 5}``-shaped literal here.
+      - equally-spaced types: flomni int(180/stepsize)*8, lamni
+        int(360/stepsize)*8, omny int(180/stepsize)*{2,4,8} depending on
+        tomo_type.
       - type 2 and 3: golden ratio-flavored, no fixed sub-tomogram count ->
         configured max (golden_max_number_of_projections), or ∞ if unset.
         Type 3 shifts sub-tomogram starting angles by the golden ratio but
-        is otherwise capped exactly like type 2, not type 1's fixed grid.
+        is otherwise capped exactly like type 2, not the equally-spaced
+        types' fixed grid.
     """
     try:
         tomo_type = int(params.get("tomo_type", 1))
         stepsize = float(params.get("tomo_angle_stepsize", 0) or 0)
         is_flomni_job = "tomo_angle_range" in params
-        compute_type1 = _compute_type1 if is_flomni_job else _lamni_compute_type1
+        is_omny_job = not is_flomni_job and "fovx" in params
+        setup = "flomni" if is_flomni_job else ("omny" if is_omny_job else "lamni")
+        profile = SETUP_PROFILES[setup]
+        type_info = profile["tomo_types"].get(tomo_type, {})
 
-        if tomo_type == 1:
+        if type_info.get("n_subtomos") is not None:
             angle_range = int(params.get("tomo_angle_range", 180))
-            actual_total, _, _ = compute_type1(angle_range, stepsize)
+            actual_total, _, _ = profile["compute_type1"](angle_range, stepsize, tomo_type)
             return str(actual_total)
 
         if tomo_type in (2, 3):
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
new file mode 100644
index 00000000..6146c670
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
@@ -0,0 +1,199 @@
+"""Regression test for TomoParamsWidget's omny-specific projection-count
+math (_compute_type1_omny/_requested_to_stepsize_omny), mirroring
+test_lamni_tomo_params_widget_math.py's style.
+
+OMNY's formula is NOT the same as flomni's/lamni's fixed-8-sub-tomogram
+grid: OMNY has three "equally spaced sub-tomograms" flavors (tomo_type
+1/4/5 -- 2/4/8 sub-tomograms), matching OMNY._equally_spaced_subtomo_angles()
+(omny.py) exactly: N = int(180/stepsize) unique angles per sub-tomogram,
+N*n_subtomos total, where n_subtomos = {1: 2, 4: 4, 5: 8}[tomo_type].
+"""
+
+import pytest
+
+from csaxs_bec.bec_ipython_client.plugins.omny.omny import OMNY
+from csaxs_bec.bec_widgets.widgets.tomo_params.tomo_params import (
+    OMNY_DEFAULTS,
+    OMNY_QUEUE_PARAM_NAMES,
+    SETUP_PROFILES,
+    _compute_fermat_positions_omny,
+    _compute_type1,
+    _compute_type1_omny,
+    _format_projections,
+    _lamni_compute_type1,
+    _requested_to_stepsize,
+    _requested_to_stepsize_omny,
+)
+from csaxs_bec.scans.omny_fermat_scan import OmnyFermatScan
+
+STEPSIZES = [10.0, 7.0, 25.0, 12.5]
+OMNY_TYPES_N_SUBTOMOS = {1: 2, 4: 4, 5: 8}
+
+
+@pytest.mark.parametrize("stepsize", STEPSIZES)
+@pytest.mark.parametrize("tomo_type", [1, 4, 5])
+def test_omny_compute_type1_matches_equally_spaced_subtomo_angles(tomo_type, stepsize):
+    """Reference formula mirrors OMNY._equally_spaced_subtomo_angles()'s own
+    grid: N = int(180/stepsize) unique angles per sub-tomogram, N*n_subtomos
+    total."""
+    N = int(180.0 / stepsize)
+    n_subtomos = OMNY_TYPES_N_SUBTOMOS[tomo_type]
+    expected_total = N * n_subtomos
+    expected_step = 180.0 / N
+
+    actual_total, achievable_step, _ = _compute_type1_omny(180, stepsize, tomo_type)
+    assert actual_total == expected_total
+    assert achievable_step == pytest.approx(expected_step)
+
+
+@pytest.mark.parametrize("tomo_type,requested_total", [(1, 18), (4, 36), (5, 72)])
+def test_omny_requested_to_stepsize_round_trips(tomo_type, requested_total):
+    """requested_total must already be a multiple of n_subtomos for the
+    round trip to land exactly back on it -- these were chosen as N=9."""
+    stepsize = _requested_to_stepsize_omny(180, requested_total, tomo_type)
+    actual_total, _, _ = _compute_type1_omny(180, stepsize, tomo_type)
+    assert actual_total == requested_total
+
+
+def test_omny_formula_differs_from_flomni_and_lamni_formula():
+    """Cheap insurance against accidentally aliasing the wrong function into
+    a SETUP_PROFILES entry -- omny's math must not silently match flomni's
+    or lamni's."""
+    for stepsize in STEPSIZES:
+        flomni_total, flomni_step, _ = _compute_type1(180, stepsize)
+        lamni_total, lamni_step, _ = _lamni_compute_type1(360, stepsize)
+        omny_total, omny_step, _ = _compute_type1_omny(180, stepsize, 1)
+        assert (flomni_total, flomni_step) != (omny_total, omny_step)
+        assert (lamni_total, lamni_step) != (omny_total, omny_step)
+
+    for requested in (16, 32, 48, 64):
+        assert _requested_to_stepsize(180, requested) != _requested_to_stepsize_omny(
+            180, requested, 1
+        )
+
+
+def test_omny_tomo_types_have_correct_n_subtomos():
+    tomo_types = SETUP_PROFILES["omny"]["tomo_types"]
+    assert tomo_types[1]["n_subtomos"] == 2
+    assert tomo_types[4]["n_subtomos"] == 4
+    assert tomo_types[5]["n_subtomos"] == 8
+    assert tomo_types[2]["n_subtomos"] is None
+    assert tomo_types[3]["n_subtomos"] is None
+
+
+def test_setup_profiles_param_names_match_cli_class():
+    """Guards against the known mirror-drift risk: SETUP_PROFILES'
+    param_names must stay in sync with OMNY's own _TOMO_SCAN_PARAM_NAMES
+    (there is no shared import between bec_widgets and the ipython-client
+    plugins, so nothing else catches this)."""
+    assert set(SETUP_PROFILES["omny"]["param_names"]) == set(OMNY._TOMO_SCAN_PARAM_NAMES)
+    assert set(OMNY_QUEUE_PARAM_NAMES) == set(OMNY._TOMO_SCAN_PARAM_NAMES)
+
+
+def test_setup_profiles_omny_defaults_cover_all_param_names():
+    missing = set(OMNY_QUEUE_PARAM_NAMES) - set(OMNY_DEFAULTS)
+    assert not missing, f"omny profile is missing defaults for: {missing}"
+
+
+def test_omny_offset_fields_empty():
+    """OMNY has no alignment-offset concept in this widget (unlike lamni's
+    tomo_fovx_offset/tomo_fovy_offset) -- confirm the profile reflects that
+    rather than silently inheriting lamni's fields."""
+    assert SETUP_PROFILES["omny"]["offset_fields"] == []
+    assert SETUP_PROFILES["omny"]["offset_getter"] is None
+    assert SETUP_PROFILES["omny"]["offset_setter"] is None
+
+
+def test_omny_field_order_matches_flomni_minus_omny_only_gaps():
+    """flomni's own field_order minus frames_per_trigger/single_point --
+    OMNY has neither property."""
+    assert SETUP_PROFILES["omny"]["field_order"] == [
+        "tomo_countingtime",
+        "tomo_shellstep",
+        "fov",
+        "stitch",
+        "tomo_stitch_overlap",
+        "ptycho_reconstruct_foldername",
+        "manual_shift",
+        "at_each_angle_hook",
+    ]
+
+
+def test_omny_has_no_180_mode_single_point_or_zero_deg_reference():
+    profile = SETUP_PROFILES["omny"]
+    assert profile["has_180_mode"] is False
+    assert profile["has_single_point"] is False
+    assert profile["has_zero_deg_reference"] is False
+
+
+def test_compute_fermat_positions_omny_matches_scan_class_below_threshold():
+    params = {"fovx": 2.0, "fovy": 2.0, "tomo_shellstep": 2.0}
+    count, min_positions = _compute_fermat_positions_omny(params)
+    assert min_positions == OmnyFermatScan.MIN_POSITIONS
+    assert count < min_positions
+    expected = OmnyFermatScan.get_omny_fermat_spiral_pos(
+        -1.0, 1.0, -1.0, 1.0, step=2.0, spiral_type=0
+    )
+    assert count == len(expected)
+
+
+def test_compute_fermat_positions_omny_matches_scan_class_above_threshold():
+    params = {"fovx": 20.0, "fovy": 20.0, "tomo_shellstep": 1.0}
+    count, min_positions = _compute_fermat_positions_omny(params)
+    assert count >= min_positions
+
+
+def test_compute_fermat_positions_omny_zero_step_is_safe():
+    count, min_positions = _compute_fermat_positions_omny(
+        {"fovx": 5.0, "fovy": 5.0, "tomo_shellstep": 0.0}
+    )
+    assert count == 0
+    assert min_positions == OmnyFermatScan.MIN_POSITIONS
+
+
+# --- _format_projections(): 3-way setup dispatch, including OMNY types 4/5 --
+
+
+def test_format_projections_dispatches_omny_job_types_1_4_5():
+    for tomo_type, n_subtomos in OMNY_TYPES_N_SUBTOMOS.items():
+        params = {"tomo_type": tomo_type, "tomo_angle_stepsize": 10.0, "fovx": 20.0, "fovy": 20.0}
+        N = int(180.0 / 10.0)
+        assert _format_projections(params) == str(N * n_subtomos)
+
+
+def test_format_projections_omny_golden_types_unaffected():
+    params = {"tomo_type": 2, "fovx": 20.0, "golden_max_number_of_projections": 500}
+    assert _format_projections(params) == "500"
+
+    params_infinite = {"tomo_type": 2, "fovx": 20.0, "golden_max_number_of_projections": 0}
+    assert _format_projections(params_infinite) == "∞"
+
+
+def test_format_projections_still_distinguishes_flomni_and_lamni_jobs():
+    """Regression guard: adding the omny branch must not break the existing
+    flomni/lamni duck-typing."""
+    flomni_params = {"tomo_type": 1, "tomo_angle_range": 180, "tomo_angle_stepsize": 10.0}
+    lamni_params = {"tomo_type": 1, "tomo_angle_stepsize": 10.0}  # no tomo_angle_range, no fovx
+
+    flomni_N = int(180.0 / 10.0)
+    assert _format_projections(flomni_params) == str(flomni_N * 8)
+
+    lamni_N = int(360.0 / 10.0)
+    assert _format_projections(lamni_params) == str(lamni_N * 8)
+
+
+# --- _validate()'s tomo_type check: regression guard for the critical fix --
+
+
+def test_validate_tomo_type_condition_accepts_omny_types_4_and_5():
+    """_validate() used to hardcode `tomo_type not in (1, 2, 3)`, which would
+    silently reject every OMNY type-4/5 submission even though the rest of
+    the UI (combo box, section visibility) would appear to work. Tested here
+    as a standalone expression against the profile data (mirroring
+    _validate()'s post-fix condition) rather than requiring a live QWidget
+    instance."""
+    tomo_types = SETUP_PROFILES["omny"]["tomo_types"]
+    for tomo_type in (1, 2, 3, 4, 5):
+        assert tomo_type in tomo_types, f"tomo_type {tomo_type} should be valid for omny"
+    for invalid in (0, 6, 99, None):
+        assert invalid not in tomo_types, f"tomo_type {invalid} should be rejected for omny"

From 6691f51bd2a6ccb4f0bf92a50e00a05c9f3f64b5 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 11:05:18 +0200
Subject: [PATCH 034/102] feat(omny): save reference images at sample-transfer
 confirm checkpoints

Mirrors flomni's ftransfer_confirm()/save_reference_image() pattern, adapted
for OMNY's dual-camera-pair setup: whichever camera pair is currently shown
live (cam200+cam203 for parking/shuttle, cam201+cam202 for the sample
stage -- see _omnycam_parking()/_omnycam_samplestage() in gui_tools.py) gets
saved together into one HDF5 file at each manual confirm checkpoint in
_otransfer_confirm(), via the new _otransfer_save_reference_images().

X-ray eye alignment image/fit saving is left untouched -- it already exists
as shared code (x_ray_eye_align.py) but has known pre-existing OMNY/LamNI
naming bugs unrelated to this change.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/gui_tools.py                 |  7 +++
 .../omny/omny_sample_transfer_mixin.py        | 48 +++++++++++++++++--
 2 files changed, 52 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index 4a18db61..ffc7d1a1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -96,6 +96,12 @@ class OMNYGuiTools:
 
     def _omnycam_parking(self):
         self.omnygui_show_omnycam_parking()
+        # Recorded so omny_sample_transfer_mixin.py's _otransfer_confirm()
+        # knows which camera pair to save a reference image from -- OMNY
+        # always shows exactly one pair (parking/shuttle or sample stage)
+        # depending on where the gripper currently is, unlike flomni's
+        # fixed single gripper camera.
+        self._omnycam_active_pair = ("cam200", "cam203")
 
     def omnygui_show_omnycam_parking(self):
         self.omnygui_show_gui()
@@ -136,6 +142,7 @@ class OMNYGuiTools:
 
     def _omnycam_samplestage(self):
         self.omnygui_show_omnycam_samplestage()
+        self._omnycam_active_pair = ("cam201", "cam202")
 
     def omnygui_show_omnycam_samplestage(self):
         self.omnygui_show_gui()
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 05ac44fc..8375e6b5 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1,6 +1,8 @@
+import os
 import time
 import builtins
 
+import h5py
 import numpy as np
 
 from rich import box
@@ -740,6 +742,7 @@ class OMNYSampleTransferMixin:
         return bool(float(dev.otransy.controller.socket_put_and_receive("MGgrstat")))
 
     def otransfer_put_sample(self, pin_position: int):
+        self.transfer_step = 0
         self._otransfer_check_sensor_connected()
         if not self._otransfer_check_free_slot_available_at_position(pin_position, 0):
             raise OMNYTransferError(f"position {pin_position} is not free")
@@ -760,7 +763,7 @@ class OMNYSampleTransferMixin:
 
         print("The mount process started.")
 
-        self._otransfer_confirm()
+        self._otransfer_confirm(step_name="put")
         self._otransfer_controller_disable_mount_mode()
         # update the new sample status in storage
         self._otransfer_check_free_slot_available_at_position(pin_position, 1)
@@ -789,7 +792,7 @@ class OMNYSampleTransferMixin:
             self._otransfer_shield_close(pin_position)
         dev.omny_samples.show_all()
 
-    def _otransfer_confirm(self):
+    def _otransfer_confirm(self, step_name: str = ""):
         mntprgs = 1
 
         while mntprgs != 0:
@@ -820,10 +823,48 @@ class OMNYSampleTransferMixin:
                     text = "All OK? Please confirm"
 
                 if self.OMNYTools.yesno(text, "y"):
+                    self.transfer_step += 1
+                    self._otransfer_save_reference_images(file_suffix=f"{step_name}_{self.transfer_step}")
                     dev.otransy.controller.socket_put_confirmed("confirm=1")
                 else:
                     raise OMNYTransferError("The sample mount progress was aborted by user.")
 
+    def _otransfer_save_reference_images(self, file_suffix: str = "") -> None:
+        """Save the currently-active camera pair's last images to one HDF5
+        file -- OMNY's equivalent of flomni's ``save_reference_image()``,
+        called at each manual confirm checkpoint (see ``_otransfer_confirm``).
+
+        Unlike flomni (one fixed camera, ``cam_flomni_gripper``), OMNY
+        always shows exactly one *pair* of cameras live at a time --
+        parking/shuttle (cam200+cam203) or sample stage (cam201+cam202) --
+        depending on where the gripper currently is (see
+        ``_omnycam_parking()``/``_omnycam_samplestage()`` in gui_tools.py,
+        which record that pair on ``self._omnycam_active_pair``). Both
+        images from the active pair go into one file, keyed by camera name,
+        rather than flomni's single "reference_image" dataset.
+
+        IDSCamera's own ``get_last_image()`` is used directly (same as
+        ``x_ray_eye_align.py``'s ``update_frame()`` already does for
+        cam_xeye), rather than flomni's BEC-preview-redis-endpoint pull --
+        cam200-203 are IDSCamera, not the WebcamViewer class flomni's
+        cameras use.
+        """
+        pair = getattr(self, "_omnycam_active_pair", None)
+        if not pair:
+            print("No active OMNY camera pair known; skipping reference-image save.")
+            return
+        suffix = f"_{file_suffix}_" if file_suffix else "_"
+        timestamp = time.strftime("%Y%m%d_%H%M%S")
+        file = os.path.expanduser(
+            f"~/data/raw/logs/omny_sample_transfer_images/omny_sample_transfer_reference_image{suffix}{timestamp}.h5"
+        )
+        os.makedirs(os.path.dirname(file), exist_ok=True)
+        with h5py.File(file, "w") as f:
+            for cam_name in pair:
+                image = getattr(dev, cam_name).get_last_image()
+                if image is not None:
+                    f.create_dataset(cam_name, data=image)
+
     def _otransfer_check_sensor_connected(self):
         sensorvoltage = float(dev.otransy.controller.socket_put_and_receive("MG@AN[8001]"))
         gripper_sensorvoltagetarget = self._get_user_param_safe(
@@ -835,6 +876,7 @@ class OMNYSampleTransferMixin:
             )
 
     def otransfer_get_sample(self, pin_position: int):
+        self.transfer_step = 0
         self._omnycam_parking()
         if not self.OMNYTools.yesno(
             "Please confirm that currently there is no sample in the gripper. It would be dropped!",
@@ -875,7 +917,7 @@ class OMNYSampleTransferMixin:
 
         print("The Unmount process started.")
         time.sleep(1)
-        self._otransfer_confirm()
+        self._otransfer_confirm(step_name="get")
 
         self._otransfer_controller_disable_mount_mode()
         # update database

From 50d27585e5d867ac1bc23fa83bbe903242379c60 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 14:53:13 +0200
Subject: [PATCH 035/102] fix(omny): remove widget status-setting; fix inverted
 loadlock confirm
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- sample_storage.py: remove the "Set measured status…" context-menu action
  (and its now-unused write helper/constants) -- measured status is CLI-only
  (omny.otransfer_set_sample_status()/dev.omny_samples.set_sample_status()),
  not manually editable from the widget.
- omny_sample_transfer_mixin.py: otransfer_park_loadlock_slot()'s confirm
  check was inverted -- it raised on "y" (in back position) and proceeded
  on "n", exactly backwards. Pre-existing bug, found during sim testing.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../omny/omny_sample_transfer_mixin.py        |  2 +-
 .../widgets/sample_storage/sample_storage.py  | 74 -------------------
 2 files changed, 1 insertion(+), 75 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 8375e6b5..a82fc592 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -474,7 +474,7 @@ class OMNYSampleTransferMixin:
             )
         # if the valve of the loadlock is not closed, ask before movement
         # todo if(epics_get("XOMNY-ES1-LL1VG1:POSITION")!="CLOSED") {
-        if self.OMNYTools.yesno("Please confirm that the leica transfer is in back position."):
+        if not self.OMNYTools.yesno("Please confirm that the leica transfer is in back position."):
             raise OMNYTransferError("Leica shuttle is not in back position.")
         else:
             self._oparkz_leica_slot(slot_number)
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index e6120e13..e83b9b51 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -131,14 +131,6 @@ OMNY_PARKING_SLOTS = tuple(range(1, 7))
 # slots (which use EMPTY_NAME = "-"), parking slots are cleared to "none".
 PARKING_EMPTY_SENTINEL = "none"
 
-# Mirrors OMNYSampleStorage.STATUS_NONE/STATUS_STARTED/STATUS_COMPLETED's
-# int<->str mapping, duplicated locally rather than reaching into that
-# class's own (private) _status_str_to_val()/_status_val_to_str()
-# classmethods -- this widget already duplicates other device-side
-# conventions the same way (see EMPTY_NAME/PARKING_EMPTY_SENTINEL above).
-OMNY_STATUS_OPTIONS = ("none", "started", "completed")
-OMNY_STATUS_STR_TO_VAL = {"none": 0, "started": 1, "completed": 2}
-
 # colours
 # An occupied slot's name label intentionally has no fixed foreground colour
 # here (see _SlotCell.set_state()) -- it was previously hardcoded to
@@ -400,17 +392,10 @@ class _SlotCell(QFrame):
         menu = QMenu(self)
         if self._occupied:
             act_rename = menu.addAction("Change name…")
-            # OMNY-only (tuple key): measured status has a real EPICS
-            # channel there (see OMNY_SampleStorage), unlike FlOMNI's
-            # scan-lifecycle-driven redis log, which isn't manually
-            # editable from here.
-            act_status = menu.addAction("Set measured status…") if isinstance(self._slot, tuple) else None
             act_clear = menu.addAction("Clear (set empty)")
             chosen = menu.exec_(self.mapToGlobal(pos))
             if chosen == act_rename:
                 self._owner.action_change_name(self._slot, self._name, self._sample_owner)
-            elif act_status is not None and chosen == act_status:
-                self._owner.action_set_status(self._slot)
             elif chosen == act_clear:
                 self._owner.action_clear(self._slot)
         else:
@@ -875,39 +860,6 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             )
             return False
 
-    def _write_status_omny(self, key: tuple, status: str) -> bool:
-        """Write just the measured-status signal for an OMNY sample-kind
-        slot, leaving used/name/owner untouched -- the counterpart to
-        ``_write_slot_omny()`` resetting status on every name/owner write,
-        for the manual "Set measured status…" action (see
-        ``action_set_status``).
-        """
-        try:
-            val = OMNY_STATUS_STR_TO_VAL[status]
-            kind = key[0]
-            if kind == "stage":
-                self._samples.sample_in_samplestage_status.set(val)
-            elif kind == "gripper":
-                self._samples.sample_in_gripper_status.set(val)
-            elif kind == "O":
-                _, n = key
-                getattr(self._samples.sample_status, f"sample{n}").set(val)
-            elif kind == "shuttle":
-                _, letter, n = key
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_status"), f"sample{n}").set(val)
-            else:
-                raise ValueError(f"unknown OMNY slot key {key!r}")
-            self._last_state.pop(key, None)
-            return True
-        except Exception as exc:
-            logger.warning(f"OMNY_SampleStorage: write of status for slot {key} failed: {exc}")
-            QMessageBox.critical(
-                self,
-                "Write failed",
-                f"Could not write status for slot {self._slot_title(key)} to the device:\n{exc}",
-            )
-            return False
-
     def _write_parking_omny(self, slot_nr: int, letter: Optional[str]) -> bool:
         """Assign (or clear) which shuttle letter is recorded as parked at
         OMNY parking slot `slot_nr` (1-6), mirroring
@@ -1262,32 +1214,6 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if self._write_sample(slot, 0, EMPTY_NAME):
             self.refresh()
 
-    def action_set_status(self, slot: tuple) -> None:
-        """Manually set an OMNY sample-kind slot's measured status. OMNY
-        only (tuple key) -- see ``_SlotCell._show_menu``. FlOMNI's status
-        stays a separate, scan-lifecycle-driven redis log (see module
-        docstring), not exposed for manual editing here.
-        """
-        if not isinstance(slot, tuple):
-            return
-        current = self._last_state.get(slot, (False, "", "", None))[3] or "none"
-        try:
-            current_index = OMNY_STATUS_OPTIONS.index(current)
-        except ValueError:
-            current_index = 0
-        status, ok = QInputDialog.getItem(
-            self,
-            "Set measured status",
-            f"Status for slot {self._slot_title(slot)}:",
-            OMNY_STATUS_OPTIONS,
-            current_index,
-            False,
-        )
-        if not ok:
-            return
-        if self._write_status_omny(slot, status):
-            self.refresh()
-
     def action_set_parking(self, letter: str, current_slot: Optional[int]) -> None:
         """Assign OMNY shuttle `letter` to a parking slot (1-6), via
         ``_ShuttleStatusLabel``'s context menu. Overwrites that slot's

From 55f4638c78c1a5dc1f1ad955b3c8e0e1304caa63 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 15:03:23 +0200
Subject: [PATCH 036/102] fix(omny): widget STATUS_NONE client-proxy crash;
 otransfer_help() coverage

- sample_storage.py: _write_slot_omny() read self._samples.STATUS_NONE, a
  plain OMNYSampleStorage class attribute -- but self._samples is the BEC
  client-side device proxy, which only exposes signals and USER_ACCESS
  methods, not arbitrary class attributes. Every widget write to an OMNY
  slot raised "'Device' object has no attribute 'STATUS_NONE'". Replaced
  with a local OMNY_STATUS_NONE constant, same pattern already used for
  EMPTY_NAME/PARKING_EMPTY_SENTINEL.
- omny_sample_transfer_mixin.py: otransfer_help() now also prints
  dev.omny_samples.help()'s full command reference (set/unset slots,
  shuttles, gripper, sample stage, owner, measured status) instead of just
  pointing at it, so omny.otransfer_help() alone is a complete reference.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/omny_sample_transfer_mixin.py         |  8 ++++++--
 .../widgets/sample_storage/sample_storage.py           | 10 +++++++++-
 2 files changed, 15 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index a82fc592..90a3a0f3 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1571,5 +1571,9 @@ class OMNYSampleTransferMixin:
         print("omny.otransfer_get_sample(position)     pick with the gripper from <position>")
         print("omny.otransfer_put_sample(position)     put with the gripper to <position>")
         print("omny.otransfer_show_all()               show the full sample storage overview")
-        print("For the other storage commands (set/unset slots, shuttles, gripper, sample")
-        print("stage) see the omny.otransfer_* commands, or dev.omny_samples.help()")
+        print(
+            "The other storage commands (set/unset slots, shuttles, gripper, sample stage,"
+        )
+        print("owner, measured status) are also available as omny.otransfer_* -- see below:")
+        print()
+        dev.omny_samples.help()
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index e83b9b51..3d1c1d12 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -131,6 +131,14 @@ OMNY_PARKING_SLOTS = tuple(range(1, 7))
 # slots (which use EMPTY_NAME = "-"), parking slots are cleared to "none".
 PARKING_EMPTY_SENTINEL = "none"
 
+# Mirrors OMNYSampleStorage.STATUS_NONE, duplicated locally rather than read
+# off the device -- self._samples is the BEC *client-side* device proxy,
+# which only exposes USER_ACCESS methods/signals, not plain class
+# attributes like STATUS_NONE (reaching for self._samples.STATUS_NONE
+# raised "'Device' object has no attribute 'STATUS_NONE'" here, even though
+# it works when testing directly against the real device class).
+OMNY_STATUS_NONE = 0
+
 # colours
 # An occupied slot's name label intentionally has no fixed foreground colour
 # here (see _SlotCell.set_state()) -- it was previously hardcoded to
@@ -823,7 +831,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         module docstring).
         """
         try:
-            status_none = self._samples.STATUS_NONE
+            status_none = OMNY_STATUS_NONE
             kind = key[0]
             if kind == "stage":
                 self._samples.sample_in_samplestage.set(used)

From 6291f6196b5acbc24f8e88c2e9561ad4aaa531b6 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 15:12:03 +0200
Subject: [PATCH 037/102] docs(omny): add sample-storage testing checklist

Covers the OMNY_SampleStorage widget, the real owner + measured-status
EPICS channel, the otransfer_* CLI wrappers, and transfer reference-image
saving -- so it can be pulled to a separate session/machine for testing.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../AI_docs/SAMPLE_STORAGE_TEST_CHECKLIST.md  | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/SAMPLE_STORAGE_TEST_CHECKLIST.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/SAMPLE_STORAGE_TEST_CHECKLIST.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/SAMPLE_STORAGE_TEST_CHECKLIST.md
new file mode 100644
index 00000000..21f47040
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/SAMPLE_STORAGE_TEST_CHECKLIST.md
@@ -0,0 +1,66 @@
+# OMNY sample-storage testing checklist (as of 2026-09-04)
+
+For live/sim testing of this branch's (`update-omny`) sample-storage work: the
+`OMNY_SampleStorage` widget's OMNY support, the real owner + measured-status EPICS
+channel, and the `omny.otransfer_*` CLI wrappers. Written so this can be pulled and
+run from a separate session/machine. See `OPEN_ISSUES.md` for the broader OMNY
+live-testing effort this is part of.
+
+## Widget — `OMNY_SampleStorage`
+
+- [ ] Open the widget in an OMNY session — header (stage+gripper) + fixed-O grid + 3
+      shuttle group boxes render, no "no known setup" banner.
+- [ ] Occupied slots show names in legible text (not near-invisible — this was a
+      dark-theme contrast bug, fixed).
+- [ ] Right-click an empty slot → **New sample…** → name + owner (both required,
+      empty owner rejected) → slot fills in without an error (a `STATUS_NONE`
+      crash here was fixed — client-side device proxies don't expose plain class
+      attributes, only signals/USER_ACCESS methods).
+- [ ] Duplicate name (matching another occupied slot) → rejected with a clear
+      message; renaming a slot to its own existing name is still fine.
+- [ ] Right-click an occupied slot → menu shows only **Change name…** / **Clear
+      (set empty)** — no "Set measured status…" (removed; status is CLI-only now).
+- [ ] **Clear (set empty)** works without error.
+- [ ] Each shuttle's status line: right-click → **Set parking slot…** (1-6) /
+      **Clear parking assignment** — shows "Slot N" / "not parked". The
+      "● ACTIVE" badge needs `oparkz` sitting at a real target position (2-6);
+      may not be easy to trigger from sim unless you drive that motor there.
+- [ ] **Print** button builds a PDF (expect a "printer not available" message
+      unless you have a `WSLA_X12SA` CUPS queue locally — not a bug).
+
+## CLI (`omny.otransfer_*`)
+
+- [ ] Tab-complete `omny.otransfer_` — lists ~22 commands (`otransfer_show_all`,
+      `otransfer_set_sample_status`, `otransfer_get_sample_owner`, etc.).
+- [ ] `omny.otransfer_help()` — prints the transfer commands **and then the full
+      `dev.omny_samples.help()` reference** below it, in one call.
+- [ ] `omny.otransfer_show_all()` — table shows `(owner)` and
+      `◐ started`/`✓ completed` suffixes on occupied slots.
+- [ ] `dev.omny_samples.set_sample_slot('A', 4, 'testsample', 'yourname')` then
+      `dev.omny_samples.get_sample_name_and_owner('A', 4)` round-trips.
+- [ ] `omny.otransfer_set_sample_status('A', 1, 'started')` / `'completed'` /
+      `'none'` — status is settable from the CLI (by design; not from the widget).
+- [ ] `omny.otransfer_park_loadlock_slot(6)` → answer **y** to "in back position"
+      → should now proceed (drive to the slot) instead of raising
+      `OMNYTransferError` (was inverted — pre-existing bug, fixed); answer **n**
+      → should correctly abort with that error.
+
+## Transfer reference-image saving
+
+Depends on whether your session drives the Galil `MGconfirm`/`MGmntprgs`
+handshake (`_otransfer_confirm()`) — may not fire in a lightweight sim.
+
+- [ ] Run `omny.otransfer_put_sample(...)` / `otransfer_get_sample(...)` through a
+      confirm checkpoint → check `~/data/raw/logs/omny_sample_transfer_images/`
+      for a new `.h5` file with both cameras of whichever pair was active
+      (parking `cam200`/`cam203` vs stage `cam201`/`cam202`).
+- [ ] If the handshake doesn't fire: `omny._otransfer_save_reference_images(file_suffix='test')`
+      after opening a camera view (e.g. `omny.otransfer_park_slot(3)`) to set
+      `_omnycam_active_pair` — same effect, minus the physical move.
+
+## X-ray eye alignment — known incomplete, not this branch's scope
+
+The fit+image saving in `x_ray_eye_align.py` is shared code (also used by FlOMNI/LamNI)
+and should already work in principle, but it has pre-existing OMNY/LamNI method-name
+mismatches (e.g. `self.lfzp_in()`) that likely block the actual click-through run from
+completing for OMNY. Not fixed this pass — flag if you hit it.

From 89056e5a527d9f4ad2e141b6e3bc358a35c8b1d4 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 15:12:41 +0200
Subject: [PATCH 038/102] docs(omny): add tomo-scan/queue/widget live-testing
 checklist

Written so Mirko can pull this and run through it from his own machine --
covers the Phase 2 widget (untested, includes the critical type-4/5
_validate() fix), the progress-GUI/idle-time/timing-summary changes, first
real end-to-end tomo-queue runs, and the advanced tomo modes' full scans
(only parameters were tested so far). Mirrors SAMPLE_STORAGE_TEST_CHECKLIST.md's
format/purpose for the concurrent sample-storage work.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md  | 59 +++++++++++++++++++
 1 file changed, 59 insertions(+)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
new file mode 100644
index 00000000..1ec26493
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
@@ -0,0 +1,59 @@
+# OMNY tomo-scan/tomo-queue/widget testing checklist (as of 2026-09-04)
+
+For live/sim testing of this branch's (`update-omny`) tomo-scan work: the tomo-queue backend
+(`TomoQueueMixin`, Phase 1), the progress-ring GUI + idle-time tracking + end-of-scan timing
+summary, the `~/data/raw/` path fixes, and the `OMNY_TomoParams` widget's OMNY support (Phase 2).
+Written so this can be pulled and run from a separate session/machine. See `OPEN_ISSUES.md` for
+the broader OMNY live-testing effort this is part of.
+
+## Widget — `OMNY_TomoParams` (never tested live, highest priority)
+
+- [ ] Open `OMNY_TomoParams` against the OMNY session — it detects `"omny"` (not flomni/lamni),
+      no "no known setup" banner.
+- [ ] Cycle through all 5 tomo types in the dropdown — the "Equally spaced sub-tomograms" section
+      shows for types 1/4/5 and hides for 2/3; the "Sub-tomograms" label reads 2/4/8 correctly for
+      each.
+- [ ] **Submit or queue a type-4 and a type-5 job specifically** — a hardcoded validation bug
+      (`tomo_type not in (1, 2, 3)`) would have silently rejected these before the fix; this is
+      the single most important check on this list.
+- [ ] Check a queued type-4/5 job's tooltip and the "Projections" column in the queue dialog show
+      correct values.
+- [ ] Shrink FOV/step until the Fermat-position count drops low enough to trigger the orange
+      warning / blocked submit — compare against the CLI's `tomo_parameters()` warning for the
+      same values.
+
+## Progress GUI / idle-time / timing summary (recently changed)
+
+- [ ] Run a real scan and watch the progress window — it should **not** re-raise/refocus on every
+      projection anymore (was "closing and reopening" on macOS).
+- [ ] Progress bar shows **3 rings** now (third one auto-tracks the live scan itself).
+- [ ] After a completed `tomo_scan()`, the end-of-scan summary prints: "Total measurement time" /
+      "...excluding detected gaps" / "...lost to detected gaps".
+- [ ] Interrupt and resume a scan (or otherwise create a gap) — confirm idle time is picked up in
+      that summary instead of showing 0.
+
+## Tomo-queue backend, first real end-to-end runs
+
+- [ ] `tomo_queue_execute()` on a real queued job, not just add/show.
+- [ ] `tomo_scan_resume()` after interrupting a scan.
+- [ ] `tomo_queue_reacquire()` — try it on both a type-1 job and a type-4/5 job (the
+      `_TOMO_TYPE_1_LIKE` generalization is new).
+
+## Advanced tomo modes — parameters were tested, full scans weren't
+
+- [ ] A real `omny.tomo_scan()` for type 2 (golden ratio) and type 3 (golden-start), not just
+      setting parameters via `tomo_parameters()`.
+- [ ] A real full scan for type 4 and type 5 (4/8 sub-tomograms).
+
+## Smaller fixes
+
+- [ ] `tomography_scannumbers.txt` and the PDF report land under `~/data/raw/...` (not the old
+      `~/Data10/...`, which doesn't exist on a fresh machine).
+- [ ] If your session has scilog configured: `write_to_scilog()`/the PDF report actually send
+      (rather than just skip with a "scilog is not enabled" warning).
+
+## Already confirmed working live (informational, not re-testing needed)
+
+- `omny.tomo_scan()`/`omny.tomo_queue_add()`/`omny.tomo_queue_show()` for tomo_type 1 — "tomo
+  scan and tomo queue seems to work now for omny."
+- `tomo_parameters()`'s "too few Fermat scan points" CLI warning.

From 0bdd20013b42c48cb13f4734100c178ff2eb8fbf Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 15:28:27 +0200
Subject: [PATCH 039/102] fix(omny): catch KeyboardInterrupt around frozen-GUI
 raise_window() calls

A Ctrl+C landing during raise_window()'s RPC wait (e.g. when the GUI
process is frozen/unresponsive) was escaping two `except Exception`
handlers that don't catch KeyboardInterrupt (a BaseException sibling,
not an Exception subclass): omnygui_show_progress() aborted the whole
tomo_scan()/tomo_scan_resume() call instead of just skipping the
window-raise, and tomo_queue_execute() left the job silently stuck at
status="running" instead of the usual clean "incomplete" + explanatory
message. Reproduced live by Mirko via the tomo queue.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/OMNY_shared/tomo_queue_mixin.py   |  9 ++-
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 66 +++++++++++++++++++
 .../plugins/omny/gui_tools.py                 | 11 ++++
 .../test_omny_gui_tools.py                    | 15 +++++
 .../test_omny_tomo_queue.py                   | 22 +++++++
 5 files changed, 122 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
index c26f7fa2..fc142da3 100644
--- a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
@@ -916,7 +916,14 @@ class TomoQueueMixin:
                         # never block on input() -- see LamNI.tomo_scan()'s
                         # fine-alignment check.
                         self.tomo_scan(interactive=False)
-            except Exception as exc:
+            except (Exception, KeyboardInterrupt) as exc:
+                # KeyboardInterrupt is a BaseException, not an Exception -- a
+                # bare `except Exception` misses it, leaving the job stuck at
+                # status="running" with no explanation the next time the
+                # queue is inspected (confirmed live: a Ctrl+C landing during
+                # tomo_scan_resume()'s GUI-raise call produced exactly this --
+                # a silent "running" job and a raw traceback instead of the
+                # informative message below).
                 self._tomo_queue_proxy.update_by_id(job_id, status="incomplete")
                 print(f"Tomo queue job '{label}' did not complete: {exc}")
                 print(
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 086c1ad1..efab46ed 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -45,6 +45,14 @@ ported to OMNY (Phase 2 of 2)" below. Mirko: "is the way to move to the widget p
 that. No live GUI verification yet (needs a real display, same as every other GUI change this
 branch) -- next step is Mirko trying it against a real OMNY session.
 
+**Just fixed following Mirko's next round of live testing (from the test checklist)**: a
+Ctrl+C during `tomo_queue_resume()`'s GUI-raise call (triggered by a frozen/unresponsive GUI
+process) was escaping as a raw `KeyboardInterrupt` instead of being handled gracefully, in two
+places -- see "KeyboardInterrupt during a frozen-GUI raise_window() call was not caught" below.
+The underlying GUI freeze itself, and a separate "two items in the server queue... after
+clearing it also did not resume" report, are not yet explained -- need more detail from Mirko
+(see that section's last paragraph).
+
 **Still open / deferred** (unchanged from before, not touched this pass):
 - `x_ray_eye_align.py` is still LamNI-derived, unadapted code beyond the two call-site renames
   that unblocked the GUI-open crash — see its own section below. The GUI itself opens fine now;
@@ -543,6 +551,64 @@ equally-spaced section shows/hides correctly and the new sub-tomogram-count labe
 submitting/queueing a type-4 or type-5 job (confirms the `_validate()` fix specifically), and
 checking a queued job's tooltip/Projections column in the queue dialog.
 
+## KeyboardInterrupt during a frozen-GUI raise_window() call was not caught (fixed)
+
+Mirko, running from the tomo queue on his own machine: aborted a running scan with Ctrl+C
+(worked correctly -- clean `ScanInterruption: User abort`, queue paused, job marked
+`"incomplete"`), then called `omny.tomo_queue_resume()` twice; the second call, while
+`tomo_scan_resume()` was starting up, produced a **raw Python `KeyboardInterrupt` traceback**
+instead of BEC's usual graceful abort. Separately: "the gui progress and tomo parameters was
+open and both a frozen on my local machine", and "i had two items in the server queue... after
+clearing it also did not resume."
+
+Root cause, read straight off the traceback: the stack bottomed out in
+`self.gui.omny.raise_window()` -> `bec_widgets`' `RPCBase._run_rpc()`, blocked on
+`self._msg_wait_event.wait(...)`. `tomo_scan()` calls `omnygui_show_progress()`
+(-> `omnygui_show_gui()` -> `raise_window()`) unconditionally as its first line, on every call
+including `tomo_scan_resume()`. When the GUI process itself is frozen/unresponsive (matching
+Mirko's separate "both frozen on my local machine" report), that RPC call doesn't hang forever --
+`bec_widgets`' default RPC timeout is 60s (`BECGuiClient._rpc_timeout`, `client_utils.py`), after
+which it raises a clean `RPCResponseTimeoutError` -- but 60s is a long, silent wait for an
+operator watching a terminal, and Mirko understandably lost patience and hit Ctrl+C himself
+during that wait. `KeyboardInterrupt` is a `BaseException`, not an `Exception` subclass, so it
+sailed straight past two different `except Exception` handlers that were supposed to catch
+exactly this kind of trouble:
+
+1. `omnygui_show_progress()` (`gui_tools.py`) already wrapped the whole show/raise sequence in
+   `try/except Exception` specifically so a GUI hiccup can never abort a scan -- but a
+   `KeyboardInterrupt` escaped it outright, propagating all the way up through
+   `tomo_scan_resume()`. **Fixed**: added a dedicated `except KeyboardInterrupt` clause that logs
+   a warning and continues without raising the window -- bringing the window to front is a
+   nicety, not something the scan itself needs.
+2. `tomo_queue_execute()` (`tomo_queue_mixin.py`)'s `except Exception as exc:` around the
+   `tomo_scan()`/`tomo_scan_resume()` call is what marks a job `status="incomplete"` and prints
+   the informative "Tomo queue job '...' did not complete: ... Queue paused..." message -- the
+   same message Mirko saw work correctly on the *first* abort. A `KeyboardInterrupt` escaping this
+   handler leaves the job silently stuck at `status="running"` with no explanation printed at all,
+   which is exactly what "I had two items in the server queue. I do not have details" describes.
+   **Fixed**: widened to `except (Exception, KeyboardInterrupt) as exc:`, so any interruption --
+   not just a raised `Exception` -- gets the same clean status update and message.
+
+Both fixes are narrowly scoped (they don't change how Ctrl+C is handled *during* an actual running
+scan -- BEC's own deferred-pause/abort alarm flow for that is untouched) and only change what
+happens when the interrupt lands during the pre-scan GUI-raise window. Regression tests:
+`test_omnygui_show_progress_swallows_keyboardinterrupt_from_frozen_gui` (`gui_tools.py`'s
+`raise_window()` mocked to raise `KeyboardInterrupt`, asserts `omnygui_show_progress()` doesn't
+propagate it) and `test_tomo_queue_execute_marks_job_incomplete_on_keyboardinterrupt`
+(`tomo_scan` mocked to raise `KeyboardInterrupt`, asserts the job ends up `"incomplete"` not
+`"running"`, and that the interrupt still propagates to the caller afterward -- it's not
+swallowed, just handled the same way any other mid-job exception already was).
+
+**Still unexplained, needs more detail from Mirko to pursue further**: "i had two items in the
+server queue" and "after clearing it also did not resume" -- ambiguous whether "server queue"
+means the OMNY-side `tomo_queue` (this session's job list, cleared via `tomo_queue_clear()`, which
+is fully destructive -- if that's what was cleared, "did not resume" is expected, there was
+nothing left to resume) or BEC's own scan-server execution queue (a lower-level, separate concept;
+inspectable via `bec.queue.scan_queue_status()` or the BECQueue GUI widget). Also unclear whether
+the underlying GUI freeze itself (client-side Qt process on Mirko's Mac) has a deeper cause worth
+chasing, or was a one-off. Not reproduced live this pass -- Mirko: "i cannot move to the machine
+you are running on with my tests now."
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index ffc7d1a1..e770cf2a 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -220,6 +220,17 @@ class OMNYGuiTools:
                 self.progressbar.add_ring().set_update("manual")
                 self.progressbar.add_ring().set_update("scan")
             self._omnygui_update_progress()
+        except KeyboardInterrupt:
+            # A frozen/unresponsive GUI process makes raise_window() block on
+            # its RPC wait (up to the client's ~60s default timeout) -- if the
+            # operator loses patience and hits Ctrl+C during that wait, don't
+            # let it escape as a raw KeyboardInterrupt and abort the whole
+            # tomo_scan()/tomo_scan_resume() call: bringing the window to
+            # front is a nicety, not something the scan itself needs.
+            logger.warning(
+                "omnygui_show_progress() interrupted (GUI unresponsive?) -- continuing "
+                "without raising the window."
+            )
         except Exception as e:
             logger.warning(f"Error in omnygui_show_progress: {e}")
 
diff --git a/tests/tests_bec_ipython_client/test_omny_gui_tools.py b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
index 55e54dd5..9e50bf59 100644
--- a/tests/tests_bec_ipython_client/test_omny_gui_tools.py
+++ b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
@@ -183,6 +183,21 @@ def test_omnygui_show_progress_creates_three_rings_matching_flomni():
     ring3.set_update.assert_called_once_with("scan")
 
 
+def test_omnygui_show_progress_swallows_keyboardinterrupt_from_frozen_gui():
+    """A frozen/unresponsive GUI process makes raise_window()'s RPC wait block
+    for up to the client's default timeout; an operator losing patience and
+    hitting Ctrl+C during that wait must not abort the calling tomo_scan()/
+    tomo_scan_resume() with a raw KeyboardInterrupt -- confirmed live: this
+    is exactly what happened, since a bare `except Exception` does not catch
+    KeyboardInterrupt (a BaseException sibling, not a subclass)."""
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    client.gui.omny.raise_window.side_effect = KeyboardInterrupt()
+    tools.progressbar = mock.MagicMock()
+
+    tools.omnygui_show_progress()  # must not raise
+
+
 def test_omnygui_update_progress_text_includes_start_eta_finish():
     tools, _ = _make_gui_tools()
     tools.progressbar = mock.MagicMock()
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
index 6ad9cca9..7627cd53 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
@@ -138,6 +138,28 @@ def test_tomo_queue_execute_resumes_incomplete_job():
     assert job["status"] == "done"
 
 
+def test_tomo_queue_execute_marks_job_incomplete_on_keyboardinterrupt():
+    """KeyboardInterrupt is a BaseException, not an Exception -- a bare
+    `except Exception` around the tomo_scan()/tomo_scan_resume() call would
+    miss it, leaving the job silently stuck at status="running" with no
+    explanation. Confirmed live: a Ctrl+C landing during tomo_scan_resume()'s
+    GUI-raise call produced exactly that (plus a raw traceback instead of the
+    informative "Queue paused..." message)."""
+    omny = make_omny()
+    omny.tomo_scan = lambda *a, **k: (_ for _ in ()).throw(KeyboardInterrupt())
+
+    omny.tomo_queue_add(label="job1")
+    try:
+        omny.tomo_queue_execute()
+        raised = False
+    except KeyboardInterrupt:
+        raised = True
+
+    assert raised
+    job = omny._tomo_queue_proxy.as_list()[0]
+    assert job["status"] == "incomplete"
+
+
 def test_tomo_queue_add_command_move_action(monkeypatch):
     omny = make_omny()
     fake_dev = {"ccm_energy": "ccm-energy-device"}

From 70696756f169934cbc4faf8b0e53cf09b9262dc5 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 15:52:52 +0200
Subject: [PATCH 040/102] fix(omny): stop polling sample name via a device_rpc
 queue round-trip

OMNY_TomoParams's poll timer called sample_name_getter every tick,
which for OMNY was dev.omny_samples.get_sample_name_in_samplestage()
-- a device method, dispatched by BEC as a device_rpc request through
the scan queue rather than a local read. With the queue busy or
paused this blocked the widget's Qt thread (GUI freeze while a scan
ran) and piled up duplicate PENDING device_rpc entries in BEC's
primary queue (confirmed live via bec.queue.queue_storage
.describe_queue()). The method was just a one-line wrapper around an
already-readable EpicsSignal, so read it directly with cached=True
instead, matching flomni's fast-getter pattern and avoiding even the
signal round-trip. Also applied cached=True to flomni's own getter,
which didn't have the device_rpc bug but is polled the same way.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 45 ++++++++++++----
 .../widgets/tomo_params/tomo_params.py        | 31 ++++++++++-
 .../test_omny_tomo_params_widget_math.py      | 51 +++++++++++++++++++
 .../test_tomo_params_widget_math.py           | 35 +++++++++++++
 4 files changed, 151 insertions(+), 11 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index efab46ed..5b1ed802 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -599,15 +599,42 @@ propagate it) and `test_tomo_queue_execute_marks_job_incomplete_on_keyboardinter
 `"running"`, and that the interrupt still propagates to the caller afterward -- it's not
 swallowed, just handled the same way any other mid-job exception already was).
 
-**Still unexplained, needs more detail from Mirko to pursue further**: "i had two items in the
-server queue" and "after clearing it also did not resume" -- ambiguous whether "server queue"
-means the OMNY-side `tomo_queue` (this session's job list, cleared via `tomo_queue_clear()`, which
-is fully destructive -- if that's what was cleared, "did not resume" is expected, there was
-nothing left to resume) or BEC's own scan-server execution queue (a lower-level, separate concept;
-inspectable via `bec.queue.scan_queue_status()` or the BECQueue GUI widget). Also unclear whether
-the underlying GUI freeze itself (client-side Qt process on Mirko's Mac) has a deeper cause worth
-chasing, or was a one-off. Not reproduced live this pass -- Mirko: "i cannot move to the machine
-you are running on with my tests now."
+**Follow-up, fully explained and fixed**: Mirko confirmed "i was talking becs own queue" (BEC's
+own scan-server execution queue, not `tomo_queue`), and separately noticed "the gui is essentially
+freezing while a scan is running... pressing queue control in the params gui, the window only
+opened after the scan finished." Caught live with a stuck queue: `bec.queue.queue_storage
+.describe_queue()` showed **two duplicate `device_rpc` entries stuck PENDING**, both
+`device='omny_samples', func='get_sample_name_in_samplestage'` (different RIDs -- two separate
+invocations), plus one `func='stop'` (routine BEC abort cleanup, unrelated), all stuck because the
+queue was `PAUSED` from the earlier abort and never got serviced.
+
+Root cause: `OMNY_TomoParams`'s poll timer (`_on_poll()` -> `_refresh_sample_name()`,
+`tomo_params.py`) calls `SETUP_PROFILES["omny"]["sample_name_getter"]` on every tick.
+It was `lambda w: w.dev.omny_samples.get_sample_name_in_samplestage()` -- a device *method* call,
+which BEC dispatches as a `device_rpc` request through the scan queue (a real round-trip), unlike
+flomni's getter (`w.dev.flomni_samples.sample_names.sample0.get()`, a direct signal read) or
+lamni's (`w.client.get_global_var(...)`, a Redis read). Polling a queue-mediated call every tick
+means: (a) it blocks the widget's Qt thread waiting on the round-trip, so a busy/paused queue
+freezes the *entire* GUI including unrelated actions like opening the queue-control dialog, and
+(b) each tick fires a *new* request without checking if the previous one is still outstanding, so
+they pile up as duplicate PENDING entries whenever the queue can't service them promptly --
+exactly what the "two items in the server queue" report was.
+
+`get_sample_name_in_samplestage()` (`omny_sample_storage.py:453-455`) turned out to be a one-line
+wrapper: `return str(self.sample_in_samplestage_name.get())`, around an `auto_monitor=True`
+EpicsSignal that's already directly readable. **Fixed**: `sample_name_getter` now reads
+`w.dev.omny_samples.sample_in_samplestage_name.get(cached=True)` directly, matching flomni's
+fast-getter pattern -- no more device_rpc round-trip, so no more GUI freeze and no more duplicate
+queue entries from this source. Mirko, from prior advice from BEC developers: GUI code should
+prefer `cached=True` where possible -- checked `DeviceBase.get()` (`bec_lib/device.py`): without
+it, `.get()` still issues a live `self._run(cached=False, ...)` round-trip to the device server;
+`cached=True` reads BEC's already-locally-updated status cache instead, no round-trip at all, so
+used it here too (there's existing precedent for this exact pattern in GUI code, e.g.
+`sample_storage.py`'s `oparkz.readback.get(cached=True)`). Regression test:
+`test_omny_sample_name_getter_reads_signal_not_rpc_method` (fake device whose
+`get_sample_name_in_samplestage()` raises `AssertionError` if called, and whose fake signal
+records its `cached` kwarg -- confirms both that the getter only touches the signal and that it
+passes `cached=True`).
 
 ## Environment note (not code, but will bite again if forgotten)
 
diff --git a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
index bab239fd..df9cc913 100644
--- a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
+++ b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
@@ -2439,7 +2439,13 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         "requested_to_stepsize": _requested_to_stepsize,
         "compute_fermat_positions": _compute_fermat_positions_flomni,
         "fermat_position_fields": ["tomo_shellstep", "fovx", "fovy"],
-        "sample_name_getter": lambda w: w.dev.flomni_samples.sample_names.sample0.get(),
+        # cached=True: no active bug here (this was always a direct signal
+        # read, never the device-method/device_rpc round-trip OMNY's getter
+        # had -- see SETUP_PROFILES["omny"]["sample_name_getter"]), but
+        # since this is also polled every tick (_on_poll()), avoid the live
+        # self._run(cached=False, ...) round-trip on principle -- standard
+        # advice for GUI/widget code.
+        "sample_name_getter": lambda w: w.dev.flomni_samples.sample_names.sample0.get(cached=True),
         "cli_hint_name": "flomni",
         "tomo_types": {
             1: {"label": "8 equally spaced sub-tomograms", "n_subtomos": 8},
@@ -2547,7 +2553,28 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         "requested_to_stepsize": _requested_to_stepsize_omny,
         "compute_fermat_positions": _compute_fermat_positions_omny,
         "fermat_position_fields": ["tomo_shellstep", "fovx", "fovy"],
-        "sample_name_getter": lambda w: w.dev.omny_samples.get_sample_name_in_samplestage(),
+        # Read the signal directly with cached=True (like flomni's own
+        # getter), not the get_sample_name_in_samplestage() wrapper method:
+        # a device *method* call is dispatched as a device_rpc request
+        # through BEC's scan queue -- a real round-trip, not a local read --
+        # so polling it every tick (see _on_poll()/_refresh_sample_name())
+        # blocks the widget's Qt thread whenever the queue is busy/paused,
+        # and piles up duplicate PENDING device_rpc entries in BEC's primary
+        # queue when it is. Confirmed live: two duplicate
+        # get_sample_name_in_samplestage device_rpc entries stuck PENDING
+        # after an abort left the queue paused, plus a GUI freeze while a
+        # scan was running -- the wrapper method itself is just
+        # `return str(self.sample_in_samplestage_name.get())`
+        # (omny_sample_storage.py), so reading the signal directly is
+        # equivalent and free of both problems. cached=True goes one step
+        # further: without it, DeviceBase.get() still issues a live
+        # `self._run(cached=False, ...)` round-trip to the device server;
+        # cached=True reads BEC's already-locally-updated status cache
+        # instead, no round-trip at all -- standard advice for GUI/widget
+        # code (see e.g. sample_storage.py's oparkz.readback.get(cached=True)).
+        "sample_name_getter": lambda w: w.dev.omny_samples.sample_in_samplestage_name.get(
+            cached=True
+        ),
         "cli_hint_name": "omny",
         # OMNY has three "equally spaced sub-tomograms" flavors (2/4/8
         # sub-tomograms), unlike flomni's/lamni's single always-8 flavor --
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
index 6146c670..f39de1bd 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
@@ -197,3 +197,54 @@ def test_validate_tomo_type_condition_accepts_omny_types_4_and_5():
         assert tomo_type in tomo_types, f"tomo_type {tomo_type} should be valid for omny"
     for invalid in (0, 6, 99, None):
         assert invalid not in tomo_types, f"tomo_type {invalid} should be rejected for omny"
+
+
+# --- sample_name_getter: regression guard against the device_rpc polling bug --
+
+
+def test_omny_sample_name_getter_reads_signal_not_rpc_method():
+    """sample_name_getter used to call get_sample_name_in_samplestage(), a
+    device *method* -- dispatched by BEC as a device_rpc request through the
+    scan queue, a real round-trip, not a local read. The widget's poll timer
+    calls this every tick (_on_poll()/_refresh_sample_name()), so with the
+    queue busy or paused this blocked the widget's Qt thread (GUI "freeze"
+    while a scan ran) and piled up duplicate PENDING device_rpc entries in
+    BEC's primary queue (confirmed live, two stuck entries after an abort
+    left the queue paused). The method itself is just
+    `return str(self.sample_in_samplestage_name.get())`
+    (omny_sample_storage.py) -- fixed to read that signal directly, matching
+    flomni's own getter's pattern (a direct .get(), no RPC)."""
+
+    class _FakeSignal:
+        def __init__(self, value):
+            self._value = value
+            self.get_calls = []
+
+        def get(self, cached=False):
+            self.get_calls.append(cached)
+            return self._value
+
+    class _FakeOmnySamples:
+        def __init__(self):
+            self.sample_in_samplestage_name = _FakeSignal("my_sample")
+
+        def get_sample_name_in_samplestage(self):
+            raise AssertionError(
+                "sample_name_getter must not call the device_rpc-dispatched "
+                "method -- it should read the signal directly"
+            )
+
+    class _FakeDev:
+        omny_samples = _FakeOmnySamples()
+
+    class _FakeWidget:
+        dev = _FakeDev()
+
+    signal = _FakeDev.omny_samples.sample_in_samplestage_name
+    result = SETUP_PROFILES["omny"]["sample_name_getter"](_FakeWidget())
+
+    assert result == "my_sample"
+    # cached=True avoids DeviceBase.get()'s live self._run(cached=False, ...)
+    # round-trip to the device server, reading BEC's local status cache
+    # instead -- standard advice for GUI/widget code.
+    assert signal.get_calls == [True]
diff --git a/tests/tests_bec_ipython_client/test_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_tomo_params_widget_math.py
index 1f1b1f6f..2f4f77ac 100644
--- a/tests/tests_bec_ipython_client/test_tomo_params_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_tomo_params_widget_math.py
@@ -10,6 +10,7 @@ import pytest
 
 from csaxs_bec.bec_ipython_client.plugins.flomni.flomni import Flomni
 from csaxs_bec.bec_widgets.widgets.tomo_params.tomo_params import (
+    SETUP_PROFILES,
     _compute_fermat_positions_flomni,
     _compute_type1,
     _requested_to_stepsize,
@@ -73,3 +74,37 @@ def test_compute_fermat_positions_flomni_zero_step_is_safe():
     )
     assert count == 0
     assert min_positions == FlomniFermatScan.MIN_POSITIONS
+
+
+def test_flomni_sample_name_getter_uses_cached_read():
+    """Not fixing a bug here (unlike SETUP_PROFILES["omny"]["sample_name_getter"]
+    -- this getter was always a direct signal read, never a device-method call
+    dispatched as a device_rpc through the scan queue), but this is also polled
+    every tick (_on_poll()), so avoid DeviceBase.get()'s live
+    self._run(cached=False, ...) round-trip on the same principle."""
+
+    class _FakeSignal:
+        def __init__(self, value):
+            self._value = value
+            self.get_calls = []
+
+        def get(self, cached=False):
+            self.get_calls.append(cached)
+            return self._value
+
+    class _FakeSampleNames:
+        sample0 = _FakeSignal("my_sample")
+
+    class _FakeFlomniSamples:
+        sample_names = _FakeSampleNames()
+
+    class _FakeDev:
+        flomni_samples = _FakeFlomniSamples()
+
+    class _FakeWidget:
+        dev = _FakeDev()
+
+    result = SETUP_PROFILES["flomni"]["sample_name_getter"](_FakeWidget())
+
+    assert result == "my_sample"
+    assert _FakeSampleNames.sample0.get_calls == [True]

From 78f0c8fa3bce14ff37185ad4c0f3939b8da162dc Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 16:25:07 +0200
Subject: [PATCH 041/102] feat(omny): port zero_deg_reference_at_each_subtomo
 to types 1/4/5

flomni already has this (type-1-only: a dedicated projection at exactly
0 degrees before every odd/forward sub-tomogram, plus once more at the
end, for tracking radiation damage over a tomogram). Deliberately
excluded from OMNY during the Phase 1 port as flomni-specific; Mirko
asked for it to be extended to OMNY's generalized equally-spaced types
(1/4/5, 2/4/8 sub-tomograms), and confirmed the pre-shot should fire
even for sub-tomogram 1 (whose own first projection already lands on 0)
to get two consecutive 0-degree shots as an immediate baseline pair.

Also fixes a second hardcoded `tomo_type != 1` bug in the widget's
_irrelevant_params_for_type() (same class as the earlier _validate()
fix) that would have hidden this setting from OMNY type-4/5 job
tooltips even when enabled.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 69 +++++++++++++++++++
 .../omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md  | 11 +++
 .../bec_ipython_client/plugins/omny/omny.py   | 68 +++++++++++++++++-
 .../widgets/tomo_params/tomo_params.py        | 25 +++++--
 .../test_omny_tomo_params_widget_math.py      | 23 ++++++-
 .../test_omny_tomo_queue.py                   |  9 ++-
 .../test_omny_tomo_scan.py                    | 61 ++++++++++++++++
 7 files changed, 252 insertions(+), 14 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 5b1ed802..ec4fca15 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -636,6 +636,75 @@ used it here too (there's existing precedent for this exact pattern in GUI code,
 records its `cached` kwarg -- confirms both that the getter only touches the signal and that it
 passes `cached=True`).
 
+## zero_deg_reference_at_each_subtomo ported to OMNY's equally spaced types (1/4/5)
+
+Mirko: "one thing flomni has and we could implement here as well is the repeated projection when
+the stage is close to 0 anyways... for the tomo types 1,4 and 5 it could also be useful. in tomo
+type 1 it would of course only mean that at the end of the measurement one additional projection
+will be recorded." This flag was deliberately excluded from OMNY's `_TOMO_SCAN_PARAM_NAMES` during
+the Phase 1 port as a "flomni-only concept" (flomni's version is type-1-only, tied to its fixed
+8-sub-tomogram/180-vs-360-mode scheme) -- this reverses that call for OMNY's generalized 1/4/5
+equally-spaced types specifically, it's not a blind re-add.
+
+Verified against `_equally_spaced_subtomo_angles()`'s bit-reversal interleaving: odd (forward)
+sub-tomograms always start near angle 0 for any `n_subtomos` (2/4/8) -- exactly flomni's 180-mode
+rule (`subtomo_number % 2 == 1`), no 360-mode branch needed since OMNY only ever scans 180deg.
+Sub-tomogram 1 specifically always starts at *exactly* 0.0 (phase offset 0 by construction,
+regardless of tomo_type); the other odd sub-tomograms (3/5/7, types 4/5 only) start at a small but
+*nonzero* phase offset -- genuinely new angles near 0, not exact duplicates.
+
+One design question flomni's own code doesn't answer for OMNY: firing the pre-shot before
+sub-tomogram 1 too would duplicate its own first projection (both exactly angle 0, back to back).
+Asked Mirko directly -- answer: "it will be very helpful to start with two projections at zero
+degrees" -- so the pre-shot fires before every odd sub-tomogram including 1, deliberately
+producing two consecutive 0-degree shots at the very start (useful as an immediate damage/noise-
+floor baseline pair), matching flomni's own ported logic exactly rather than diverging from it.
+
+**Implementation** (`omny.py`): new `zero_deg_reference_at_each_subtomo` property (mirrors
+flomni's of the same name), added to `_TOMO_SCAN_PARAM_NAMES` (comment above the tuple updated --
+this is now the one flomni-adjacent concept OMNY *does* carry, unlike `tomo_angle_range`/
+`single_point_*`/`frames_per_trigger`, which still don't apply). `tomo_scan()`'s type-1-like loop:
+before each odd sub-tomogram (`ii % 2 == 1`), fires `self._tomo_scan_at_angle(0, ii)` -- guarded by
+`start_angle is None` so a resume mid-sub-tomogram doesn't force a detour through 0 it isn't
+actually passing through -- and once more after the whole loop finishes, for the final before/after
+bookend shot. `tomo_parameters()` gained a matching print (current-settings summary) and a
+`self.OMNYTools.yesno(...)` prompt (edit mode), gated by `self.tomo_type in self._TOMO_TYPE_1_LIKE`.
+
+**Widget** (`tomo_params.py`): `SETUP_PROFILES["omny"]["has_zero_deg_reference"]` flipped
+`False` -> `True` -- the checkbox itself (`_build_type1_section()`'s `if self._profile[
+"has_zero_deg_reference"]: self._add_bool(...)`) was already fully generic, needing no new UI
+code. Added `zero_deg_reference_at_each_subtomo` to `OMNY_QUEUE_PARAM_NAMES`/`OMNY_DEFAULTS`
+(default `False`). **Second hardcoded-`!= 1` bug caught while wiring this up** (same class of bug
+as `_validate()`'s Phase 2 fix): `_irrelevant_params_for_type()` (used by `_job_tooltip()` to hide
+inapplicable fields) had `if tomo_type != 1: irrelevant |= _TYPE1_ONLY_PARAMS` -- would have hidden
+this setting from every OMNY type-4/5 job's tooltip even when genuinely enabled. Fixed to
+`tomo_type not in (1, 4, 5)` (safe without profile context: 4/5 are OMNY-only tomo_type values,
+flomni/lamni jobs never have them).
+
+Regression tests: `test_tomo_scan_zero_deg_reference_disabled_by_default_no_extra_shots`,
+`..._type1_fires_before_subtomo1_and_after_subtomo2`, `..._type5_fires_before_every_odd_subtomo`,
+`..._skipped_only_for_the_resumed_subtomo` (`test_omny_tomo_scan.py`, spy on `_tomo_scan_at_angle`
+with `sub_tomo_scan` stubbed out); `test_irrelevant_params_for_type_keeps_zero_deg_reference_for_omny_types_4_and_5`
+(`test_omny_tomo_params_widget_math.py`); updated the pre-existing "no flomni-only concepts" test
+(`test_omny_tomo_queue.py`) and the pre-existing `has_zero_deg_reference is False` test (now
+`True`), both of which would otherwise have failed against this deliberate reversal. Full suite:
+770 passed.
+
+**Deferred, needs Mirko's hardware knowledge, not implemented**: Mirko also asked for flomni's
+`collect_empty_frames()` (acquires 10 flat-field/empty frames at angle 0 with the sample shifted
+out of the beam by fovx/2, called once at the start of every new tomo_scan()) to be ported to
+OMNY. Checked flomni's implementation (`flomni.py:2570`) -- it's built entirely on flomni's fine-
+piezo/laser-tracker stack (`dev.rtx`/`rty`/`rtz`, `laser_tracker_check_signalstrength()`,
+`move_samx_to_scan_region()`), none of which OMNY has. OMNY's own alignment offsets
+(`omny_alignment_mixin.py`'s `get_alignment_offset()`) are a pure sinusoidal-fit computation
+folded directly into `cenx`/`ceny` passed to `scans.omny_fermat_scan()` -- there's no separate
+fine-stage motor to move at all, and no `scans.acquire()` (or equivalent stationary-multi-frame-
+burst call) used anywhere in OMNY's plugin code to crib from. A literal port isn't possible without
+knowing: (1) what OMNY-side call performs a stationary multi-frame acquisition (does one exist?),
+and (2) whether "shift out of the beam" for OMNY means moving `osamx` directly (it's a real,
+movable coarse stage, confirmed) or just passing a deliberately offset `cenx` into
+`omny_fermat_scan()`. Not guessed at -- next step is asking Mirko for these two specifics.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
index 1ec26493..69de97aa 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
@@ -45,6 +45,17 @@ the broader OMNY live-testing effort this is part of.
       setting parameters via `tomo_parameters()`.
 - [ ] A real full scan for type 4 and type 5 (4/8 sub-tomograms).
 
+## zero_deg_reference_at_each_subtomo (new, never tested live)
+
+- [ ] `tomo_parameters()`: enable it for tomo_type 1 -- confirm the prompt/summary text and that a
+      real `tomo_scan()` records two projections at angle 0 right at the start (subtomo 1's own
+      first projection plus the deliberate duplicate) and one more at the very end.
+- [ ] Same for tomo_type 4 or 5 -- confirm extra 0-degree shots also appear before sub-tomograms
+      3/5/7 (not just 1), each at a distinct (nonzero) angle from 0, not a duplicate.
+- [ ] Widget: the "0° reference each sub-tomo" checkbox now appears for OMNY (previously
+      flomni/lamni only) -- toggle it for a type-4/5 job specifically and check the queued job's
+      tooltip shows it (regression guard for a hardcoded `!= 1` bug caught while wiring this up).
+
 ## Smaller fixes
 
 - [ ] `tomography_scannumbers.txt` and the PDF report land under `~/data/raw/...` (not the old
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index fbc4f402..10ef4a1d 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -654,8 +654,10 @@ class OMNY(
     # Property names a tomo_queue_add() job snapshots (TomoQueueMixin
     # contract). Mirrors flomni's own tuple exactly, since OMNY's properties
     # already mirror flomni's names 1:1 -- no tomo_angle_range/single_point_*/
-    # zero_deg_reference_at_each_subtomo/frames_per_trigger, since OMNY has
-    # no such properties.
+    # frames_per_trigger, since OMNY has no such properties.
+    # zero_deg_reference_at_each_subtomo *is* included (unlike the above) --
+    # it applies to any equally spaced tomo type, not just type 1, see
+    # tomo_scan()'s type-1-like loop and its own property docstring below.
     _TOMO_SCAN_PARAM_NAMES = (
         "tomo_countingtime",
         "tomo_shellstep",
@@ -671,6 +673,7 @@ class OMNY(
         "golden_ratio_bunch_size",
         "golden_max_number_of_projections",
         "golden_projections_at_0_deg_for_damage_estimation",
+        "zero_deg_reference_at_each_subtomo",
         "corridor_size",
         "at_each_angle_hook",
     )
@@ -1051,6 +1054,30 @@ class OMNY(
     def golden_projections_at_0_deg_for_damage_estimation(self, val: float):
         self.client.set_global_var("golden_projections_at_0_deg_for_damage_estimation", val)
 
+    @property
+    def zero_deg_reference_at_each_subtomo(self):
+        """If True (tomo_type in _TOMO_TYPE_1_LIKE, i.e. 1/4/5 -- the equally
+        spaced sub-tomogram modes), an additional projection at exactly 0
+        degrees is acquired at the start of every odd (forward) sub-tomogram
+        -- i.e. every time the rotation passes back through 0 degrees,
+        including sub-tomogram 1 itself, which already lands on 0 degrees
+        naturally -- and once more after the final sub-tomogram completes.
+        Together with sub-tomogram 1's own first projection, this gives two
+        consecutive 0-degree shots right at the start (deliberate: useful as
+        an immediate damage/noise-floor baseline pair) and one more at every
+        later natural pass through 0, useful for tracking radiation damage
+        over time. Mirrors flomni's property of the same name, and
+        golden_projections_at_0_deg_for_damage_estimation, which provides
+        similar functionality for tomo_type 2/3."""
+        val = self.client.get_global_var("zero_deg_reference_at_each_subtomo")
+        if val is None:
+            return False
+        return val
+
+    @zero_deg_reference_at_each_subtomo.setter
+    def zero_deg_reference_at_each_subtomo(self, val: bool):
+        self.client.set_global_var("zero_deg_reference_at_each_subtomo", val)
+
     @property
     def golden_ratio_bunch_size(self):
         val = self.client.get_global_var("golden_ratio_bunch_size")
@@ -1354,9 +1381,34 @@ class OMNY(
                     n_subtomos = {1: 2, 4: 4, 5: 8}[self.tomo_type]
                     self.progress["tomo_type"] = f"Equally spaced sub-tomograms ({n_subtomos})"
                     for ii in range(subtomo_start, n_subtomos + 1):
+                        if (
+                            start_angle is None
+                            and ii % 2 == 1
+                            and self.zero_deg_reference_at_each_subtomo
+                        ):
+                            # Dedicated reference shot at exactly 0 degrees, taken
+                            # every time the rotation passes back through 0
+                            # (every odd/forward sub-tomogram -- see
+                            # _equally_spaced_subtomo_angles()), for tracking
+                            # radiation damage over the full tomogram. Fires
+                            # for sub-tomogram 1 too even though its own first
+                            # projection already lands on 0 -- two consecutive
+                            # 0-degree shots right at the start is deliberate
+                            # (immediate baseline pair), not skipped as
+                            # redundant. Skipped when resuming mid-sub-tomogram
+                            # (start_angle given explicitly) since we're not
+                            # actually passing through 0 deg at that moment.
+                            self._tomo_scan_at_angle(0, ii)
                         self.sub_tomo_scan(ii, n_subtomos=n_subtomos, start_angle=start_angle)
                         start_angle = None
 
+                    if self.zero_deg_reference_at_each_subtomo:
+                        # Final reference shot at exactly 0 degrees once the whole
+                        # tomogram is complete, giving a clean "before vs after"
+                        # pair for radiation-damage comparison across the full
+                        # acquisition.
+                        self._tomo_scan_at_angle(0, n_subtomos)
+
                 elif self.tomo_type == 2:
                     # Golden ratio tomography
                     previous_subtomo_number = -1
@@ -1889,6 +1941,11 @@ class OMNY(
             )
             print(f"Total number of projections: {180/self.tomo_angle_stepsize*n_subtomos}")
             print(f"Angular step within sub-tomogram:   {self.tomo_angle_stepsize} degrees")
+        if self.tomo_type in self._TOMO_TYPE_1_LIKE and self.zero_deg_reference_at_each_subtomo:
+            print(
+                "Repeating a reference projection at 0 degrees at the start of every forward"
+                " sub-tomogram, plus once more at the end."
+            )
         print(f"\nSample name: {self.sample_name}\n")
 
         if self.OMNYTools.yesno("Are these parameters correctly set for your scan?", "y"):
@@ -1994,6 +2051,13 @@ class OMNY(
                 self.tomo_angle_stepsize = 180 / tomo_numberofprojections * n_subtomos
                 print(f"The angular step in a subtomogram it will be {self.tomo_angle_stepsize}")
 
+            if self.tomo_type in self._TOMO_TYPE_1_LIKE:
+                self.zero_deg_reference_at_each_subtomo = self.OMNYTools.yesno(
+                    "Repeat a reference projection at 0 degrees at the start of every forward"
+                    " sub-tomogram (plus once more at the end)?",
+                    "y" if self.zero_deg_reference_at_each_subtomo else "n",
+                )
+
     @staticmethod
     def _get_val(msg: str, default_value, data_type):
         return data_type(input(f"{msg} ({default_value}): ") or default_value)
diff --git a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
index df9cc913..4df22863 100644
--- a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
+++ b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
@@ -80,11 +80,13 @@ logger = bec_logger.logger
 # ── constants ────────────────────────────────────────────────────────────────
 
 # Mirrors _update_type_visibility()'s section/field gating (_sec_type1 shown
-# only for type 1, golden_ratio_bunch_size shown only for type 2 within
-# _sec_type23, the rest of _sec_type23 shown for type 2/3) -- reused by
-# _job_tooltip() so a queued job's hover details don't show fields that are
-# meaningless for its own tomo_type (e.g. golden-ratio settings on a type-1
-# job), on both flomni and lamni.
+# for every equally spaced sub-tomogram type -- 1 for flomni/lamni, 1/4/5 for
+# OMNY --, golden_ratio_bunch_size shown only for type 2 within _sec_type23,
+# the rest of _sec_type23 shown for type 2/3) -- reused by _job_tooltip() so
+# a queued job's hover details don't show fields that are meaningless for
+# its own tomo_type (e.g. golden-ratio settings on a type-1 job).
+# tomo_angle_range is flomni-only regardless (OMNY has no such property, so
+# it's simply never present in an OMNY job's params to begin with).
 _TYPE1_ONLY_PARAMS = {"tomo_angle_range", "zero_deg_reference_at_each_subtomo"}
 _TYPE2_ONLY_PARAMS = {"golden_ratio_bunch_size"}
 _TYPE23_PARAMS = {
@@ -97,7 +99,11 @@ def _irrelevant_params_for_type(tomo_type: Any) -> set[str]:
     """Param names that don't apply to a job's own tomo_type and should be
     hidden from its tooltip."""
     irrelevant: set[str] = set()
-    if tomo_type != 1:
+    # tomo_type 1 for flomni/lamni; 1/4/5 (all equally spaced sub-tomogram
+    # flavors) for OMNY -- 4/5 are OMNY-only tomo_type values (flomni/lamni
+    # jobs never have them), so this is safe without knowing which setup a
+    # given job's params belong to.
+    if tomo_type not in (1, 4, 5):
         irrelevant |= _TYPE1_ONLY_PARAMS
     if tomo_type not in (2, 3):
         irrelevant |= _TYPE23_PARAMS
@@ -240,6 +246,7 @@ OMNY_QUEUE_PARAM_NAMES = (
     "golden_ratio_bunch_size",
     "golden_max_number_of_projections",
     "golden_projections_at_0_deg_for_damage_estimation",
+    "zero_deg_reference_at_each_subtomo",
     "corridor_size",
     "at_each_angle_hook",
 )
@@ -260,6 +267,7 @@ OMNY_DEFAULTS: dict[str, Any] = {
     "golden_ratio_bunch_size": 20,
     "golden_max_number_of_projections": 1000.0,
     "golden_projections_at_0_deg_for_damage_estimation": 0,
+    "zero_deg_reference_at_each_subtomo": False,
     "corridor_size": -1,
     "at_each_angle_hook": None,
 }
@@ -2525,7 +2533,10 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         "defaults": OMNY_DEFAULTS,
         "has_180_mode": False,
         "has_single_point": False,
-        "has_zero_deg_reference": False,
+        # Applies to any equally spaced tomo type here (1/4/5), not just
+        # type 1 -- see omny.py's zero_deg_reference_at_each_subtomo
+        # property and tomo_scan()'s type-1-like loop.
+        "has_zero_deg_reference": True,
         "fov_fields": [
             ("fovx", "FOV x (µm)", 0.1, 200.0, 2),
             ("fovy", "FOV y (µm)", 0.1, 100.0, 2),
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
index f39de1bd..f5b2796e 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
@@ -20,6 +20,7 @@ from csaxs_bec.bec_widgets.widgets.tomo_params.tomo_params import (
     _compute_type1,
     _compute_type1_omny,
     _format_projections,
+    _irrelevant_params_for_type,
     _lamni_compute_type1,
     _requested_to_stepsize,
     _requested_to_stepsize_omny,
@@ -119,11 +120,15 @@ def test_omny_field_order_matches_flomni_minus_omny_only_gaps():
     ]
 
 
-def test_omny_has_no_180_mode_single_point_or_zero_deg_reference():
+def test_omny_has_no_180_mode_or_single_point():
+    """has_zero_deg_reference IS True for OMNY (unlike 180-mode/single-point,
+    which genuinely don't exist here): zero_deg_reference_at_each_subtomo
+    applies to any equally spaced tomo type, not just type 1 -- see
+    omny.py's own property docstring and tomo_scan()'s type-1-like loop."""
     profile = SETUP_PROFILES["omny"]
     assert profile["has_180_mode"] is False
     assert profile["has_single_point"] is False
-    assert profile["has_zero_deg_reference"] is False
+    assert profile["has_zero_deg_reference"] is True
 
 
 def test_compute_fermat_positions_omny_matches_scan_class_below_threshold():
@@ -182,6 +187,20 @@ def test_format_projections_still_distinguishes_flomni_and_lamni_jobs():
     assert _format_projections(lamni_params) == str(lamni_N * 8)
 
 
+# --- _irrelevant_params_for_type(): regression guard for the type-4/5 gap --
+
+
+def test_irrelevant_params_for_type_keeps_zero_deg_reference_for_omny_types_4_and_5():
+    """_irrelevant_params_for_type() used to hardcode `tomo_type != 1`, which
+    would hide zero_deg_reference_at_each_subtomo from an OMNY type-4/5 job's
+    tooltip even though it's a real, applicable setting for those types too
+    (only flomni/lamni are limited to type 1) -- fixed to `not in (1, 4, 5)`."""
+    for tomo_type in (1, 4, 5):
+        assert "zero_deg_reference_at_each_subtomo" not in _irrelevant_params_for_type(tomo_type)
+    for tomo_type in (2, 3):
+        assert "zero_deg_reference_at_each_subtomo" in _irrelevant_params_for_type(tomo_type)
+
+
 # --- _validate()'s tomo_type check: regression guard for the critical fix --
 
 
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
index 7627cd53..736a54b2 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
@@ -58,14 +58,17 @@ def make_omny(fake_client=None):
 
 def test_tomo_scan_param_names_have_no_flomni_only_concepts():
     """OMNY mirrors flomni's names for shared concepts, but has no
-    180/360 toggle, no single-point acquisition, no zero-deg reference,
-    and no frames_per_trigger -- none of these exist as OMNY properties."""
+    180/360 toggle, no single-point acquisition, and no frames_per_trigger --
+    none of these exist as OMNY properties. zero_deg_reference_at_each_subtomo
+    is a deliberate exception: it applies to any equally spaced tomo type
+    (1/4/5 for OMNY, not just type 1), so unlike the others it *is* present --
+    see tomo_scan()'s type-1-like loop and the property's own docstring."""
     names = OMNY._TOMO_SCAN_PARAM_NAMES
     assert "tomo_angle_range" not in names
     assert "single_point_instead_of_fermat_scan" not in names
     assert "single_point_random_shift_max" not in names
-    assert "zero_deg_reference_at_each_subtomo" not in names
     assert "frames_per_trigger" not in names
+    assert "zero_deg_reference_at_each_subtomo" in names
     # shared-with-flomni names are present, using OMNY's own property names
     assert "fovx" in names
     assert "stitch_x" in names
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 80a11719..fd3b7638 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -147,6 +147,67 @@ def test_tomo_scan_accepts_interactive_kwarg(monkeypatch):
     assert omny.progress["tomo_start_time"] is not None
 
 
+def test_tomo_scan_zero_deg_reference_disabled_by_default_no_extra_shots(monkeypatch):
+    """zero_deg_reference_at_each_subtomo defaults to False -- no extra
+    _tomo_scan_at_angle(0, ...) calls beyond whatever sub_tomo_scan() does
+    on its own (stubbed to a no-op here, so none at all)."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    calls = []
+    omny._tomo_scan_at_angle = lambda angle, subtomo_number: calls.append((angle, subtomo_number))
+
+    omny.tomo_scan()
+
+    assert calls == []
+
+
+def test_tomo_scan_zero_deg_reference_type1_fires_before_subtomo1_and_after_subtomo2(monkeypatch):
+    """Type 1 (n_subtomos=2): a pre-shot before sub-tomogram 1 (even though
+    its own first projection already lands on 0 -- two consecutive 0-degree
+    shots right at the start is deliberate) and a final shot after
+    sub-tomogram 2, giving exactly one extra projection at the end plus one
+    at the very start for this type."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.tomo_type = 1
+    omny.zero_deg_reference_at_each_subtomo = True
+    calls = []
+    omny._tomo_scan_at_angle = lambda angle, subtomo_number: calls.append((angle, subtomo_number))
+
+    omny.tomo_scan()
+
+    assert calls == [(0, 1), (0, 2)]
+
+
+def test_tomo_scan_zero_deg_reference_type5_fires_before_every_odd_subtomo(monkeypatch):
+    """Type 5 (n_subtomos=8): a pre-shot before every odd/forward
+    sub-tomogram (1, 3, 5, 7), plus the final shot after sub-tomogram 8."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.tomo_type = 5
+    omny.zero_deg_reference_at_each_subtomo = True
+    calls = []
+    omny._tomo_scan_at_angle = lambda angle, subtomo_number: calls.append((angle, subtomo_number))
+
+    omny.tomo_scan()
+
+    assert calls == [(0, 1), (0, 3), (0, 5), (0, 7), (0, 8)]
+
+
+def test_tomo_scan_zero_deg_reference_skipped_only_for_the_resumed_subtomo(monkeypatch):
+    """Resuming mid-sub-tomogram (start_angle given explicitly) must skip the
+    pre-shot only for that specific sub-tomogram -- we aren't actually
+    passing through 0 deg at that moment -- but later odd sub-tomograms in
+    the same tomo_scan() call still get theirs, and the final shot is
+    unaffected either way."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.tomo_type = 5
+    omny.zero_deg_reference_at_each_subtomo = True
+    calls = []
+    omny._tomo_scan_at_angle = lambda angle, subtomo_number: calls.append((angle, subtomo_number))
+
+    omny.tomo_scan(subtomo_start=3, start_angle=12.5)
+
+    assert calls == [(0, 5), (0, 7), (0, 8)]
+
+
 def test_tomo_scan_clears_heartbeat_on_normal_completion(monkeypatch):
     """The busy-detector heartbeat must be cleared as soon as the scan
     finishes, not left for the next poll to time out before the GUI stops

From 71eb9d858ffadce3f809931b4ac1a9d942aba2ba Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 16:50:46 +0200
Subject: [PATCH 042/102] feat(omny): port collect_empty_frames() from flomni

10 flat-field/empty-frame images at angle 0, sample shifted out of the
beam by fovx/2 + margin, taken once at the start of every new
tomo_scan() (not on resume) -- mirrors flomni's own collect_empty_frames()
structure and formula, using OMNY's own device names.

Took a few corrections to land on the right design: an initial staged
rtx+osamx move (based on a paraphrase of the real algorithm) was
discarded once Mirko surfaced the actual legacy SPEC macro, which does
a single position-threshold recenter instead. A second implementation
of that (RtOMNYController.move_samx_to_scan_region(), matching a name
already declared but unimplemented in USER_ACCESS) was itself
discarded on realizing OMNY already has this exact mechanism, working
and already wired into every real projection: dev.osamx
.omny_osamx_to_scan_center() (omny_fermat_scan.py's
prepare_setup_part2()). collect_empty_frames() reuses that directly.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  59 +++++++-
 .../omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md  |  12 ++
 .../bec_ipython_client/plugins/omny/omny.py   |  59 ++++++++
 csaxs_bec/devices/omny/rt/rt_omny_ophyd.py    |   8 ++
 .../test_omny_tomo_scan.py                    | 131 ++++++++++++++++++
 5 files changed, 268 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index ec4fca15..045162b4 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -1,4 +1,4 @@
-# OMNY open issues (as of 2026-09-03)
+# OMNY open issues (as of 2026-09-05)
 
 Tracks the live-testing effort for bringing OMNY up to flomni's/BEC's current standards on
 branch `update-omny`: bugs found (fixed and unfixed) and what's still untested. Written so a
@@ -705,6 +705,63 @@ and (2) whether "shift out of the beam" for OMNY means moving `osamx` directly (
 movable coarse stage, confirmed) or just passing a deliberately offset `cenx` into
 `omny_fermat_scan()`. Not guessed at -- next step is asking Mirko for these two specifics.
 
+## collect_empty_frames() ported to OMNY
+
+Mirko: flomni's `collect_empty_frames()` (10 flat-field/empty-frame images at angle 0, sample
+shifted out of the beam by fovx/2, taken once at the start of every new `tomo_scan()`) had no OMNY
+equivalent. Working out the right port took several rounds, each correcting the last:
+
+1. **First attempt (discarded)**: a bespoke "150 microns single-move, 300 combined" staged
+   rtx+osamx dance, based on Mirko's own paraphrase ("move rtx within 150 microns range, if more
+   range needed, move rtx to 150, then osamx 150..."). Confirmed via `AskUserQuestion` that rtx's
+   own reading stays put (doesn't reset) across the osamx move -- but this whole model turned out
+   to be an approximation of something else entirely (see below), and was never committed as final
+   -- superseded before being finished.
+2. **Second attempt (also discarded)**: while drafting, Mirko volunteered the *actual* legacy SPEC
+   macro for OMNY's projection scan, which recenters `osamx` with a single position-threshold
+   check (0.025mm/25um), not a staged multi-move dance:
+   ```
+   if (fabs(A[osamx]-(_omny_samx_in+$3/1000)) > 0.025) { ...move osamx to _omny_samx_in+$3/1000... }
+   ```
+   Cross-checking `RtOMNYController.USER_ACCESS` (`rt_omny_ophyd.py`) found `"move_samx_to_scan_
+   region"` declared there -- exactly flomni's own mechanism's name -- but **never actually
+   implemented** for OMNY (only `RtFlomniController.move_samx_to_scan_region()`, flomni's real
+   version, exists, and it's a PID-voltage-based iterative correction Mirko confirmed OMNY has no
+   equivalent readback for). Implemented a new `RtOMNYController.move_samx_to_scan_region()` from
+   the SPEC algorithm to fill this apparent gap.
+3. **Correction, before committing anything (the actual fix)**: Mirko recalled that in flomni this
+   recenter logic lives inside the *scan class itself* (`flomni_fermat_scan.py`), not the plugin,
+   and asked whether OMNY's own scan class should get the same treatment for consistency. Checking
+   `omny_fermat_scan.py`'s `prepare_setup_part2()` found **`self.dev.osamx.omny_osamx_to_scan_
+   center(self.cenx)` already there** -- a real, already-implemented, already-wired-into-every-
+   projection port of the exact same SPEC algorithm, just living on `OMNYGalilMotor`
+   (`ogalil_ophyd.py`) instead of `RtOMNYController`. The "gap" from step 2 didn't actually exist;
+   `move_samx_to_scan_region` (declared in `USER_ACCESS`, never implemented) was simply the wrong,
+   unused name to have gone looking under. **Removed** the step-2 addition entirely (replaced with
+   a comment pointing at the real mechanism, so nobody else goes down the same path) rather than
+   leave two parallel "recenter osamx" implementations that don't call each other.
+
+**Final implementation** (`omny.py`): `collect_empty_frames()`, structurally mirroring flomni's own
+(same 10-frame count, same `subtomo_number=0` logging convention, same
+"shift by fovx/2 + 20um margin, direction away from the normal alignment offset" formula) but using
+OMNY's own device names (`osamroy` not `fsamroy`) and reusing the *existing*
+`dev.osamx.omny_osamx_to_scan_center()` for the recenter step -- no new device-driver code needed
+in the end. Wired into `tomo_scan()`'s "a new tomo scan was started" branch (same placement as
+flomni's), so it fires once per fresh scan across all 5 tomo types, never on a resume.
+
+Regression tests: `test_tomo_scan_collects_empty_frames_on_new_scan_not_on_resume`,
+`test_collect_empty_frames_rotates_to_zero_when_not_already_there`,
+`test_collect_empty_frames_shifts_x_away_from_normal_offset_and_recenters_osamx`
+(`test_omny_tomo_scan.py`) -- the last one checks the exact shifted-x value, that
+`omny_osamx_to_scan_center()` is called with that same value, and that exactly one scan number
+gets logged with `subtomo_number=0`. `make_omny_for_tomo_scan()`'s shared fixture gained a
+`collect_empty_frames = lambda: None` stub (needed by every other `tomo_scan()` test once this
+was wired in). Full suite: 773 passed.
+
+**Not verified against real hardware** -- next step is Mirko trying a real `tomo_scan()` and
+confirming: the rotation-skip-if-already-at-0 branch, the direction/magnitude of the x shift, and
+that `omny_osamx_to_scan_center()`'s recenter fires (or correctly doesn't) as expected.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
index 69de97aa..10757976 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TOMO_SCAN_TEST_CHECKLIST.md
@@ -56,6 +56,18 @@ the broader OMNY live-testing effort this is part of.
       flomni/lamni only) -- toggle it for a type-4/5 job specifically and check the queued job's
       tooltip shows it (regression guard for a hardcoded `!= 1` bug caught while wiring this up).
 
+## collect_empty_frames() (new, never tested on real hardware)
+
+- [ ] Start a fresh `tomo_scan()` (any tomo type) -- confirm it rotates to 0 (or prints "No
+      rotation required" if already there), shifts x away from the normal alignment offset by
+      fovx/2 + 20um, and successfully acquires 10 empty frames before the real angular grid starts.
+- [ ] Confirm `dev.osamx.omny_osamx_to_scan_center()`'s recenter fires when it should (osamx more
+      than 25um from where it needs to be for the shifted x) and is a no-op otherwise.
+- [ ] Confirm this does *not* run on `tomo_scan_resume()`/a mid-scan resume -- only on a genuinely
+      fresh scan.
+- [ ] Check `tomography_scannumbers.txt` gets one new line per empty frame, `subtomo_number=0`,
+      distinguishable from the real angular grid (subtomo_number 1+).
+
 ## Smaller fixes
 
 - [ ] `tomography_scannumbers.txt` and the PDF report land under `~/data/raw/...` (not the old
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 10ef4a1d..90136fed 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1373,6 +1373,7 @@ class OMNY(
             self.progress["estimated_finish_time"] = None
             self.progress["accumulated_idle_time"] = 0.0
             self.progress["heartbeat"] = None
+            self.collect_empty_frames()
 
         try:
             with scans.dataset_id_on_hold:
@@ -1784,6 +1785,64 @@ class OMNY(
                 f"{scan_number} {angle} {dev.osamroy.read()['osamroy']['value']:.3f} {self.tomo_id} {subtomo_number} {0} {self.sample_name}\n"
             )
 
+    def collect_empty_frames(self):
+        """Acquire 10 empty-frame (flat-field) images at angle 0, with osamx/rtx
+        shifted out of the beam by half the field of view (fovx/2), in the
+        direction opposite the normal alignment x-offset at angle 0.
+
+        Called once at the start of a new tomo_scan() (not on resume). Mirrors
+        flomni's collect_empty_frames() (same purpose, same 10-frame count,
+        same subtomo_number=0 logging convention), adapted for OMNY's own
+        device names: rtx is moved directly to the shifted-out x offset, then
+        dev.osamx.omny_osamx_to_scan_center() recenters osamx too if it has
+        drifted far enough from where it should sit for this offset -- the
+        same recenter check every real projection already goes through
+        (wired into omny_fermat_scan.py's prepare_setup_part2(), not
+        anything specific to this method), reused as-is rather than
+        duplicated.
+
+        These frames are deliberately not passed through tomo_reconstruct()
+        -- they are flat fields, not ptycho projections, and must not be
+        added to the reconstruction queue. Logged to
+        tomography_scannumbers.txt with subtomo_number=0 so they remain
+        traceable but are clearly distinguished from the angular grid.
+        """
+        scans = builtins.__dict__.get("scans")
+
+        angle = 0
+
+        # --- rotation ---
+        osamroy_current_setpoint = dev.osamroy.user_setpoint.get()
+        if angle != osamroy_current_setpoint:
+            umv(dev.osamroy, angle)
+        else:
+            print("No rotation required")
+
+        # --- alignment offset at angle 0, then push x out of the beam by
+        # fovx/2, in the direction opposite the normal offset ---
+        offsets = self.get_alignment_offset(angle)
+        normal_offset_x = offsets[0] - self.compute_additional_correction_x(angle)
+        normal_offset_y = (
+            offsets[1]
+            - self.compute_additional_correction_y(angle)
+            - self.compute_additional_correction_y_2(angle)
+        )
+        normal_offset_z = offsets[2]
+        direction = -1 if normal_offset_x >= 0 else 1
+        sum_offset_x = normal_offset_x + direction * (self.fovx / 2) + direction * 20
+
+        self.laser_tracker_on()
+        umv(dev.rtx, sum_offset_x, dev.rty, normal_offset_y, dev.rtz, normal_offset_z)
+        self.laser_tracker_check_and_wait_for_signalstrength()
+        dev.osamx.omny_osamx_to_scan_center(sum_offset_x)
+
+        print("Acquiring 10 empty frames at angle 0, samx/rtx shifted out of the beam.")
+        start_scan_number = bec.queue.next_scan_number
+        scans.acquire(exp_time=self.tomo_countingtime, frames_per_trigger=10)
+        end_scan_number = bec.queue.next_scan_number
+        for scan_nr in range(start_scan_number, end_scan_number):
+            self._write_tomo_scan_number(scan_nr, angle, subtomo_number=0)
+
     def tomo_scan_projection(self, angle: float):
         scans = builtins.__dict__.get("scans")
 
diff --git a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
index c9cfba05..28c35110 100644
--- a/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_omny_ophyd.py
@@ -680,6 +680,14 @@ class RtOMNYController(Controller):
                 print("Failed to reach laser target position.")
                 raise RtError("Failed to reach laser target position.")
 
+    # move_samx_to_scan_region is declared in USER_ACCESS above but was never
+    # implemented here -- checked while wiring up OMNY.collect_empty_frames()
+    # (2026-09-05): the real, already-working equivalent for OMNY is
+    # OMNYGalilMotor.omny_osamx_to_scan_center() (ogalil_ophyd.py), called
+    # from omny_fermat_scan.py's prepare_setup_part2() on every projection
+    # -- ported from the same original SPEC macro this docstring would have
+    # quoted, already wired into regular scanning. Not duplicating it here.
+
     def laser_tracker_print_intensity_for_otrack_tweaking(self):
         # self.laser_update_tracker_info()
         # _laser_tracker_intensity = self.tracker_info["tracker_intensity"]
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index fd3b7638..99a1791f 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -71,6 +71,7 @@ def make_omny_for_tomo_scan(monkeypatch, tomo_angle_stepsize: float, active_acco
     obj._current_special_angles = []
     obj._at_each_angle_hooks = {}  # normally set by _init_tomo_queue()
     obj.write_pdf_report = lambda: None
+    obj.collect_empty_frames = lambda: None
     obj.sub_tomo_scan = lambda subtomo_number, n_subtomos=2, start_angle=None: None
     obj.omnygui_show_progress = lambda: None
     obj.OMNYTools = types.SimpleNamespace(printgreenbold=lambda msg: None)
@@ -122,6 +123,24 @@ def test_tomo_scan_registers_sample_with_plain_string_account(monkeypatch):
     assert omny.tomo_id == 42
 
 
+def test_tomo_scan_collects_empty_frames_on_new_scan_not_on_resume(monkeypatch):
+    """collect_empty_frames() (flat-field acquisition at angle 0, sample
+    shifted out of the beam) belongs to starting a fresh tomo_scan(), not to
+    resuming an interrupted one -- mirrors flomni's own placement, inside
+    the same "a new tomo scan was started" branch as the sample-database
+    registration and progress-field reset just above it."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    calls = []
+    omny.collect_empty_frames = lambda: calls.append("collected")
+
+    omny.tomo_scan()
+    assert calls == ["collected"]
+
+    calls.clear()
+    omny.tomo_scan(subtomo_start=2, start_angle=90.0)
+    assert calls == []
+
+
 def test_tomo_scan_shows_progress_gui(monkeypatch):
     """tomo_scan() must open/show the progress GUI unconditionally at the
     start of every scan -- previously only shown per-angle inside
@@ -460,3 +479,115 @@ def test_write_tomo_scan_number_creates_missing_directory(monkeypatch, tmp_path)
 
     written = (tmp_path / "data" / "raw" / "logs" / "tomography_scannumbers.txt").read_text()
     assert written == "844 12.5 12.500 1 1 0 test_sample\n"
+
+
+# --- collect_empty_frames(): flat-field acquisition at scan start, ported
+# from flomni's own collect_empty_frames() for OMNY's device names and its
+# already-existing osamx recenter (dev.osamx.omny_osamx_to_scan_center(),
+# the same one every real projection already goes through via
+# omny_fermat_scan.py's prepare_setup_part2() -- not anything bespoke). ----
+
+
+def _make_omny_for_collect_empty_frames(monkeypatch, osamroy_setpoint=45.0):
+    """Bare OMNY instance with collect_empty_frames()'s dependencies stubbed:
+    a fake device tree (osamroy/rtx/rty/rtz/osamx), umv(), alignment-offset
+    math, and the laser-tracker/recenter calls -- everything real hardware
+    control, nothing scan-content-computation, so the test only checks the
+    sequence/values collect_empty_frames() itself is responsible for."""
+    calls = []
+
+    fake_osamx = types.SimpleNamespace(
+        omny_osamx_to_scan_center=lambda cenx: calls.append(("recenter", cenx))
+    )
+    fake_dev = types.SimpleNamespace(
+        osamroy=types.SimpleNamespace(
+            user_setpoint=types.SimpleNamespace(get=lambda: osamroy_setpoint),
+            read=lambda: {"osamroy": {"value": 0.0}},
+        ),
+        rtx=object(),
+        rty=object(),
+        rtz=object(),
+        osamx=fake_osamx,
+    )
+    monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
+    monkeypatch.setattr(
+        omny_module, "umv", lambda *args: calls.append(("umv", args)), raising=False
+    )
+
+    class _FakeQueue:
+        def __init__(self):
+            self.next_scan_number = 100
+
+    fake_bec = types.SimpleNamespace(queue=_FakeQueue())
+    monkeypatch.setattr(omny_module, "bec", fake_bec, raising=False)
+
+    def _fake_acquire(**kwargs):
+        calls.append(("acquire", kwargs))
+        fake_bec.queue.next_scan_number += 1
+
+    fake_scans = types.SimpleNamespace(acquire=_fake_acquire)
+    monkeypatch.setitem(builtins.__dict__, "scans", fake_scans)
+
+    omny = object.__new__(OMNY)
+    omny.client = FakeGlobalVarClient()
+    omny.tomo_id = 1
+    omny.tomo_countingtime = 0.2
+    omny.fovx = 40.0
+    omny.get_alignment_offset = lambda angle: (5.0, 1.0, 0.0)
+    omny.compute_additional_correction_x = lambda angle: 0.0
+    omny.compute_additional_correction_y = lambda angle: 0.0
+    omny.compute_additional_correction_y_2 = lambda angle: 0.0
+    omny.laser_tracker_on = lambda: calls.append(("tracker_on",))
+    omny.laser_tracker_check_and_wait_for_signalstrength = lambda: calls.append(("tracker_check",))
+    written_scan_numbers = []
+    omny._write_tomo_scan_number = (
+        lambda scan_nr, angle, subtomo_number: written_scan_numbers.append(
+            (scan_nr, angle, subtomo_number)
+        )
+    )
+    return omny, calls, written_scan_numbers
+
+
+def test_collect_empty_frames_rotates_to_zero_when_not_already_there(monkeypatch):
+    omny, calls, _ = _make_omny_for_collect_empty_frames(monkeypatch, osamroy_setpoint=45.0)
+
+    omny.collect_empty_frames()
+
+    rotation_calls = [c for c in calls if c[0] == "umv" and c[1] == (omny_module.dev.osamroy, 0)]
+    assert len(rotation_calls) == 1
+
+
+def test_collect_empty_frames_shifts_x_away_from_normal_offset_and_recenters_osamx(monkeypatch):
+    """direction is chosen to move AWAY from the normal alignment offset at
+    angle 0 (normal_offset_x=5.0 here -- positive, so direction=-1), by
+    fovx/2 + a 20um margin, matching flomni's own formula exactly. osamx
+    recentering reuses the real dev.osamx.omny_osamx_to_scan_center(), not a
+    bespoke mechanism -- called with that same shifted x value."""
+    omny, calls, written_scan_numbers = _make_omny_for_collect_empty_frames(
+        monkeypatch, osamroy_setpoint=0.0
+    )
+
+    omny.collect_empty_frames()
+
+    # no rotation umv call: already at angle 0
+    assert [c for c in calls if c[0] == "umv" and len(c[1]) == 1] == []
+
+    expected_offset_x = (
+        5.0 + (-1) * (40.0 / 2) + (-1) * 20
+    )  # normal_offset_x + direction*(fovx/2+20)
+    rtx_moves = [c for c in calls if c[0] == "umv" and len(c[1]) > 1]
+    assert len(rtx_moves) == 1
+    assert rtx_moves[0][1][1] == expected_offset_x  # umv(dev.rtx, <x>, dev.rty, <y>, dev.rtz, <z>)
+    assert rtx_moves[0][1][3] == 1.0  # normal_offset_y, unshifted
+
+    assert ("recenter", expected_offset_x) in calls
+    assert ("tracker_on",) in calls
+    assert ("tracker_check",) in calls
+
+    acquire_calls = [c for c in calls if c[0] == "acquire"]
+    assert acquire_calls == [("acquire", {"exp_time": 0.2, "frames_per_trigger": 10})]
+
+    # one acquire call bumped next_scan_number by 1 (100 -> 101) -- exactly
+    # one scan number logged, with subtomo_number=0 (flat field, not part
+    # of the angular grid)
+    assert written_scan_numbers == [(100, 0, 0)]

From bdb0d25f90db4203d497a2c6b0bd025a6f5a89b3 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 17:01:00 +0200
Subject: [PATCH 043/102] fix(omny): reset progress fields before zero-degree
 reference shots

progress["projection"]/["subtomo_projection"]/["subtomo_total_projections"]/
["total_projections"] are otherwise only ever set inside sub_tomo_scan()'s
per-point loop. The zero_deg_reference_at_each_subtomo pre/post shots call
_tomo_scan_at_angle() directly, bypassing that -- so the printed progress
showed whatever was left over from a previous scan/subtomo instead of a
value that made sense for the shot. Confirmed live: a fresh scan's first
reference shot printed a stale "Projection: 9 / Total: 32" from an earlier
run. Same bug exists in flomni.py (this was ported from there faithfully,
bug included) -- flagged in OPEN_ISSUES.md but not touched, out of this
branch's scope.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 32 +++++++++++
 .../bec_ipython_client/plugins/omny/omny.py   | 27 +++++++++-
 .../test_omny_tomo_scan.py                    | 54 +++++++++++++++++++
 3 files changed, 112 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 045162b4..7d69baa6 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -762,6 +762,38 @@ was wired in). Full suite: 773 passed.
 confirming: the rotation-skip-if-already-at-0 branch, the direction/magnitude of the x shift, and
 that `omny_osamx_to_scan_center()`'s recenter fires (or correctly doesn't) as expected.
 
+## zero_deg_reference_at_each_subtomo's progress fields were stale (fixed for OMNY; same bug likely in flomni, not touched)
+
+Mirko, live-testing the just-landed feature: "the first zero degree projection does not seem to
+reset the projection number. not sure if it is correctly done in the case of flomni" -- and a
+pasted transcript showing the very first (pre-subtomo-1) reference shot printing "Projection: 9 /
+Total projections expected: 32" (stale leftover from an earlier run), followed moments later by
+subtomo 1's own real first projection correctly printing "Projection: 0 / Total: 10".
+
+Root cause: `progress["projection"]`/`["subtomo_projection"]`/`["subtomo_total_projections"]`/
+`["total_projections"]` are otherwise only ever set inside `sub_tomo_scan()`'s per-point loop. The
+0-degree reference shots (both the pre-subtomo-N and the final post-loop one) call
+`_tomo_scan_at_angle()` directly, bypassing `sub_tomo_scan()` entirely -- so whatever those fields
+happened to hold from a previous scan (or the previous subtomo) is what gets printed, not a value
+that makes sense for this shot.
+
+**Fixed for OMNY**: both call sites in `tomo_scan()`'s type-1-like loop now explicitly set all
+four fields immediately before calling `_tomo_scan_at_angle(0, ...)` -- the pre-shot is treated as
+sub-tomogram `ii`'s own projection 0 (matching what `sub_tomo_scan()` is about to set for its real
+first point right after), the final shot as one past the last real point of the final
+sub-tomogram. Regression test:
+`test_tomo_scan_zero_deg_reference_progress_fields_are_fresh_not_stale` (seeds `progress` with
+stale values matching the live report, asserts both shots' snapshots are fully fresh/correct, not
+just non-crashing).
+
+**Same bug confirmed present in flomni's own code** (`flomni.py`'s equally-spaced-sub-tomograms
+loop, `_tomo_scan_at_angle(0, ii)`/`_tomo_scan_at_angle(0, 8)` calls, same as OMNY's before this
+fix -- flomni's `sub_tomo_scan()` is likewise the only place that sets these fields) -- this is
+where OMNY's version was ported from, so it inherited the bug faithfully. **Not fixed here**:
+`flomni.py` is a different, currently-in-production plugin outside this branch's scope
+(`update-omny`); flagging for a separate, dedicated look rather than bundling an unreviewed
+flomni-affecting change into this branch.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 90136fed..d07a2ea1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1380,6 +1380,7 @@ class OMNY(
                 if self.tomo_type in (1, 4, 5):
                     # equally spaced sub-tomograms (2, 4, or 8)
                     n_subtomos = {1: 2, 4: 4, 5: 8}[self.tomo_type]
+                    n_points = int(180.0 / self.tomo_angle_stepsize)
                     self.progress["tomo_type"] = f"Equally spaced sub-tomograms ({n_subtomos})"
                     for ii in range(subtomo_start, n_subtomos + 1):
                         if (
@@ -1399,6 +1400,24 @@ class OMNY(
                             # redundant. Skipped when resuming mid-sub-tomogram
                             # (start_angle given explicitly) since we're not
                             # actually passing through 0 deg at that moment.
+                            #
+                            # progress["projection"]/["subtomo_projection"]/etc.
+                            # are otherwise only ever set inside sub_tomo_scan()
+                            # -- set them explicitly here too, or the printed
+                            # progress for this shot shows whatever was left
+                            # over from the previous scan/subtomo instead of a
+                            # value that makes sense for it (confirmed live: a
+                            # stale "Projection: 9 / Total: 32" from a prior
+                            # run, on the very first projection of a fresh
+                            # scan). Treated as sub-tomogram ii's own
+                            # projection 0, matching what sub_tomo_scan() is
+                            # about to set for its real first point right
+                            # after this.
+                            self.progress["subtomo"] = ii
+                            self.progress["subtomo_projection"] = 0
+                            self.progress["subtomo_total_projections"] = n_points
+                            self.progress["projection"] = (ii - 1) * n_points
+                            self.progress["total_projections"] = n_points * n_subtomos
                             self._tomo_scan_at_angle(0, ii)
                         self.sub_tomo_scan(ii, n_subtomos=n_subtomos, start_angle=start_angle)
                         start_angle = None
@@ -1407,7 +1426,13 @@ class OMNY(
                         # Final reference shot at exactly 0 degrees once the whole
                         # tomogram is complete, giving a clean "before vs after"
                         # pair for radiation-damage comparison across the full
-                        # acquisition.
+                        # acquisition. One past the last real point of the final
+                        # sub-tomogram, same progress-freshness reasoning as above.
+                        self.progress["subtomo"] = n_subtomos
+                        self.progress["subtomo_projection"] = n_points
+                        self.progress["subtomo_total_projections"] = n_points
+                        self.progress["projection"] = n_points * n_subtomos
+                        self.progress["total_projections"] = n_points * n_subtomos
                         self._tomo_scan_at_angle(0, n_subtomos)
 
                 elif self.tomo_type == 2:
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 99a1791f..4be38cca 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -196,6 +196,60 @@ def test_tomo_scan_zero_deg_reference_type1_fires_before_subtomo1_and_after_subt
     assert calls == [(0, 1), (0, 2)]
 
 
+def test_tomo_scan_zero_deg_reference_progress_fields_are_fresh_not_stale(monkeypatch):
+    """progress["projection"]/["total_projections"]/["subtomo_projection"]/
+    ["subtomo_total_projections"] are otherwise only ever set inside
+    sub_tomo_scan() -- the 0-degree reference shots bypass that, calling
+    _tomo_scan_at_angle() directly, so without an explicit reset they show
+    whatever was left over from a previous scan/subtomo instead of a value
+    that makes sense for this shot. Confirmed live: a fresh scan's very
+    first (pre-subtomo-1) reference shot printed a stale "Projection: 9 /
+    Total projections expected: 32" from an earlier run."""
+    omny = make_omny_for_tomo_scan(monkeypatch, 45.0, active_account="")
+    omny.tomo_type = 1
+    omny.zero_deg_reference_at_each_subtomo = True
+    # simulate stale leftover progress from an unrelated previous scan
+    omny.progress["projection"] = 9
+    omny.progress["total_projections"] = 32
+    omny.progress["subtomo_projection"] = 9
+    omny.progress["subtomo_total_projections"] = 16
+
+    fields = (
+        "subtomo",
+        "subtomo_projection",
+        "subtomo_total_projections",
+        "projection",
+        "total_projections",
+    )
+    snapshots = []
+
+    def _fake_at_angle(angle, subtomo_number):
+        snapshots.append({key: omny.progress[key] for key in fields})
+
+    omny._tomo_scan_at_angle = _fake_at_angle
+
+    omny.tomo_scan()
+
+    # n_points = int(180/45) = 4, n_subtomos = 2 -> total = 8
+    pre_shot = snapshots[0]  # before sub-tomogram 1
+    assert pre_shot == {
+        "subtomo": 1,
+        "subtomo_projection": 0,
+        "subtomo_total_projections": 4,
+        "projection": 0,
+        "total_projections": 8,
+    }
+
+    final_shot = snapshots[-1]  # after sub-tomogram 2
+    assert final_shot == {
+        "subtomo": 2,
+        "subtomo_projection": 4,
+        "subtomo_total_projections": 4,
+        "projection": 8,
+        "total_projections": 8,
+    }
+
+
 def test_tomo_scan_zero_deg_reference_type5_fires_before_every_odd_subtomo(monkeypatch):
     """Type 5 (n_subtomos=8): a pre-shot before every odd/forward
     sub-tomogram (1, 3, 5, 7), plus the final shot after sub-tomogram 8."""

From 3ffcdf51289e58888feddb219cbad28bea6da131 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 19:51:58 +0200
Subject: [PATCH 044/102] fix(omny): parking overwrite guard, active-slot leica
 targets, shuttle-scoped print; add measured-status+account encoding and
 P-touch label printing

- Widget: reject assigning a shuttle to a parking slot already held by a
  different shuttle ("Slot in use", clear it first) instead of silently
  overwriting.
- Widget: PDF report now shows only the 3 shuttles + their samples (title
  "OMNY Shuttle Samples") -- stage/gripper/fixed-O positions can't
  physically leave the vacuum chamber, so a printed report has nothing
  useful to say about them. The on-screen widget still shows/manages all
  of it.
- Widget: fixed the active-parking-slot badge never showing for a
  loadlock-driven park. Root cause: otransfer_park_loadlock_slot() drives
  oparkz to a different target-position table (base -6, "leica") than the
  regular otransfer_park_slot() (base -0.9); the widget only recognized
  the regular one. Now checks both.
- OMNYSampleStorage: measured status now packs status *and* the beamtime
  account into one VAL -- 0 = not measured, negative 5-digit = started,
  positive 5-digit = completed, falling back to FALLBACK_ACCOUNT (11111)
  for anything that doesn't parse as exactly 5 digits. No IOC schema
  change needed (same ai record). New get_sample_account()(+gripper/
  samplestage variants); set_sample_status() now takes an account param;
  show_all()/help() updated. otransfer_* CLI wrappers updated to match.
- Widget: new P-touch label-print offer, but only when clearing a
  *shuttle* slot (not fixed-O/stage/gripper -- those are bookkeeping
  corrections, not physical sample removal, since only shuttle samples
  leave the vacuum chamber). Uses a separate PTouchLabelPrinter instance
  at template 3 (not yet bench-tested against a real printer, unlike
  FlOMNI's confirmed-working template 1), same field names as FlOMNI.
- AI_docs/OPEN_ISSUES.md: noted that the measured-status+account encoding
  should be ported to FlOMNI at some point (separate task, not this
  branch's scope -- FlOMNI's own status tracking is untouched, still the
  redis-based _MeasuredSampleLog).
- New tests: encode/decode round-trips + fallback behavior for the
  status+account VAL scheme, plus oparkz leica-target coverage.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |  20 ++
 .../omny/omny_sample_transfer_mixin.py        |  21 +-
 .../widgets/sample_storage/sample_storage.py  | 217 ++++++++++++++----
 csaxs_bec/devices/omny/omny_sample_storage.py | 155 +++++++++----
 .../test_omny_sample_storage_widget_math.py   |  20 ++
 .../tests_devices/test_omny_sample_storage.py |  47 ++++
 6 files changed, 379 insertions(+), 101 deletions(-)
 create mode 100644 tests/tests_devices/test_omny_sample_storage.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 7d69baa6..4d161436 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -794,6 +794,26 @@ where OMNY's version was ported from, so it inherited the bug faithfully. **Not
 (`update-omny`); flagging for a separate, dedicated look rather than bundling an unreviewed
 flomni-affecting change into this branch.
 
+## Measured-status + account tracking now real EPICS for OMNY -- port to flomni later
+
+OMNY sample storage gained a real EPICS channel for measured status and the beamtime account
+(`OMNYSampleStorage`'s new `sample_status`/`sample_shuttle_{A,B,C}_status` signals, one new `ai`
+record per sample position -- see `omny_samples_status.template` in `OMNY/OMNY.git` and
+`OMNY/ioc-samples-and-xrayeye`). Encoding: VAL packs *both* status and account into one number --
+`0` means not measured; otherwise VAL's magnitude is the 5-digit account and its sign is the
+status (negative = "started", positive = "completed"), falling back to `FALLBACK_ACCOUNT` (11111)
+for anything that doesn't parse as exactly 5 digits. See `OMNYSampleStorage.STATUS_NONE`'s class
+comment and `_status_to_val()`/`_val_to_status()`/`_val_to_account()`/`_normalize_account()` in
+`csaxs_bec/devices/omny/omny_sample_storage.py`.
+
+This deliberately mirrors, but does not replace, FlOMNI's own measured-status tracking, which
+still lives entirely in a BEC redis global var (`_MeasuredSampleLog`/`flomni_measured_samples` in
+`sample_storage.py`/`flomni.py`), keyed by `pack_desc(name, owner)` rather than a fixed physical
+position -- FlOMNI wasn't touched this branch (explicitly out of scope, see the sample-storage
+work above). **Mirko's intent: port the same real-EPICS status+account channel to FlOMNI at some
+point** -- a separate, dedicated task (its own `.template` record + `FlomniSampleStorage` changes
++ retiring/reconciling `_MeasuredSampleLog`), not bundled into this branch.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 90a3a0f3..58b3b093 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1170,30 +1170,39 @@ class OMNYSampleTransferMixin:
     def otransfer_get_sample_name_and_owner(self, container: str, slot_nr: int) -> tuple:
         return dev.omny_samples.get_sample_name_and_owner(container, slot_nr)
 
-    def otransfer_set_sample_status(self, container: str, slot_nr: int, status: str) -> bool:
-        return dev.omny_samples.set_sample_status(container, slot_nr, status)
+    def otransfer_set_sample_status(self, container: str, slot_nr: int, status: str, account=None) -> bool:
+        return dev.omny_samples.set_sample_status(container, slot_nr, status, account)
 
     def otransfer_get_sample_status(self, container: str, slot_nr: int) -> str:
         return dev.omny_samples.get_sample_status(container, slot_nr)
 
+    def otransfer_get_sample_account(self, container: str, slot_nr: int):
+        return dev.omny_samples.get_sample_account(container, slot_nr)
+
     def otransfer_get_sample_owner_in_gripper(self) -> str:
         return dev.omny_samples.get_sample_owner_in_gripper()
 
     def otransfer_get_sample_owner_in_samplestage(self) -> str:
         return dev.omny_samples.get_sample_owner_in_samplestage()
 
-    def otransfer_set_sample_status_in_gripper(self, status: str) -> bool:
-        return dev.omny_samples.set_sample_status_in_gripper(status)
+    def otransfer_set_sample_status_in_gripper(self, status: str, account=None) -> bool:
+        return dev.omny_samples.set_sample_status_in_gripper(status, account)
 
     def otransfer_get_sample_status_in_gripper(self) -> str:
         return dev.omny_samples.get_sample_status_in_gripper()
 
-    def otransfer_set_sample_status_in_samplestage(self, status: str) -> bool:
-        return dev.omny_samples.set_sample_status_in_samplestage(status)
+    def otransfer_get_sample_account_in_gripper(self):
+        return dev.omny_samples.get_sample_account_in_gripper()
+
+    def otransfer_set_sample_status_in_samplestage(self, status: str, account=None) -> bool:
+        return dev.omny_samples.set_sample_status_in_samplestage(status, account)
 
     def otransfer_get_sample_status_in_samplestage(self) -> str:
         return dev.omny_samples.get_sample_status_in_samplestage()
 
+    def otransfer_get_sample_account_in_samplestage(self):
+        return dev.omny_samples.get_sample_account_in_samplestage()
+
     # def _otransfer_modify_sample(_ocontainer, _oposition, _ostatus, _oname):
     #   #_ocontainer is A, B, C for the pin containers
     #   #it can also be FZP, OSA and omny
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 3d1c1d12..64f5e99c 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -24,11 +24,11 @@ OMNY (``dev.omny_samples``)
     recording which shuttle letter is docked at each physical parking
     position (parking slots are a shuttle-letter assignment, not a sample,
     so they carry no name/owner/status). Unlike FlOMNI, OMNY has a
-    dedicated owner channel (and a measured-status channel -- see
-    ``OMNY_SampleStorage.STATUS_NONE``/``STATUS_STARTED``/
-    ``STATUS_COMPLETED``) next to each sample slot's existing placed/name
-    channels, so no packing is needed there. Whichever shuttle's parking
-    slot matches the ``oparkz`` motor's current readback is "active", i.e.
+    dedicated owner channel and a measured-status channel (packing status
+    *and* account into one VAL -- see ``OMNY_SampleStorage.STATUS_NONE``)
+    next to each sample slot's existing placed/name channels, so no
+    packing is needed there. Whichever shuttle's parking slot matches the
+    ``oparkz`` motor's current readback is "active", i.e.
     at the transfer-ready position (see ``oparkz_active_parking_slot()``).
 
 A LamNI session has neither device; the widget shows a "no known setup
@@ -157,10 +157,13 @@ COLOR_SLOT_BORDER = "#c0c0c0"
 # already-transferred template (confirmed working) -- NOT the generic
 # Text1/Text2/Text6 names that OMNY_shared/flomni.lbx's own objectName
 # attributes happen to use for its (different) template source file.
-# FlOMNI-only: OMNY has no measured-sample-log integration (see module
-# docstring), so it never drives this printer.
+# Same printer, same field names, but a *different* template number is
+# pre-loaded on the printer for the OMNY label -- not yet bench-tested
+# against a real printer the way FlOMNI's template 1 has been, so the
+# field names are an assumption for now, not confirmed working.
 PTOUCH_PRINTER_HOST = "BRN94DDF8AAB8EC.psi.ch"
 PTOUCH_TEMPLATE_NUMBER = 1
+PTOUCH_TEMPLATE_NUMBER_OMNY = 3
 PTOUCH_FIELD_ACCOUNT = "ACCOUNT"
 PTOUCH_FIELD_DATE = "DATE"
 PTOUCH_FIELD_SAMPLENAME = "SAMPLENAME"
@@ -197,20 +200,38 @@ _OPARKZ_TARGET_POSITIONS: dict[int, float] = {
     5: -0.9 - 29,
     6: -0.9,
 }
+# otransfer_park_loadlock_slot()'s targets (_oparkz_leica_slot() in the same
+# mixin) -- the *same* slot numbers, reached via the loadlock/leica transfer
+# path instead of the regular gripper path, at a different oparkz offset
+# (base -6, not -0.9). Both genuinely mean "the parking stage is at that
+# slot" -- "active" must recognize either, or a loadlock-driven park (like
+# otransfer_park_loadlock_slot()) never shows as active in the GUI even
+# though it physically is.
+_OPARKZ_LEICA_TARGET_POSITIONS: dict[int, float] = {
+    2: -6 - 29 * 3 - 42 - 0.05,
+    3: -6 - 29 * 3,
+    4: -6 - 29 * 2,
+    5: -6 - 29,
+    6: -6,
+}
 _OPARKZ_TOLERANCE = 0.05
 
 
 def oparkz_active_parking_slot(readback: float, tol: float = _OPARKZ_TOLERANCE) -> Optional[int]:
     """Return which parking slot (2-6) the oparkz motor is currently sitting
     at, i.e. ready for a sample transfer, or None if it's between positions
-    (or at slot 1, which has no drivable transfer target). Pure function --
-    see the module-level docstring above ``_OPARKZ_TARGET_POSITIONS`` for
-    why this duplicates rather than imports omny_sample_transfer_mixin.py's
-    ``_oparkz_slot_check()``.
+    (or at slot 1, which has no drivable transfer target). Checks both the
+    regular-gripper and loadlock/leica target tables (see
+    ``_OPARKZ_LEICA_TARGET_POSITIONS``) since either represents the parking
+    stage genuinely being at that slot. Pure function -- see the
+    module-level docstring above ``_OPARKZ_TARGET_POSITIONS`` for why this
+    duplicates rather than imports omny_sample_transfer_mixin.py's
+    ``_oparkz_slot_check()``/``_oparkz_leica_slot()``.
     """
-    for slot, target in _OPARKZ_TARGET_POSITIONS.items():
-        if abs(readback - target) < tol:
-            return slot
+    for targets in (_OPARKZ_TARGET_POSITIONS, _OPARKZ_LEICA_TARGET_POSITIONS):
+        for slot, target in targets.items():
+            if abs(readback - target) < tol:
+                return slot
     return None
 
 
@@ -504,6 +525,9 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         self.label_printer = PTouchLabelPrinter(
             host=PTOUCH_PRINTER_HOST, template_number=PTOUCH_TEMPLATE_NUMBER
         )
+        self.label_printer_omny = PTouchLabelPrinter(
+            host=PTOUCH_PRINTER_HOST, template_number=PTOUCH_TEMPLATE_NUMBER_OMNY
+        )
         self._setup = self._detect_setup()
         self._build_ui()
         self._poll_timer = QTimer(self)
@@ -634,9 +658,9 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         sample-kind slot -- stage, gripper, the 10 fixed O positions, and
         the 18 shuttle slots. Owner and measured status each have their own
         dedicated OMNYSampleStorage signal (added alongside the existing
-        placed/name signals -- see that class's ``STATUS_NONE``/
-        ``STATUS_STARTED``/``STATUS_COMPLETED``), unlike FlOMNI which packs
-        name+owner into one field via ``sample_desc_codec``.
+        placed/name signals -- see that class's status+account VAL
+        encoding, ``STATUS_NONE``), unlike FlOMNI which packs name+owner
+        into one field via ``sample_desc_codec``.
         """
 
         def _val(key, default=None):
@@ -646,13 +670,19 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             return default
 
         def _status_str(raw) -> Optional[str]:
-            # mirrors OMNYSampleStorage._status_val_to_str(), without a live
+            # mirrors OMNYSampleStorage._val_to_status(), without a live
             # device round-trip: this widget only has the bulk-read dict.
+            # VAL packs status+account (see that class's status+account VAL
+            # encoding comment): 0 -> no badge, negative -> "started",
+            # positive -> "completed" (the magnitude is the account, not
+            # needed here -- see _status_account() for that).
             try:
                 val = int(round(float(raw)))
             except (TypeError, ValueError):
                 return None
-            return {1: "started", 2: "completed"}.get(val)  # 0 ("none") -> None: no badge
+            if val == 0:
+                return None
+            return "started" if val < 0 else "completed"
 
         state: dict[tuple, tuple[bool, str, str, Optional[str]]] = {}
 
@@ -788,6 +818,74 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             if reply != QMessageBox.StandardButton.Retry:
                 break
 
+    def _offer_print_label_for_previous_occupant_omny(self, key: tuple) -> None:
+        """If the shuttle slot about to be cleared has a measured status
+        (started or completed), offer to print an account/date/name label
+        for it -- OMNY's counterpart to
+        ``_offer_print_label_for_previous_occupant()``, but only ever
+        called for shuttle-slot clears (see ``_write_slot_omny``): unlike
+        the fixed-O/stage/gripper positions, a shuttle's samples are the
+        only ones that can physically leave the vacuum chamber, so
+        printing a label only makes sense there.
+
+        Uses ``self.label_printer_omny`` (``PTOUCH_TEMPLATE_NUMBER_OMNY``),
+        a different template number than FlOMNI's -- same field names
+        (ACCOUNT/DATE/SAMPLENAME) by assumption, not yet bench-tested
+        against a real printer the way FlOMNI's template 1 is.
+
+        OMNY has no FlOMNI-style measured-sample log to pop a record from
+        -- status and account already live directly on the slot itself
+        (see ``OMNYSampleStorage``'s status+account VAL encoding), so this
+        reads them fresh from the device right before the clear, instead.
+        There's also no stored measurement date (OMNY doesn't track one),
+        so the label's DATE field is simply today's date, at print time.
+        """
+        assert key[0] == "shuttle"
+        _, letter, n = key
+        try:
+            was_used = self._samples.is_sample_slot_used(letter, n)
+            prev_name = self._samples.get_sample_name(letter, n)
+            status = self._samples.get_sample_status(letter, n)
+            account = self._samples.get_sample_account(letter, n)
+        except Exception as exc:
+            logger.warning(
+                f"OMNY_SampleStorage: could not read previous state of slot {key} for the"
+                f" measured-label check: {exc}"
+            )
+            return
+        if not was_used or status == "none":
+            return
+        reply = QMessageBox.question(
+            self,
+            "Print label?",
+            f"Sample '{prev_name}' was measured ({status}), account {account}. Print a label?",
+            QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
+        )
+        if reply != QMessageBox.StandardButton.Yes:
+            return
+        fields = {
+            PTOUCH_FIELD_ACCOUNT: str(account),
+            PTOUCH_FIELD_DATE: datetime.date.today().strftime("%Y-%m-%d"),
+            PTOUCH_FIELD_SAMPLENAME: prev_name,
+        }
+        # Retry loop, same reasoning as _offer_print_label_for_previous_occupant():
+        # the slot is about to be cleared regardless of whether printing
+        # succeeds, so give the operator a real chance to fix the printer
+        # and retry rather than losing the label silently.
+        while not self.label_printer_omny.print_label(fields):
+            reply = QMessageBox.question(
+                self,
+                "Print failed",
+                f"Could not print label for '{prev_name}' — printer unreachable.\n\n"
+                "Power it on / check it has tape loaded, then Retry, or Ignore to"
+                " give up on printing this label.\n\nThe slot will be updated"
+                " regardless, once you close this dialog.",
+                QMessageBox.StandardButton.Retry | QMessageBox.StandardButton.Ignore,
+                QMessageBox.StandardButton.Retry,
+            )
+            if reply != QMessageBox.StandardButton.Retry:
+                break
+
     def _write_slot(self, slot: int, used: int, name: str, owner: str = "") -> bool:
         """
         Write (used, name, owner) to a FlOMNI storage slot 0–20 or the
@@ -826,13 +924,21 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         no packing needed. Measured status is reset to "none" on every
         write here, mirroring ``OMNYSampleStorage.set_sample_slot()``'s/
         ``unset_sample_slot()``'s own behavior -- a fresh name (even a
-        rename) or a cleared slot isn't mid-measurement. No P-touch
-        label-printing offer for the previous occupant (FlOMNI-only, see
-        module docstring).
+        rename) or a cleared slot isn't mid-measurement.
+
+        Offers a P-touch label print for the previous occupant only when
+        *clearing* a *shuttle* slot (see
+        ``_offer_print_label_for_previous_occupant_omny``) -- shuttles are
+        the only OMNY samples that can physically leave the vacuum
+        chamber, so that's the only "sample remove" this widget can
+        meaningfully print a label for; every other clear (fixed-O/stage/
+        gripper) is a bookkeeping correction, not a physical removal.
         """
+        kind = key[0]
+        if used == 0 and kind == "shuttle":
+            self._offer_print_label_for_previous_occupant_omny(key)
         try:
             status_none = OMNY_STATUS_NONE
-            kind = key[0]
             if kind == "stage":
                 self._samples.sample_in_samplestage.set(used)
                 self._samples.sample_in_samplestage_name.set(name)
@@ -1224,11 +1330,18 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def action_set_parking(self, letter: str, current_slot: Optional[int]) -> None:
         """Assign OMNY shuttle `letter` to a parking slot (1-6), via
-        ``_ShuttleStatusLabel``'s context menu. Overwrites that slot's
-        previous occupant, if any, without clearing wherever `letter` was
-        previously parked -- mirrors ``set_shuttle_slot()``'s own
-        semantics exactly; keeping the two in sync is operator discipline,
-        same as everywhere else in this widget (see module docstring).
+        ``_ShuttleStatusLabel``'s context menu. Rejects the assignment if
+        that slot is already assigned to a *different* shuttle -- unlike
+        ``set_shuttle_slot()`` itself, which would silently overwrite it
+        (see module docstring on why writes elsewhere in this widget don't
+        add interlocks: parking is the one exception, since two different
+        shuttles both being "in" the same slot is a bookkeeping
+        impossibility, not a legitimate concurrent-edit race). Re-assigning
+        the *same* shuttle to a slot it's already in is a no-op-safe
+        confirm, not an error.
+
+        Doesn't clear wherever `letter` was previously parked, if anywhere
+        else -- still the operator's job, same as everywhere else here.
         """
         slot_nr, ok = QInputDialog.getInt(
             self,
@@ -1241,6 +1354,19 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         )
         if not ok:
             return
+        data = self._bulk_read_omny()
+        parking_assignment = self._parse_parking_assignment_omny(data) if data is not None else {}
+        occupant = parking_assignment.get(slot_nr)
+        if occupant is not None and occupant != letter:
+            QMessageBox.warning(
+                self,
+                "Slot in use",
+                f"Parking slot {slot_nr} is already assigned to shuttle {occupant}.\n\n"
+                f"Clear shuttle {occupant}'s parking assignment first (right-click its "
+                f"status line → Clear parking assignment), then assign shuttle "
+                f"{letter} to slot {slot_nr}.",
+            )
+            return
         if self._write_parking_omny(slot_nr, letter):
             self.refresh()
 
@@ -1358,10 +1484,16 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         return path
 
     def _build_report_pdf_omny(self) -> str:
-        """Render a page mirroring the on-screen OMNY layout (stage +
-        gripper header, fixed-O grid, 3 shuttle sections with their
-        installed/active status text) from a fresh device read, and return
-        the path of the temp PDF file it was written to.
+        """Render a page with just the 3 shuttles and their samples (status
+        line + slot grid) from a fresh device read, and return the path of
+        the temp PDF file it was written to.
+
+        Deliberately excludes the stage/gripper/fixed-O positions that the
+        on-screen widget also shows -- unlike the shuttles, none of those
+        samples can physically leave the vacuum chamber, so a printed
+        report (meant to travel with a shuttle's physical samples) has
+        nothing useful to say about them. The widget itself still displays
+        and manages all of it; only this printed report is scoped down.
         """
         from fpdf import XPos, YPos
 
@@ -1375,7 +1507,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         with PDFWriter(path) as file:
             pdf = file._pdf
             pdf.set_font("Helvetica", "B", 16)
-            pdf.cell(0, 10, "OMNY Sample Storage", new_x=XPos.LMARGIN, new_y=YPos.NEXT, align="C")
+            pdf.cell(0, 10, "OMNY Shuttle Samples", new_x=XPos.LMARGIN, new_y=YPos.NEXT, align="C")
             pdf.set_font("Helvetica", "", 10)
             timestamp = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
             pdf.cell(0, 6, timestamp, new_x=XPos.LMARGIN, new_y=YPos.NEXT, align="C")
@@ -1383,27 +1515,10 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
             margin = pdf.l_margin
             usable_w = pdf.w - 2 * margin
-            cell_w = usable_w / 5
             cell_h = 28
 
-            # header: stage + gripper, same widths as two fixed-O cells
-            y0 = pdf.get_y()
-            self._draw_report_cell(pdf, margin, y0, cell_w, cell_h, ("stage",), state.get(("stage",)))
-            self._draw_report_cell(
-                pdf, margin + cell_w, y0, cell_w, cell_h, ("gripper",), state.get(("gripper",))
-            )
-
-            # fixed O positions, same 5-wide grid as the on-screen layout
-            fixed_y0 = y0 + cell_h + 4
-            for idx, n in enumerate(OMNY_FIXED_POSITIONS):
-                r, c = divmod(idx, 5)
-                x = margin + c * cell_w
-                y = fixed_y0 + r * cell_h
-                key = ("O", n)
-                self._draw_report_cell(pdf, x, y, cell_w, cell_h, key, state.get(key))
-
             # shuttles A/B/C: status line + 3-wide slot grid, side by side
-            shuttle_y0 = fixed_y0 + 2 * cell_h + 8
+            shuttle_y0 = pdf.get_y()
             shuttle_w = usable_w / 3
             for si, letter in enumerate(OMNY_SHUTTLE_LETTERS):
                 x0 = margin + si * shuttle_w
diff --git a/csaxs_bec/devices/omny/omny_sample_storage.py b/csaxs_bec/devices/omny/omny_sample_storage.py
index 000cb19a..362fc537 100644
--- a/csaxs_bec/devices/omny/omny_sample_storage.py
+++ b/csaxs_bec/devices/omny/omny_sample_storage.py
@@ -1,4 +1,5 @@
 import time
+from typing import Optional
 
 from ophyd import Component as Cpt
 from ophyd import Device
@@ -27,13 +28,16 @@ class OMNYSampleStorage(Device):
         "get_sample_owner_in_gripper",
         "set_sample_status_in_samplestage",
         "get_sample_status_in_samplestage",
+        "get_sample_account_in_samplestage",
         "set_sample_status_in_gripper",
         "get_sample_status_in_gripper",
+        "get_sample_account_in_gripper",
         "get_sample_name",
         "get_sample_owner",
         "get_sample_name_and_owner",
         "set_sample_status",
         "get_sample_status",
+        "get_sample_account",
         "is_sample_in_samplestage",
         "set_shuttle_slot",
         "unset_shuttle_slot",
@@ -46,17 +50,26 @@ class OMNYSampleStorage(Device):
     SUB_VALUE = "value"
     _default_sub = SUB_VALUE
 
-    # Measured status, one of these three -- an "ai" record's VAL (see
-    # omny_samples_status.template in the OMNY/OMNY.git IOC repo), not a
-    # proper EPICS enum: this IOC's sample DB uses plain "ai" records
-    # uniformly even for boolean-ish fields (see the placed-flag records),
-    # so the new STATUS record follows the same convention rather than
-    # introducing an mbbo/mbbi record type used nowhere else here. The
-    # int<->str mapping lives entirely in this class.
+    # Measured status *and* account, packed into one number -- an "ai"
+    # record's VAL (see omny_samples_status.template in the OMNY/OMNY.git
+    # IOC repo), not a proper EPICS enum: this IOC's sample DB uses plain
+    # "ai" records uniformly even for boolean-ish fields (see the
+    # placed-flag records), so the STATUS record follows the same
+    # convention rather than introducing a new record type used nowhere
+    # else here.
+    #
+    # Encoding: VAL == 0 means "not measured"; otherwise VAL's magnitude is
+    # the 5-digit beamtime account and its sign is the status -- negative
+    # while a measurement is in progress ("started"), positive once it's
+    # done ("completed"). This packs status+account into the one VAL this
+    # IOC's "ai"-record convention already gives us, with no new EPICS
+    # record needed. An account that isn't exactly 5 digits (e.g. a
+    # non-numeric test account) falls back to FALLBACK_ACCOUNT (11111) --
+    # safe because real account numbers are already above 20000, so this
+    # sentinel can never collide with a real one, and only ever shows up
+    # for test accounts.
     STATUS_NONE = 0
-    STATUS_STARTED = 1
-    STATUS_COMPLETED = 2
-    _STATUS_LABELS = {STATUS_NONE: "none", STATUS_STARTED: "started", STATUS_COMPLETED: "completed"}
+    FALLBACK_ACCOUNT = 11111
 
     sample_shuttle_A_placed = {
         f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}", {"auto_monitor": True}) for i in range(1, 7)
@@ -119,11 +132,11 @@ class OMNYSampleStorage(Device):
     }
     sample_names = Dcpt(sample_names)
 
-    # Measured status (VAL) + owner (DESC) -- one new record per sample
-    # position, added alongside the existing placed/name records (see
-    # STATUS_NONE/STARTED/COMPLETED above and omny_samples_status.template
-    # in OMNY/OMNY.git). Parking slots have no equivalent -- they hold a
-    # shuttle letter, not a sample.
+    # Measured status+account (VAL) + owner (DESC) -- one new record per
+    # sample position, added alongside the existing placed/name records
+    # (see the status+account VAL encoding described above and
+    # omny_samples_status.template in OMNY/OMNY.git). Parking slots have no
+    # equivalent -- they hold a shuttle letter, not a sample.
     sample_shuttle_A_status = {
         f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}:STATUS", {"auto_monitor": True})
         for i in range(1, 7)
@@ -242,27 +255,53 @@ class OMNYSampleStorage(Device):
         self._run_subs(sub_type=self.SUB_VALUE, timestamp=timestamp, obj=self)
 
     @classmethod
-    def _status_str_to_val(cls, status: str) -> int:
-        status = (status or "none").strip().lower()
-        for val, label in cls._STATUS_LABELS.items():
-            if label == status:
+    def _normalize_account(cls, account) -> int:
+        """A positive 5-digit account number for the status+account VAL
+        encoding (see the class docstring comment above), or
+        FALLBACK_ACCOUNT if `account` doesn't parse as exactly 5 digits.
+        """
+        digits = "".join(ch for ch in str(account) if ch.isdigit()) if account is not None else ""
+        if len(digits) == 5:
+            val = int(digits)
+            if 10000 <= val <= 99999:
                 return val
-        raise OMNYSampleStorageError(
-            f"Invalid status {status!r}; expected one of {sorted(cls._STATUS_LABELS.values())}."
-        )
+        return cls.FALLBACK_ACCOUNT
 
     @classmethod
-    def _status_val_to_str(cls, val) -> str:
+    def _status_to_val(cls, status: str, account=None) -> int:
+        status = (status or "none").strip().lower()
+        if status == "none":
+            return 0
+        if status not in ("started", "completed"):
+            raise OMNYSampleStorageError(
+                f"Invalid status {status!r}; expected one of ['none', 'started', 'completed']."
+            )
+        acc = cls._normalize_account(account)
+        return -acc if status == "started" else acc
+
+    @classmethod
+    def _val_to_status(cls, val) -> str:
         try:
-            return cls._STATUS_LABELS.get(int(round(float(val))), "none")
+            v = int(round(float(val)))
         except (TypeError, ValueError):
             return "none"
+        if v == 0:
+            return "none"
+        return "started" if v < 0 else "completed"
+
+    @classmethod
+    def _val_to_account(cls, val) -> Optional[int]:
+        try:
+            v = int(round(float(val)))
+        except (TypeError, ValueError):
+            return None
+        return abs(v) if v != 0 else None
 
     def set_sample_slot(self, container: str, slot_nr: int, name: str, owner: str = "") -> bool:
         if slot_nr > 20:
             raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
 
-        status = self._status_str_to_val("none")
+        status = self._status_to_val("none")
         if container == "A":
             getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").set(1)
             getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").set(name)
@@ -288,7 +327,7 @@ class OMNYSampleStorage(Device):
         if slot_nr > 20:
             raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
 
-        status = self._status_str_to_val("none")
+        status = self._status_to_val("none")
         if container == "A":
             getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").set(0)
             getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").set("-")
@@ -310,8 +349,8 @@ class OMNYSampleStorage(Device):
             getattr(self.sample_owners, f"sample{slot_nr}").set("")
             getattr(self.sample_status, f"sample{slot_nr}").set(status)
 
-    def set_sample_status(self, container: str, slot_nr: int, status: str) -> bool:
-        val = self._status_str_to_val(status)
+    def set_sample_status(self, container: str, slot_nr: int, status: str, account=None) -> bool:
+        val = self._status_to_val(status, account)
         if container == "A":
             getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(val)
         elif container == "B":
@@ -332,7 +371,24 @@ class OMNYSampleStorage(Device):
             val = getattr(self.sample_status, f"sample{slot_nr}").get()
         else:
             return "none"
-        return self._status_val_to_str(val)
+        return self._val_to_status(val)
+
+    def get_sample_account(self, container: str, slot_nr: int) -> Optional[int]:
+        """The account packed into this slot's status VAL (see the
+        status+account encoding described above ``STATUS_NONE``), or None
+        if the slot isn't measured ("none" status).
+        """
+        if container == "A":
+            val = getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").get()
+        elif container == "B":
+            val = getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").get()
+        elif container == "C":
+            val = getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").get()
+        elif container == "O":
+            val = getattr(self.sample_status, f"sample{slot_nr}").get()
+        else:
+            return None
+        return self._val_to_account(val)
 
     def get_sample_owner(self, container: str, slot_nr: int) -> str:
         if container == "A":
@@ -366,25 +422,25 @@ class OMNYSampleStorage(Device):
         self.sample_in_gripper.set(1)
         self.sample_in_gripper_name.set(name)
         self.sample_in_gripper_owner.set(owner)
-        self.sample_in_gripper_status.set(self._status_str_to_val("none"))
+        self.sample_in_gripper_status.set(self._status_to_val("none"))
 
     def unset_sample_in_gripper(self) -> bool:
         self.sample_in_gripper.set(0)
         self.sample_in_gripper_name.set("-")
         self.sample_in_gripper_owner.set("")
-        self.sample_in_gripper_status.set(self._status_str_to_val("none"))
+        self.sample_in_gripper_status.set(self._status_to_val("none"))
 
     def set_sample_in_samplestage(self, name: str, owner: str = "") -> bool:
         self.sample_in_samplestage.set(1)
         self.sample_in_samplestage_name.set(name)
         self.sample_in_samplestage_owner.set(owner)
-        self.sample_in_samplestage_status.set(self._status_str_to_val("none"))
+        self.sample_in_samplestage_status.set(self._status_to_val("none"))
 
     def unset_sample_in_samplestage(self) -> bool:
         self.sample_in_samplestage.set(0)
         self.sample_in_samplestage_name.set("-")
         self.sample_in_samplestage_owner.set("")
-        self.sample_in_samplestage_status.set(self._status_str_to_val("none"))
+        self.sample_in_samplestage_status.set(self._status_to_val("none"))
 
     def get_sample_owner_in_gripper(self) -> str:
         val = self.sample_in_gripper_owner.get()
@@ -394,17 +450,23 @@ class OMNYSampleStorage(Device):
         val = self.sample_in_samplestage_owner.get()
         return str(val) if val else ""
 
-    def set_sample_status_in_gripper(self, status: str) -> bool:
-        self.sample_in_gripper_status.set(self._status_str_to_val(status))
+    def set_sample_status_in_gripper(self, status: str, account=None) -> bool:
+        self.sample_in_gripper_status.set(self._status_to_val(status, account))
 
     def get_sample_status_in_gripper(self) -> str:
-        return self._status_val_to_str(self.sample_in_gripper_status.get())
+        return self._val_to_status(self.sample_in_gripper_status.get())
 
-    def set_sample_status_in_samplestage(self, status: str) -> bool:
-        self.sample_in_samplestage_status.set(self._status_str_to_val(status))
+    def get_sample_account_in_gripper(self) -> Optional[int]:
+        return self._val_to_account(self.sample_in_gripper_status.get())
+
+    def set_sample_status_in_samplestage(self, status: str, account=None) -> bool:
+        self.sample_in_samplestage_status.set(self._status_to_val(status, account))
 
     def get_sample_status_in_samplestage(self) -> str:
-        return self._status_val_to_str(self.sample_in_samplestage_status.get())
+        return self._val_to_status(self.sample_in_samplestage_status.get())
+
+    def get_sample_account_in_samplestage(self) -> Optional[int]:
+        return self._val_to_account(self.sample_in_samplestage_status.get())
 
     def is_sample_slot_used(self, container, slot_nr: int) -> bool:
         if container == "A":
@@ -473,9 +535,11 @@ class OMNYSampleStorage(Device):
         status = self.get_sample_status(container, slot_nr)
         suffix = f" ({owner})" if owner else ""
         if status == "started":
-            suffix += "  ◐ started"
+            account = self.get_sample_account(container, slot_nr)
+            suffix += f"  ◐ started (acc {account})"
         elif status == "completed":
-            suffix += "  ✓ completed"
+            account = self.get_sample_account(container, slot_nr)
+            suffix += f"  ✓ completed (acc {account})"
         return name + suffix
 
     def show_all(self):
@@ -508,9 +572,9 @@ class OMNYSampleStorage(Device):
             status = self.get_sample_status_in_samplestage()
             suffix = f" ({owner})" if owner else ""
             if status == "started":
-                suffix += "  ◐ started"
+                suffix += f"  ◐ started (acc {self.get_sample_account_in_samplestage()})"
             elif status == "completed":
-                suffix += "  ✓ completed"
+                suffix += f"  ✓ completed (acc {self.get_sample_account_in_samplestage()})"
             print(f"\n\n  Sample stage:   {name}{suffix}")
         else:
             print(f"\n\n  Sample stage:   no sample")
@@ -544,9 +608,12 @@ class OMNYSampleStorage(Device):
         print(" dev.omny_samples.set_sample_slot('system',position,'name','owner')")
         print("   system can be A, B, C, O")
         print(" dev.omny_samples.get_sample_owner('system',position)")
-        print(" dev.omny_samples.set_sample_status('system',position,'status')")
+        print(" dev.omny_samples.set_sample_status('system',position,'status',account)")
         print("   status is one of 'none', 'started', 'completed'")
+        print("   account is required for 'started'/'completed' (a 5-digit account number,")
+        print("   falls back to 11111 if not exactly 5 digits)")
         print(" dev.omny_samples.get_sample_status('system',position)")
+        print(" dev.omny_samples.get_sample_account('system',position)")
         print(" dev.omny_samples.set_sample_in_gripper('name','owner') / unset_sample_in_gripper()")
         print(" dev.omny_samples.set_sample_in_samplestage('name','owner'), unset_sample_in_samplestage()")
         print(" dev.omny_samples.set_shuttle_slot(container, slot_nr) / unset_shuttle_slot(slot_nr)")
diff --git a/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py b/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py
index b91c833c..5f4deea3 100644
--- a/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_omny_sample_storage_widget_math.py
@@ -31,6 +31,26 @@ def test_oparkz_active_parking_slot_matches_each_target(readback, expected_slot)
     assert oparkz_active_parking_slot(readback) == expected_slot
 
 
+@pytest.mark.parametrize(
+    "readback,expected_slot",
+    [
+        (-6, 6),
+        (-6 - 29, 5),
+        (-6 - 29 * 2, 4),
+        (-6 - 29 * 3, 3),
+        (-6 - 29 * 3 - 42 - 0.05, 2),
+    ],
+)
+def test_oparkz_active_parking_slot_matches_each_leica_target(readback, expected_slot):
+    """otransfer_park_loadlock_slot()'s targets (_oparkz_leica_slot(), a
+    different oparkz offset than the regular otransfer_park_slot() table)
+    must be recognized as "active" too -- a real bug: the GUI never showed
+    the active badge after a loadlock-driven park, since only the regular
+    target table was checked.
+    """
+    assert oparkz_active_parking_slot(readback) == expected_slot
+
+
 def test_oparkz_active_parking_slot_none_when_far_from_any_target():
     assert oparkz_active_parking_slot(0.0) is None
 
diff --git a/tests/tests_devices/test_omny_sample_storage.py b/tests/tests_devices/test_omny_sample_storage.py
new file mode 100644
index 00000000..71a730e2
--- /dev/null
+++ b/tests/tests_devices/test_omny_sample_storage.py
@@ -0,0 +1,47 @@
+import pytest
+
+from csaxs_bec.devices.omny.omny_sample_storage import OMNYSampleStorage, OMNYSampleStorageError
+
+
+def test_status_none_encodes_to_zero():
+    assert OMNYSampleStorage._status_to_val("none") == 0
+    assert OMNYSampleStorage._val_to_status(0) == "none"
+    assert OMNYSampleStorage._val_to_account(0) is None
+
+
+@pytest.mark.parametrize("account", [20123, "20123", "e20123"])
+def test_started_encodes_negative_account(account):
+    val = OMNYSampleStorage._status_to_val("started", account)
+    assert val == -20123
+    assert OMNYSampleStorage._val_to_status(val) == "started"
+    assert OMNYSampleStorage._val_to_account(val) == 20123
+
+
+@pytest.mark.parametrize("account", [20123, "20123", "e20123"])
+def test_completed_encodes_positive_account(account):
+    val = OMNYSampleStorage._status_to_val("completed", account)
+    assert val == 20123
+    assert OMNYSampleStorage._val_to_status(val) == "completed"
+    assert OMNYSampleStorage._val_to_account(val) == 20123
+
+
+@pytest.mark.parametrize("bad_account", [None, "", "not-a-number", "123", "123456", "e-test"])
+def test_unparseable_account_falls_back_to_sentinel(bad_account):
+    val = OMNYSampleStorage._status_to_val("started", bad_account)
+    assert OMNYSampleStorage._val_to_account(val) == OMNYSampleStorage.FALLBACK_ACCOUNT
+    assert OMNYSampleStorage.FALLBACK_ACCOUNT == 11111
+
+
+def test_invalid_status_raises():
+    with pytest.raises(OMNYSampleStorageError):
+        OMNYSampleStorage._status_to_val("bogus")
+
+
+@pytest.mark.parametrize("raw", ["not-a-number", None, object()])
+def test_val_to_status_defaults_to_none_on_bad_input(raw):
+    assert OMNYSampleStorage._val_to_status(raw) == "none"
+
+
+@pytest.mark.parametrize("raw", ["not-a-number", None, object()])
+def test_val_to_account_defaults_to_none_on_bad_input(raw):
+    assert OMNYSampleStorage._val_to_account(raw) is None

From bae3094761a1d8291c691f69f5372d928f638722 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 20:02:04 +0200
Subject: [PATCH 045/102] fix(omny): use GUI confirm dialogs in transfer flow;
 fix sim sensor voltage

- omny_sample_transfer_mixin.py: add otransfer_confirm_dialog(), mirroring
  flomni.py's ftransfer_confirm_dialog() -- routes sample-transfer
  confirmations through the GUI console widget (already opened by
  _omnycam_parking()/_omnycam_samplestage()) when available, instead of
  always blocking on a terminal input() prompt. Falls back to the plain
  yesno() prompt if the camera view hasn't been opened yet. All 8
  self.OMNYTools.yesno() call sites in the transfer flow now go through it.
- simulated_omny.yaml: otransy's gripper-sensor check
  (_otransfer_check_sensor_connected(), @AN[8001]) always failed in sim --
  it fell back to the simulated Galil's shared default for unseeded analog
  channels (-8.0V, tuned for motor-temperature registers elsewhere), against
  an expected -2.3V +-0.5V. Added sim_analog_inputs: {8001: -2.3} to seed
  that specific channel.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../omny/omny_sample_transfer_mixin.py        | 37 +++++++++++++++----
 .../simulated_omny/simulated_omny.yaml        |  8 ++++
 2 files changed, 37 insertions(+), 8 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 58b3b093..81d5e7e4 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -51,6 +51,27 @@ class OMNYSampleTransferMixin:
             raise ValueError(f"Device {device} has no user parameter definition for {var}.")
         return param.get(var)
 
+    def otransfer_confirm_dialog(self, message: str, default: str = "none") -> bool:
+        """
+        Yes/No confirmation for sample-transfer steps -- OMNY's counterpart
+        to flomni.py's ``ftransfer_confirm_dialog()``.
+
+        Uses the GUI console widget (ConsoleButtonsWidget, opened by
+        ``_omnycam_parking()``/``_omnycam_samplestage()`` in gui_tools.py)
+        when it's already available, so the operator can confirm/abort
+        right next to the live camera view, instead of a blocking terminal
+        ``input()`` prompt. Falls back to the regular console ``yesno()``
+        prompt if the cameras/console haven't been opened yet -- e.g. if a
+        transfer step is called directly, outside the usual
+        ``otransfer_get_sample``/``otransfer_put_sample`` sequence that
+        opens them first. ``self.console`` is set by ``OMNYGuiTools``
+        (a sibling mixin on the composed ``OMNY`` class), not this one.
+        """
+        if self.console is not None:
+            print("Using GUI console for confirmation dialog.")
+            return self.OMNYTools.gui_yesno(message, gui=self.console, default=default)
+        return self.OMNYTools.yesno(message, default)
+
     def _otransfer_shuttle_aligner_down(self):
         if not dev.oshuttlealign.get_motor_limit_switch()[1]:
             dev.oshuttlealign.drive_axis_to_limit("forward")
@@ -143,7 +164,7 @@ class OMNYSampleTransferMixin:
             if not dev.oshuttlealign.get_motor_limit_switch()[0]:
                 print("Not in correct start position for alignment.")
                 dev.oshuttlealign.controller.socket_put_confirmed("MO")
-                if self.OMNYTools.yesno(
+                if self.otransfer_confirm_dialog(
                     "Shall I try to move it to the correct start position? Do this only once!"
                 ):
                     print("starting...")
@@ -373,7 +394,7 @@ class OMNYSampleTransferMixin:
 
     def _otransfer_gripper_to_park_z(self):
         if not self._otransfer_gripper_querry_status_closed():
-            if self.OMNYTools.yesno(
+            if self.otransfer_confirm_dialog(
                 "The gripper appears to be open, while it was expected to be closed.May it be closed now?",
                 "y",
             ):
@@ -474,7 +495,7 @@ class OMNYSampleTransferMixin:
             )
         # if the valve of the loadlock is not closed, ask before movement
         # todo if(epics_get("XOMNY-ES1-LL1VG1:POSITION")!="CLOSED") {
-        if not self.OMNYTools.yesno("Please confirm that the leica transfer is in back position."):
+        if not self.otransfer_confirm_dialog("Please confirm that the leica transfer is in back position."):
             raise OMNYTransferError("Leica shuttle is not in back position.")
         else:
             self._oparkz_leica_slot(slot_number)
@@ -780,7 +801,7 @@ class OMNYSampleTransferMixin:
         # keep shuttle open and ask user which sample to pick
         # but have to make sure that shield will be closed for sample pos movements beyond shuttle positions
         if pin_position in range(1, 7):
-            if self.OMNYTools.yesno(
+            if self.otransfer_confirm_dialog(
                 "Pick another sample from this shuttle? Keep shield open?", "y"
             ):
                 print(
@@ -811,7 +832,7 @@ class OMNYSampleTransferMixin:
                     toppin = self._otransfer_get_toppin_position()
                     print(f"TopPin position is {toppin:.3f} mm")
                     if self._otransfer_get_toppin_position() > -25.4:
-                        if not self.OMNYTools.yesno(
+                        if not self.otransfer_confirm_dialog(
                             "THIS IS LARGER THAN THE CURRENT THRESHOLD OF -25.4. ARE YOU SURE THE PIN IS OK AND DOES NOT HAVE A DAMAGE IN THE BOTTOM? Continue?"
                         ):
                             raise OMNYTransferError("Abort by user because of top pin position.")
@@ -822,7 +843,7 @@ class OMNYSampleTransferMixin:
                 elif mntprgs == 0:
                     text = "All OK? Please confirm"
 
-                if self.OMNYTools.yesno(text, "y"):
+                if self.otransfer_confirm_dialog(text, "y"):
                     self.transfer_step += 1
                     self._otransfer_save_reference_images(file_suffix=f"{step_name}_{self.transfer_step}")
                     dev.otransy.controller.socket_put_confirmed("confirm=1")
@@ -878,7 +899,7 @@ class OMNYSampleTransferMixin:
     def otransfer_get_sample(self, pin_position: int):
         self.transfer_step = 0
         self._omnycam_parking()
-        if not self.OMNYTools.yesno(
+        if not self.otransfer_confirm_dialog(
             "Please confirm that currently there is no sample in the gripper. It would be dropped!",
             "y",
         ):
@@ -957,7 +978,7 @@ class OMNYSampleTransferMixin:
             feedback_status = self.device_manager.devices.rtx.controller.feedback_is_running()
             if feedback_status == True:
                 # feedback is running
-                if self.OMNYTools.yesno("May the feedback be disabled", "y"):
+                if self.otransfer_confirm_dialog("May the feedback be disabled", "y"):
                     raise OMNYTransferError(
                         "Manual abort of sample transfer, need to disable feedback has not been confirmed."
                     )
diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index 199d010e..6f888f8c 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -279,6 +279,14 @@ otransy:
     sign: 1
     sim_velocity: 10.0
     sim_initial_position: 0
+    # _otransfer_check_sensor_connected() reads @AN[8001] as the gripper's
+    # sensor voltage and expects it within 0.5V of gripper_sensorvoltagetarget
+    # below (-2.3). Without an override here it falls back to the simulated
+    # Galil's shared default for unseeded analog channels (-8.0V, tuned for
+    # motor-temperature registers elsewhere, not this one), which always
+    # fails the check -- see sim_galil.py's _DEFAULT_ANALOG_INPUT_V.
+    sim_analog_inputs:
+      8001: -2.3
   enabled: true
   onFailure: buffer
   readOnly: false

From 53f3686d225d4f306d8227783727877c5bb54ce5 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 20:09:12 +0200
Subject: [PATCH 046/102] fix(omny): quote sim_analog_inputs key as a string,
 fixes config reload

The bare YAML int key (8001:) broke config reload entirely: BEC's msgpack
config transport uses strict_map_key=True, which rejects non-string map
keys outright ("int is not allowed for map key"). Quoting it ("8001":)
matches the existing convention already used in simulated_flomni.yaml's
own sim_analog_inputs, and round-trips through msgpack correctly --
configure_axis() already does int(chan) internally, so the string key
still resolves to the same channel.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index 6f888f8c..a8c82cc6 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -285,8 +285,12 @@ otransy:
     # Galil's shared default for unseeded analog channels (-8.0V, tuned for
     # motor-temperature registers elsewhere, not this one), which always
     # fails the check -- see sim_galil.py's _DEFAULT_ANALOG_INPUT_V.
+    # Key must be a quoted string, not a bare YAML int: BEC's msgpack config
+    # transport uses strict_map_key=True, which rejects int map keys outright
+    # (a bare 8001: here breaks config reload entirely) -- matches the
+    # existing convention in simulated_flomni.yaml's own sim_analog_inputs.
     sim_analog_inputs:
-      8001: -2.3
+      "8001": -2.3
   enabled: true
   onFailure: buffer
   readOnly: false

From fbc76b4fb16ec05638890189bc3685adcba87135 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Thu, 3 Sep 2026 20:19:12 +0200
Subject: [PATCH 047/102] fix(omny): simulate oshield's digital open-switch
 from its live position

_oshield_is_ST_open() reads a digital switch (@IN[8014]) on otransx's Galil
controller to confirm the sample-stage thermal shield reached its physical
"open" limit -- but oshield is a Smaract stage, simulated by a completely
separate simulator (sim_smaract.py), so that switch had no connection to
oshield's actual simulated position and always read a stale default.

sim_galil.py's @IN[8014] handler now computes the switch value live from
oshield's real position via SimStateRegistry (cross-simulator lookup),
instead of a disconnected default -- 1.0 within tolerance of the "open"
target (-11.88, _oshield_ST_open()'s own umv() target), 0.0 otherwise.

Also fixes oshield's simulated starting position: it started at 0 (neither
the "open" -11.88 nor "closed" 15.5), so _otransfer_stage_to_ST()'s
oshield_current < 15 closed-check always failed fresh. Now starts at 15.5,
matching the real idle/closed resting state.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../simulated_omny/simulated_omny.yaml        |   6 +-
 csaxs_bec/devices/sim/sim_galil.py            |  37 ++++++
 .../test_sim_galil_oshield_switch.py          | 118 ++++++++++++++++++
 3 files changed, 160 insertions(+), 1 deletion(-)
 create mode 100644 tests/tests_devices/test_sim_galil_oshield_switch.py

diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index a8c82cc6..b49e5d5b 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -709,7 +709,11 @@ oshield:
     - 15.8
     port: 3334
     sign: 1
-    sim_initial_position: 0
+    # Real hardware idles with the sample-stage shield closed; 15.5 is
+    # _oshield_ST_close()'s own umv() target (omny_sample_transfer_mixin.py).
+    # Starting at 0 (neither open -11.88 nor closed 15.5) always failed
+    # _otransfer_stage_to_ST()'s "oshield_current < 15" closed check.
+    sim_initial_position: 15.5
   enabled: true
   onFailure: buffer
   readOnly: false
diff --git a/csaxs_bec/devices/sim/sim_galil.py b/csaxs_bec/devices/sim/sim_galil.py
index d6a21fc3..c61e8b86 100644
--- a/csaxs_bec/devices/sim/sim_galil.py
+++ b/csaxs_bec/devices/sim/sim_galil.py
@@ -46,6 +46,37 @@ _OMNY_ROTATION_AXIS = 2
 # 150 degC on every axis without an explicit sim_analog_inputs override.
 _DEFAULT_ANALOG_INPUT_V = -8.0
 
+# oshield (the sample-stage thermal shield) is a Smaract stage, not a Galil axis --
+# but its "fully open" limit switch is wired into *this* Galil controller's digital
+# input @IN[8014] on real hardware, read via otransx's socket since they share the
+# same controller (see _oshield_is_ST_open() in omny_sample_transfer_mixin.py: "the
+# switch for detecting status can be reached via galil controller 1, so we use
+# otransx for access"). oshield's own simulated position lives entirely in
+# sim_smaract.py's SimSmaractState (a different simulator, keyed by a different
+# host/port), so without this, @IN[8014] would read a static default forever,
+# disagreeing with wherever oshield actually simulated-moved to. Computed dynamically
+# below instead of seeded once, since oshield's position changes during a session.
+_OSHIELD_OPEN_SWITCH_CHANNEL = 8014
+_OSHIELD_GALIL_HOST = "mpc3217.psi.ch"
+_OSHIELD_GALIL_PORT = 8081  # otransx/otransy's controller
+_OSHIELD_SMARACT_HOST = "mpc3217.psi.ch"
+_OSHIELD_SMARACT_PORT = 3334
+_OSHIELD_SMARACT_AXIS = 2  # axis_Id "C"
+_OSHIELD_OPEN_POSITION_MM = -11.88  # _oshield_ST_open()'s own umv() target
+_OSHIELD_OPEN_TOLERANCE_MM = 0.1
+
+
+def _oshield_open_switch_value() -> float:
+    # Imported lazily to avoid a module-level import cycle risk between the two
+    # simulator modules; sim_smaract.py doesn't import sim_galil.py today, but
+    # keeping this import local avoids ever having to care if that changes.
+    from csaxs_bec.devices.sim.sim_smaract import SimSmaractState
+
+    state = SimStateRegistry.get(SimSmaractState, _OSHIELD_SMARACT_HOST, _OSHIELD_SMARACT_PORT)
+    position_mm = state.axis(_OSHIELD_SMARACT_AXIS).position() / 1.0e6  # nm -> mm
+    is_open = abs(position_mm - _OSHIELD_OPEN_POSITION_MM) < _OSHIELD_OPEN_TOLERANCE_MM
+    return 1.0 if is_open else 0.0
+
 
 class _SimGalilAxis:
     """State of a single simulated Galil axis (positions in microsteps)."""
@@ -494,6 +525,12 @@ class SimGalilSocket(SimSocketBase):
             return "0.0000"
         if arg.startswith("@IN["):
             channel = int(arg[4:].split("]")[0])
+            if (
+                channel == _OSHIELD_OPEN_SWITCH_CHANNEL
+                and state.host == _OSHIELD_GALIL_HOST
+                and state.port == _OSHIELD_GALIL_PORT
+            ):
+                return f"{_oshield_open_switch_value():.4f}"
             return f"{state.digital_inputs.get(channel, 0.0):.4f}"
         if arg.startswith("@OUT["):
             channel = int(arg[5:].split("]")[0])
diff --git a/tests/tests_devices/test_sim_galil_oshield_switch.py b/tests/tests_devices/test_sim_galil_oshield_switch.py
new file mode 100644
index 00000000..f33d1f07
--- /dev/null
+++ b/tests/tests_devices/test_sim_galil_oshield_switch.py
@@ -0,0 +1,118 @@
+import pytest
+from bec_server.device_server.tests.utils import DMMock
+
+from csaxs_bec.devices.omny.galil.ogalil_ophyd import OMNYGalilController
+from csaxs_bec.devices.sim.sim_galil import (
+    _OSHIELD_GALIL_HOST,
+    _OSHIELD_GALIL_PORT,
+    _OSHIELD_OPEN_POSITION_MM,
+    _OSHIELD_SMARACT_AXIS,
+    _OSHIELD_SMARACT_PORT,
+)
+from csaxs_bec.devices.sim.sim_omny import SimOMNYGalilMotor
+from csaxs_bec.devices.sim.sim_smaract import SimSmaractMotor, SimSmaractState
+from csaxs_bec.devices.sim.sim_socket import SimStateRegistry
+
+# otransx's own axis letter doesn't matter here -- only its host/port (shared with
+# oshield's "open" limit switch on real hardware, see sim_galil.py's
+# _OSHIELD_GALIL_HOST/_OSHIELD_GALIL_PORT).
+_OTRANSX_AXIS_ID = "D"
+
+
+@pytest.fixture(autouse=True)
+def _reset_sim_state():
+    OMNYGalilController._reset_controller()
+    SimStateRegistry.reset()
+    yield
+    SimStateRegistry.reset()
+    OMNYGalilController._reset_controller()
+
+
+def _make_devices(oshield_initial_position):
+    otransx = SimOMNYGalilMotor(
+        _OTRANSX_AXIS_ID,
+        name="otransx",
+        host=_OSHIELD_GALIL_HOST,
+        port=_OSHIELD_GALIL_PORT,
+        sign=1,
+        device_manager=DMMock(),
+        sim_initial_position=0,
+        sim_velocity=10.0,
+    )
+    otransx.wait_for_connection()
+    oshield = SimSmaractMotor(
+        "C",
+        name="oshield",
+        host=_OSHIELD_GALIL_HOST,
+        port=_OSHIELD_SMARACT_PORT,
+        sign=1,
+        device_manager=DMMock(),
+        sim_initial_position=oshield_initial_position,
+        sim_velocity=10.0,
+    )
+    oshield.wait_for_connection()
+    return otransx, oshield
+
+
+def _switch_value(otransx) -> float:
+    return float(otransx.controller.socket_put_and_receive("MG @IN[8014]"))
+
+
+def test_switch_reads_closed_when_oshield_is_closed():
+    """oshield closed (15.5, _oshield_ST_close()'s own target) -> switch not
+    triggered, matching _oshield_is_ST_open()'s real-hardware semantics."""
+    otransx, oshield = _make_devices(15.5)
+    try:
+        assert _switch_value(otransx) == 0.0
+    finally:
+        otransx.destroy()
+        oshield.destroy()
+
+
+def test_switch_reads_open_when_oshield_is_at_open_position():
+    otransx, oshield = _make_devices(_OSHIELD_OPEN_POSITION_MM)
+    try:
+        assert _switch_value(otransx) == 1.0
+    finally:
+        otransx.destroy()
+        oshield.destroy()
+
+
+def test_switch_tracks_oshield_position_live_not_just_at_startup():
+    """The switch must reflect oshield's *current* simulated position, not
+    just whatever it started at -- this is the actual bug being fixed:
+    the digital switch and oshield's position are simulated by two
+    different simulator classes (Galil vs Smaract) that don't otherwise
+    talk to each other."""
+    otransx, oshield = _make_devices(15.5)
+    try:
+        assert _switch_value(otransx) == 0.0
+        state = SimStateRegistry.get(SimSmaractState, _OSHIELD_GALIL_HOST, _OSHIELD_SMARACT_PORT)
+        state.axis(_OSHIELD_SMARACT_AXIS).pos_nm = _OSHIELD_OPEN_POSITION_MM * 1.0e6
+        assert _switch_value(otransx) == 1.0
+    finally:
+        otransx.destroy()
+        oshield.destroy()
+
+
+def test_switch_reads_closed_at_an_intermediate_position():
+    otransx, oshield = _make_devices(0.0)
+    try:
+        assert _switch_value(otransx) == 0.0
+    finally:
+        otransx.destroy()
+        oshield.destroy()
+
+
+def test_other_channels_unaffected_by_the_oshield_special_case():
+    """A different digital-input channel on the same controller must still
+    use the plain seeded/default value, not get swept up in the oshield
+    special-case."""
+    otransx, oshield = _make_devices(15.5)
+    try:
+        # channel 14 (light curtain) has its own module-level default (1.0),
+        # independent of oshield's position
+        assert float(otransx.controller.socket_put_and_receive("MG @IN[14]")) == 1.0
+    finally:
+        otransx.destroy()
+        oshield.destroy()

From eef1c7eb469f4d956d93b656828e108944d59de1 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 16:36:14 +0200
Subject: [PATCH 048/102] fix(omny): reuse camera docks on parking/samplestage
 switch, GUI-confirm mount step, speed up otransx/oshield sim

- gui_tools.py: _omnycam_parking()/_omnycam_samplestage() now share one
  _omnygui_show_omnycam_pair() helper that creates the two camera Image
  docks + console once and re-points them via Image.image(device=...)
  on later switches instead of tearing down and rebuilding the whole
  GUI every time (bec_widgets' Image.image() already supports being
  called again to swap the monitored device). Also stops live mode on
  the outgoing camera pair on a switch, and drops the dead
  _omnycam_check_device_exists no-op guard in favor of the `in dev`
  idiom already used for cam_xeye in this file.
- omny_sample_transfer_mixin.py: the two remaining blocking
  input("Ready. Press Enter...") prompts in otransfer_put_sample/
  otransfer_get_sample now go through otransfer_confirm_dialog() like
  every other transfer confirmation, so they show up in the GUI console
  instead of blocking on a terminal keypress; fixed the get_sample
  prompt's copy-pasted "mount" wording to "unmount".
- simulated_omny.yaml: otransx sim_velocity 10->100 mm/s; oshield
  gained sim_velocity: 10.0 (previously unset, defaulting to the
  Smaract sim's 1 mm/s) -- both x10 per request.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/gui_tools.py                 | 112 +++++++-----------
 .../omny/omny_sample_transfer_mixin.py        |   6 +-
 .../simulated_omny/simulated_omny.yaml        |   3 +-
 .../test_omny_gui_tools.py                    |  46 +++++++
 4 files changed, 97 insertions(+), 70 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
index e770cf2a..367248a2 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/gui_tools.py
@@ -33,11 +33,10 @@ class OMNYGuiTools:
         self.progressbar = None
         self.xeyegui = None
         self.idle_text_box = None
-        self.fig200 = None
-        self.fig201 = None
-        self.fig202 = None
-        self.fig203 = None
+        self.cam_dock_a = None
+        self.cam_dock_b = None
         self.console = None
+        self._omnycam_shown_pair = None
 
     def set_client(self, client):
         self.client = client
@@ -68,14 +67,6 @@ class OMNYGuiTools:
             return True
         return False
 
-    def _omnycam_check_device_exists(self, device):
-        try:
-            device
-        except:
-            return False
-        else:
-            return True
-
     def omnygui_show_xeyealign(self):
         self.omnygui_show_gui()
         if self._omnygui_is_missing("xeyegui"):
@@ -104,30 +95,37 @@ class OMNYGuiTools:
         self._omnycam_active_pair = ("cam200", "cam203")
 
     def omnygui_show_omnycam_parking(self):
+        self._omnygui_show_omnycam_pair("cam200", "cam203", num_rotation_90=3)
+
+    def _omnycam_samplestage(self):
+        self.omnygui_show_omnycam_samplestage()
+        self._omnycam_active_pair = ("cam201", "cam202")
+
+    def omnygui_show_omnycam_samplestage(self):
+        self._omnygui_show_omnycam_pair("cam201", "cam202", num_rotation_90=0)
+
+    def _omnygui_show_omnycam_pair(self, cam_a: str, cam_b: str, num_rotation_90: int = 0):
+        """Show a live camera pair, reusing the two camera docks + console
+        across parking<->samplestage switches instead of tearing the whole
+        GUI down and rebuilding it every time.
+
+        ``Image.image(device=..., signal=...)`` (bec_widgets) disconnects
+        the previous monitor and reconnects to the new one on an existing
+        widget, so switching pairs is just re-pointing ``cam_dock_a``/
+        ``cam_dock_b`` at the new devices -- the docks and console are only
+        (re)created here if they don't exist yet (first camera view this
+        session, or after a full teardown via another GUI state such as
+        idle/progress/xeyealign).
+        """
         self.omnygui_show_gui()
         if (
-            self._omnygui_is_missing("fig200")
-            or self._omnygui_is_missing("fig203")
+            self._omnygui_is_missing("cam_dock_a")
+            or self._omnygui_is_missing("cam_dock_b")
             or self._omnygui_is_missing("console")
         ):
             self.omnygui_remove_all_docks()
-            self.fig200 = self.gui.omny.new("Image")
-            if self._omnycam_check_device_exists(dev.cam200):
-                self.fig200.image(device="cam200", signal="preview")
-                self.fig200.num_rotation_90 = 3
-                self.fig200.lock_aspect_ratio = True
-                dev.cam200.start_live_mode()
-            else:
-                print("Cannot open cam200. Device does not exist.")
-            self.fig203 = self.gui.omny.new("Image")
-            if self._omnycam_check_device_exists(dev.cam203):
-                self.fig203.image(device="cam203", signal="preview")
-                self.fig203.num_rotation_90 = 3
-                self.fig203.lock_aspect_ratio = True
-                dev.cam203.start_live_mode()
-            else:
-                print("Cannot open cam203. Device does not exist.")
-
+            self.cam_dock_a = self.gui.omny.new("Image")
+            self.cam_dock_b = self.gui.omny.new("Image")
             # Hard-stop console, docked below the cameras. otransy is the
             # closest omny analog to flomni's ftransy (both the transfer-Y
             # axis) -- no secondary/extra stop device wired yet.
@@ -140,41 +138,22 @@ class OMNYGuiTools:
             )
             self.gui.omny.set_layout_ratios(vertical=[5, 1])
 
-    def _omnycam_samplestage(self):
-        self.omnygui_show_omnycam_samplestage()
-        self._omnycam_active_pair = ("cam201", "cam202")
+        outgoing_pair = self._omnycam_shown_pair
+        if outgoing_pair and outgoing_pair != (cam_a, cam_b):
+            for cam_name in outgoing_pair:
+                if cam_name in dev:
+                    getattr(dev, cam_name).stop_live_mode()
 
-    def omnygui_show_omnycam_samplestage(self):
-        self.omnygui_show_gui()
-        if (
-            self._omnygui_is_missing("fig201")
-            or self._omnygui_is_missing("fig202")
-            or self._omnygui_is_missing("console")
-        ):
-            self.omnygui_remove_all_docks()
-            self.fig201 = self.gui.omny.new("Image")
-            if self._omnycam_check_device_exists(dev.cam201):
-                self.fig201.image(device="cam201", signal="preview")
-                self.fig201.lock_aspect_ratio = True
-                dev.cam201.start_live_mode()
+        for dock, cam_name in ((self.cam_dock_a, cam_a), (self.cam_dock_b, cam_b)):
+            if cam_name in dev:
+                dock.image(device=cam_name, signal="preview")
+                dock.num_rotation_90 = num_rotation_90
+                dock.lock_aspect_ratio = True
+                getattr(dev, cam_name).start_live_mode()
             else:
-                print("Cannot open cam201. Device does not exist.")
-            self.fig202 = self.gui.omny.new("Image")
-            if self._omnycam_check_device_exists(dev.cam202):
-                self.fig202.image(device="cam202", signal="preview")
-                self.fig202.lock_aspect_ratio = True
-                dev.cam202.start_live_mode()
-            else:
-                print("Cannot open cam202. Device does not exist.")
+                print(f"Cannot open {cam_name}. Device does not exist.")
 
-            self.console = self.gui.omny.new(
-                "z_ConsoleButtonsWidget",
-                object_name="console",
-                where="bottom",
-                hard_stop_device_name="otransy",
-                hard_stop_label="OMNY Motion Stop",
-            )
-            self.gui.omny.set_layout_ratios(vertical=[5, 1])
+        self._omnycam_shown_pair = (cam_a, cam_b)
 
     def omnygui_remove_all_docks(self):
         if hasattr(self.gui, "omny"):
@@ -183,11 +162,10 @@ class OMNYGuiTools:
         self.text_box = None
         self.xeyegui = None
         self.idle_text_box = None
-        self.fig200 = None
-        self.fig201 = None
-        self.fig202 = None
-        self.fig203 = None
+        self.cam_dock_a = None
+        self.cam_dock_b = None
         self.console = None
+        self._omnycam_shown_pair = None
 
     def omnygui_idle(self):
         self.omnygui_show_gui()
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 81d5e7e4..7ca98c90 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -779,7 +779,8 @@ class OMNYSampleTransferMixin:
         self._otransfer_controller_enable_mount_mode()
         dev.otransy.controller.socket_put_confirmed(f"mntaprch={_otransy_approach_height:.2f}")
 
-        input("Ready. Press Enter to start the mount process now...")
+        if not self.otransfer_confirm_dialog("Ready to start the mount process now?", "y"):
+            raise OMNYTransferError("Transfer process has been manually aborted.")
         dev.otransy.controller.socket_put_confirmed("XQ#GRPUT")
 
         print("The mount process started.")
@@ -932,7 +933,8 @@ class OMNYSampleTransferMixin:
 
         dev.otransy.controller.socket_put_confirmed(f"getaprch={_otransy_approach_height:.2f}")
 
-        input("Ready. Press Enter to start the mount process now...")
+        if not self.otransfer_confirm_dialog("Ready to start the unmount process now?", "y"):
+            raise OMNYTransferError("Transfer process has been manually aborted.")
 
         dev.otransy.controller.socket_put_confirmed("XQ#GRGET")
 
diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index b49e5d5b..dbd84c4c 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -255,7 +255,7 @@ otransx:
     - 0
     port: 8081
     sign: 1
-    sim_velocity: 10.0
+    sim_velocity: 100.0
     sim_initial_position: 0
   enabled: true
   onFailure: buffer
@@ -709,6 +709,7 @@ oshield:
     - 15.8
     port: 3334
     sign: 1
+    sim_velocity: 10.0
     # Real hardware idles with the sample-stage shield closed; 15.5 is
     # _oshield_ST_close()'s own umv() target (omny_sample_transfer_mixin.py).
     # Starting at 0 (neither open -11.88 nor closed 15.5) always failed
diff --git a/tests/tests_bec_ipython_client/test_omny_gui_tools.py b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
index 9e50bf59..a1e579f2 100644
--- a/tests/tests_bec_ipython_client/test_omny_gui_tools.py
+++ b/tests/tests_bec_ipython_client/test_omny_gui_tools.py
@@ -122,6 +122,7 @@ def test_omnygui_show_omnycam_parking_uses_current_image_widget_api():
     client.gui.omny.new.side_effect = [fig200, fig203, console]
 
     dev_mock = mock.MagicMock()
+    dev_mock.__contains__ = mock.Mock(return_value=True)
 
     with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
         tools.omnygui_show_omnycam_parking()
@@ -240,6 +241,7 @@ def test_omnygui_show_omnycam_samplestage_uses_current_image_widget_api():
     client.gui.omny.new.side_effect = [fig201, fig202, console]
 
     dev_mock = mock.MagicMock()
+    dev_mock.__contains__ = mock.Mock(return_value=True)
 
     with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
         tools.omnygui_show_omnycam_samplestage()
@@ -250,3 +252,47 @@ def test_omnygui_show_omnycam_samplestage_uses_current_image_widget_api():
     fig202.image.assert_called_once_with(device="cam202", signal="preview")
     dev_mock.cam202.start_live_mode.assert_called_once()
     assert tools.console is console
+
+
+def test_omnycam_switch_repoints_existing_docks_instead_of_recreating():
+    """Switching parking<->samplestage while the camera view is already open
+    must not tear down and rebuild the GUI (visible flicker) -- it should
+    reuse the same two Image docks + console and just re-point them at the
+    new camera pair via Image.image(), per bec_widgets' current API."""
+    tools, client = _make_gui_tools()
+    client.gui.windows = {"omny": mock.MagicMock()}
+    dock_a = mock.MagicMock()
+    dock_a._is_deleted.return_value = False
+    dock_b = mock.MagicMock()
+    dock_b._is_deleted.return_value = False
+    console = mock.MagicMock()
+    console._is_deleted.return_value = False
+    client.gui.omny.new.side_effect = [dock_a, dock_b, console]
+
+    dev_mock = mock.MagicMock()
+    dev_mock.__contains__ = mock.Mock(return_value=True)
+
+    with mock.patch(f"{GUI_TOOLS}.dev", dev_mock, create=True):
+        tools.omnygui_show_omnycam_parking()
+        client.gui.omny.new.reset_mock()
+        dock_a.image.reset_mock()
+        dock_b.image.reset_mock()
+
+        tools.omnygui_show_omnycam_samplestage()
+
+    # no new docks/console created on the switch
+    client.gui.omny.new.assert_not_called()
+    assert tools.cam_dock_a is dock_a
+    assert tools.cam_dock_b is dock_b
+    assert tools.console is console
+
+    # the same two docks were re-pointed at the new devices
+    dock_a.image.assert_called_once_with(device="cam201", signal="preview")
+    assert dock_a.num_rotation_90 == 0
+    dock_b.image.assert_called_once_with(device="cam202", signal="preview")
+
+    # the outgoing pair's live mode was stopped, the incoming pair's started
+    dev_mock.cam200.stop_live_mode.assert_called_once()
+    dev_mock.cam203.stop_live_mode.assert_called_once()
+    dev_mock.cam201.start_live_mode.assert_called_once()
+    dev_mock.cam202.start_live_mode.assert_called_once()

From 2086c9e4e6527ced07c10c724ecc3dbf1144b4c9 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 16:51:21 +0200
Subject: [PATCH 049/102] fix(omny): always route fast-shutter control through
 dev.fsh; carry owner/status/account across sample transfer

- shutter.py (OMNYFastShutter): drop the "use dev.fsh if configured, else
  fall back to a local dummy signal" branching -- always delegate to the
  'fsh' device. Removed the now-unused MonitorSignal class and the
  dummy shutter Cpt along with it. Rewrote test_omny_shutter.py to assert
  delegation to a mocked 'fsh' device instead of exercising the removed
  dummy fallback.
- omny_sample_transfer_mixin.py: picking a sample up (get_sample, three
  source kinds: shuttle slot, fixed position, sample stage) only carried
  the sample name into set_sample_in_gripper(), silently dropping owner
  (defaulted to "") and measured status/account (reset to "none" by
  set_sample_in_gripper() itself). Same gap in reverse on put_sample.
  All six call sites (three pick, three put) now read owner/status/account
  from the source before clearing it and carry them onto the destination.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../omny/omny_sample_transfer_mixin.py        | 55 ++++++++++---
 csaxs_bec/devices/omny/shutter.py             | 72 ++++------------
 tests/tests_devices/test_omny_shutter.py      | 82 ++++++++-----------
 3 files changed, 92 insertions(+), 117 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 7ca98c90..2ae14aa3 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -12,8 +12,6 @@ from typeguard import typechecked
 
 # from functools import wraps
 
-from csaxs_bec.bec_ipython_client.plugins.cSAXS import epics_get, epics_put, fshopen, fshclose
-
 
 if builtins.__dict__.get("bec") is not None:
     bec = builtins.__dict__.get("bec")
@@ -987,7 +985,11 @@ class OMNYSampleTransferMixin:
 
             self.device_manager.devices.rtx.controller.feedback_disable()
 
-        fshclose()
+        # dev.fsh (not the raw cSAXS_beamline.fshclose(), which does a bare
+        # epics.caput() straight to X12SA-ES1-TTL:OUT_01 outside BEC entirely
+        # -- unreachable/unmocked in a simulated session) -- same device
+        # omny_optics_mixin.py already uses for shutter control.
+        dev.fsh.fshclose()
 
         if oeyez_current < -20:
             raise OMNYTransferError(
@@ -1294,9 +1296,20 @@ class OMNYSampleTransferMixin:
                         samplename = dev.omny_samples.get_sample_name(
                             installedshuttle, _osampleposition
                         )
-                        # remove sample from slot and put to gripper
+                        owner = dev.omny_samples.get_sample_owner(
+                            installedshuttle, _osampleposition
+                        )
+                        status = dev.omny_samples.get_sample_status(
+                            installedshuttle, _osampleposition
+                        )
+                        account = dev.omny_samples.get_sample_account(
+                            installedshuttle, _osampleposition
+                        )
+                        # remove sample from slot and put to gripper -- owner/status/account
+                        # carry over with it, the same physical sample
                         dev.omny_samples.unset_sample_slot(installedshuttle, _osampleposition)
-                        dev.omny_samples.set_sample_in_gripper(samplename)
+                        dev.omny_samples.set_sample_in_gripper(samplename, owner)
+                        dev.omny_samples.set_sample_status_in_gripper(status, account)
                     return True
                 else:
                     print("There is no sample availabe at that position.")
@@ -1385,8 +1398,12 @@ class OMNYSampleTransferMixin:
             if dev.omny_samples.is_sample_slot_used("O", _osampleposition):
                 if _picked_it:
                     samplename = dev.omny_samples.get_sample_name("O", _osampleposition)
+                    owner = dev.omny_samples.get_sample_owner("O", _osampleposition)
+                    status = dev.omny_samples.get_sample_status("O", _osampleposition)
+                    account = dev.omny_samples.get_sample_account("O", _osampleposition)
                     dev.omny_samples.unset_sample_slot("O", _osampleposition)
-                    dev.omny_samples.set_sample_in_gripper(samplename)
+                    dev.omny_samples.set_sample_in_gripper(samplename, owner)
+                    dev.omny_samples.set_sample_status_in_gripper(status, account)
                     # FZP was picked
                     # if (_osampleposition == 10 || _osampleposition == 11 || _osampleposition == 100)
                     #  _otransfer_modify_sample("omny",110,2,samplename)
@@ -1406,8 +1423,12 @@ class OMNYSampleTransferMixin:
             if dev.omny_samples.is_sample_in_samplestage():
                 if _picked_it:
                     samplename = dev.omny_samples.get_sample_name_in_samplestage()
+                    owner = dev.omny_samples.get_sample_owner_in_samplestage()
+                    status = dev.omny_samples.get_sample_status_in_samplestage()
+                    account = dev.omny_samples.get_sample_account_in_samplestage()
                     dev.omny_samples.unset_sample_in_samplestage()
-                    dev.omny_samples.set_sample_in_gripper(samplename)
+                    dev.omny_samples.set_sample_in_gripper(samplename, owner)
+                    dev.omny_samples.set_sample_status_in_gripper(status, account)
                     # FZP was picked
                     # if (_osampleposition == 10 || _osampleposition == 11 || _osampleposition == 100)
                     #  _otransfer_modify_sample("omny",110,2,samplename)
@@ -1480,9 +1501,15 @@ class OMNYSampleTransferMixin:
                 if not dev.omny_samples.is_sample_slot_used(installedshuttle, _osampleposition):
                     if _put_it:
                         samplename = dev.omny_samples.get_sample_name_in_gripper()
+                        owner = dev.omny_samples.get_sample_owner_in_gripper()
+                        status = dev.omny_samples.get_sample_status_in_gripper()
+                        account = dev.omny_samples.get_sample_account_in_gripper()
                         dev.omny_samples.unset_sample_in_gripper()
                         dev.omny_samples.set_sample_slot(
-                            installedshuttle, _osampleposition, samplename
+                            installedshuttle, _osampleposition, samplename, owner
+                        )
+                        dev.omny_samples.set_sample_status(
+                            installedshuttle, _osampleposition, status, account
                         )
                     return True
                 else:
@@ -1572,7 +1599,11 @@ class OMNYSampleTransferMixin:
             if not dev.omny_samples.is_sample_slot_used("O", _osampleposition):
                 if _put_it:
                     samplename = dev.omny_samples.get_sample_name_in_gripper()
-                    dev.omny_samples.set_sample_slot("O", _osampleposition, samplename)
+                    owner = dev.omny_samples.get_sample_owner_in_gripper()
+                    status = dev.omny_samples.get_sample_status_in_gripper()
+                    account = dev.omny_samples.get_sample_account_in_gripper()
+                    dev.omny_samples.set_sample_slot("O", _osampleposition, samplename, owner)
+                    dev.omny_samples.set_sample_status("O", _osampleposition, status, account)
                     dev.omny_samples.unset_sample_in_gripper()
                 return True
             else:
@@ -1584,7 +1615,11 @@ class OMNYSampleTransferMixin:
             if not dev.omny_samples.is_sample_in_samplestage():
                 if _put_it:
                     samplename = dev.omny_samples.get_sample_name_in_gripper()
-                    dev.omny_samples.set_sample_in_samplestage(samplename)
+                    owner = dev.omny_samples.get_sample_owner_in_gripper()
+                    status = dev.omny_samples.get_sample_status_in_gripper()
+                    account = dev.omny_samples.get_sample_account_in_gripper()
+                    dev.omny_samples.set_sample_in_samplestage(samplename, owner)
+                    dev.omny_samples.set_sample_status_in_samplestage(status, account)
                     dev.omny_samples.unset_sample_in_gripper()
                 return True
             else:
diff --git a/csaxs_bec/devices/omny/shutter.py b/csaxs_bec/devices/omny/shutter.py
index 6e5e4fe8..56e9b219 100644
--- a/csaxs_bec/devices/omny/shutter.py
+++ b/csaxs_bec/devices/omny/shutter.py
@@ -1,95 +1,53 @@
 """
-Fast Shutter control for OMNY setup. If started with a config file in which the device_manager
-has a 'fsh' device (cSAXSFastEpicsShutter), this device will be used as the shutter.
-Otherwise, the device will create a dummy shutter device that will log warnings when shutter
-methods are called, but will not raise exceptions.
+Fast Shutter control for OMNY setup. Delegates directly to the 'fsh' device
+(cSAXSFastEpicsShutter, or its simulated counterpart) via the device manager
+-- 'fsh' must be present and enabled in the running config.
 """
 
 from bec_lib.logger import bec_logger
-from ophyd import Component as Cpt
-from ophyd import Device, Signal
+from ophyd import Device
 from ophyd_devices import PSIDeviceBase
 
 logger = bec_logger.logger
 
 
-class MonitorSignal(Signal):
-    """A simple wrapper around ophyd Signal that automatically monitors the signal for changes."""
-
-    def __init__(self, *, name, auto_monitor=False, **kwargs):
-        super().__init__(name=name, **kwargs)
-        self.auto_monitor = auto_monitor
-
-
 class OMNYFastShutter(PSIDeviceBase, Device):
     """
-    Fast Shutter control for OMNY setup. If started with at the beamline, it will expose
-    the shutter control methods (fshopen, fshclose, fshstatus, fshinfo) from the
-    cSAXSFastEpicsShutter device. The device is identified by the 'fsh' name in the device manager.
-    If the 'fsh' device is not found in the device manager, this device will create a dummy shutter
-    and log warnings when shutter methods are called, but will not raise exceptions.
+    Fast Shutter control for OMNY setup. Exposes the shutter control methods
+    (fshopen, fshclose, fshstatus, fshinfo, fshstatus_readback) by delegating
+    to the 'fsh' device (cSAXSFastEpicsShutter) found in the device manager.
     """
 
     USER_ACCESS = ["fshopen", "fshclose", "fshstatus", "fshinfo", "help", "fshstatus_readback"]
     SUB_VALUE = "value"
     _default_sub = SUB_VALUE
 
-    shutter = Cpt(MonitorSignal, name="shutter", auto_monitor=True)
-
     # -----------------------------------------------------
     # User-facing shutter control functions
     # -----------------------------------------------------
 
-    # pylint: disable=invalid-name
-    def _check_if_cSAXS_shutter_exists_in_config(self) -> bool:
-        """
-        Check on the device manager if the shutter device exists.
-
-        Returns:
-            bool: True if the 'fsh' device exists in the device manager, False otherwise
-        """
-        if self.device_manager.devices.get("fsh", None) is None:
-            logger.warning(f"Fast shutter device not found for {self.name}.")
-            return False
-        return True
-
     def fshopen(self):
         """Open the fast shutter."""
-        if self._check_if_cSAXS_shutter_exists_in_config():
-            return self.device_manager.devices["fsh"].fshopen()
-        else:
-            self.shutter.put(1)
+        return self.device_manager.devices["fsh"].fshopen()
 
     def fshclose(self):
         """Close the fast shutter."""
-        if self._check_if_cSAXS_shutter_exists_in_config():
-            return self.device_manager.devices["fsh"].fshclose()
-        else:
-            self.shutter.put(0)
+        return self.device_manager.devices["fsh"].fshclose()
 
     def fshstatus(self):
         """Return the fast shutter status (0=closed, 1=open)."""
-        if self._check_if_cSAXS_shutter_exists_in_config():
-            return self.device_manager.devices["fsh"].fshstatus()
-        else:
-            return self.shutter.get()
+        return self.device_manager.devices["fsh"].fshstatus()
 
     def fshinfo(self):
         """Print information about which EPICS PV channel is being used."""
-        if self._check_if_cSAXS_shutter_exists_in_config():
-            return self.device_manager.devices["fsh"].fshinfo()
-        else:
-            print("Using dummy fast shutter device. No EPICS channel is connected.")
+        return self.device_manager.devices["fsh"].fshinfo()
+
+    def fshstatus_readback(self):
+        """Return the fast shutter status (0=closed, 1=open) from the readback signal."""
+        return self.device_manager.devices["fsh"].fshstatus_readback()
 
     def help(self):
         """Display available user methods."""
         print("Available methods:")
         for method in self.USER_ACCESS:
             print(f"  - {method}")
-
-    def fshstatus_readback(self):
-        """Return the fast shutter status (0=closed, 1=open) from the readback signal."""
-        if self._check_if_cSAXS_shutter_exists_in_config():
-            return self.device_manager.devices["fsh"].fshstatus_readback()
-        else:
-            self.shutter.get()
diff --git a/tests/tests_devices/test_omny_shutter.py b/tests/tests_devices/test_omny_shutter.py
index b2bc1c9d..85161b69 100644
--- a/tests/tests_devices/test_omny_shutter.py
+++ b/tests/tests_devices/test_omny_shutter.py
@@ -1,69 +1,51 @@
+from unittest import mock
+
 import pytest
 from bec_server.device_server.tests.utils import DMMock
 
-from csaxs_bec.devices.omny.shutter import MonitorSignal, OMNYFastShutter
-
-
-@pytest.mark.parametrize("auto_monitor", [False, True])
-def test_monitor_signal_stores_auto_monitor(auto_monitor):
-    signal = MonitorSignal(name="signal", auto_monitor=auto_monitor)
-
-    assert signal.auto_monitor is auto_monitor
-
-
-def test_monitor_signal_put_propagates_value_to_readback_callback():
-    signal = MonitorSignal(name="signal", auto_monitor=True)
-    initial_value = signal.read()[signal.name]["value"]
-    callback_values = []
-    callback_reads = []
-
-    def _test_cb(value, old_value, **kwargs):
-        callback_values.append((value, old_value))
-        callback_reads.append(kwargs["obj"].read())
-
-    signal.subscribe(_test_cb, event_type=signal.SUB_VALUE, run=False)
-
-    signal.put(1)
-
-    assert callback_values == [(1, initial_value)]
-    assert len(callback_reads) == 1
-    assert callback_reads[0][signal.name]["value"] == 1
-    assert signal.read()[signal.name]["value"] == 1
-
-    signal.put(0)
-    assert callback_values == [(1, initial_value), (0, 1)]
-    assert len(callback_reads) == 2
-    assert callback_reads[1][signal.name]["value"] == 0
-    assert signal.read()[signal.name]["value"] == 0
+from csaxs_bec.devices.omny.shutter import OMNYFastShutter
 
 
 @pytest.fixture
 def omny_fast_shutter():
-    shutter = OMNYFastShutter(name="omny_fast_shutter", device_manager=DMMock())
+    device_manager = DMMock()
+    fsh = mock.MagicMock()
+    device_manager.devices["fsh"] = fsh
+    shutter = OMNYFastShutter(name="omny_fast_shutter", device_manager=device_manager)
 
     try:
-        yield shutter
+        yield shutter, fsh
     finally:
         shutter.destroy()
 
 
-def test_omny_fast_shutter_uses_monitor_signal_with_auto_monitor(omny_fast_shutter):
-    assert isinstance(omny_fast_shutter.shutter, MonitorSignal)
-    assert omny_fast_shutter.shutter.auto_monitor is True
+def test_omny_fast_shutter_fshopen_delegates_to_fsh(omny_fast_shutter):
+    shutter, fsh = omny_fast_shutter
+    shutter.fshopen()
+    fsh.fshopen.assert_called_once()
 
 
-def test_omny_fast_shutter_propagates_signal_changes_to_device_readback(omny_fast_shutter):
-    signal_name = omny_fast_shutter.shutter.name
-    callback_reads = []
+def test_omny_fast_shutter_fshclose_delegates_to_fsh(omny_fast_shutter):
+    shutter, fsh = omny_fast_shutter
+    shutter.fshclose()
+    fsh.fshclose.assert_called_once()
 
-    def _test_cb(**kwargs):
-        callback_reads.append(omny_fast_shutter.read())
 
-    omny_fast_shutter.shutter.subscribe(_test_cb, event_type=omny_fast_shutter.shutter.SUB_VALUE, run=False)
+def test_omny_fast_shutter_fshstatus_delegates_to_fsh(omny_fast_shutter):
+    shutter, fsh = omny_fast_shutter
+    fsh.fshstatus.return_value = 1
+    assert shutter.fshstatus() == 1
+    fsh.fshstatus.assert_called_once()
 
-    omny_fast_shutter.shutter.put(1)
 
-    assert len(callback_reads) == 1
-    assert callback_reads[0][signal_name]["value"] == 1
-    assert omny_fast_shutter.read()[signal_name]["value"] == 1
-    assert omny_fast_shutter.fshstatus() == 1
+def test_omny_fast_shutter_fshstatus_readback_delegates_to_fsh(omny_fast_shutter):
+    shutter, fsh = omny_fast_shutter
+    fsh.fshstatus_readback.return_value = 0
+    assert shutter.fshstatus_readback() == 0
+    fsh.fshstatus_readback.assert_called_once()
+
+
+def test_omny_fast_shutter_fshinfo_delegates_to_fsh(omny_fast_shutter):
+    shutter, fsh = omny_fast_shutter
+    shutter.fshinfo()
+    fsh.fshinfo.assert_called_once()

From 7dc8de741c64767022dbcfd9076b81210213fd99 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 16:55:00 +0200
Subject: [PATCH 050/102] fix(sample_storage widget): rename "Change name..."
 context-menu action to "Change sample..."

The action replaces both name and owner and resets the slot's measured
status/account back to "none" -- "change name" undersold what it
actually does. Renamed action_change_name() -> action_change_sample()
to match, and documented the status-reset behavior in its docstring.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../widgets/sample_storage/sample_storage.py  | 26 +++++++++++--------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 64f5e99c..b8294780 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -420,11 +420,11 @@ class _SlotCell(QFrame):
     def _show_menu(self, pos) -> None:
         menu = QMenu(self)
         if self._occupied:
-            act_rename = menu.addAction("Change name…")
+            act_rename = menu.addAction("Change sample…")
             act_clear = menu.addAction("Clear (set empty)")
             chosen = menu.exec_(self.mapToGlobal(pos))
             if chosen == act_rename:
-                self._owner.action_change_name(self._slot, self._name, self._sample_owner)
+                self._owner.action_change_sample(self._slot, self._name, self._sample_owner)
             elif chosen == act_clear:
                 self._owner.action_clear(self._slot)
         else:
@@ -1002,7 +1002,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def _write_sample(self, slot, used: int, name: str, owner: str = "") -> bool:
         """Shared write dispatcher used by the sample-cell mutation actions
-        (action_change_name/action_new_sample/action_clear) for both
+        (action_change_sample/action_new_sample/action_clear) for both
         setups: OMNY keys are tuples (see _SlotCell), FlOMNI keys are
         plain ints.
         """
@@ -1210,7 +1210,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
     def _find_duplicate_name(self, slot, name: str):
         """Return the slot key that already holds `name`, if any OTHER
         occupied slot of the active setup currently has this exact name, or
-        None. Used by action_change_name()/action_new_sample() to enforce
+        None. Used by action_change_sample()/action_new_sample() to enforce
         that sample names are unique -- otherwise the measured-sample log
         (FlOMNI, keyed by name+owner) and operators reading the storage
         overview could no longer tell two same-named samples apart.
@@ -1230,11 +1230,15 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 return key
         return None
 
-    def action_change_name(self, slot, current_name: str, current_owner: str = "") -> None:
-        """Rename an occupied slot (stays occupied). Shared by both setups
-        (see ``_SlotCell``) -- both require a name and an owner (see module
-        docstring), and both require the name to be unique across the
-        active setup's slots (see ``_find_duplicate_name``).
+    def action_change_sample(self, slot, current_name: str, current_owner: str = "") -> None:
+        """Replace an occupied slot's sample identity (name + owner), stays
+        occupied. Named "change sample" rather than "rename" because
+        _write_sample() resets the slot's measured status/account back to
+        "none" -- appropriate since a new name+owner means a different
+        physical sample, not a correction to the existing one's record.
+        Shared by both setups (see ``_SlotCell``) -- both require a name and
+        an owner (see module docstring), and both require the name to be
+        unique across the active setup's slots (see ``_find_duplicate_name``).
         """
         name, ok = QInputDialog.getText(
             self,
@@ -1279,7 +1283,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def action_new_sample(self, slot) -> None:
         """Mark an empty slot occupied and give it a name. Shared by both
-        setups (see ``action_change_name``), including the uniqueness check.
+        setups (see ``action_change_sample``), including the uniqueness check.
         """
         name, ok = QInputDialog.getText(
             self, "New sample", f"Sample name for slot {self._slot_title(slot)}:"
@@ -1313,7 +1317,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def action_clear(self, slot) -> None:
         """Mark a slot empty (destructive; confirmed). Shared by both
-        setups (see ``action_change_name``).
+        setups (see ``action_change_sample``).
         """
         reply = QMessageBox.question(
             self,

From 953d381acdc782a6c8ef455f6c7d7455bad06cea Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 17:00:07 +0200
Subject: [PATCH 051/102] revert(omny): otransfer_park_loadlock_slot
 confirmation back to CLI, not GUI

Requested revert of one call site from the earlier GUI-console-confirm
sweep: this confirmation is about the operator physically checking the
leica transfer's back position, not something they'd be watching the
camera GUI console for, so it stays a plain terminal yesno() prompt.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/omny_sample_transfer_mixin.py               | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 2ae14aa3..7bd6b50a 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -493,7 +493,10 @@ class OMNYSampleTransferMixin:
             )
         # if the valve of the loadlock is not closed, ask before movement
         # todo if(epics_get("XOMNY-ES1-LL1VG1:POSITION")!="CLOSED") {
-        if not self.otransfer_confirm_dialog("Please confirm that the leica transfer is in back position."):
+        # CLI prompt on purpose, not otransfer_confirm_dialog() -- the operator
+        # is physically at the loadlock/leica transfer, not watching the GUI
+        # camera console, when confirming this.
+        if not self.OMNYTools.yesno("Please confirm that the leica transfer is in back position."):
             raise OMNYTransferError("Leica shuttle is not in back position.")
         else:
             self._oparkz_leica_slot(slot_number)

From f50be3aeb4c23780bac21a57db89c63950242be3 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 17:05:04 +0200
Subject: [PATCH 052/102] fix(omny): _oparkz_slot_check() recognize
 loadlock/leica parking targets too

otransfer_park_loadlock_slot() (_oparkz_leica_slot()) parks oparkz at a
different offset (base -6) than otransfer_park_slot() (base -0.9) for
the same slot numbers. _oparkz_slot_check() -- used throughout the
transfer flow, including otransfer_put_sample()/otransfer_get_sample()'s
availability checks -- only recognized the regular-gripper (-0.9) table,
so after parking via the loadlock (as the GUI correctly showed "ACTIVE"
for, per the earlier oparkz_active_parking_slot() widget fix), any
transfer call still raised "Parking stage is not at an active parking
position." Now checks both tables, mirroring sample_storage.py's
oparkz_active_parking_slot() on the widget side.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../omny/omny_sample_transfer_mixin.py        | 46 ++++++++++++----
 .../test_omny_sample_transfer_mixin.py        | 54 +++++++++++++++++++
 2 files changed, 90 insertions(+), 10 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_omny_sample_transfer_mixin.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 7bd6b50a..2077d965 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -26,6 +26,30 @@ class OMNYTransferError(Exception):
     pass
 
 
+# otransfer_park_slot()'s oparkz targets (regular gripper transfer path).
+_OPARKZ_TARGET_POSITIONS = {
+    2: -0.9 - 29 * 3 - 42 - 0.05,
+    3: -0.9 - 29 * 3,
+    4: -0.9 - 29 * 2,
+    5: -0.9 - 29,
+    6: -0.9,
+}
+# otransfer_park_loadlock_slot()'s targets (_oparkz_leica_slot()) -- the
+# *same* slot numbers, reached via the loadlock/leica transfer path instead
+# of the regular gripper path, at a different oparkz offset (base -6, not
+# -0.9). Both genuinely mean "the parking stage is at that slot", so
+# _oparkz_slot_check() must recognize either -- see also
+# sample_storage.py's oparkz_active_parking_slot(), which duplicates this
+# same pair of tables on the widget side of the device-server/GUI boundary.
+_OPARKZ_LEICA_TARGET_POSITIONS = {
+    2: -6 - 29 * 3 - 42 - 0.05,
+    3: -6 - 29 * 3,
+    4: -6 - 29 * 2,
+    5: -6 - 29,
+    6: -6,
+}
+
+
 class OMNYSampleTransferMixin:
 
     def __init__(self) -> None:
@@ -535,17 +559,19 @@ class OMNYSampleTransferMixin:
             return False
 
     def _oparkz_slot_check(self):
+        # Checks both the regular-gripper (_OPARKZ_TARGET_POSITIONS) and
+        # loadlock/leica (_OPARKZ_LEICA_TARGET_POSITIONS) target tables --
+        # otransfer_park_loadlock_slot() parks at a different oparkz offset
+        # than otransfer_park_slot() for the same slot number, and both
+        # genuinely mean the parking stage is at that slot.
         parkingposition = 10
-        if self._oparkz_check(-0.9):
-            parkingposition = 6
-        elif self._oparkz_check(-0.9 - 29):
-            parkingposition = 5
-        elif self._oparkz_check(-0.9 - 29 * 2):
-            parkingposition = 4
-        elif self._oparkz_check(-0.9 - 29 * 3):
-            parkingposition = 3
-        elif self._oparkz_check(-0.9 - 29 * 3 - 42 - 0.05):
-            parkingposition = 2
+        for targets in (_OPARKZ_TARGET_POSITIONS, _OPARKZ_LEICA_TARGET_POSITIONS):
+            for slot, target in targets.items():
+                if self._oparkz_check(target):
+                    parkingposition = slot
+                    break
+            if parkingposition != 10:
+                break
 
         if parkingposition == 10:
             print("Oparkz is not in a parking position.")
diff --git a/tests/tests_bec_ipython_client/test_omny_sample_transfer_mixin.py b/tests/tests_bec_ipython_client/test_omny_sample_transfer_mixin.py
new file mode 100644
index 00000000..54c18730
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_omny_sample_transfer_mixin.py
@@ -0,0 +1,54 @@
+from unittest import mock
+
+import pytest
+
+from csaxs_bec.bec_ipython_client.plugins.omny.omny_sample_transfer_mixin import (
+    _OPARKZ_LEICA_TARGET_POSITIONS,
+    _OPARKZ_TARGET_POSITIONS,
+    OMNYSampleTransferMixin,
+)
+
+# pylint: disable=protected-access
+
+MIXIN = "csaxs_bec.bec_ipython_client.plugins.omny.omny_sample_transfer_mixin"
+
+
+def _mixin_at(readback: float) -> OMNYSampleTransferMixin:
+    mixin = OMNYSampleTransferMixin()
+    dev_mock = mock.MagicMock()
+    dev_mock.oparkz.get.return_value.readback = readback
+    mixin._dev_patch = mock.patch(f"{MIXIN}.dev", dev_mock, create=True)
+    mixin._dev_patch.start()
+    return mixin
+
+
+@pytest.mark.parametrize("slot,target", sorted(_OPARKZ_TARGET_POSITIONS.items()))
+def test_oparkz_slot_check_matches_each_regular_gripper_target(slot, target):
+    mixin = _mixin_at(target)
+    try:
+        assert mixin._oparkz_slot_check() == slot
+    finally:
+        mixin._dev_patch.stop()
+
+
+@pytest.mark.parametrize("slot,target", sorted(_OPARKZ_LEICA_TARGET_POSITIONS.items()))
+def test_oparkz_slot_check_matches_each_leica_target(slot, target):
+    """otransfer_park_loadlock_slot() parks at the leica offset (base -6),
+    not the regular gripper offset (base -0.9) -- both must be recognized
+    as a valid active parking slot, or otransfer_put_sample()/
+    otransfer_get_sample() wrongly raise "Parking stage is not at an
+    active parking position" right after a loadlock park even though the
+    GUI (and the operator) can see it parked there."""
+    mixin = _mixin_at(target)
+    try:
+        assert mixin._oparkz_slot_check() == slot
+    finally:
+        mixin._dev_patch.stop()
+
+
+def test_oparkz_slot_check_returns_10_between_positions():
+    mixin = _mixin_at(-3.0)
+    try:
+        assert mixin._oparkz_slot_check() == 10
+    finally:
+        mixin._dev_patch.stop()

From 96fabeb1c7032bee6bc5ac679a5a731e024c1f9d Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 17:16:25 +0200
Subject: [PATCH 053/102] fix(omny): simulate oshuttlealign's quirky
 low-limit-trips-positive hardware behavior

_otransfer_shuttle_align()'s own comment documents this as "a routine
for broken hardware": on real hardware, driving the shuttle aligner
(oshuttlealign, axis H) positive of its forward-reference zero also
trips the low/reverse limit switch, due to how the two switches are
wired -- not just the normal reference-axis routine. The sim had no
concept of this: plain PR/BG moves never update limit_low_active/
limit_high_active at all (those flags are only ever set by the
separate #FES/#FRM reference-axis path), so the routine's final
"searchwrongendswitch" search loop (a 22-iteration, +200-step-at-a-time
hunt for the low switch) could never find it and the whole
otransfer_put_sample()/otransfer_get_sample() flow hung until RPC
timeout, raising "The shuttle aligner did not move back."

Added a per-axis opt-in flag (quirky_positive_trips_low_limit, wired
through configure_axis()/_sim_state_kwargs()/SimOMNYGalilMotor) that
makes the simulated low limit switch position-derived (active whenever
position > 0) instead of purely flag-based, and set it only for
oshuttlealign in simulated_omny.yaml. Verified end-to-end against a
replay of the real command sequence (reference, +200 recovery nudge,
the five alignment excursions, then the search loop) -- the low switch
is now found within the 22-iteration budget, same as real hardware.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../simulated_omny/simulated_omny.yaml        |   7 +
 csaxs_bec/devices/sim/sim_galil.py            |  15 +++
 csaxs_bec/devices/sim/sim_omny.py             |   2 +
 ...st_sim_galil_oshuttlealign_quirky_limit.py | 122 ++++++++++++++++++
 4 files changed, 146 insertions(+)
 create mode 100644 tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py

diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index dbd84c4c..ce3a87dd 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -493,6 +493,13 @@ oshuttlealign:
     sign: 1
     sim_velocity: 10.0
     sim_initial_position: 0
+    # _otransfer_shuttle_align()'s "routine for broken hardware" comment
+    # (omny_sample_transfer_mixin.py): the negative/low limit switch is
+    # wired close enough to the positive/high one that it also trips once
+    # driven positive of the forward-reference zero point, not just via
+    # normal referencing. Without this, the alignment routine's final
+    # "searchwrongendswitch" loop never finds the low switch and times out.
+    sim_quirky_positive_trips_low_limit: true
   enabled: true
   onFailure: buffer
   readOnly: true
diff --git a/csaxs_bec/devices/sim/sim_galil.py b/csaxs_bec/devices/sim/sim_galil.py
index c61e8b86..e13cf17f 100644
--- a/csaxs_bec/devices/sim/sim_galil.py
+++ b/csaxs_bec/devices/sim/sim_galil.py
@@ -99,6 +99,13 @@ class _SimGalilAxis:
         self._move_t1 = 0.0
         self.limit_low_active = False
         self.limit_high_active = False
+        # Models oshuttlealign's documented "broken hardware" quirk
+        # (omny_sample_transfer_mixin.py's _otransfer_shuttle_align()): the
+        # low/reverse limit switch is wired close enough to the high/forward
+        # one that it also trips once the axis is driven positive of its
+        # forward-reference zero point -- not just via the normal
+        # reference-axis routine. See the _LR handling in _handle_mg().
+        self.quirky_positive_trips_low_limit = False
 
     def position(self) -> float:
         now = time.time()
@@ -222,6 +229,10 @@ class SimGalilState:
                 ax.limit_low_active = bool(kwargs["limit_low_active"])
             if kwargs.get("limit_high_active") is not None:
                 ax.limit_high_active = bool(kwargs["limit_high_active"])
+            if kwargs.get("quirky_positive_trips_low_limit") is not None:
+                ax.quirky_positive_trips_low_limit = bool(
+                    kwargs["quirky_positive_trips_low_limit"]
+                )
         self.recompute_allaxref()
 
     def thread_active(self, thread_id: int) -> bool:
@@ -516,6 +527,8 @@ class SimGalilSocket(SimSocketBase):
             for token, axis_char in zip(re.findall(r"_L[RF]", arg), axes):
                 ax = state.axis(ord(axis_char.lower()) - 97)
                 active = ax.limit_low_active if token == "_LR" else ax.limit_high_active
+                if token == "_LR" and ax.quirky_positive_trips_low_limit and ax.position() > 0:
+                    active = True
                 parts.append(f"{0.0 if active else 1.0:.4f}")
             return " ".join(parts)
         if arg.startswith("_TD"):
@@ -640,6 +653,7 @@ def _sim_state_kwargs(
     sim_encpermm=None,
     sim_digital_outputs=None,
     sim_variables=None,
+    sim_quirky_positive_trips_low_limit=None,
 ) -> dict:
     initial_position = None
     if sim_initial_position is not None:
@@ -651,6 +665,7 @@ def _sim_state_kwargs(
         "referenced": sim_referenced,
         "analog_inputs": sim_analog_inputs,
         "digital_inputs": sim_digital_inputs,
+        "quirky_positive_trips_low_limit": sim_quirky_positive_trips_low_limit,
         "limit_low_active": sim_limit_low_active,
         "limit_high_active": sim_limit_high_active,
         "encpermm": sim_encpermm,
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 19a6015e..1ed23d9f 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -72,6 +72,7 @@ class SimOMNYGalilMotor(OMNYGalilMotor):
         sim_limit_low_active=None,
         sim_limit_high_active=None,
         sim_variables=None,
+        sim_quirky_positive_trips_low_limit=None,
         **kwargs,
     ):
         super().__init__(
@@ -112,6 +113,7 @@ class SimOMNYGalilMotor(OMNYGalilMotor):
                 self.sign,
                 sim_digital_outputs=sim_digital_outputs,
                 sim_variables=variables,
+                sim_quirky_positive_trips_low_limit=sim_quirky_positive_trips_low_limit,
             ),
         )
 
diff --git a/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py b/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py
new file mode 100644
index 00000000..98022baf
--- /dev/null
+++ b/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py
@@ -0,0 +1,122 @@
+import time
+
+import pytest
+from bec_server.device_server.tests.utils import DMMock
+
+from csaxs_bec.devices.omny.galil.ogalil_ophyd import OMNYGalilController
+from csaxs_bec.devices.sim.sim_omny import SimOMNYGalilMotor
+from csaxs_bec.devices.sim.sim_socket import SimStateRegistry
+
+_HOST = "mpc3217.psi.ch"
+_PORT = 8082
+
+
+@pytest.fixture(autouse=True)
+def _reset_sim_state():
+    OMNYGalilController._reset_controller()
+    SimStateRegistry.reset()
+    yield
+    SimStateRegistry.reset()
+    OMNYGalilController._reset_controller()
+
+
+def _make_align(quirky: bool) -> SimOMNYGalilMotor:
+    align = SimOMNYGalilMotor(
+        "H",
+        name="oshuttlealign",
+        host=_HOST,
+        port=_PORT,
+        sign=1,
+        device_manager=DMMock(),
+        sim_initial_position=0,
+        sim_velocity=100.0,
+        sim_quirky_positive_trips_low_limit=quirky,
+    )
+    align.wait_for_connection()
+    return align
+
+
+def _drive_relative(align: SimOMNYGalilMotor, steps: int):
+    align.controller.socket_put_confirmed(f"PRH={steps}")
+    align.controller.socket_put_confirmed("BGH")
+    while bool(float(align.controller.socket_put_and_receive("MG_BGH"))):
+        time.sleep(0.01)
+
+
+def test_low_limit_inactive_at_position_zero_even_when_quirky():
+    """Matches the real hardware log: right after reaching the forward/high
+    reference (position 0), the low switch has NOT yet tripped -- only a
+    subsequent positive move trips it. Otherwise
+    _otransfer_shuttle_align()'s "Not in correct start position for
+    alignment." branch (and the whole recovery routine it guards) would
+    never even run."""
+    align = _make_align(quirky=True)
+    try:
+        assert align.get_motor_limit_switch()[0] is False
+    finally:
+        align.destroy()
+
+
+def test_quirky_low_limit_trips_after_positive_move_past_zero():
+    align = _make_align(quirky=True)
+    try:
+        _drive_relative(align, 200)
+        assert align.get_motor_limit_switch()[0] is True
+    finally:
+        align.destroy()
+
+
+def test_quirky_low_limit_inactive_when_negative_of_zero():
+    align = _make_align(quirky=True)
+    try:
+        _drive_relative(align, -5000)
+        assert align.get_motor_limit_switch()[0] is False
+    finally:
+        align.destroy()
+
+
+def test_non_quirky_axis_never_trips_low_limit_from_position_alone():
+    """The quirk is opt-in per axis (only oshuttlealign has it configured) --
+    an ordinary axis at a positive position must not spuriously report its
+    low limit switch as active."""
+    align = _make_align(quirky=False)
+    try:
+        _drive_relative(align, 200)
+        assert align.get_motor_limit_switch()[0] is False
+    finally:
+        align.destroy()
+
+
+def test_shuttle_align_search_loop_finds_low_switch_within_budget():
+    """End-to-end replay of _otransfer_shuttle_align()'s real command
+    sequence (omny_sample_transfer_mixin.py): reach the forward/high
+    reference, nudge +200 (recovery), run the big alignment excursions,
+    then the final +200-step search loop (budget: 22 iterations) must find
+    the low switch -- this is the exact sequence that timed out before
+    sim_quirky_positive_trips_low_limit was wired up."""
+    align = _make_align(quirky=True)
+    try:
+        # reach the forward/high reference the same way drive_axis_to_limit() does
+        align.controller.socket_put_confirmed("naxis=7")
+        align.controller.socket_put_confirmed("ndir=1")
+        align.controller.socket_put_confirmed("XQ#NEWPAR")
+        align.controller.socket_put_confirmed("XQ#FES")
+        assert align.get_motor_limit_switch() == [False, True]
+
+        # recovery nudge
+        _drive_relative(align, 200)
+
+        # big alignment excursions
+        for steps in (-5000, -19500, 3000, -3000, 23500):
+            _drive_relative(align, steps)
+        assert align.get_motor_limit_switch()[0] is False
+
+        # final search loop
+        for i in range(22):
+            _drive_relative(align, 200)
+            if align.get_motor_limit_switch()[0]:
+                break
+        else:
+            pytest.fail("search loop never found the low limit switch")
+    finally:
+        align.destroy()

From a68f48d9136afd9c6b3b18ac7667365681ab6662 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 17:26:46 +0200
Subject: [PATCH 054/102] fix(omny): oshuttlealign starts pre-referenced;
 simulate oshuttleopen's open-detection limit

- oshuttlealign: start the sim already at the forward/high (down)
  reference (sim_limit_high_active: true), matching real hardware's
  typical idle state, instead of re-driving to a limit it was already
  at on the first alignment each session.
- oshuttleopen: _otransfer_shield_open() drives it open with plain
  PRG=17000/PRG=37000 (never through the naxis/XQ#NEWPAR reference-axis
  routine that normally flips limit-switch flags), so
  _otransfer_is_shuttle_open()'s high-limit check could never see it as
  open -- "Did not manage to open the lid" fired even though the move
  completed. Added a general, opt-in position-derived high-limit
  mechanism to the Galil sim (high_limit_trip_position_steps, wired
  through configure_axis()/_sim_state_kwargs()/SimOMNYGalilMotor) and
  set it for oshuttleopen at 1.0 mm (comfortably below the ~1.05 mm/
  54000-step total commanded excursion).

Verified both against a standalone replay of the real command
sequences before writing tests.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../simulated_omny/simulated_omny.yaml        | 13 +++
 csaxs_bec/devices/sim/sim_galil.py            | 20 +++++
 csaxs_bec/devices/sim/sim_omny.py             |  2 +
 ...st_sim_galil_oshuttlealign_quirky_limit.py | 25 ++++++
 .../test_sim_galil_oshuttleopen_high_limit.py | 80 +++++++++++++++++++
 5 files changed, 140 insertions(+)
 create mode 100644 tests/tests_devices/test_sim_galil_oshuttleopen_high_limit.py

diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
index ce3a87dd..4943cff2 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_omny.yaml
@@ -471,6 +471,14 @@ oshuttleopen:
     sign: 1
     sim_velocity: 10.0
     sim_initial_position: 0
+    # _otransfer_shield_open() drives this axis open with plain PRG=17000
+    # then PRG=37000 (omny_sample_transfer_mixin.py) -- never through the
+    # naxis/XQ#NEWPAR reference-axis routine that normally flips the
+    # limit-switch flags -- so without a position-derived trip point,
+    # _otransfer_is_shuttle_open() (checks the high/forward limit) never
+    # sees it as open. 1.0 mm is comfortably below the ~1.05 mm (54000
+    # step) total commanded excursion.
+    sim_high_limit_trip_position: 1.0
   enabled: true
   onFailure: buffer
   readOnly: true
@@ -493,6 +501,11 @@ oshuttlealign:
     sign: 1
     sim_velocity: 10.0
     sim_initial_position: 0
+    # Real hardware idles with the shuttle aligner down (at the forward/high
+    # limit, _otransfer_shuttle_aligner_down()'s target) -- start the sim
+    # already there so the first alignment each session doesn't spend time
+    # re-driving to a limit it was already sitting at.
+    sim_limit_high_active: true
     # _otransfer_shuttle_align()'s "routine for broken hardware" comment
     # (omny_sample_transfer_mixin.py): the negative/low limit switch is
     # wired close enough to the positive/high one that it also trips once
diff --git a/csaxs_bec/devices/sim/sim_galil.py b/csaxs_bec/devices/sim/sim_galil.py
index e13cf17f..3beedc2e 100644
--- a/csaxs_bec/devices/sim/sim_galil.py
+++ b/csaxs_bec/devices/sim/sim_galil.py
@@ -106,6 +106,14 @@ class _SimGalilAxis:
         # forward-reference zero point -- not just via the normal
         # reference-axis routine. See the _LR handling in _handle_mg().
         self.quirky_positive_trips_low_limit = False
+        # Optional position-derived high/forward limit (steps): some OMNY
+        # axes are driven open-loop with plain PR{axis}=/BG{axis} (no
+        # naxis/XQ#NEWPAR reference-axis routine involved at all -- see
+        # e.g. _otransfer_shield_open()'s oshuttleopen "PRG=17000"/"PRG=37000"
+        # sequence), so limit_high_active would otherwise never become True
+        # for them. When set, the high/forward limit reads active once
+        # position() reaches this threshold, same as a real physical switch.
+        self.high_limit_trip_position_steps = None
 
     def position(self) -> float:
         now = time.time()
@@ -233,6 +241,10 @@ class SimGalilState:
                 ax.quirky_positive_trips_low_limit = bool(
                     kwargs["quirky_positive_trips_low_limit"]
                 )
+            if kwargs.get("high_limit_trip_position") is not None:
+                ax.high_limit_trip_position_steps = (
+                    float(kwargs["high_limit_trip_position"]) * ax.stppermm
+                )
         self.recompute_allaxref()
 
     def thread_active(self, thread_id: int) -> bool:
@@ -529,6 +541,12 @@ class SimGalilSocket(SimSocketBase):
                 active = ax.limit_low_active if token == "_LR" else ax.limit_high_active
                 if token == "_LR" and ax.quirky_positive_trips_low_limit and ax.position() > 0:
                     active = True
+                if (
+                    token == "_LF"
+                    and ax.high_limit_trip_position_steps is not None
+                    and ax.position() >= ax.high_limit_trip_position_steps
+                ):
+                    active = True
                 parts.append(f"{0.0 if active else 1.0:.4f}")
             return " ".join(parts)
         if arg.startswith("_TD"):
@@ -654,6 +672,7 @@ def _sim_state_kwargs(
     sim_digital_outputs=None,
     sim_variables=None,
     sim_quirky_positive_trips_low_limit=None,
+    sim_high_limit_trip_position=None,
 ) -> dict:
     initial_position = None
     if sim_initial_position is not None:
@@ -666,6 +685,7 @@ def _sim_state_kwargs(
         "analog_inputs": sim_analog_inputs,
         "digital_inputs": sim_digital_inputs,
         "quirky_positive_trips_low_limit": sim_quirky_positive_trips_low_limit,
+        "high_limit_trip_position": sim_high_limit_trip_position,
         "limit_low_active": sim_limit_low_active,
         "limit_high_active": sim_limit_high_active,
         "encpermm": sim_encpermm,
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 1ed23d9f..5cfb4f00 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -73,6 +73,7 @@ class SimOMNYGalilMotor(OMNYGalilMotor):
         sim_limit_high_active=None,
         sim_variables=None,
         sim_quirky_positive_trips_low_limit=None,
+        sim_high_limit_trip_position=None,
         **kwargs,
     ):
         super().__init__(
@@ -114,6 +115,7 @@ class SimOMNYGalilMotor(OMNYGalilMotor):
                 sim_digital_outputs=sim_digital_outputs,
                 sim_variables=variables,
                 sim_quirky_positive_trips_low_limit=sim_quirky_positive_trips_low_limit,
+                sim_high_limit_trip_position=sim_high_limit_trip_position,
             ),
         )
 
diff --git a/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py b/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py
index 98022baf..ccf9fbf3 100644
--- a/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py
+++ b/tests/tests_devices/test_sim_galil_oshuttlealign_quirky_limit.py
@@ -57,6 +57,31 @@ def test_low_limit_inactive_at_position_zero_even_when_quirky():
         align.destroy()
 
 
+def test_can_start_pre_referenced_already_down():
+    """simulated_omny.yaml sets sim_limit_high_active: true for
+    oshuttlealign so the sim starts already at the forward/high (down)
+    reference -- matching real hardware's typical idle state -- so
+    _otransfer_shuttle_aligner_down() doesn't need to re-drive to a limit
+    it was already sitting at on the first alignment each session."""
+    align = SimOMNYGalilMotor(
+        "H",
+        name="oshuttlealign",
+        host=_HOST,
+        port=_PORT,
+        sign=1,
+        device_manager=DMMock(),
+        sim_initial_position=0,
+        sim_velocity=100.0,
+        sim_quirky_positive_trips_low_limit=True,
+        sim_limit_high_active=True,
+    )
+    align.wait_for_connection()
+    try:
+        assert align.get_motor_limit_switch() == [False, True]
+    finally:
+        align.destroy()
+
+
 def test_quirky_low_limit_trips_after_positive_move_past_zero():
     align = _make_align(quirky=True)
     try:
diff --git a/tests/tests_devices/test_sim_galil_oshuttleopen_high_limit.py b/tests/tests_devices/test_sim_galil_oshuttleopen_high_limit.py
new file mode 100644
index 00000000..adb1eb67
--- /dev/null
+++ b/tests/tests_devices/test_sim_galil_oshuttleopen_high_limit.py
@@ -0,0 +1,80 @@
+import time
+
+import pytest
+from bec_server.device_server.tests.utils import DMMock
+
+from csaxs_bec.devices.omny.galil.ogalil_ophyd import OMNYGalilController
+from csaxs_bec.devices.sim.sim_omny import SimOMNYGalilMotor
+from csaxs_bec.devices.sim.sim_socket import SimStateRegistry
+
+_HOST = "mpc3217.psi.ch"
+_PORT = 8082
+
+
+@pytest.fixture(autouse=True)
+def _reset_sim_state():
+    OMNYGalilController._reset_controller()
+    SimStateRegistry.reset()
+    yield
+    SimStateRegistry.reset()
+    OMNYGalilController._reset_controller()
+
+
+def _make_opener(high_limit_trip_position=None) -> SimOMNYGalilMotor:
+    opener = SimOMNYGalilMotor(
+        "G",
+        name="oshuttleopen",
+        host=_HOST,
+        port=_PORT,
+        sign=1,
+        device_manager=DMMock(),
+        sim_initial_position=0,
+        sim_velocity=100.0,
+        sim_high_limit_trip_position=high_limit_trip_position,
+    )
+    opener.wait_for_connection()
+    return opener
+
+
+def _drive_relative(opener: SimOMNYGalilMotor, steps: int):
+    opener.controller.socket_put_confirmed(f"PRG={steps}")
+    opener.controller.socket_put_confirmed("BGG")
+    while bool(float(opener.controller.socket_put_and_receive("MG_BGG"))):
+        time.sleep(0.01)
+
+
+def test_high_limit_inactive_before_reaching_trip_position():
+    opener = _make_opener(high_limit_trip_position=1.0)
+    try:
+        assert opener.get_motor_limit_switch()[1] is False
+    finally:
+        opener.destroy()
+
+
+def test_high_limit_active_matches_real_shield_open_command_sequence():
+    """Replays _otransfer_shield_open()'s exact oshuttleopen excursion
+    (omny_sample_transfer_mixin.py: PRG=17000 then PRG=37000, ~1.05 mm
+    total at this axis's resolution) -- the high/forward limit must read
+    active afterward, or _otransfer_is_shuttle_open() never sees the
+    shuttle as open and otransfer_put_sample()/otransfer_get_sample()
+    raise "Did not manage to open the lid" even though the move completed."""
+    opener = _make_opener(high_limit_trip_position=1.0)
+    try:
+        _drive_relative(opener, 17000)
+        _drive_relative(opener, 37000)
+        assert opener.get_motor_limit_switch()[1] is True
+    finally:
+        opener.destroy()
+
+
+def test_high_limit_trip_position_is_opt_in():
+    """Without sim_high_limit_trip_position configured, plain PR/BG moves
+    must not spuriously report the high limit as active (matches every
+    other axis's existing behavior)."""
+    opener = _make_opener(high_limit_trip_position=None)
+    try:
+        _drive_relative(opener, 17000)
+        _drive_relative(opener, 37000)
+        assert opener.get_motor_limit_switch()[1] is False
+    finally:
+        opener.destroy()

From a0cc2167fd1a688f9a5a1a0dd5c3621115f4d968 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 17:57:25 +0200
Subject: [PATCH 055/102] fix(omny): seed shuttle A at parking slot 6 by
 default; drop redundant y/n hint from GUI confirm

- sim_omny.py: SimOMNYSampleStorage now seeds shuttle A (which already
  holds the default sim_sample_1/2/3) as parked at slot 6 -- saves
  calling dev.omny_samples.set_shuttle_slot('A', 6) by hand at the
  start of every test session. (oshuttlealign already starts
  pre-referenced/down from the previous commit's sim_limit_high_active
  change -- confirmed still in place, no further change needed there.)
- omny_general_tools.py: gui_yesno() no longer appends a "[y]/n?"-style
  text hint to the message -- the ConsoleButtonsWidget already shows
  actual Yes/No buttons, so the text was redundant (only the
  terminal-only yesno() prompt still needs it).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/OMNY_shared/omny_general_tools.py |  5 +--
 csaxs_bec/devices/sim/sim_omny.py             |  7 +++++
 .../test_sim_omny_sample_storage_defaults.py  | 31 +++++++++++++++++++
 3 files changed, 41 insertions(+), 2 deletions(-)
 create mode 100644 tests/tests_devices/test_sim_omny_sample_storage_defaults.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py
index 218105fa..2b333ebd 100644
--- a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py
@@ -145,9 +145,10 @@ class OMNYTools:
             self.printgreen(message + " Automatically confirming default: no")
             return False
 
-        suffix = {"y": " [Y]/n?", "n": " y/[N]?"}.get(default, " y/n?")
+        # No "[y]/n?" suffix here (unlike yesno()'s terminal prompt) -- the
+        # widget shows actual Yes/No buttons, so the text hint is redundant.
         gui.clear_response()
-        gui.message = message + suffix
+        gui.message = message
         while True:
             response = gui.response()
             if response == "yes":
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 5cfb4f00..4f91b56d 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -312,6 +312,13 @@ class SimOMNYSampleStorage(OMNYSampleStorage):
             storage.set_sample_in_samplestage("sim_stage_sample")
             for slot_nr, name in samples.items():
                 storage.set_sample_slot("A", int(slot_nr), str(name))
+            # shuttle A (holding the seeded samples above) starts parked at
+            # slot 6 -- the parking-carousel bookkeeping only, not oparkz's
+            # own position, which still needs otransfer_park_slot(6)/
+            # otransfer_park_loadlock_slot(6) to actually drive there. Saves
+            # having to set_shuttle_slot('A', 6) by hand at the start of
+            # every test session.
+            storage.set_shuttle_slot("A", 6)
             return storage
 
     def __init__(self, *args, sim_samples: dict | None = None, **kwargs):
diff --git a/tests/tests_devices/test_sim_omny_sample_storage_defaults.py b/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
new file mode 100644
index 00000000..9aac632f
--- /dev/null
+++ b/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
@@ -0,0 +1,31 @@
+import pytest
+
+from csaxs_bec.devices.sim.sim_omny import SimOMNYSampleStorage
+
+
+@pytest.fixture
+def storage():
+    dev = SimOMNYSampleStorage(name="omny_samples", prefix="XOMNY-")
+    try:
+        yield dev
+    finally:
+        dev.destroy()
+
+
+def test_shuttle_a_starts_parked_at_slot_6(storage):
+    """Saves having to set_shuttle_slot('A', 6) by hand at the start of
+    every test session -- shuttle A already holds the default seeded
+    samples (sim_sample_1/2/3), so it makes sense for it to already be
+    the one parked and ready to test against."""
+    assert storage.get_shuttle_name_slot(6) == "A"
+
+
+def test_other_parking_slots_start_empty(storage):
+    for slot in (1, 2, 3, 4, 5):
+        assert storage.get_shuttle_name_slot(slot) == "none"
+
+
+def test_default_samples_still_seeded_in_shuttle_a(storage):
+    assert storage.get_sample_name("A", 1) == "sim_sample_1"
+    assert storage.get_sample_name("A", 2) == "sim_sample_2"
+    assert storage.get_sample_name("A", 3) == "sim_sample_3"

From bd14eae6b97ecf85e28e4f0b543eb898b8c2310c Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Fri, 4 Sep 2026 18:01:41 +0200
Subject: [PATCH 056/102] docs(omny): make the sample storage widget the
 primary workflow, CLI a reference section

The "Managing sample storage" section documented dev.omny_samples.*
calls as the normal way to view/edit storage, but day-to-day usage is
now the OMNY Sample Storage GUI widget (added from BEC Widgets' widget
palette) -- documented this session's right-click actions (Change
sample.../Clear/New sample.../Set parking slot...), the measured-status
badges, and that measured status is intentionally CLI/scan-only, not
settable from the widget.

Split into three subsections: widget usage (primary), sample transfer
(still CLI -- the widget only edits the record, it doesn't drive
hardware), and a "CLI reference for sample storage" section for
scripting/GUI-unavailable cases, updated with the owner parameter and
the measured-status+account otransfer_* commands added this session.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 docs/user/ptychography/omny.md | 68 ++++++++++++++++++++--------------
 1 file changed, 41 insertions(+), 27 deletions(-)

diff --git a/docs/user/ptychography/omny.md b/docs/user/ptychography/omny.md
index 8c5719d0..855a8819 100644
--- a/docs/user/ptychography/omny.md
+++ b/docs/user/ptychography/omny.md
@@ -62,14 +62,8 @@ If this error happens after a sample was mounted or unmounted, it is important t
 (user.ptychography.omny.samples)=
 ### Sample storage and transfer
 
-Following commands will provide help within BEC:  
-- `omny.otransfer_help()`	print help related to sample transfer
-- `dev.omny_samples.help()` print help related to sample storage
-
-#### Managing sample storage
-
-The sample holders used are [OMNY pins](https://www.dora.lib4ri.ch/psi/islandora/object/psi:4528). These are instsalled in sample transfer shuttles, which can load up to six pins. These shuttles are transferred via a vacuum load lock to the vacuum chamber. The loading procedure can be handled at room temperature or under cryogenic conditions.  
-The thee __shuttles__ that exist are named __“A”, “B”, “C”__. The __pin positions__ within a shuttle are number __1 to 6__ according to the following sketch:
+The sample holders used are [OMNY pins](https://www.dora.lib4ri.ch/psi/islandora/object/psi:4528). These are installed in sample transfer shuttles, which can load up to six pins. These shuttles are transferred via a vacuum load lock to the vacuum chamber. The loading procedure can be handled at room temperature or under cryogenic conditions.  
+The three __shuttles__ that exist are named __“A”, “B”, “C”__. The __pin positions__ within a shuttle are numbered __1 to 6__ according to the following sketch:
 
 ```{figure} omny_shuttle.png
 OMNY sample shuttle
@@ -83,34 +77,27 @@ Each shuttle can be placed in a __parking slot__ in OMNY. The parking slots are
 OMNY parking station
 ```
 
-The status of the sample storage has to be correct in BEC. This means that the status of OMNY pins within OMNY ("O") as well as the shuttles has to be correct, the pin status within the shuttles ("A", "B", "C"), as well as the status of the shuttles within the OMNY parking.  
-This loading status is handled via a OMNY samples device: `dev.omny_samples`
+The status of the sample storage has to be correct in BEC. This means that the status of OMNY pins within OMNY ("O") as well as the shuttles has to be correct, the pin status within the shuttles ("A", "B", "C"), as well as the status of the shuttles within the OMNY parking.
 
-Within the BEC client session `dev.omny_samples.help()` will display all required commands with a short explanation.
+#### Viewing and adjusting sample storage (widget)
 
-To get an overview use `dev.omny_samples.show_all()` or `omny.otransfer_show_all()`
+Day to day, sample storage is viewed and adjusted through the __OMNY Sample Storage__ widget in the BEC GUI, not the CLI — add it from BEC Widgets' widget palette if it isn't already part of your layout.
 
-Modify a slot position of systems "A", "B", "C", "O":  
-`dev.omny_samples.unset_sample_slot('system',position)` free a sample position.  
-`dev.omny_samples.set_sample_slot('system',position,'name')` set a sample position. The sample has to get a _name_.  
+The widget shows every position (shuttle pins A/B/C, fixed "O" positions, the gripper, and the sample stage) with its occupied state, sample name, owner, and measured status (unmeasured / ◐ started / ✓ completed). The parking-carousel view also shows which shuttle is in which parking slot and marks the currently __ACTIVE__ one (oparkz is physically sitting there, ready for transfer).
 
-There are two __special sample slots__:  
-If a sample is in the __gripper__ and the information has to be manually changed use  
-`dev.omny_samples.unset_sample_in_gripper()`  
-`dev.omny_samples.set_sample_in_gripper('name')`
+Right-click a slot for:
+- __Change sample…__ — set a new name and owner for an occupied slot (replaces the sample record, including resetting its measured status back to unmeasured — use this when a physically different sample is now there, not to correct a typo in the current one's account).
+- __Clear (set empty)__ — mark a slot empty after physically removing the sample. Only offered for shuttle slots, since only samples in a shuttle can leave vacuum: this also offers to print a P-touch label for the sample that was just removed.
+- __New sample…__ — occupy an empty slot with a name and owner.
+- __Set parking slot…__ / __Clear parking assignment__ (shuttle labels) — record which parking slot a shuttle occupies; a slot already held by a different shuttle is rejected, clear it there first.
 
-In the case of the sample stage position, the commands are  
-`dev.omny_samples.unset_sample_in_samplestage()`  
-`dev.omny_samples.set_sample_in_samplestage('name')`
+Measured status itself (unmeasured/started/completed) is set automatically as part of a tomographic scan, or from the CLI (see reference below) — it is intentionally not settable from the widget.
 
-The shuttles are mounted in the parking station. Typically oparkz slot 3 is used for shuttle A, slot 4 for shuttle B, slot 5 for shuttle C. If that status has to be modified, the following commands can be used:  
-`dev.omny_samples.unset_shuttle_slot(slot_nr)`  
-`dev.omny_samples.set_shuttle_slot(container, slot_nr)`  
-Here is an _example_: dev.omny_samples.set_shuttle_slot('A',2)
+Use `omny.otransfer_show_all()` from the CLI for the same overview as plain text (useful when the GUI isn't available).
 
 #### Sample transfer
 
-Once the sample places are set correctly and checked by using `omny.otransfer_show_all()`, the following commands are available for sample change. To pick a sample from a parking slot, the parking slot stage has to be moved to the correct parking slot position. If a parking position is active, this information is displayed in sample storage overview.
+Physically moving samples still goes through the CLI — the widget only edits the storage record, it does not drive hardware. Once the storage record is correct (check with the widget or `omny.otransfer_show_all()`), the following commands are available for sample change. To pick a sample from a parking slot, the parking slot stage has to be moved to the correct parking slot position first. If a parking position is active, this is shown in the widget (and in `otransfer_show_all()`'s text overview).
 
 | Command | Explanation |
 | --- | --- |
@@ -132,6 +119,33 @@ Advanced commands ... in case something goes wrong
 
 When closing a shuttle of the shield, the gripper will be moved to the parking position prior closing.
 
+#### CLI reference for sample storage
+
+Not part of the normal workflow above (that's the widget) — kept here for scripting, and for the rare case the GUI isn't available. All of it lives on the OMNY samples device, `dev.omny_samples`; `dev.omny_samples.help()` prints the same reference with argument details from within a BEC session, and `omny.otransfer_help()` includes it too.
+
+Modify a slot position of systems "A", "B", "C", "O" (owner is optional, defaults to empty; setting a slot resets its measured status to unmeasured):  
+`dev.omny_samples.unset_sample_slot('system', position)` free a sample position.  
+`dev.omny_samples.set_sample_slot('system', position, 'name', 'owner')` set a sample position.
+
+There are two __special sample slots__:  
+If a sample is in the __gripper__ and the information has to be manually changed use  
+`dev.omny_samples.unset_sample_in_gripper()`  
+`dev.omny_samples.set_sample_in_gripper('name', 'owner')`
+
+In the case of the sample stage position, the commands are  
+`dev.omny_samples.unset_sample_in_samplestage()`  
+`dev.omny_samples.set_sample_in_samplestage('name', 'owner')`
+
+The shuttles are mounted in the parking station. Typically oparkz slot 3 is used for shuttle A, slot 4 for shuttle B, slot 5 for shuttle C. If that status has to be modified, the following commands can be used:  
+`dev.omny_samples.unset_shuttle_slot(slot_nr)`  
+`dev.omny_samples.set_shuttle_slot(container, slot_nr)`  
+Here is an _example_: dev.omny_samples.set_shuttle_slot('A',2)
+
+Measured status/account (normally set automatically during a tomographic scan) can be read and, if really needed, corrected manually via the `omny.otransfer_*` wrappers, e.g.:  
+`omny.otransfer_get_sample_status('system', position)` / `otransfer_get_sample_status_in_gripper()` / `otransfer_get_sample_status_in_samplestage()`  
+`omny.otransfer_set_sample_status('system', position, status, account)` (`status` is one of `"none"`/`"started"`/`"completed"`) and the matching `_in_gripper`/`_in_samplestage` variants  
+`omny.otransfer_get_sample_account(...)` and its `_in_gripper`/`_in_samplestage` variants read back the account tied to a "started"/"completed" status.
+
 ### Status of OMNY
 
 To see the status of the insrument, following commands can be used. Most of the components mentioned below are controlled via devices with naming starting with omny. TAB completion on dev.omny can be a quick way to find the commands.

From 9fe0678899246b205739499d25a20828c84581b7 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 11:59:33 +0200
Subject: [PATCH 057/102] fix(omny): inverted feedback-disable confirm in
 _otransfer_stage_to_ST

Pre-existing bug from 55aa712 (before this session): confirming "yes,
disable the feedback" raised OMNYTransferError instead of proceeding --
inverted condition, missing a `not`. Same class of bug as the
otransfer_park_loadlock_slot fix earlier this session. Audited every
other otransfer_confirm_dialog() call site in this file; this was the
only inverted one.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/omny_sample_transfer_mixin.py                  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 2077d965..d90cb64e 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1007,7 +1007,7 @@ class OMNYSampleTransferMixin:
             feedback_status = self.device_manager.devices.rtx.controller.feedback_is_running()
             if feedback_status == True:
                 # feedback is running
-                if self.otransfer_confirm_dialog("May the feedback be disabled", "y"):
+                if not self.otransfer_confirm_dialog("May the feedback be disabled", "y"):
                     raise OMNYTransferError(
                         "Manual abort of sample transfer, need to disable feedback has not been confirmed."
                     )

From a7429b2de266218231d2b3cff25a568050cf1799 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 12:21:01 +0200
Subject: [PATCH 058/102] fix(omny): save reference images at every manual
 confirm gate, not just the RT confirm handshake

_otransfer_save_reference_images() was only called from _otransfer_confirm()'s
"All OK?" checkpoint. Now also called at otransfer_get_sample()'s "no sample
in gripper" and "ready to start the unmount process" gates, and
otransfer_put_sample()'s "ready to start the mount process" gate -- all
three already run after the camera pair is live, so no extra setup needed.

Checked flomni.py for the equivalent gap per request: there isn't one --
ftransfer_get_sample()/ftransfer_put_sample() have no manual confirm
dialog before starting mount/unmount at all (just an automated check +
raise), so there's no existing flomni gate missing an image-save call.
Documented in AI_docs/OPEN_ISSUES.md, including a forward-looking note in
case flomni ever gains an interactive gripper-empty confirm of its own.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       | 32 +++++++++++++++++++
 .../omny/omny_sample_transfer_mixin.py        |  3 ++
 2 files changed, 35 insertions(+)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 4d161436..802c382d 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -814,6 +814,38 @@ work above). **Mirko's intent: port the same real-EPICS status+account channel t
 point** -- a separate, dedicated task (its own `.template` record + `FlomniSampleStorage` changes
 + retiring/reconciling `_MeasuredSampleLog`), not bundled into this branch.
 
+## Reference images now saved at every manual confirm gate in otransfer_get_sample/put_sample -- flomni has no equivalent gate to save at
+
+`_otransfer_save_reference_images()` used to be called only from inside `_otransfer_confirm()`'s
+"All OK?" checkpoint (the RT-controller confirm handshake during the actual mount/unmount motion).
+It's now also called at every earlier manual `otransfer_confirm_dialog()` gate in
+`omny_sample_transfer_mixin.py`:
+- `otransfer_get_sample()`'s "Please confirm that currently there is no sample in the gripper..."
+  gate (`file_suffix="get_gripper_empty_check"`)
+- `otransfer_get_sample()`'s "Ready to start the unmount process now?" gate
+  (`file_suffix="get_unmount_start"`)
+- `otransfer_put_sample()`'s "Ready to start the mount process now?" gate
+  (`file_suffix="put_mount_start"`)
+
+All three already run after `_omnycam_parking()`/`_omnycam_samplestage()` has made the camera pair
+live, so no extra setup was needed -- just one more call to the existing, generic
+`_otransfer_save_reference_images(file_suffix=...)` helper at each site.
+
+**Checked flOMNI for the equivalent gap, per Mirko's request: there isn't one to fix.**
+`flomni.py`'s `ftransfer_get_sample()`/`ftransfer_put_sample()` have no manual confirm dialog at
+all before starting the mount/unmount motion -- unlike OMNY, they just do an automated
+`is_sample_in_gripper()`/`is_sample_slot_used()` check and raise `FlomniError` directly, no
+`ftransfer_confirm_dialog()` gate to save an image at. FlOMNI's `save_reference_image()` is (like
+OMNY's `_otransfer_save_reference_images()` used to be) only ever called from its own "All OK?
+Continue?" handshake (`flomni.py` around line 1107-1112) -- so flOMNI and OMNY are consistent
+with each other again after this change, just via different means (OMNY has extra manual gates
+FlOMNI never had, not a missing image-save call on an existing FlOMNI gate).
+
+If FlOMNI ever gains an interactive "confirm gripper is empty" gate of its own (closing this
+long-standing behavioral difference from OMNY), it should get a `save_reference_image()` call at
+the same point, for consistency with this change -- noted here so it isn't forgotten if/when that
+gate gets added, not because anything is broken today.
+
 ## Environment note (not code, but will bite again if forgotten)
 
 Both `csaxs_bec` and `bec_widgets` were pip-installed editable pointing at pre-repo-
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index d90cb64e..e0703aed 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -808,6 +808,7 @@ class OMNYSampleTransferMixin:
 
         if not self.otransfer_confirm_dialog("Ready to start the mount process now?", "y"):
             raise OMNYTransferError("Transfer process has been manually aborted.")
+        self._otransfer_save_reference_images(file_suffix="put_mount_start")
         dev.otransy.controller.socket_put_confirmed("XQ#GRPUT")
 
         print("The mount process started.")
@@ -932,6 +933,7 @@ class OMNYSampleTransferMixin:
             "y",
         ):
             raise OMNYTransferError("Transfer process has been manually aborted.")
+        self._otransfer_save_reference_images(file_suffix="get_gripper_empty_check")
         # clean abort before starting
         dev.otransx.controller.socket_put_confirmed("XQ#STOP,1")
         time.sleep(0.1)
@@ -962,6 +964,7 @@ class OMNYSampleTransferMixin:
 
         if not self.otransfer_confirm_dialog("Ready to start the unmount process now?", "y"):
             raise OMNYTransferError("Transfer process has been manually aborted.")
+        self._otransfer_save_reference_images(file_suffix="get_unmount_start")
 
         dev.otransy.controller.socket_put_confirmed("XQ#GRGET")
 

From 415d55f599da4757033c80e1481e7a52ae3af9d2 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 12:25:39 +0200
Subject: [PATCH 059/102] fix(omny): widen misleading "position not free"/"no
 sample available" errors

Both _otransfer_check_free_slot_available_at_position() and
_otransfer_check_sample_available_at_position() distinguish "slot
occupied/empty" from "no shuttle parked at the active parking
position" internally (via print()), but only returned bool -- so the
raised OMNYTransferError always said "position N is not free"/"no
sample available at position N" even when the real cause was no
shuttle being parked at oparkz's current slot at all, which reads as
if the pin itself were the problem. Widened both messages to cover
either cause, per Mirko's simplest-fix suggestion.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../plugins/omny/omny_sample_transfer_mixin.py         | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index e0703aed..4e6bbdd0 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -793,7 +793,10 @@ class OMNYSampleTransferMixin:
         self.transfer_step = 0
         self._otransfer_check_sensor_connected()
         if not self._otransfer_check_free_slot_available_at_position(pin_position, 0):
-            raise OMNYTransferError(f"position {pin_position} is not free")
+            raise OMNYTransferError(
+                f"position {pin_position} is not free, or no shuttle is parked at the"
+                " active parking position"
+            )
 
         #    global _ogalil_encoder_steps_per_mm
         if pin_position == 0:
@@ -940,7 +943,10 @@ class OMNYSampleTransferMixin:
 
         self._otransfer_check_sensor_connected()
         if not self._otransfer_check_sample_available_at_position(pin_position, 0):
-            raise OMNYTransferError(f"There is no sample available at position {pin_position}")
+            raise OMNYTransferError(
+                f"There is no sample available at position {pin_position}, or no shuttle is"
+                " parked at the active parking position"
+            )
 
         # global _otransy_approach_height
         # global _ogalil_encoder_steps_per_mm

From 3241e880cee15fe954e72c4349f5e63ddc6225f2 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 12:57:48 +0200
Subject: [PATCH 060/102] docs(omny): design plan for machine-vision
 auto-confirm on sample transfer

Explores classical CV (registration + edge/SSIM/contour matching against
multiple reference images) to reduce the manual y/n confirms in
otransfer_get_sample()/otransfer_put_sample(), reusing the existing
reference-image capture and the push_smear_preview() GUI-overlay pattern
already proven for LamNI's rotation-center calibration. Exploration only;
implementation to follow on a separate branch.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../MACHINE_VISION_AUTOCONFIRM_PLAN.md        | 147 ++++++++++++++++++
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |   6 +-
 2 files changed, 151 insertions(+), 2 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
new file mode 100644
index 00000000..a150b4ff
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
@@ -0,0 +1,147 @@
+# OMNY sample-transfer machine-vision auto-confirm — design plan (2026-09-06)
+
+Exploration only — **no code in this pass**. Written on `update-omny` so a future session/branch
+can pick this up without re-deriving it. Companion docs: `OPEN_ISSUES.md` (the live-testing effort
+this plan grows out of — see its "full gripper sample-transfer chain... untested" item) and
+`SAMPLE_STORAGE_TEST_CHECKLIST.md`.
+
+## Motivation
+
+Mirko's starting question: is there a Python package for comparing a live gripper/pin camera image
+against a set of reference images, robust to exposure changes and small camera-alignment drift, to
+decide "is the pin sitting in the gripper correctly" — classic machine-vision, not deep learning.
+Applied to BEC: could this let OMNY's sample-transfer flow (`otransfer_get_sample()` /
+`otransfer_put_sample()`) auto-approve routine steps instead of stopping for a human `y/n` at every
+single one, while still catching real problems (pin damage, missed grip, wrong shuttle state)?
+
+This doc maps that idea onto OMNY's actual confirm gates and camera/GUI plumbing, and proposes a
+staged plan. **Goal for this session: write this plan down. Implementation is a separate, later
+branch.**
+
+## Where today's human confirmations actually live
+
+All of these are in `omny_sample_transfer_mixin.py` and go through
+`otransfer_confirm_dialog()` (line 76 — GUI `ConsoleButtonsWidget` yes/no if the camera console is
+already open, else a blocking CLI `yesno()`):
+
+1. **`_otransfer_confirm()`** (line 848) — the main per-step handshake during an actual mount/get,
+   driven by the Galil controller's `confirm`/`mntprgs` variables (`XQ#GRPUT`/`XQ#GRGET` macros).
+   Loops until the controller reports `mntprgs == 0`; each iteration is one manual "All OK?"
+   gate. For a *get*, the first iteration additionally hard-checks the top-pin position against a
+   fixed threshold (`-25.4`, line 866) and asks an extra, more alarming confirm if it's exceeded —
+   this is a **physical safety check**, not a generic step confirm, and should stay independent of
+   any vision system.
+2. **`otransfer_get_sample()`** (line 934) — "confirm there is no sample in the gripper, it would
+   be dropped" before starting at all.
+3. **`otransfer_get_sample()`** (line 971) / **`otransfer_put_sample()`** (line 812) — "Ready to
+   start the [un]mount process now?" right before triggering `XQ#GRGET`/`XQ#GRPUT`.
+4. **`otransfer_put_sample()`** (line 836) — "Pick another sample from this shuttle? Keep shield
+   open?" after a successful put.
+5. **`_otransfer_shuttle_align()`** (line 189) — one-off "shall I try to move the aligner to the
+   correct start position" recovery prompt, only on a specific bad-limit-switch state. Edge case,
+   not a routine per-transfer gate — out of scope for auto-confirm.
+6. **`otransfer_park_loadlock_slot()`** (line 523) — CLI-only `yesno()` by design (operator is
+   physically at the loadlock, not watching the GUI camera console) — also out of scope here.
+
+Gates 1–4 are the routine, repeated-every-transfer confirmations this plan targets. Every one of
+them already calls **`_otransfer_save_reference_images()`** (line 885, landed in `a7429b2`) right
+at the confirm point, which dumps the currently-active camera pair's `get_last_image()` frames to
+an HDF5 file under `~/data/raw/logs/omny_sample_transfer_images/`, named by step + timestamp. **This
+is already the reference-image corpus this plan would compare against** — it exists purely as a
+post-hoc audit log today, with no comparison logic reading it back.
+
+## Existing infrastructure to build on (no new plumbing needed for a prototype)
+
+- **`IDSCamera.get_last_image()`** (`csaxs_bec/devices/ids_cameras/ids_camera.py:234`) — already
+  how `_otransfer_save_reference_images()` gets frames; same call works for a live comparison.
+- **`OMNYGuiTools._omnycam_active_pair`** (`gui_tools.py:88-105`) — tracks which camera pair
+  (`cam200`+`cam203` parking/shuttle, or `cam201`+`cam202` sample stage) is currently shown, exactly
+  the info needed to pick the matching reference subset.
+- **`IDSCamera.push_preview_image()` / `push_smear_preview()`** (`ids_camera.py:240,269`) — a
+  device-server-side hook to publish a processed/composite array back through the same
+  `device_preview` channel the GUI already subscribes to, without disturbing the live acquisition
+  feed. **This exact mechanism is already proven for a similar purpose**: LamNI's rotation-center
+  calibration (`LamNI/x_ray_eye_align.py:737-797`, see `[[project_lamni_rotation_center_calibration]]`-era
+  work) pushes a growing composite image via `push_smear_preview()`, and
+  `bec_widgets/widgets/xray_eye/x_ray_eye.py` (`smear_preview_toggle`, lines 386-873) already has a
+  working UI toggle to switch an `Image` dock between the live feed and this diagnostic channel.
+  **A vision-diff overlay for OMNY sample transfer should reuse this pattern** — push an
+  aligned-reference/diff/contour-overlay composite via `push_smear_preview()` on whichever of
+  cam200/201/202/203 is active, and add the same toggle affordance to OMNY's camera docks
+  (`gui_tools.py:127-152`) — rather than inventing a third dock or a new preview channel.
+- **`opencv-python`** is already a project dependency (`pyproject.toml:27`); `scikit-image` is not
+  yet (needed only if SSIM specifically is wanted — see below).
+
+## Proposed CV pipeline (classical, no deep learning)
+
+Per the original discussion this grew out of: classical machine vision is enough for a
+well-constrained "is the pin geometry right" question; no training data, no model to keep in sync
+with hardware changes.
+
+1. **Registration first.** Camera mounts can drift slightly, so raw pixel comparison isn't
+   meaningful until the current frame is aligned to the reference. `cv2.findTransformECC` for
+   small translation/rotation (the expected case — a bolted-down camera); an ORB/SIFT +
+   `cv2.findHomography` fallback if perspective drift turns out to be larger than ECC handles.
+2. **Exposure-robust representation.** Compare edges/gradients (Sobel/Canny) or CLAHE-normalized
+   images, not raw intensity — illumination changes should not look like a defect.
+3. **Similarity/anomaly scoring**, two complementary signals:
+   - **Contour/silhouette match** (`cv2.findContours` + `cv2.matchShapes`) on the extracted
+     pin/gripper silhouette — the most directly relevant signal for "is the pin sitting right",
+     and close to fully lighting-invariant.
+   - **SSIM** (`skimage.metrics.structural_similarity`) on the registered, normalized pair as a
+     general structural-anomaly fallback, in case a defect doesn't show up as a clean contour
+     change. (Pulls in `scikit-image` as a new dependency — only if this signal proves worth its
+     weight; contour matching alone may be sufficient given how constrained the geometry is.)
+4. **Multi-reference scoring.** Score against *every* reference image for the given
+   `(pin_position, step_name, camera)` combination and take the best (minimum-distance) match, not
+   a single fixed reference — natural sample-to-sample and lighting variation shouldn't inflate the
+   anomaly score just because one particular reference happened to be a bad match.
+5. **Escalate only if needed.** If classical contour/SSIM scoring proves insufficiently robust to
+   subtle real defects, `anomalib` (e.g. PatchCore) is the documented fallback — but per the
+   original assessment this is very likely overkill for a fixed pin/gripper geometry, and shouldn't
+   be built preemptively.
+
+## What "getting rid of human confirmations" should actually mean — staged rollout
+
+Physical hardware, real samples, real damage risk (see the top-pin threshold in gate 1 above) means
+this should not be an all-or-nothing flag flip. Proposed phases for the later implementation branch:
+
+- **Phase 0 — instrument, don't automate.** Compute and log the vision score at every existing gate
+  (1–4 above); still always show the human the same confirm prompt, but now alongside the score and
+  a diff/overlay visualization (via the `push_smear_preview()` pattern above). Purpose: build a
+  labeled dataset of real operator pass/fail decisions vs. score, across real lighting and sample
+  variety, before trusting any threshold. No behavior change to the transfer flow itself.
+- **Phase 1 — assist, never silently reject.** A comfortably-high score can auto-answer "yes" at a
+  gate (with the decision logged and visibly flagged as auto-confirmed, and an easy override); a
+  low score never fails silently or auto-aborts — it escalates to the same confirm prompt, now with
+  the diff visualization made prominent, so the human's attention goes exactly where the anomaly
+  is. This mirrors how the existing top-pin-position check already works (a hard numeric threshold
+  that *escalates* the confirm text, never silently proceeds or silently aborts).
+- **Phase 2 — skip the prompt on high-confidence routine steps.** Only once Phase 0/1 data shows
+  the scoring is reliable across real operational conditions, let specific gates (candidates: gate
+  2's "no sample in gripper" check, gate 4's "pick another sample" prompt — the more purely
+  informational ones) skip the prompt outright on a high score, behind an explicit opt-in/kill
+  switch. The physical safety checks (top-pin threshold, `_otransfer_check_sensor_connected()`)
+  stay hard-coded and independent of the vision system regardless of phase — vision augments the
+  judgment calls, it doesn't replace the interlocks.
+
+## Open questions / decisions needed before implementation starts
+
+- **Reference corpus curation.** Today's saved images are a timestamped append-only run log, not a
+  curated "golden" set — every run adds a new file, nothing marks one as trustworthy for
+  comparison. Need either a promotion step (operator marks a saved image as a reference) or a
+  separate deliberately-curated directory, distinct from the audit-log files
+  `_otransfer_save_reference_images()` already writes.
+- **Per-camera-pair segmentation.** Parking/shuttle view (cam200+cam203) and sample-stage view
+  (cam201+cam202) have different backgrounds/lighting; silhouette extraction likely needs tuning
+  per pair, not one global set of CV parameters.
+- **Threshold calibration.** Can't be picked a priori — needs the Phase 0 logged-score dataset
+  across real sessions before any auto-confirm threshold is chosen.
+- **Where scores/results live.** Likely alongside the existing HDF5 reference-image files (same
+  per-step file, additional dataset for score + registration transform), rather than a new storage
+  mechanism.
+
+## Non-goals for this session
+
+No dependencies added, no code written, no new GUI elements built. This document is the handoff for
+the follow-up branch.
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index 802c382d..ad400426 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -3,9 +3,11 @@
 Tracks the live-testing effort for bringing OMNY up to flomni's/BEC's current standards on
 branch `update-omny`: bugs found (fixed and unfixed) and what's still untested. Written so a
 future session can pick this up without re-deriving it. Companion docs:
-`../../flomni/AI_docs/SIMULATED_ENDSTATIONS.md` (the sim architecture) and
+`../../flomni/AI_docs/SIMULATED_ENDSTATIONS.md` (the sim architecture),
 `../../flomni/AI_docs/FLOMNI_TO_LAMNI_COMPARISON.md` (the flomni→lamni migration this OMNY work
-is meant to mirror).
+is meant to mirror), and `MACHINE_VISION_AUTOCONFIRM_PLAN.md` (design-only exploration of using
+classical machine vision on the sample-transfer camera feeds to reduce/replace the manual confirm
+gates in `otransfer_get_sample()`/`otransfer_put_sample()` — not started, separate future branch).
 
 ## Current status
 

From 9d4cd0347ebf4a1ab26bdeaa9736c71e75fdd6dd Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 13:07:34 +0200
Subject: [PATCH 061/102] docs(omny): make the vision pipeline a generic
 camera-agnostic device

Reworks the plan per feedback: instead of building CV logic into
IDSCamera / inline in the sample-transfer mixin, propose a standalone
SampleVisionMonitor device whose only dependency is the get_last_image()
contract already shared by IDSCamera and AlliedVisionAravisCamera, wired
to its camera(s) by configured name (ddg_1.py's device_manager.devices.get()
pattern, generalized). Same class is then reusable for any endstation's
camera(s) via config alone.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../MACHINE_VISION_AUTOCONFIRM_PLAN.md        | 122 ++++++++++++++----
 1 file changed, 95 insertions(+), 27 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
index a150b4ff..134ae6ba 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
@@ -50,28 +50,87 @@ an HDF5 file under `~/data/raw/logs/omny_sample_transfer_images/`, named by step
 is already the reference-image corpus this plan would compare against** — it exists purely as a
 post-hoc audit log today, with no comparison logic reading it back.
 
-## Existing infrastructure to build on (no new plumbing needed for a prototype)
+## Existing infrastructure to build on
 
-- **`IDSCamera.get_last_image()`** (`csaxs_bec/devices/ids_cameras/ids_camera.py:234`) — already
-  how `_otransfer_save_reference_images()` gets frames; same call works for a live comparison.
+- **`get_last_image() -> np.ndarray`** is already a shared, RPC-exposed contract across camera
+  device classes, not an `IDSCamera` idiosyncrasy: both `IDSCamera`
+  (`csaxs_bec/devices/ids_cameras/ids_camera.py:234`, `rpc_access` line 72) and
+  `AlliedVisionAravisCamera` (`csaxs_bec/devices/allied_vision_cameras/allied_vision_aravis_camera.py:216`,
+  `rpc_access` line 62) implement it identically, and client-side code already calls it directly
+  through the device-server RPC boundary — `LamNI/x_ray_eye_align.py:202,821` and
+  `flomni/x_ray_eye_align.py:127` do exactly this (`dev.cam_xeye.get_last_image()`) regardless of
+  which concrete camera class backs `cam_xeye` at a given beamline. This is the natural minimal
+  interface for a generic vision component to depend on — see the architecture section below.
 - **`OMNYGuiTools._omnycam_active_pair`** (`gui_tools.py:88-105`) — tracks which camera pair
   (`cam200`+`cam203` parking/shuttle, or `cam201`+`cam202` sample stage) is currently shown, exactly
   the info needed to pick the matching reference subset.
-- **`IDSCamera.push_preview_image()` / `push_smear_preview()`** (`ids_camera.py:240,269`) — a
-  device-server-side hook to publish a processed/composite array back through the same
-  `device_preview` channel the GUI already subscribes to, without disturbing the live acquisition
-  feed. **This exact mechanism is already proven for a similar purpose**: LamNI's rotation-center
-  calibration (`LamNI/x_ray_eye_align.py:737-797`, see `[[project_lamni_rotation_center_calibration]]`-era
-  work) pushes a growing composite image via `push_smear_preview()`, and
-  `bec_widgets/widgets/xray_eye/x_ray_eye.py` (`smear_preview_toggle`, lines 386-873) already has a
-  working UI toggle to switch an `Image` dock between the live feed and this diagnostic channel.
-  **A vision-diff overlay for OMNY sample transfer should reuse this pattern** — push an
-  aligned-reference/diff/contour-overlay composite via `push_smear_preview()` on whichever of
-  cam200/201/202/203 is active, and add the same toggle affordance to OMNY's camera docks
-  (`gui_tools.py:127-152`) — rather than inventing a third dock or a new preview channel.
+- **Precedent for one device depending on another by configured name, resolved through the device
+  manager**: `DDG1.prepare_mcs_on_trigger()` (`csaxs_bec/devices/epics/delay_generator_csaxs/ddg_1.py:369-397`)
+  looks up a sibling device via `self.device_manager.devices.get(mcs_name, None)` at call time (not
+  at `__init__`, since device construction order across a YAML config isn't guaranteed) and raises
+  clearly if it's missing. Same pattern, generalized to a *configurable* name instead of `ddg_1.py`'s
+  hardcoded `"mcs"`, is the mechanism proposed below for a vision device's camera dependency.
+- **`IDSCamera.push_preview_image()` / `push_smear_preview()`** (`ids_camera.py:240,269`) — an
+  `IDSCamera`-specific hook to publish a processed/composite array through its own
+  `device_preview` channel, already proven for a similar purpose in LamNI's rotation-center
+  calibration (`LamNI/x_ray_eye_align.py:737-797`) together with the matching UI toggle in
+  `bec_widgets/widgets/xray_eye/x_ray_eye.py:386-873`. Usable as a visualization *fallback* when the
+  configured camera happens to be an `IDSCamera`, but not something the generic vision device
+  should depend on — see "own diagnostic signal vs. borrowing the camera's channel" below.
 - **`opencv-python`** is already a project dependency (`pyproject.toml:27`); `scikit-image` is not
   yet (needed only if SSIM specifically is wanted — see below).
 
+## Proposed architecture: a generic, camera-agnostic vision device
+
+Earlier drafts of this plan sketched the CV pipeline as logic living inside `IDSCamera` itself, or
+inline in `omny_sample_transfer_mixin.py` calling `cv2`/`skimage` directly against whichever
+`cam200`-`cam203` frame it just pulled. Mirko's feedback: keep the imaging pipeline generic and
+reusable against *any* camera, structured as its own device with a camera as a declared dependency,
+rather than building it into a specific camera class. Concretely:
+
+- **A new, endstation-agnostic device class** (working name `SampleVisionMonitor`), living outside
+  `omny/` — e.g. `csaxs_bec/devices/vision/sample_vision_monitor.py` — so it isn't OMNY-specific
+  code, just OMNY's first user of it.
+- **Its only hard dependency is the shared `get_last_image()` contract** above — nothing
+  `IDSCamera`-specific (no reliance on `push_smear_preview`, the `image` `PreviewSignal`'s
+  rotation/transpose handling, etc.). Any current or future camera class that implements
+  `get_last_image() -> np.ndarray | None` can be wired in, including `AlliedVisionAravisCamera` or a
+  simulated camera, with zero changes to this device.
+- **Config-driven camera dependency, resolved lazily.** A `camera_names: list[str]` constructor
+  parameter (a list, not a single name, so OMNY's camera-*pairs* — `["cam200", "cam203"]` for
+  parking, `["cam201", "cam202"]` for the sample stage — are a natural fit; a single-camera setup
+  like flomni's gripper cam is just a length-1 list). Resolved through
+  `self.device_manager.devices.get(name, None)` at call time, mirroring `ddg_1.py`'s pattern above,
+  with a clear error if a configured name isn't present in the active session's device config.
+  **This is what makes the device reusable across endstations without touching its code**: the same
+  class, pointed at a different `camera_names` list in a different beamline's device-config YAML,
+  is the entire integration cost for a new camera or a new endstation.
+- **Runs device-server-side** (a `PSIDeviceBase` subclass, like `IDSCamera` itself), consistent with
+  where camera image processing already happens in this codebase, and appropriate for the
+  registration/scoring compute cost.
+- **Opaque, caller-defined reference tags**, not OMNY vocabulary baked into the device: reference
+  images and scores are grouped by a plain string tag the caller picks (for OMNY,
+  `f"{step_name}_{pin_position}"`; a different endstation could tag however makes sense to it) — the
+  device itself has no notion of "pin position" or "shuttle slot".
+- **Client-facing RPC surface** (sketch, names not final):
+  - `save_reference(tag: str) -> None` — pulls the current frame(s) from the configured camera(s)
+    and stores them as a labeled reference under `tag`.
+  - `score(tag: str) -> dict` — pulls the current frame(s), registers + scores each against every
+    stored reference under `tag` (see CV pipeline below), publishes a diagnostic overlay (see next
+    bullet), and returns the best-match score(s) plus enough detail to build a confirm message.
+  - `omny_sample_transfer_mixin.py`'s gates (1-4 above) become *callers* of this device
+    (`dev.omny_vision_parking.score(...)`, `dev.omny_vision_samplestage.score(...)`, one device
+    instance per camera pair) instead of doing any `cv2`/`skimage` work themselves — the mixin only
+    turns the returned score into a confirm-dialog decision (per the staged rollout below).
+  - **Own diagnostic signal vs. borrowing the target camera's channel** — open decision, not
+    resolved here: (a) give `SampleVisionMonitor` its own `diagnostic_image` `PreviewSignal`
+    component, fully decoupled from whichever camera it's pointed at, requiring one new `Image` dock
+    in `gui_tools.py` per vision device; vs. (b) when the configured camera happens to expose
+    `push_smear_preview()` (i.e. it's an `IDSCamera`), feature-detect that and reuse the existing
+    dock + toggle pattern instead of adding a new one. (a) is more genuinely camera-agnostic (matches
+    the rest of this design); (b) is less new GUI surface for OMNY specifically, at the cost of only
+    working when the backing camera happens to support it. Worth prototyping both before deciding.
+
 ## Proposed CV pipeline (classical, no deep learning)
 
 Per the original discussion this grew out of: classical machine vision is enough for a
@@ -92,10 +151,10 @@ with hardware changes.
      general structural-anomaly fallback, in case a defect doesn't show up as a clean contour
      change. (Pulls in `scikit-image` as a new dependency — only if this signal proves worth its
      weight; contour matching alone may be sufficient given how constrained the geometry is.)
-4. **Multi-reference scoring.** Score against *every* reference image for the given
-   `(pin_position, step_name, camera)` combination and take the best (minimum-distance) match, not
-   a single fixed reference — natural sample-to-sample and lighting variation shouldn't inflate the
-   anomaly score just because one particular reference happened to be a bad match.
+4. **Multi-reference scoring.** Score against *every* reference image stored under the given tag
+   and take the best (minimum-distance) match, not a single fixed reference — natural
+   sample-to-sample and lighting variation shouldn't inflate the anomaly score just because one
+   particular reference happened to be a bad match.
 5. **Escalate only if needed.** If classical contour/SSIM scoring proves insufficiently robust to
    subtle real defects, `anomalib` (e.g. PatchCore) is the documented fallback — but per the
    original assessment this is very likely overkill for a fixed pin/gripper geometry, and shouldn't
@@ -107,10 +166,11 @@ Physical hardware, real samples, real damage risk (see the top-pin threshold in
 this should not be an all-or-nothing flag flip. Proposed phases for the later implementation branch:
 
 - **Phase 0 — instrument, don't automate.** Compute and log the vision score at every existing gate
-  (1–4 above); still always show the human the same confirm prompt, but now alongside the score and
-  a diff/overlay visualization (via the `push_smear_preview()` pattern above). Purpose: build a
-  labeled dataset of real operator pass/fail decisions vs. score, across real lighting and sample
-  variety, before trusting any threshold. No behavior change to the transfer flow itself.
+  (1–4 above) via `SampleVisionMonitor.score()`; still always show the human the same confirm
+  prompt, but now alongside the score and the diagnostic diff/overlay visualization it publishes.
+  Purpose: build a labeled dataset of real operator pass/fail decisions vs. score, across real
+  lighting and sample variety, before trusting any threshold. No behavior change to the transfer
+  flow itself.
 - **Phase 1 — assist, never silently reject.** A comfortably-high score can auto-answer "yes" at a
   gate (with the decision logged and visibly flagged as auto-confirmed, and an easy override); a
   low score never fails silently or auto-aborts — it escalates to the same confirm prompt, now with
@@ -129,17 +189,25 @@ this should not be an all-or-nothing flag flip. Proposed phases for the later im
 
 - **Reference corpus curation.** Today's saved images are a timestamped append-only run log, not a
   curated "golden" set — every run adds a new file, nothing marks one as trustworthy for
-  comparison. Need either a promotion step (operator marks a saved image as a reference) or a
-  separate deliberately-curated directory, distinct from the audit-log files
-  `_otransfer_save_reference_images()` already writes.
+  comparison. Need either a promotion step (operator marks a saved image as a reference, e.g. via
+  `save_reference()` above) or a separate deliberately-curated directory, distinct from the
+  audit-log files `_otransfer_save_reference_images()` already writes.
 - **Per-camera-pair segmentation.** Parking/shuttle view (cam200+cam203) and sample-stage view
   (cam201+cam202) have different backgrounds/lighting; silhouette extraction likely needs tuning
-  per pair, not one global set of CV parameters.
+  per pair, not one global set of CV parameters — one `SampleVisionMonitor` instance per pair (its
+  own config, own reference store) is the natural place for that tuning to live.
 - **Threshold calibration.** Can't be picked a priori — needs the Phase 0 logged-score dataset
   across real sessions before any auto-confirm threshold is chosen.
 - **Where scores/results live.** Likely alongside the existing HDF5 reference-image files (same
   per-step file, additional dataset for score + registration transform), rather than a new storage
   mechanism.
+- **Diagnostic visualization: own `PreviewSignal` vs. borrowing the camera's `smear_preview`** —
+  see the architecture section above; needs a short prototype of both before committing.
+- **One `SampleVisionMonitor` config per camera pair vs. one instance whose `camera_names` gets
+  reconfigured at call time** — static per-pair config (e.g. `omny_vision_parking`,
+  `omny_vision_samplestage` as two fixed device-config entries) is simpler and matches how OMNY's
+  own two camera pairs are already fixed, not dynamic; leaning toward this unless a concrete need
+  for a dynamic pairing shows up.
 
 ## Non-goals for this session
 

From d04932b68d0225a91489f0f63aa4556f699b4255 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 13:15:11 +0200
Subject: [PATCH 062/102] docs(omny): split vision plan into a generic
 toolkit/interface + confirm app

Per feedback: split the design into three layers instead of one
confirm-scoring device. Layer 0 is a plain image-manipulation toolkit
(grayscale, edge detection, registration, overlays) with no device/BEC
dependency. Layer 1 is a new generic VisionInterface device -- camera in,
processed image out, mode selectable at runtime -- usable as an
in-between interface for any camera consumer, not just sample-transfer
confirms; x_ray_eye_align.py's alignment GUI is called out as a second,
independent consumer. Layer 2 (SampleVisionMonitor, the sample-transfer
confirm/scoring device from the previous pass) is now framed as one
application built on top of Layers 0/1.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../MACHINE_VISION_AUTOCONFIRM_PLAN.md        | 159 ++++++++++++------
 1 file changed, 106 insertions(+), 53 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
index 134ae6ba..1e624ba8 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
@@ -15,8 +15,12 @@ Applied to BEC: could this let OMNY's sample-transfer flow (`otransfer_get_sampl
 single one, while still catching real problems (pin damage, missed grip, wrong shuttle state)?
 
 This doc maps that idea onto OMNY's actual confirm gates and camera/GUI plumbing, and proposes a
-staged plan. **Goal for this session: write this plan down. Implementation is a separate, later
-branch.**
+staged plan. Follow-up feedback broadened the scope: rather than building the image-processing logic
+into a single confirm/scoring device, keep it generic — a reusable camera-in/processed-image-out
+interface (grayscale, edge detection, overlays, ...) that the sample-transfer confirm use case is
+only the *first* consumer of; `x_ray_eye_align.py`'s alignment GUI is identified below as a second,
+independent consumer of the same layer. **Goal for this session: write this plan down.
+Implementation is a separate, later branch.**
 
 ## Where today's human confirmations actually live
 
@@ -80,56 +84,95 @@ post-hoc audit log today, with no comparison logic reading it back.
 - **`opencv-python`** is already a project dependency (`pyproject.toml:27`); `scikit-image` is not
   yet (needed only if SSIM specifically is wanted — see below).
 
-## Proposed architecture: a generic, camera-agnostic vision device
+## Proposed architecture: a generic, camera-agnostic vision layer
 
 Earlier drafts of this plan sketched the CV pipeline as logic living inside `IDSCamera` itself, or
 inline in `omny_sample_transfer_mixin.py` calling `cv2`/`skimage` directly against whichever
-`cam200`-`cam203` frame it just pulled. Mirko's feedback: keep the imaging pipeline generic and
-reusable against *any* camera, structured as its own device with a camera as a declared dependency,
-rather than building it into a specific camera class. Concretely:
+`cam200`-`cam203` frame it just pulled. Mirko's feedback, in two parts: (1) keep the imaging
+pipeline generic and reusable against *any* camera, structured as its own device with a camera as a
+declared dependency, rather than building it into a specific camera class; (2) go further than a
+single-purpose confirm/scoring device — make the underlying image manipulation (grayscale, edge
+detection, and similar) a generic, reusable *interface* that can sit between a raw camera and its
+consumer for other purposes too, e.g. an alternative processed/overlay view for
+`x_ray_eye_align.py`'s alignment GUI, not just sample-transfer scoring. Three layers, each usable on
+its own:
 
-- **A new, endstation-agnostic device class** (working name `SampleVisionMonitor`), living outside
-  `omny/` — e.g. `csaxs_bec/devices/vision/sample_vision_monitor.py` — so it isn't OMNY-specific
-  code, just OMNY's first user of it.
-- **Its only hard dependency is the shared `get_last_image()` contract** above — nothing
-  `IDSCamera`-specific (no reliance on `push_smear_preview`, the `image` `PreviewSignal`'s
-  rotation/transpose handling, etc.). Any current or future camera class that implements
-  `get_last_image() -> np.ndarray | None` can be wired in, including `AlliedVisionAravisCamera` or a
-  simulated camera, with zero changes to this device.
-- **Config-driven camera dependency, resolved lazily.** A `camera_names: list[str]` constructor
-  parameter (a list, not a single name, so OMNY's camera-*pairs* — `["cam200", "cam203"]` for
-  parking, `["cam201", "cam202"]` for the sample stage — are a natural fit; a single-camera setup
-  like flomni's gripper cam is just a length-1 list). Resolved through
-  `self.device_manager.devices.get(name, None)` at call time, mirroring `ddg_1.py`'s pattern above,
-  with a clear error if a configured name isn't present in the active session's device config.
-  **This is what makes the device reusable across endstations without touching its code**: the same
-  class, pointed at a different `camera_names` list in a different beamline's device-config YAML,
-  is the entire integration cost for a new camera or a new endstation.
-- **Runs device-server-side** (a `PSIDeviceBase` subclass, like `IDSCamera` itself), consistent with
-  where camera image processing already happens in this codebase, and appropriate for the
-  registration/scoring compute cost.
-- **Opaque, caller-defined reference tags**, not OMNY vocabulary baked into the device: reference
-  images and scores are grouped by a plain string tag the caller picks (for OMNY,
-  `f"{step_name}_{pin_position}"`; a different endstation could tag however makes sense to it) — the
-  device itself has no notion of "pin position" or "shuttle slot".
+### Layer 0 — a plain image-processing toolkit (pure functions, no device, no BEC dependency)
+
+Grayscale conversion, CLAHE, Sobel/Canny edge detection, ECC/ORB-based registration, contour
+extraction, and overlay drawing (crosshair, contour outline, diff highlight) as plain
+`numpy`/`opencv` functions — array in, array (or array + metadata, e.g. a fitted transform or a
+contour) out. No devices, no BEC imports, trivially unit-testable in isolation, matching this
+repo's existing preference for pure-function "widget math" test files (e.g.
+`test_omny_tomo_params_widget_math.py`). This is the shared vocabulary both layers below build on —
+neither the confirm/scoring use case nor a live processed-view use case should each hand-roll their
+own edge-detection/registration code.
+
+### Layer 1 — `VisionInterface`: a generic camera-in, processed-image-out device
+
+The direct answer to "a camera interface that allows image manipulation... could be used as an
+intermediate interface for x_ray_eye align, bypass the normal image, activate edge detection,
+overlay graphics": a device that sits *between* a source camera and whatever is watching it,
+publishing a transformed view instead of (or alongside) the raw feed.
+
+- **Endstation-agnostic**, living outside `omny/` — e.g. `csaxs_bec/devices/vision/vision_interface.py`.
+- **Same camera-dependency mechanism as before**: config-driven `camera_names: list[str]`, resolved
+  lazily via `self.device_manager.devices.get(name, None)` (the `ddg_1.py` pattern), requiring only
+  the shared `get_last_image()` contract — no dependency on which concrete camera class it's pointed
+  at.
+- **A selectable processing mode**, built from Layer 0's toolkit — `"raw"`, `"grayscale"`,
+  `"edges"`, `"clahe"`, `"overlay"` (e.g. a stored reference's contour drawn over the live frame),
+  or a small ordered pipeline of these — settable at runtime via an RPC/`Signal` (e.g.
+  `set_mode(name: str)`), not hardcoded per device instance. This generalizes what
+  `push_smear_preview()`/the existing `smear_preview_toggle` do today (one hardcoded composite, one
+  fixed second channel) into "any of a small library of transforms, chosen at runtime".
+- **Own `diagnostic_image` `PreviewSignal`**, decoupled from whichever camera it's pointed at (the
+  "own signal" option from the previous draft of this doc) — this is what makes it a genuine
+  in-between interface rather than a camera-specific patch: the GUI dock watches the
+  `VisionInterface`'s output, and swapping/reconfiguring the source camera or the active mode
+  doesn't change what the dock is looking at.
+- **Two independent consumers**, justifying building this generically rather than folding it
+  straight into the sample-transfer use case:
+  - **`SampleVisionMonitor`** (Layer 2, below) uses it for registration + the diagnostic overlay it
+    publishes during confirm gates.
+  - **`x_ray_eye_align.py`**'s alignment GUI (`update_frame()`,
+    `flomni/x_ray_eye_align.py:114-135` — the operator watches a raw live `cam_xeye` feed and
+    manually places alignment points, fit later done in Matlab; OMNY's own copy is still an
+    unadapted LamNI leftover per `OPEN_ISSUES.md`) currently shows only the unprocessed live image.
+    A `VisionInterface` in front of `cam_xeye` could offer an edge-enhanced or CLAHE-normalized live
+    view as an operator-toggleable alternative during manual point-picking — exactly the same
+    exposure-invariance motivation as the sample-transfer use case, applied to a second, already-
+    existing manual-confirmation-style workflow. **Not proposed as a replacement for the existing
+    Matlab-based fit** — just a second real consumer of the same generic layer, and a concrete
+    illustration of why Layer 0/1 shouldn't be scoped to OMNY sample-transfer specifically.
+
+### Layer 2 — `SampleVisionMonitor`: the sample-transfer confirm/scoring application
+
+Everything from the previous draft of this plan, now explicitly framed as *one application built on
+top of Layers 0/1*, not a separate camera-coupled implementation:
+
+- **Runs device-server-side** (a `PSIDeviceBase` subclass, like `IDSCamera`/`VisionInterface`
+  itself), consistent with where camera image processing already happens in this codebase.
+- **Opaque, caller-defined reference tags** — reference images and scores are grouped by a plain
+  string tag the caller picks (for OMNY, `f"{step_name}_{pin_position}"`); the device itself has no
+  notion of "pin position" or "shuttle slot".
 - **Client-facing RPC surface** (sketch, names not final):
-  - `save_reference(tag: str) -> None` — pulls the current frame(s) from the configured camera(s)
-    and stores them as a labeled reference under `tag`.
-  - `score(tag: str) -> dict` — pulls the current frame(s), registers + scores each against every
-    stored reference under `tag` (see CV pipeline below), publishes a diagnostic overlay (see next
-    bullet), and returns the best-match score(s) plus enough detail to build a confirm message.
+  - `save_reference(tag: str) -> None` — pulls the current frame(s) (via its own or a shared
+    `VisionInterface`) and stores them as a labeled reference under `tag`.
+  - `score(tag: str) -> dict` — registers + scores the current frame(s) against every stored
+    reference under `tag` (see CV pipeline below, using Layer 0's registration/contour/SSIM
+    functions), publishes a diagnostic diff/overlay through the `VisionInterface` it uses, and
+    returns the best-match score(s) plus enough detail to build a confirm message.
   - `omny_sample_transfer_mixin.py`'s gates (1-4 above) become *callers* of this device
-    (`dev.omny_vision_parking.score(...)`, `dev.omny_vision_samplestage.score(...)`, one device
-    instance per camera pair) instead of doing any `cv2`/`skimage` work themselves — the mixin only
-    turns the returned score into a confirm-dialog decision (per the staged rollout below).
-  - **Own diagnostic signal vs. borrowing the target camera's channel** — open decision, not
-    resolved here: (a) give `SampleVisionMonitor` its own `diagnostic_image` `PreviewSignal`
-    component, fully decoupled from whichever camera it's pointed at, requiring one new `Image` dock
-    in `gui_tools.py` per vision device; vs. (b) when the configured camera happens to expose
-    `push_smear_preview()` (i.e. it's an `IDSCamera`), feature-detect that and reuse the existing
-    dock + toggle pattern instead of adding a new one. (a) is more genuinely camera-agnostic (matches
-    the rest of this design); (b) is less new GUI surface for OMNY specifically, at the cost of only
-    working when the backing camera happens to support it. Worth prototyping both before deciding.
+    (`dev.omny_vision_parking.score(...)`, `dev.omny_vision_samplestage.score(...)`, one instance
+    per camera pair) instead of doing any `cv2`/`skimage` work themselves — the mixin only turns the
+    returned score into a confirm-dialog decision (per the staged rollout below).
+- **Open composition question, not resolved here**: whether `SampleVisionMonitor` *contains* a
+  `VisionInterface` instance internally (composition), or is itself built directly on Layer 0 with
+  its own separate `diagnostic_image` signal and `VisionInterface` stays a purely GUI/alignment-side
+  concept. Composition (reusing one `VisionInterface` per camera pair, shared by both the confirm
+  scoring and any live processed view of that same pair) avoids two devices both owning a signal for
+  the same physical camera pair — likely the cleaner shape, but worth prototyping both.
 
 ## Proposed CV pipeline (classical, no deep learning)
 
@@ -201,13 +244,23 @@ this should not be an all-or-nothing flag flip. Proposed phases for the later im
 - **Where scores/results live.** Likely alongside the existing HDF5 reference-image files (same
   per-step file, additional dataset for score + registration transform), rather than a new storage
   mechanism.
-- **Diagnostic visualization: own `PreviewSignal` vs. borrowing the camera's `smear_preview`** —
-  see the architecture section above; needs a short prototype of both before committing.
-- **One `SampleVisionMonitor` config per camera pair vs. one instance whose `camera_names` gets
-  reconfigured at call time** — static per-pair config (e.g. `omny_vision_parking`,
-  `omny_vision_samplestage` as two fixed device-config entries) is simpler and matches how OMNY's
-  own two camera pairs are already fixed, not dynamic; leaning toward this unless a concrete need
-  for a dynamic pairing shows up.
+- **`SampleVisionMonitor` composing a `VisionInterface` vs. owning its own signal directly** — see
+  the "open composition question" at the end of the architecture section; needs a short prototype of
+  both before committing.
+- **One `SampleVisionMonitor`/`VisionInterface` config per camera pair vs. one instance whose
+  `camera_names` gets reconfigured at call time** — static per-pair config (e.g.
+  `omny_vision_parking`, `omny_vision_samplestage` as two fixed device-config entries) is simpler
+  and matches how OMNY's own two camera pairs are already fixed, not dynamic; leaning toward this
+  unless a concrete need for a dynamic pairing shows up.
+- **How an operator switches `VisionInterface`'s mode from the GUI.** The existing
+  `smear_preview_toggle` (`x_ray_eye.py:386-873`) is a single on/off switch between two fixed
+  channels; a `VisionInterface` with several selectable modes (raw/grayscale/edges/CLAHE/overlay)
+  needs a small mode picker, not just a toggle — new GUI widget surface, not sketched yet.
+- **Overlay compositing vs. the GUI's own annotations.** `x_ray_eye_align.py`'s alignment GUI
+  already lets the operator click to place points/markers on the live image; a `VisionInterface`
+  "overlay" mode drawing its own graphics (contours, diff highlights) onto the frame it republishes
+  must not visually conflict with or obscure those widget-drawn markers — needs checking against the
+  actual widget code before this mode is built, not assumed compatible.
 
 ## Non-goals for this session
 

From e8baa759e91e75a6e8fa9c967bfbd1f7252cd495 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 13:21:05 +0200
Subject: [PATCH 063/102] docs(omny): spell out CLI-first operator interface
 for the vision layer

Per feedback: the vision device(s) should be operable from the command
line as their own separately-addressable interface, not gated behind
GUI widget work. Notes this falls out of BEC's normal device-RPC model
for free (same mechanism get_last_image() already uses client-side),
and proposes thin omny.ovision_* wrapper methods matching the existing
otransfer_* wrapper convention around dev.omny_samples.*. Downgrades the
GUI mode-picker open question to strictly additive, not a prerequisite.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018Mupip8x7Hean6E3FFvpbj
---
 .../MACHINE_VISION_AUTOCONFIRM_PLAN.md        | 44 +++++++++++++++++--
 1 file changed, 40 insertions(+), 4 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
index 1e624ba8..b73cb7a8 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/MACHINE_VISION_AUTOCONFIRM_PLAN.md
@@ -131,6 +131,12 @@ publishing a transformed view instead of (or alongside) the raw feed.
   in-between interface rather than a camera-specific patch: the GUI dock watches the
   `VisionInterface`'s output, and swapping/reconfiguring the source camera or the active mode
   doesn't change what the dock is looking at.
+- **Command-line addressable from day one, independent of any GUI work.** `set_mode()` and any other
+  controls are plain device RPC methods — like `get_last_image()`, they're callable directly from a
+  BEC session (`dev.omny_vision_parking.set_mode("edges")`) the moment the device exists, with no
+  GUI widget required. The operator-facing question "how does someone switch modes" therefore has an
+  answer on day one regardless of whether/when a GUI mode-picker gets built — see the dedicated CLI
+  section below.
 - **Two independent consumers**, justifying building this generically rather than folding it
   straight into the sample-transfer use case:
   - **`SampleVisionMonitor`** (Layer 2, below) uses it for registration + the diagnostic overlay it
@@ -174,6 +180,34 @@ top of Layers 0/1*, not a separate camera-coupled implementation:
   scoring and any live processed view of that same pair) avoids two devices both owning a signal for
   the same physical camera pair — likely the cleaner shape, but worth prototyping both.
 
+### Operator interface: command line first, a GUI mode-picker second
+
+Per feedback: the tool an operator uses to drive this should not be gated behind new GUI widget
+work — it should be addressable on the command line as its own, separately-callable interface,
+independent of whether/when a GUI control for it exists.
+
+- **This falls out of BEC's normal device-RPC model, not something to build specially.** Every
+  method on a device (`VisionInterface.set_mode()`, `SampleVisionMonitor.save_reference()`/`score()`)
+  is already callable directly from a BEC ipython session the moment the device exists —
+  `dev.omny_vision_parking.set_mode("edges")`, `dev.omny_vision_parking.score("put_mount_start_3")`
+  — the exact same mechanism `get_last_image()` already relies on for its own direct client-side
+  calls in `x_ray_eye_align.py`. No dedicated CLI layer needs to be designed from scratch; it's a
+  free consequence of this being a device.
+- **Thin per-endstation wrapper methods, matching the existing convention.** Raw device names
+  (`omny_vision_parking`, `omny_vision_samplestage`) aren't the ergonomic surface an operator should
+  have to remember. `omny_sample_transfer_mixin.py` already establishes the pattern for exactly this
+  problem — its `otransfer_is_sample_slot_used()`/`otransfer_set_sample_slot()`/etc. block (lines
+  1175-1255) is a set of thin one-line wrappers around `dev.omny_samples.*`, added, per its own
+  comment, "so every sample-storage command tab-completes under `omny.otransfer_*`". The same shape
+  applies here: short `omny.ovision_*` wrappers (e.g. `ovision_set_mode(pair, mode)`,
+  `ovision_score(tag)`, `ovision_save_reference(tag)`) that dispatch to the right
+  `SampleVisionMonitor`/`VisionInterface` instance for the currently-active camera pair (using
+  `_omnycam_active_pair`, already tracked — see "Existing infrastructure" above), so an operator
+  never needs to know the underlying device names at all.
+- **GUI mode-picker (the open question above) becomes strictly additive**, not a prerequisite —
+  the command-line interface is complete and usable the day `VisionInterface`/`SampleVisionMonitor`
+  land, regardless of GUI work landing later or not at all.
+
 ## Proposed CV pipeline (classical, no deep learning)
 
 Per the original discussion this grew out of: classical machine vision is enough for a
@@ -252,10 +286,12 @@ this should not be an all-or-nothing flag flip. Proposed phases for the later im
   `omny_vision_parking`, `omny_vision_samplestage` as two fixed device-config entries) is simpler
   and matches how OMNY's own two camera pairs are already fixed, not dynamic; leaning toward this
   unless a concrete need for a dynamic pairing shows up.
-- **How an operator switches `VisionInterface`'s mode from the GUI.** The existing
-  `smear_preview_toggle` (`x_ray_eye.py:386-873`) is a single on/off switch between two fixed
-  channels; a `VisionInterface` with several selectable modes (raw/grayscale/edges/CLAHE/overlay)
-  needs a small mode picker, not just a toggle — new GUI widget surface, not sketched yet.
+- **A GUI mode-picker for `VisionInterface`** (as opposed to the command-line control, which is
+  covered — see "Operator interface" above). The existing `smear_preview_toggle`
+  (`x_ray_eye.py:386-873`) is a single on/off switch between two fixed channels; a `VisionInterface`
+  with several selectable modes (raw/grayscale/edges/CLAHE/overlay) would need a small mode picker
+  instead, not just a toggle — new GUI widget surface, not sketched yet, and not a blocker for
+  anything else in this plan.
 - **Overlay compositing vs. the GUI's own annotations.** `x_ray_eye_align.py`'s alignment GUI
   already lets the operator click to place points/markers on the live image; a `VisionInterface`
   "overlay" mode drawing its own graphics (contours, diff highlights) onto the frame it republishes

From 144c1eabf02e45af3a14fd95e8b46339553c6b4f Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Sun, 6 Sep 2026 13:41:15 +0200
Subject: [PATCH 064/102] fix(flomni): save a gripper reference image at the
 empty/occupied checks

ftransfer_get_sample()/ftransfer_put_sample() only ever saved a gripper
camera image at the final "All OK?" confirm, never at the earlier
automated "is there a sample in the gripper" check -- so there was no
visual record of the gripper state when that check failed and aborted
the transfer. Extract the existing image-capture logic (used by
ftransfer_confirm) into _ftransfer_capture_gripper_image() and call it
at both gripper-state decision points, before the FlomniError is raised.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QLrD7sVYGLAzsQjLVJpCgt
---
 .../plugins/flomni/flomni.py                  | 19 ++++-
 .../test_flomni_gripper_check_images.py       | 84 +++++++++++++++++++
 2 files changed, 99 insertions(+), 4 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_flomni_gripper_check_images.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 91a603ba..547d5033 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -751,6 +751,7 @@ class FlomniSampleTransferMixin:
         self.check_sensor_connected()
 
         sample_in_gripper = dev.flomni_samples.is_sample_in_gripper()
+        self._ftransfer_capture_gripper_image(file_suffix="get_gripper_empty_check")
         if sample_in_gripper:
             raise FlomniError(
                 "The gripper does carry a sample. Cannot proceed getting another sample."
@@ -812,6 +813,7 @@ class FlomniSampleTransferMixin:
 
         sample_in_gripper = dev.flomni_samples.is_sample_in_gripper()
         # dev.flomni_samples.sample_in_gripper.get()
+        self._ftransfer_capture_gripper_image(file_suffix="put_gripper_occupied_check")
         if not sample_in_gripper:
             raise FlomniError("The gripper does not carry a sample.")
 
@@ -1106,16 +1108,25 @@ class FlomniSampleTransferMixin:
         self.transfer_step += 1
         if self.ftransfer_confirm_dialog("All OK? Continue?", "y"):
             print("OK. continue.")
-            data = self.client.connector.get_last(
-                MessageEndpoints.device_preview("cam_flomni_gripper", "preview")
-            )["data"].data
-            self.save_reference_image(data, file_suffix=f"{step_name}_{self.transfer_step}")
+            self._ftransfer_capture_gripper_image(file_suffix=f"{step_name}_{self.transfer_step}")
             dev.ftransy.controller.socket_put_confirmed("confirm=1")
         else:
             print("Stopping.")
             self.ftransfer_abort()
             raise FlomniError("User abort sample transfer.")
 
+    def _ftransfer_capture_gripper_image(self, file_suffix: str = ""):
+        """Grab the latest gripper-camera preview and write it to disk via
+        save_reference_image(). Used at every gripper state decision point
+        (empty/occupied checks and the "All OK?" motion-loop confirms) so
+        the sample transfer log has a visual record of the gripper at each
+        step, not just the final confirm.
+        """
+        data = self.client.connector.get_last(
+            MessageEndpoints.device_preview("cam_flomni_gripper", "preview")
+        )["data"].data
+        self.save_reference_image(data, file_suffix=file_suffix)
+
     def save_reference_image(self, image: np.ndarray, file_suffix: str = ""):
         suffix = f"_{file_suffix}_" or "_"
         # Save the reference image to a file
diff --git a/tests/tests_bec_ipython_client/test_flomni_gripper_check_images.py b/tests/tests_bec_ipython_client/test_flomni_gripper_check_images.py
new file mode 100644
index 00000000..0cc06730
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_flomni_gripper_check_images.py
@@ -0,0 +1,84 @@
+"""Tests that flomni's gripper-empty/gripper-occupied sample-transfer
+checks capture a gripper camera reference image, not just the final
+"All OK?" confirm (see csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/
+OPEN_ISSUES.md, "flomni has no equivalent gate to save at").
+
+Uses a bare FlomniSampleTransferMixin instance (bypassing Flomni's heavy
+__init__), same pattern as test_lamni_account_change_reset.py.
+"""
+
+import pytest
+
+import csaxs_bec.bec_ipython_client.plugins.flomni.flomni as flomni_module
+from csaxs_bec.bec_ipython_client.plugins.flomni.flomni import (
+    FlomniError,
+    FlomniSampleTransferMixin,
+)
+
+
+class FakeConnector:
+    def __init__(self, image):
+        self.image = image
+        self.requested_endpoints = []
+
+    def get_last(self, endpoint):
+        self.requested_endpoints.append(endpoint)
+        return {"data": type("Msg", (), {"data": self.image})()}
+
+
+class FakeClient:
+    def __init__(self, image="gripper-cam-frame"):
+        self.connector = FakeConnector(image)
+
+
+class FakeFlomniSamples:
+    def __init__(self, sample_in_gripper):
+        self._sample_in_gripper = sample_in_gripper
+
+    def is_sample_in_gripper(self):
+        return self._sample_in_gripper
+
+
+class _FakeDev:
+    def __init__(self, sample_in_gripper):
+        self.flomni_samples = FakeFlomniSamples(sample_in_gripper)
+
+
+def make_flomni(sample_in_gripper):
+    flomni_module.dev = _FakeDev(sample_in_gripper)
+    obj = object.__new__(FlomniSampleTransferMixin)
+    obj.client = FakeClient()
+    obj.check_tray_in = lambda: None
+    obj.check_sensor_connected = lambda: None
+    obj.saved_images = []
+    obj.save_reference_image = lambda image, file_suffix="": obj.saved_images.append(
+        (image, file_suffix)
+    )
+    return obj
+
+
+def test_get_sample_captures_image_before_raising_when_gripper_occupied():
+    flomni = make_flomni(sample_in_gripper=True)
+
+    with pytest.raises(FlomniError, match="does carry a sample"):
+        flomni.ftransfer_get_sample(5)
+
+    assert flomni.saved_images == [("gripper-cam-frame", "get_gripper_empty_check")]
+
+
+def test_put_sample_captures_image_before_raising_when_gripper_empty():
+    flomni = make_flomni(sample_in_gripper=False)
+
+    with pytest.raises(FlomniError, match="does not carry a sample"):
+        flomni.ftransfer_put_sample(5)
+
+    assert flomni.saved_images == [("gripper-cam-frame", "put_gripper_occupied_check")]
+
+
+def test_capture_gripper_image_fetches_preview_and_saves_it():
+    flomni = make_flomni(sample_in_gripper=False)
+
+    flomni._ftransfer_capture_gripper_image(file_suffix="my_suffix")
+
+    assert flomni.saved_images == [("gripper-cam-frame", "my_suffix")]
+    assert flomni.client.connector.requested_endpoints

From cba7c378dc0ff005d8b9106015bcabdb62e8d889 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Sat, 17 Oct 2026 15:19:40 +0200
Subject: [PATCH 065/102] feat(flomni): sample storage on the new flOMNI soft
 IOC (FLOMNI-SAMPLE:<slot>:<field>)

The flOMNI sample storage moves from the XOMNY-SAMPLE_DB_flomni<n>:GET/.DESC
records (name and owner packed into one 40-char DESC via sample_desc_codec,
measurement status in the BEC global var "flomni_measured_samples" keyed by
that packed string) to one record per slot on the flOMNI soft IOC
(flOMNI repo, softioc/ioc_flomni.py):

    FLOMNI-SAMPLE:<slot>:USED / NAME (up to 256 chars) / OWNER /
                         STATUS (none|started|completed) / MEAS_DATE
    <slot> = STAGE (0), T01..T20 (1-20), GRIPPER (100)

No transition (decided by Mirko 2026-10-17).

- FlomniSampleStorage: same public methods (slot 100 = gripper), attribute
  names sample_placed/sample_names/sample_in_gripper[_name] kept; new
  sample_owners/sample_status/sample_meas_date (+ gripper equivalents),
  get_sample_status/meas_date/record, set_sample_measured(slot, status,
  date, owner_if_empty) and transfer_sample(from, to), which moves the whole
  record so the measurement status travels with the sample
- flomni plugin: transfers use transfer_sample(); tomo_scan marks the stage
  sample started/completed on the record; the label offer reads status,
  date and owner from the record; _MeasuredSampleLog and
  sample_get_measured_log_key removed
  Behaviour change: the label's account is the sample owner (was the active
  account at measurement time); set_sample_measured fills an empty owner
  with the active account
- sample storage widget: bulk read incl. owner/status, writes via
  set_sample_slot/unset_sample_slot; no global-var measured log
- webpage generator: name and owner from separate fields
- e2e harness and tomo test updated; nexus writer unchanged (sample name is
  now the plain name)

Tested against the live IOC on mpc2844 (ophyd): long names, transfers slot ->
gripper -> stage with status/date, owner_if_empty, show_all, clear, slot
range check, bulk read() keys.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNtKEk4jAyjebMDQFwRHJQ
---
 .../plugins/flomni/flomni.py                  | 152 ++--------
 .../flomni/flomni_webpage_generator.py        |  20 +-
 .../widgets/sample_storage/sample_storage.py  | 145 +++-------
 .../devices/omny/flomni_sample_storage.py     | 261 ++++++++++++------
 csaxs_bec/devices/sim/sim_sample_storage.py   |   2 +-
 omny_e2e_tests/sim_flomni_harness.py          |  45 +--
 .../test_flomni_tomo_angles.py                |   7 +-
 7 files changed, 293 insertions(+), 339 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 093a1c3e..329a2b41 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -42,7 +42,6 @@ from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.omny_general_tools import
 )
 from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.ptouch_printer import PTouchLabelPrinter
 from csaxs_bec.devices.omny.galil.galil_ophyd import GalilError
-from csaxs_bec.devices.omny.sample_desc_codec import pack_desc, unpack_desc
 
 logger = bec_logger.logger
 
@@ -818,13 +817,11 @@ class FlomniSampleTransferMixin:
         self.ftransfer_controller_disable_mount_mode()
         self.ensure_gripper_up()
 
-        signal_name = getattr(dev.flomni_samples.sample_names, f"sample{position}")
-        name, owner = unpack_desc(signal_name.get())
-        self.flomni_modify_storage_non_interactive(100, 1, name, owner=owner)
-        self.flomni_modify_storage_non_interactive(position, 0, "-")
+        # the whole record (name, owner, measurement status/date) moves to the gripper
+        dev.flomni_samples.transfer_sample(position, 100)
 
     def ftransfer_show_all(self):
-        dev.flomni_samples.show_all(measured=self.measured_log.snapshot())
+        dev.flomni_samples.show_all()
 
     def ftransfer_put_sample(self, position: int):
         self.check_position_is_valid(position)
@@ -877,9 +874,8 @@ class FlomniSampleTransferMixin:
         self.ftransfer_controller_disable_mount_mode()
         self.ensure_gripper_up()
 
-        sample_name, sample_owner = unpack_desc(dev.flomni_samples.sample_in_gripper_name.get())
-        self.flomni_modify_storage_non_interactive(100, 0, "-")
-        self.flomni_modify_storage_non_interactive(position, 1, sample_name, owner=sample_owner)
+        # the whole record (name, owner, measurement status/date) moves from the gripper
+        dev.flomni_samples.transfer_sample(100, position)
 
         if position == 0:
             self.ftransfer_flomni_stage_in()
@@ -889,18 +885,7 @@ class FlomniSampleTransferMixin:
         """
         Get the name of the sample currently in the given position.
         """
-        signal_name = getattr(dev.flomni_samples.sample_names, f"sample{position}")
-        return unpack_desc(signal_name.get())[0]
-
-    def sample_get_measured_log_key(self, position: int = 0) -> str:
-        """Packed `name | owner` identity key for the sample at `position`,
-        for use with `self.measured_log` -- NOT the same as `sample_name`
-        (a `sample_get_name()` alias), which is name-only and would silently
-        under-key the measured log against a different sample of the same
-        name but a different owner.
-        """
-        name, owner = dev.flomni_samples.get_sample_name_and_owner(position)
-        return pack_desc(name, owner)
+        return dev.flomni_samples.get_sample_name(position)
 
     def ftransfer_sample_change(self, new_sample_position: int):
         self.check_tray_in()
@@ -1039,23 +1024,22 @@ class FlomniSampleTransferMixin:
         print offer would incorrectly fire on every ordinary transfer step
         instead of only on a genuine manual clear/replace.
         """
-        if not dev.flomni_samples.is_sample_slot_used(position):
-            return
-        prev_name, prev_owner = dev.flomni_samples.get_sample_name_and_owner(position)
-        prev_packed = pack_desc(prev_name, prev_owner)
-        record = self.measured_log.pop(prev_packed)
-        if record is None:
+        # measurement status/date/owner live on the sample record in the IOC
+        # (FLOMNI-SAMPLE:<slot>:STATUS/MEAS_DATE/OWNER) since 2026-10-17
+        record = dev.flomni_samples.get_sample_record(position)
+        if not record["used"] or record["status"] == "none":
             return
+        prev_name = record["name"]
         if self.OMNYTools.yesno(
             f"Sample '{prev_name}' was measured ({record['status']}) on"
-            f" {record['measured_date']}. Print a label?",
+            f" {record['meas_date']}. Print a label?",
             "y",
         ):
             self.label_printer.ensure_ready()
             printed = self.label_printer.print_label(
                 {
-                    self._PTOUCH_FIELD_ACCOUNT: record["account"],
-                    self._PTOUCH_FIELD_DATE: record["measured_date"],
+                    self._PTOUCH_FIELD_ACCOUNT: record["owner"],
+                    self._PTOUCH_FIELD_DATE: record["meas_date"],
                     self._PTOUCH_FIELD_SAMPLENAME: prev_name,
                 }
             )
@@ -1068,15 +1052,11 @@ class FlomniSampleTransferMixin:
     def flomni_modify_storage_non_interactive(
         self, position: int, used: int, name: str, owner: str = ""
     ):
-        packed_name = pack_desc(name, owner)
-        if position == 100:
-            dev.flomni_samples.sample_in_gripper.set(used).wait(timeout=5)
-            dev.flomni_samples.sample_in_gripper_name.set(packed_name).wait(timeout=5)
+        # position 100 = gripper; a new/renamed sample starts with measurement status "none"
+        if used:
+            dev.flomni_samples.set_sample_slot(position, name, owner=owner)
         else:
-            signal = getattr(dev.flomni_samples.sample_placed, f"sample{position}")
-            signal.set(used).wait(timeout=5)
-            signal_name = getattr(dev.flomni_samples.sample_names, f"sample{position}")
-            signal_name.set(packed_name).wait(timeout=5)
+            dev.flomni_samples.unset_sample_slot(position)
 
     def check_position_is_valid(self, position: int):
         if 0 <= position < 21:
@@ -1710,83 +1690,6 @@ class _ProgressProxy:
         return self._load()
 
 
-class _MeasuredSampleLog:
-    """Tracks which flomni samples have been measured, for the P-touch
-    label-printing feature (print an account/date/name label when a
-    measured sample is cleared or replaced in tray storage).
-
-    Keyed by the packed ``name | owner`` string (see pack_desc/unpack_desc
-    in sample_desc_codec.py) rather than by slot number, since that packed
-    string is the identity that already travels with a sample across
-    ftransfer_get_sample/ftransfer_put_sample transfers between tray
-    slots, the gripper, and the stage -- tracking by slot number would
-    require threading a flag through every one of those transfer calls.
-    Persisted as a BEC global var (same pattern as _ProgressProxy above)
-    so it's visible to any client session -- CLI or GUI widget -- and
-    survives a kernel restart.
-
-    Two statuses: "started" (a fresh tomogram began for this sample) and
-    "completed" (that tomogram's scan loop ran to completion without
-    error). Both count as "measured" for is_measured()/the print offer --
-    "started" without "completed" just means the tomogram may be
-    incomplete, which callers surface in the offer wording rather than
-    suppressing the offer entirely.
-    """
-
-    _GLOBAL_VAR_KEY = "flomni_measured_samples"
-
-    def __init__(self, client):
-        self._client = client
-
-    def _load(self) -> dict:
-        val = self._client.get_global_var(self._GLOBAL_VAR_KEY)
-        return val if val is not None else {}
-
-    def _save(self, data: dict) -> None:
-        self._client.set_global_var(self._GLOBAL_VAR_KEY, data)
-
-    def mark_measured(self, sample_key: str, account: str, date: str, status: str) -> None:
-        """Record `sample_key` as measured, overwriting any existing record.
-
-        Overwriting (rather than merging) means re-measuring a sample from
-        scratch correctly resets a stale "completed" back to "started".
-        """
-        data = self._load()
-        data[sample_key] = {"account": account, "measured_date": date, "status": status}
-        self._save(data)
-
-    def is_measured(self, sample_key: str) -> bool:
-        return sample_key in self._load()
-
-    def get(self, sample_key: str) -> dict | None:
-        return self._load().get(sample_key)
-
-    def snapshot(self) -> dict:
-        """One bulk fetch of the whole log, as a plain dict.
-
-        Used instead of `get` when the caller needs to hand the data to
-        `dev.flomni_samples.show_all()`, which runs via BEC's
-        device-server RPC mechanism -- every argument gets msgpack-
-        serialized, so a bound method (`self.measured_log.get`) can't be
-        passed directly; a plain dict can.
-        """
-        return self._load()
-
-    def pop(self, sample_key: str) -> dict | None:
-        """Remove and return the record for `sample_key`, if any.
-
-        Called once the print offer for that sample has been resolved
-        (printed or declined), so the log stays bounded to
-        currently-measured-but-not-yet-cleared samples instead of growing
-        unbounded over a beamtime.
-        """
-        data = self._load()
-        record = data.pop(sample_key, None)
-        if record is not None:
-            self._save(data)
-        return record
-
-
 class Flomni(
     TomoQueueMixin,
     TomoAngleFileMixin,
@@ -1843,7 +1746,6 @@ class Flomni(
         self.reconstructor = PtychoReconstructor(self.ptycho_reconstruct_foldername)
         self.tomo_id_manager = TomoIDManager()
         self.align = XrayEyeAlign(self.client, self)
-        self.measured_log = _MeasuredSampleLog(self.client)
         self.label_printer = PTouchLabelPrinter(host="BRN94DDF8AAB8EC.psi.ch", template_number=1)
         self.set_client(client)
 
@@ -2842,11 +2744,12 @@ class Flomni(
                 "test additional info",
                 "BEC",
             )
-            self.measured_log.mark_measured(
-                self.sample_get_measured_log_key(0),
-                bec.active_account or "",
+            # measurement status on the sample record (stage slot 0) in the IOC
+            dev.flomni_samples.set_sample_measured(
+                0,
+                "started",
                 datetime.date.today().strftime("%Y-%m"),
-                status="started",
+                owner_if_empty=bec.active_account or "",
             )
             self.write_pdf_report()
             # estimated_remaining_time/estimated_finish_time/accumulated_idle_time/
@@ -3035,11 +2938,12 @@ class Flomni(
         self._print_progress()
         self._log_tomogram_timing()
         self.OMNYTools.printgreenbold("Tomoscan finished")
-        self.measured_log.mark_measured(
-            self.sample_get_measured_log_key(0),
-            bec.active_account or "",
+        # measurement status on the sample record (stage slot 0) in the IOC
+        dev.flomni_samples.set_sample_measured(
+            0,
+            "completed",
             datetime.date.today().strftime("%Y-%m"),
-            status="completed",
+            owner_if_empty=bec.active_account or "",
         )
         timing_lines = self._build_timing_lines()
         for line in timing_lines[3:]:
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_webpage_generator.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_webpage_generator.py
index 7538e26c..105fc6ef 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_webpage_generator.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_webpage_generator.py
@@ -43,7 +43,6 @@ from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.webpage_generator_base imp
     _safe_get,
     _safe_float,
 )
-from csaxs_bec.devices.omny.sample_desc_codec import unpack_desc
 
 
 class FlomniWebpageGenerator(WebpageGeneratorBase):
@@ -106,19 +105,16 @@ class FlomniWebpageGenerator(WebpageGeneratorBase):
         # ── Sample name ───────────────────────────────────────────────
         # slot 0 of flomni_samples is the flOMNI measurement stage itself
         # (see FlomniSampleStorage.show_all()'s own "flOMNI stage:" label
-        # for slot 0 -- not an arbitrary tray position). The raw DESC value
-        # is packed as "name | owner" (sample_desc_codec.pack_desc, added
-        # 7e8e807) -- unpack it here too, the same way
-        # FlomniSampleStorage.get_sample_name_and_owner() and show_all()
-        # already do, so the page doesn't show the raw delimiter-joined
-        # string as the "sample name". Owner is appended in parentheses,
-        # mirroring show_all()'s own "(owner: ...)" formatting.
-        raw_sample = _safe_get(dm, "flomni_samples.sample_names.sample0")
-        if raw_sample is None:
+        # for slot 0 -- not an arbitrary tray position). Name and owner are
+        # separate IOC fields since 2026-10-17 (FLOMNI-SAMPLE:STAGE:NAME /
+        # :OWNER); owner is appended in parentheses, mirroring show_all()'s
+        # own "(owner: ...)" formatting.
+        name = _safe_get(dm, "flomni_samples.sample_names.sample0")
+        if name is None:
             sample_name = "N/A"
         else:
-            name, owner = unpack_desc(raw_sample)
-            sample_name = f"{name} (owner: {owner})" if owner else name
+            owner = _safe_get(dm, "flomni_samples.sample_owners.sample0")
+            sample_name = f"{name} (owner: {owner})" if owner else str(name)
 
         # ── Temperatures ──────────────────────────────────────────────
         temperatures = {
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 9348f07a..64963266 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -29,10 +29,14 @@ single source of truth also consulted by the transfer state machine.  The
 widget reads/writes it directly, mirroring
 ``Flomni.flomni_modify_storage_non_interactive()``:
 
-  slots 0–20 : sample_placed.sample{N}.set(used)
-               sample_names.sample{N}.set(name)
-  gripper    : sample_in_gripper.set(used)
-               sample_in_gripper_name.set(name)
+  writes     : set_sample_slot(N, name, owner) / unset_sample_slot(N)
+               (N = 0–20, 100 = gripper; device methods, all record fields)
+  reads      : one bulk read() of sample_placed / sample_names /
+               sample_owners / sample_status (gripper: sample_in_gripper*)
+
+Since 2026-10-17 every slot is one record on the flOMNI soft IOC
+(FLOMNI-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE); the measurement
+status travels with the sample and is no longer kept in a BEC global var.
 
 Polling
 -------
@@ -69,7 +73,6 @@ from qtpy.QtWidgets import (
 )
 
 from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.ptouch_printer import PTouchLabelPrinter
-from csaxs_bec.devices.omny.sample_desc_codec import pack_desc, unpack_desc
 
 logger = bec_logger.logger
 
@@ -115,54 +118,6 @@ PTOUCH_FIELD_SAMPLENAME = "SAMPLENAME"
 PRINTER_NAME = "WSLA_X12SA"
 
 
-# ── measured-sample log ──────────────────────────────────────────────────────
-
-
-class _MeasuredSampleLog:
-    """Tracks which flomni samples have been measured, for the P-touch
-    label-printing feature.
-
-    Deliberately duplicated here rather than imported from
-    ``flomni.py``'s ``_MeasuredSampleLog`` -- pulling in that whole plugin
-    module (CLI-only dependencies, module-level ``bec``/``dev`` builtins
-    access) into this widget's gui-server process is a heavier and more
-    fragile coupling than re-declaring this ~15-line global-var wrapper,
-    and this widget already duplicates ``flomni_modify_storage_non_interactive()``
-    the same way (see module docstring). Both copies read/write the same
-    ``flomni_measured_samples`` global-var key, so they stay consistent in
-    effect despite being independent code, exactly like the existing
-    ``_write_slot``/``flomni_modify_storage_non_interactive`` duplication.
-    """
-
-    _GLOBAL_VAR_KEY = "flomni_measured_samples"
-
-    def __init__(self, client):
-        self._client = client
-
-    def _load(self) -> dict:
-        val = self._client.get_global_var(self._GLOBAL_VAR_KEY)
-        return val if val is not None else {}
-
-    def _save(self, data: dict) -> None:
-        self._client.set_global_var(self._GLOBAL_VAR_KEY, data)
-
-    def get(self, sample_key: str) -> Optional[dict]:
-        return self._load().get(sample_key)
-
-    def snapshot(self) -> dict:
-        """One bulk fetch of the whole log, for callers (like the poll
-        loop below) that need to look up many sample keys at once without
-        one redis round-trip per key."""
-        return self._load()
-
-    def pop(self, sample_key: str) -> Optional[dict]:
-        data = self._load()
-        record = data.pop(sample_key, None)
-        if record is not None:
-            self._save(data)
-        return record
-
-
 # ── slot cell widget ─────────────────────────────────────────────────────────
 
 
@@ -232,7 +187,7 @@ class _SlotCell(QFrame):
     ) -> None:
         """Update the cell's displayed state (called by the poll/refresh).
 
-        `measured_status` is "started"/"completed" (from `_MeasuredSampleLog`)
+        `measured_status` is "started"/"completed" (FLOMNI-SAMPLE:<slot>:STATUS)
         or None if this slot's current occupant has no measured record.
         """
         self._occupied = occupied
@@ -309,7 +264,6 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         # last-seen (occupied, name, owner, measured_status) per slot, for
         # change-detection in refresh()
         self._last_state: dict[int, tuple[bool, str, str, Optional[str]]] = {}
-        self.measured_log = _MeasuredSampleLog(self.client)
         self.label_printer = PTouchLabelPrinter(
             host=PTOUCH_PRINTER_HOST, template_number=PTOUCH_TEMPLATE_NUMBER
         )
@@ -345,9 +299,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
     def _read_all_slots(self) -> dict[int, tuple[bool, str, str, Optional[str]]]:
         """Return {slot: (occupied, name, owner, measured_status)} for every
         slot 0–20 and the gripper from a SINGLE bulk
-        ``dev.flomni_samples.read()`` round-trip plus a single bulk
-        ``_MeasuredSampleLog.snapshot()`` (one redis round-trip, not one
-        per occupied slot).
+        ``dev.flomni_samples.read()`` round-trip (name, owner and
+        measurement status are separate IOC fields since 2026-10-17).
 
         The per-slot accessors (``is_sample_slot_used`` +
         ``sample_names.sample{N}.get()``) would be ~44 blocking device
@@ -358,8 +311,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         ``flomni_samples_sample_names_sample{N}`` /
         ``flomni_samples_sample_in_gripper`` /
         ``flomni_samples_sample_in_gripper_name``), the same keys the CLI
-        iterated over in ftransfer_sample_change. The raw name signal packs
-        name+owner (see ``sample_desc_codec``), unpacked here.
+        iterated over in ftransfer_sample_change.
 
         Every underlying signal is an ``auto_monitor=True`` ``EpicsSignal``
         (see ``FlomniSampleStorage``), so BEC already keeps a fresh cached
@@ -375,40 +327,31 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             # keep whatever is currently displayed rather than blanking out
             return {}
 
-        try:
-            measured = self.measured_log.snapshot()
-        except Exception as exc:
-            logger.warning(f"OMNY_SampleStorage: measured-log read failed: {exc}")
-            measured = {}
-
         def _val(key, default=None):
             entry = data.get(key)
             if isinstance(entry, dict):
                 return entry.get("value", default)
             return default
 
-        def _measured_status(used: bool, name: str, owner: str) -> Optional[str]:
-            if not used:
-                return None
-            record = measured.get(pack_desc(name, owner))
-            return record["status"] if record else None
+        def _status(used: bool, raw) -> Optional[str]:
+            status = str(raw) if raw is not None else ""
+            return status if used and status in ("started", "completed") else None
 
         for slot in (STAGE_SLOT, *STORAGE_SLOTS):
-            used = _val(f"flomni_samples_sample_placed_sample{slot}", 0)
-            raw_name = _val(f"flomni_samples_sample_names_sample{slot}", EMPTY_NAME)
-            name, owner = unpack_desc(raw_name if raw_name else EMPTY_NAME)
-            name = name if name else EMPTY_NAME
-            result[slot] = (bool(used), name, owner, _measured_status(bool(used), name, owner))
+            used = bool(_val(f"flomni_samples_sample_placed_sample{slot}", 0))
+            name = _val(f"flomni_samples_sample_names_sample{slot}", EMPTY_NAME) or EMPTY_NAME
+            owner = _val(f"flomni_samples_sample_owners_sample{slot}", "") or ""
+            status = _status(used, _val(f"flomni_samples_sample_status_sample{slot}"))
+            result[slot] = (used, str(name), str(owner), status)
 
-        g_used = _val("flomni_samples_sample_in_gripper", 0)
-        g_raw_name = _val("flomni_samples_sample_in_gripper_name", EMPTY_NAME)
-        g_name, g_owner = unpack_desc(g_raw_name if g_raw_name else EMPTY_NAME)
-        g_name = g_name if g_name else EMPTY_NAME
+        g_used = bool(_val("flomni_samples_sample_in_gripper", 0))
+        g_name = _val("flomni_samples_sample_in_gripper_name", EMPTY_NAME) or EMPTY_NAME
+        g_owner = _val("flomni_samples_sample_in_gripper_owner", "") or ""
         result[GRIPPER_SLOT] = (
-            bool(g_used),
-            g_name,
-            g_owner,
-            _measured_status(bool(g_used), g_name, g_owner),
+            g_used,
+            str(g_name),
+            str(g_owner),
+            _status(g_used, _val("flomni_samples_sample_in_gripper_status")),
         )
 
         return result
@@ -425,39 +368,32 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         ``Flomni.flomni_modify_storage_non_interactive()``.
         """
         try:
-            if slot == GRIPPER_SLOT:
-                was_used = bool(self._samples.sample_in_gripper.get())
-                prev_name, prev_owner = unpack_desc(str(self._samples.sample_in_gripper_name.get()))
-            else:
-                was_used = self._samples.is_sample_slot_used(slot)
-                prev_name, prev_owner = self._samples.get_sample_name_and_owner(slot)
+            record = self._samples.get_sample_record(slot)
         except Exception as exc:
             logger.warning(
                 f"OMNY_SampleStorage: could not read previous state of slot {slot} for the"
                 f" measured-label check: {exc}"
             )
             return
-        if not was_used:
-            return
-        record = self.measured_log.pop(pack_desc(prev_name, prev_owner))
-        if record is None:
+        if not record["used"] or record["status"] not in ("started", "completed"):
             return
+        prev_name = record["name"]
         reply = QMessageBox.question(
             self,
             "Print label?",
             f"Sample '{prev_name}' was measured ({record['status']}) on"
-            f" {record['measured_date']}. Print a label?",
+            f" {record['meas_date']}. Print a label?",
             QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
         )
         if reply != QMessageBox.StandardButton.Yes:
             return
         fields = {
-            PTOUCH_FIELD_ACCOUNT: record["account"],
-            PTOUCH_FIELD_DATE: record["measured_date"],
+            PTOUCH_FIELD_ACCOUNT: record["owner"],
+            PTOUCH_FIELD_DATE: record["meas_date"],
             PTOUCH_FIELD_SAMPLENAME: prev_name,
         }
-        # Retry loop instead of a single attempt: the record was already
-        # popped from measured_log above, so if we gave up after one
+        # Retry loop instead of a single attempt: the slot record is
+        # overwritten right after this offer, so if we gave up after one
         # failure the label's account/date/name would be gone for good
         # even though the operator could just switch the printer on and
         # try again a moment later. Mirrors the CLI's ensure_ready() retry
@@ -487,13 +423,12 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         """
         self._offer_print_label_for_previous_occupant(slot)
         try:
-            packed_name = pack_desc(name, owner)
-            if slot == GRIPPER_SLOT:
-                self._samples.sample_in_gripper.set(used)
-                self._samples.sample_in_gripper_name.set(packed_name)
+            # device methods write the whole record (slot 100 = gripper); a new or
+            # renamed sample starts with measurement status "none"
+            if used:
+                self._samples.set_sample_slot(slot, name, owner=owner)
             else:
-                getattr(self._samples.sample_placed, f"sample{slot}").set(used)
-                getattr(self._samples.sample_names, f"sample{slot}").set(packed_name)
+                self._samples.unset_sample_slot(slot)
             # drop the cached state for this slot so the refresh() right after
             # a write always repaints it, without waiting for the value to
             # differ from a possibly-stale cache entry
diff --git a/csaxs_bec/devices/omny/flomni_sample_storage.py b/csaxs_bec/devices/omny/flomni_sample_storage.py
index 3588b261..2ccce0c8 100644
--- a/csaxs_bec/devices/omny/flomni_sample_storage.py
+++ b/csaxs_bec/devices/omny/flomni_sample_storage.py
@@ -1,5 +1,27 @@
+"""flOMNI sample storage on the flOMNI soft IOC (``ioc_flomni.py`` in the flOMNI repo).
+
+One record per slot, all fields autosaved by the IOC::
+
+    FLOMNI-SAMPLE:<slot>:USED       0 = free, 1 = sample present
+    FLOMNI-SAMPLE:<slot>:NAME       sample name (long string, up to 256 chars)
+    FLOMNI-SAMPLE:<slot>:OWNER      e-account of the owner
+    FLOMNI-SAMPLE:<slot>:STATUS     none / started / completed (measurement status)
+    FLOMNI-SAMPLE:<slot>:MEAS_DATE  date of the measurement
+
+    <slot> = STAGE (slot 0, the flOMNI sample stage), T01 ... T20 (tray slots 1-20),
+             GRIPPER (slot 100)
+
+Replaces (2026-10-17) the former ``XOMNY-SAMPLE_DB_flomni<n>:GET`` / ``.DESC`` records,
+where name and owner were packed into one 40-character DESC (``sample_desc_codec``)
+and the measurement status lived in a separate BEC global variable keyed by that
+packed string. The status now travels with the sample: ``transfer_sample()`` moves
+all fields between slots, the gripper and the stage.
+
+An empty string cannot be written to the char-array NAME via Channel Access, so a
+free slot carries the name ``EMPTY_NAME`` ("-").
+"""
+
 import time
-from typing import Optional
 
 from ophyd import Component as Cpt
 from ophyd import Device
@@ -7,13 +29,36 @@ from ophyd import DynamicDeviceComponent as Dcpt
 from ophyd import EpicsSignal
 from prettytable import PrettyTable
 
-from csaxs_bec.devices.omny.sample_desc_codec import pack_desc, unpack_desc
+PV_PREFIX = "FLOMNI-SAMPLE:"
+GRIPPER_SLOT = 100
+STAGE_SLOT = 0
+TRAY_SLOTS = range(1, 21)
+EMPTY_NAME = "-"
+STATUS_NONE = "none"
+STATUS_STARTED = "started"
+STATUS_COMPLETED = "completed"
+STATUS_VALUES = (STATUS_NONE, STATUS_STARTED, STATUS_COMPLETED)
 
 
 class FlomniSampleStorageError(Exception):
     pass
 
 
+def _slot_pv(slot_nr: int) -> str:
+    if slot_nr == STAGE_SLOT:
+        return "STAGE"
+    if slot_nr == GRIPPER_SLOT:
+        return "GRIPPER"
+    return f"T{slot_nr:02d}"
+
+
+def _slot_signals(field: str, **kwargs) -> dict:
+    return {
+        f"sample{i}": (EpicsSignal, f"{PV_PREFIX}{_slot_pv(i)}:{field}", dict(auto_monitor=True, **kwargs))
+        for i in range(21)
+    }
+
+
 class FlomniSampleStorage(Device):
     USER_ACCESS = [
         "is_sample_slot_used",
@@ -25,30 +70,36 @@ class FlomniSampleStorage(Device):
         "get_sample_name",
         "get_sample_owner",
         "get_sample_name_and_owner",
+        "get_sample_status",
+        "get_sample_meas_date",
+        "get_sample_record",
+        "set_sample_measured",
+        "transfer_sample",
         "show_all",
     ]
     SUB_VALUE = "value"
     _default_sub = SUB_VALUE
-    sample_placed = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_flomni{i}:GET", {"auto_monitor": True}) for i in range(21)
-    }
-    sample_placed = Dcpt(sample_placed)
 
-    sample_names = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_flomni{i}:GET.DESC", {"string": True, "auto_monitor": True})
-        for i in range(21)
-    }
-    sample_names = Dcpt(sample_names)
+    # slots 0-20 (0 = flOMNI stage); attribute names kept from the former device
+    sample_placed = Dcpt(_slot_signals("USED"))
+    sample_names = Dcpt(_slot_signals("NAME", string=True))
+    sample_owners = Dcpt(_slot_signals("OWNER", string=True))
+    sample_status = Dcpt(_slot_signals("STATUS", string=True))
+    sample_meas_date = Dcpt(_slot_signals("MEAS_DATE", string=True))
 
-    sample_in_gripper = Cpt(
-        EpicsSignal, name="sample_in_gripper", read_pv="XOMNY-SAMPLE_DB_flomni100:GET", auto_monitor=True
-    )
+    # gripper (slot 100)
+    sample_in_gripper = Cpt(EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:USED", auto_monitor=True)
     sample_in_gripper_name = Cpt(
-        EpicsSignal,
-        name="sample_in_gripper_name",
-        read_pv="XOMNY-SAMPLE_DB_flomni100:GET.DESC",
-        string=True,
-        auto_monitor=True
+        EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:NAME", string=True, auto_monitor=True
+    )
+    sample_in_gripper_owner = Cpt(
+        EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:OWNER", string=True, auto_monitor=True
+    )
+    sample_in_gripper_status = Cpt(
+        EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:STATUS", string=True, auto_monitor=True
+    )
+    sample_in_gripper_meas_date = Cpt(
+        EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:MEAS_DATE", string=True, auto_monitor=True
     )
 
     def __init__(self, prefix="", *, name, **kwargs):
@@ -60,72 +111,132 @@ class FlomniSampleStorage(Device):
         self.wait_for_connection()
         self._run_subs(sub_type=self.SUB_VALUE, timestamp=timestamp, obj=self)
 
-    def set_sample_slot(self, slot_nr: int, name: str, owner: str = "") -> bool:
-        if slot_nr > 20:
-            raise FlomniSampleStorageError(f"Invalid slot number {slot_nr}.")
+    # ── slot addressing ──────────────────────────────────────────────────────
+    @staticmethod
+    def _check_slot(slot_nr: int) -> int:
+        slot_nr = int(slot_nr)
+        if slot_nr == GRIPPER_SLOT or 0 <= slot_nr <= 20:
+            return slot_nr
+        raise FlomniSampleStorageError(
+            f"Invalid slot number {slot_nr} (0 = stage, 1-20 = tray, {GRIPPER_SLOT} = gripper)."
+        )
 
-        getattr(self.sample_placed, f"sample{slot_nr}").set(1).wait(timeout=5)
-        getattr(self.sample_names, f"sample{slot_nr}").set(pack_desc(name, owner)).wait(timeout=5)
+    def _sig(self, field: str, slot_nr: int) -> EpicsSignal:
+        slot_nr = self._check_slot(slot_nr)
+        if slot_nr == GRIPPER_SLOT:
+            return {
+                "used": self.sample_in_gripper,
+                "name": self.sample_in_gripper_name,
+                "owner": self.sample_in_gripper_owner,
+                "status": self.sample_in_gripper_status,
+                "meas_date": self.sample_in_gripper_meas_date,
+            }[field]
+        group = {
+            "used": self.sample_placed,
+            "name": self.sample_names,
+            "owner": self.sample_owners,
+            "status": self.sample_status,
+            "meas_date": self.sample_meas_date,
+        }[field]
+        return getattr(group, f"sample{slot_nr}")
 
-    def unset_sample_slot(self, slot_nr: int) -> bool:
-        if slot_nr > 20:
-            raise FlomniSampleStorageError(f"Invalid slot number {slot_nr}.")
+    @staticmethod
+    def _str(val) -> str:
+        return "" if val is None else str(val)
 
-        getattr(self.sample_placed, f"sample{slot_nr}").set(0).wait(timeout=5)
-        getattr(self.sample_names, f"sample{slot_nr}").set("-").wait(timeout=5)
+    # ── write ────────────────────────────────────────────────────────────────
+    def _write(self, slot_nr: int, used: int, name: str, owner: str, status: str, meas_date: str):
+        if status not in STATUS_VALUES:
+            raise FlomniSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
+        name = name if name else EMPTY_NAME
+        # name/owner/status/date first, USED last: a client watching USED sees a complete record
+        self._sig("name", slot_nr).set(name).wait(timeout=5)
+        self._sig("owner", slot_nr).set(owner or "").wait(timeout=5)
+        self._sig("status", slot_nr).set(status).wait(timeout=5)
+        self._sig("meas_date", slot_nr).set(meas_date or "").wait(timeout=5)
+        self._sig("used", slot_nr).set(int(used)).wait(timeout=5)
 
-    def set_sample_in_gripper(self, name: str, owner: str = "") -> bool:
-        self.sample_in_gripper.set(1).wait(timeout=5)
-        self.sample_in_gripper_name.set(pack_desc(name, owner)).wait(timeout=5)
+    def set_sample_slot(
+        self, slot_nr: int, name: str, owner: str = "", status: str = STATUS_NONE, meas_date: str = ""
+    ):
+        """Place a sample record in slot `slot_nr` (0-20, or 100 = gripper)."""
+        self._write(slot_nr, 1, name, owner, status, meas_date)
 
-    def unset_sample_in_gripper(self) -> bool:
-        self.sample_in_gripper.set(0).wait(timeout=5)
-        self.sample_in_gripper_name.set("-").wait(timeout=5)
+    def unset_sample_slot(self, slot_nr: int):
+        """Clear slot `slot_nr` (0-20, or 100 = gripper)."""
+        self._write(slot_nr, 0, EMPTY_NAME, "", STATUS_NONE, "")
 
+    def set_sample_in_gripper(self, name: str, owner: str = "", status: str = STATUS_NONE, meas_date: str = ""):
+        self.set_sample_slot(GRIPPER_SLOT, name, owner, status, meas_date)
+
+    def unset_sample_in_gripper(self):
+        self.unset_sample_slot(GRIPPER_SLOT)
+
+    def set_sample_measured(self, slot_nr: int, status: str, meas_date: str, owner_if_empty: str = ""):
+        """Record the measurement status/date of the sample in `slot_nr`.
+
+        If the sample has no owner yet, `owner_if_empty` (e.g. the active
+        e-account) is stored as owner -- the label printed when a measured
+        sample is cleared uses the owner as account.
+        """
+        if status not in STATUS_VALUES:
+            raise FlomniSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
+        if owner_if_empty and not self.get_sample_owner(slot_nr):
+            self._sig("owner", slot_nr).set(owner_if_empty).wait(timeout=5)
+        self._sig("status", slot_nr).set(status).wait(timeout=5)
+        self._sig("meas_date", slot_nr).set(meas_date or "").wait(timeout=5)
+
+    def transfer_sample(self, from_slot: int, to_slot: int):
+        """Move the complete record (name, owner, status, date) from one slot to
+        another (0-20, 100 = gripper) and clear the source slot."""
+        rec = self.get_sample_record(from_slot)
+        self.set_sample_slot(to_slot, rec["name"], rec["owner"], rec["status"], rec["meas_date"])
+        self.unset_sample_slot(from_slot)
+
+    # ── read ─────────────────────────────────────────────────────────────────
     def is_sample_slot_used(self, slot_nr: int) -> bool:
-        val = getattr(self.sample_placed, f"sample{slot_nr}").get(use_monitor=False)
-        return bool(val)
+        return bool(self._sig("used", slot_nr).get(use_monitor=False))
 
     def is_sample_in_gripper(self) -> bool:
-        val = self.sample_in_gripper.get(use_monitor=False)
-        return bool(val)
+        return self.is_sample_slot_used(GRIPPER_SLOT)
 
     def get_sample_name(self, slot_nr) -> str:
-        val = getattr(self.sample_names, f"sample{slot_nr}").get()
-        return unpack_desc(str(val))[0]
+        name = self._str(self._sig("name", slot_nr).get())
+        return name if name else EMPTY_NAME
 
     def get_sample_owner(self, slot_nr) -> str:
-        val = getattr(self.sample_names, f"sample{slot_nr}").get()
-        return unpack_desc(str(val))[1]
+        return self._str(self._sig("owner", slot_nr).get())
 
     def get_sample_name_and_owner(self, slot_nr) -> tuple:
-        val = getattr(self.sample_names, f"sample{slot_nr}").get()
-        return unpack_desc(str(val))
+        return (self.get_sample_name(slot_nr), self.get_sample_owner(slot_nr))
 
-    def show_all(self, measured: Optional[dict] = None):
-        """Print the tray grid plus loaded tray/gripper/stage samples.
+    def get_sample_status(self, slot_nr) -> str:
+        status = self._str(self._sig("status", slot_nr).get())
+        return status if status in STATUS_VALUES else STATUS_NONE
 
-        `measured`, if given, is a plain dict (as returned by
-        `_MeasuredSampleLog.snapshot()`) mapping packed
-        `pack_desc(name, owner)` strings to {"status": ..., ...} records --
-        this device class stays decoupled from the BEC-client-backed
-        measured-sample log that produces it; callers (e.g.
-        `Flomni.ftransfer_show_all()`) inject the snapshot instead.
+    def get_sample_meas_date(self, slot_nr) -> str:
+        return self._str(self._sig("meas_date", slot_nr).get())
 
-        Must be a plain, msgpack-serializable dict, not a callable: this
-        method runs via BEC's device-server RPC mechanism, which
-        serializes every argument before sending it, so a bound method
-        (an earlier version of this passed `self.measured_log.get`) fails
-        with "can not serialize 'method' object".
-        """
+    def get_sample_record(self, slot_nr) -> dict:
+        return {
+            "used": self.is_sample_slot_used(slot_nr),
+            "name": self.get_sample_name(slot_nr),
+            "owner": self.get_sample_owner(slot_nr),
+            "status": self.get_sample_status(slot_nr),
+            "meas_date": self.get_sample_meas_date(slot_nr),
+        }
 
-        def _measured_suffix(name: str, owner: str) -> str:
-            if not measured:
-                return ""
-            record = measured.get(pack_desc(name, owner))
-            if record is None:
-                return ""
-            return f"  [measured: {record['status']}]"
+    def show_all(self):
+        """Print the tray grid plus loaded tray/gripper/stage samples."""
+
+        def _suffix(slot_nr: int) -> str:
+            owner = self.get_sample_owner(slot_nr)
+            status = self.get_sample_status(slot_nr)
+            text = f"  (owner: {owner})" if owner else ""
+            if status != STATUS_NONE:
+                date = self.get_sample_meas_date(slot_nr)
+                text += f"  [measured: {status}{', ' + date if date else ''}]"
+            return text
 
         t = PrettyTable()
         t.title = "flOMNI sample storage"
@@ -141,21 +252,15 @@ class FlomniSampleStorage(Device):
             t.add_row(row)
         print(t)
         print("\n\nFollowing samples are currently loaded:\n")
-        for ct in range(1, 21):
+        for ct in TRAY_SLOTS:
             if self.is_sample_slot_used(ct):
-                name, owner = self.get_sample_name_and_owner(ct)
-                owner_suffix = f"  (owner: {owner})" if owner else ""
-                print(f"  Position {ct:2.0f}: {name}{owner_suffix}{_measured_suffix(name, owner)}")
-        if self.sample_in_gripper.get():
-            name, owner = unpack_desc(str(self.sample_in_gripper_name.get()))
-            owner_suffix = f"  (owner: {owner})" if owner else ""
-            print(f"\n  Gripper:        {name}{owner_suffix}{_measured_suffix(name, owner)}\n")
+                print(f"  Position {ct:2.0f}: {self.get_sample_name(ct)}{_suffix(ct)}")
+        if self.is_sample_in_gripper():
+            print(f"\n  Gripper:        {self.get_sample_name(GRIPPER_SLOT)}{_suffix(GRIPPER_SLOT)}\n")
         else:
             print(f"\n  Gripper:        no sample\n")
 
-        if self.is_sample_slot_used(0):
-            name, owner = self.get_sample_name_and_owner(0)
-            owner_suffix = f"  (owner: {owner})" if owner else ""
-            print(f"  flOMNI stage:   {name}{owner_suffix}{_measured_suffix(name, owner)}\n")
+        if self.is_sample_slot_used(STAGE_SLOT):
+            print(f"  flOMNI stage:   {self.get_sample_name(STAGE_SLOT)}{_suffix(STAGE_SLOT)}\n")
         else:
             print(f"  flOMNI stage:   no sample\n")
diff --git a/csaxs_bec/devices/sim/sim_sample_storage.py b/csaxs_bec/devices/sim/sim_sample_storage.py
index 602740e7..f70c11d9 100644
--- a/csaxs_bec/devices/sim/sim_sample_storage.py
+++ b/csaxs_bec/devices/sim/sim_sample_storage.py
@@ -1,7 +1,7 @@
 """
 Simulated flOMNI sample storage.
 
-`FlomniSampleStorage` is purely EPICS-backed (XOMNY-SAMPLE_DB_flomni* PVs). The simulated
+`FlomniSampleStorage` is purely EPICS-backed (FLOMNI-SAMPLE:<slot>:<field> PVs). The simulated
 version follows the patched-device pattern of `simulated_beamline_devices`: the real class
 is instantiated with all PVs replaced by in-memory mock PVs, so `set_sample_slot`,
 `show_all`, the gripper bookkeeping and the sample-transfer scripts run unchanged; the
diff --git a/omny_e2e_tests/sim_flomni_harness.py b/omny_e2e_tests/sim_flomni_harness.py
index 1b8778e4..4e5c543d 100644
--- a/omny_e2e_tests/sim_flomni_harness.py
+++ b/omny_e2e_tests/sim_flomni_harness.py
@@ -417,36 +417,47 @@ def main():  # noqa: C901
         "slot 1 -> gripper bookkeeping",
     )
 
-    # --- 9b. sample owner (packed into the same DESC field as name) ------------------
+    # --- 9b. sample record: name, owner, measurement status (separate IOC fields) ----
     samples.set_sample_slot(2, "owner_test_sample", owner="mholler")
     check(
-        samples.get_sample_name(2) == "owner_test_sample", "get_sample_name returns plain name only"
+        samples.get_sample_name(2) == "owner_test_sample", "get_sample_name returns the name"
     )
-    check(samples.get_sample_owner(2) == "mholler", "get_sample_owner returns the packed owner")
+    check(samples.get_sample_owner(2) == "mholler", "get_sample_owner returns the owner")
     check(
         samples.get_sample_name_and_owner(2) == ("owner_test_sample", "mholler"),
         "get_sample_name_and_owner returns (name, owner)",
     )
+    check(samples.get_sample_status(2) == "none", "a new sample starts with status 'none'")
     samples.unset_sample_slot(2)
     check(
-        str(getattr(samples.sample_names, "sample2").get()) == "-",
-        "unset_sample_slot writes bare '-', not '- | <owner>'",
+        str(getattr(samples.sample_names, "sample2").get()) == "-"
+        and samples.get_sample_owner(2) == "",
+        "unset_sample_slot clears name ('-') and owner",
     )
-    # gripper move (slot -> gripper) must preserve owner, not just name. The
-    # gripper is a separate Cpt (sample_in_gripper_name), not part of the
-    # sample_names slot dict, so unpack it directly rather than via
-    # get_sample_name_and_owner (which only covers slots 0-20).
-    from csaxs_bec.devices.omny.sample_desc_codec import unpack_desc
-
+    # transfer slot -> gripper -> slot must carry the whole record (name, owner,
+    # measurement status and date), slot 100 = gripper
     samples.set_sample_slot(4, "transfer_test_sample", owner="e12345")
-    name, owner = samples.get_sample_name_and_owner(4)
-    samples.set_sample_in_gripper(name, owner=owner)
-    samples.unset_sample_slot(4)
+    samples.set_sample_measured(4, "completed", "2026-10")
+    samples.transfer_sample(4, 100)
     check(
-        unpack_desc(str(samples.sample_in_gripper_name.get())) == ("transfer_test_sample", "e12345"),
-        "owner survives a slot -> gripper move",
+        samples.is_sample_in_gripper()
+        and not samples.is_sample_slot_used(4)
+        and samples.get_sample_name_and_owner(100) == ("transfer_test_sample", "e12345")
+        and samples.get_sample_status(100) == "completed"
+        and samples.get_sample_meas_date(100) == "2026-10",
+        "slot -> gripper move carries name, owner, status and date",
     )
-    samples.unset_sample_in_gripper()
+    samples.transfer_sample(100, 5)
+    check(
+        not samples.is_sample_in_gripper() and samples.get_sample_status(5) == "completed",
+        "gripper -> slot move carries the status",
+    )
+    samples.unset_sample_slot(5)
+    # set_sample_measured fills an empty owner (label printing uses the owner as account)
+    samples.set_sample_slot(6, "no_owner_sample")
+    samples.set_sample_measured(6, "started", "2026-10", owner_if_empty="e99999")
+    check(samples.get_sample_owner(6) == "e99999", "owner_if_empty fills an empty owner")
+    samples.unset_sample_slot(6)
 
     frame_a = ids_cam.cam.get_image_data()
     frame_b = ids_cam.cam.get_image_data()
diff --git a/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py b/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py
index 5385c15d..71e6932c 100644
--- a/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py
@@ -243,8 +243,6 @@ def make_flomni_for_golden_resume(monkeypatch, tomo_type: int) -> Flomni:
     obj.golden_max_number_of_projections = 21
     obj.tomo_id = -1
     obj.sample_get_name = lambda position: "test"  # backs the read-only sample_name property
-    obj.sample_get_measured_log_key = lambda position=0: "test|"
-    obj.measured_log = types.SimpleNamespace(mark_measured=lambda *a, **k: None)
     obj.special_angles = []
     obj._golden = _fake_golden
     obj._golden_equally_spaced = _fake_golden
@@ -270,6 +268,11 @@ def make_flomni_for_golden_resume(monkeypatch, tomo_type: int) -> Flomni:
     )
     monkeypatch.setitem(builtins.__dict__, "bec", fake_bec)
     monkeypatch.setitem(builtins.__dict__, "scans", _FakeScans())
+    # tomo_scan() records the measurement status on the sample record (stage slot 0)
+    fake_dev = types.SimpleNamespace(
+        flomni_samples=types.SimpleNamespace(set_sample_measured=lambda *a, **k: None)
+    )
+    monkeypatch.setitem(builtins.__dict__, "dev", fake_dev)
     return obj
 
 

From 89ba28550c3680f0f0389948d02c060c86c8e86e Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Sun, 18 Oct 2026 19:28:39 +0200
Subject: [PATCH 066/102] OMNY sample storage on the OMNY soft IOC records
 (OMNY-SAMPLE:<slot>:...)

OMNYSampleStorage follows FlomniSampleStorage: one record per slot
(USED/NAME/OWNER/STATUS/MEAS_DATE; slots A1..C6, P10..P101, STAGE, GRIPPER,
PARK1..6), served by OMNY's caproto IOC (OMNY repo preemt_rt,
OMNYtools/softioc/ioc_omny.py). Replaces the XOMNY-SAMPLE_DB_* records and the
status x account VAL packing.

- device: slot_name(), transfer_sample() (whole record moves),
  set_sample_measured(), get_sample_record()/get_sample_meas_date(); the
  (container, slot_nr) API is kept; the 0-20 slot check that rejected 32-34/
  100/101 is gone.
- transfer mixin: picks/puts use transfer_sample(); otransfer_* wrappers for
  the new methods, the account wrappers removed.
- omny.py tomo_scan(): started/completed + month on the STAGE record (as flOMNI).
- sample_storage widget: bulk-read parser and writes on the new records; label
  prints owner as account and the stored date (as flOMNI).
- tomo_params: sample name from sample_names.STAGE.
- SimOMNYSampleStorage, tests, user docs.

Checked against a local ioc_omny.py (real EPICS, localhost): long names,
status enum, transfers, parking.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNtKEk4jAyjebMDQFwRHJQ
---
 .../plugins/omny/AI_docs/OPEN_ISSUES.md       |   6 +
 .../bec_ipython_client/plugins/omny/omny.py   |  16 +
 .../omny/omny_sample_transfer_mixin.py        |  92 +--
 .../widgets/sample_storage/sample_storage.py  | 186 ++---
 .../widgets/tomo_params/tomo_params.py        |   6 +-
 csaxs_bec/devices/omny/omny_sample_storage.py | 738 +++++++-----------
 csaxs_bec/devices/sim/sim_omny.py             |  58 +-
 docs/user/ptychography/omny.md                |   9 +-
 .../test_omny_tomo_angles.py                  |  25 +-
 .../test_omny_tomo_params_widget_math.py      |   6 +-
 .../test_omny_tomo_queue.py                   |   5 +-
 .../test_omny_tomo_scan.py                    |  10 +-
 .../tests_devices/test_omny_sample_storage.py | 111 ++-
 .../test_sim_omny_sample_storage_defaults.py  |   7 +
 14 files changed, 508 insertions(+), 767 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
index ad400426..651527d7 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/OPEN_ISSUES.md
@@ -816,6 +816,12 @@ work above). **Mirko's intent: port the same real-EPICS status+account channel t
 point** -- a separate, dedicated task (its own `.template` record + `FlomniSampleStorage` changes
 + retiring/reconciling `_MeasuredSampleLog`), not bundled into this branch.
 
+**Superseded 2026-10-18 (branch `feat/omny-sample-ioc`):** both instruments now keep one
+soft-IOC record per slot (`FLOMNI-SAMPLE:<slot>:...` since 2026-10-17, `OMNY-SAMPLE:<slot>:USED/
+NAME/OWNER/STATUS/MEAS_DATE` on OMNY's caproto IOC `ioc_omny.py`); the status is an enum plus a
+date, the status x account packing above and `_MeasuredSampleLog` are gone, `transfer_sample()`
+moves the whole record, and `tomo_scan()` sets started/completed on the STAGE record (as flOMNI).
+
 ## Reference images now saved at every manual confirm gate in otransfer_get_sample/put_sample -- flomni has no equivalent gate to save at
 
 `_otransfer_save_reference_images()` used to be called only from inside `_otransfer_confirm()`'s
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index a2664d3b..16b67727 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1365,6 +1365,14 @@ class OMNY(
                 self.write_pdf_report()
             else:
                 self.tomo_id = 0
+            # measurement status on the sample record (sample stage) in the IOC
+            dev.omny_samples.set_sample_measured(
+                "STAGE",
+                0,
+                "started",
+                datetime.date.today().strftime("%Y-%m"),
+                owner_if_empty=bec.active_account or "",
+            )
             self.progress["tomo_start_time"] = datetime.datetime.now().isoformat()
             # reset stale estimates from any previous scan, otherwise the GUI
             # would keep showing a leftover ETA from before this scan has
@@ -1551,6 +1559,14 @@ class OMNY(
         self.progress["subtomo_projection"] = self.progress["subtomo_total_projections"]
         self._print_progress()
         self.OMNYTools.printgreenbold("Tomoscan finished")
+        # measurement status on the sample record (sample stage) in the IOC
+        dev.omny_samples.set_sample_measured(
+            "STAGE",
+            0,
+            "completed",
+            datetime.date.today().strftime("%Y-%m"),
+            owner_if_empty=bec.active_account or "",
+        )
 
         idle_s = self.progress.get("accumulated_idle_time", 0.0)
         start_str = self.progress.get("tomo_start_time")
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 4e6bbdd0..369397e6 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1233,14 +1233,22 @@ class OMNYSampleTransferMixin:
     def otransfer_get_sample_name_and_owner(self, container: str, slot_nr: int) -> tuple:
         return dev.omny_samples.get_sample_name_and_owner(container, slot_nr)
 
-    def otransfer_set_sample_status(self, container: str, slot_nr: int, status: str, account=None) -> bool:
-        return dev.omny_samples.set_sample_status(container, slot_nr, status, account)
+    def otransfer_set_sample_measured(
+        self, container: str, slot_nr: int, status: str, meas_date: str, owner_if_empty: str = ""
+    ):
+        return dev.omny_samples.set_sample_measured(container, slot_nr, status, meas_date, owner_if_empty)
 
     def otransfer_get_sample_status(self, container: str, slot_nr: int) -> str:
         return dev.omny_samples.get_sample_status(container, slot_nr)
 
-    def otransfer_get_sample_account(self, container: str, slot_nr: int):
-        return dev.omny_samples.get_sample_account(container, slot_nr)
+    def otransfer_get_sample_meas_date(self, container: str, slot_nr: int) -> str:
+        return dev.omny_samples.get_sample_meas_date(container, slot_nr)
+
+    def otransfer_get_sample_record(self, container: str, slot_nr: int) -> dict:
+        return dev.omny_samples.get_sample_record(container, slot_nr)
+
+    def otransfer_transfer_sample(self, from_slot, to_slot):
+        return dev.omny_samples.transfer_sample(from_slot, to_slot)
 
     def otransfer_get_sample_owner_in_gripper(self) -> str:
         return dev.omny_samples.get_sample_owner_in_gripper()
@@ -1248,24 +1256,12 @@ class OMNYSampleTransferMixin:
     def otransfer_get_sample_owner_in_samplestage(self) -> str:
         return dev.omny_samples.get_sample_owner_in_samplestage()
 
-    def otransfer_set_sample_status_in_gripper(self, status: str, account=None) -> bool:
-        return dev.omny_samples.set_sample_status_in_gripper(status, account)
-
     def otransfer_get_sample_status_in_gripper(self) -> str:
         return dev.omny_samples.get_sample_status_in_gripper()
 
-    def otransfer_get_sample_account_in_gripper(self):
-        return dev.omny_samples.get_sample_account_in_gripper()
-
-    def otransfer_set_sample_status_in_samplestage(self, status: str, account=None) -> bool:
-        return dev.omny_samples.set_sample_status_in_samplestage(status, account)
-
     def otransfer_get_sample_status_in_samplestage(self) -> str:
         return dev.omny_samples.get_sample_status_in_samplestage()
 
-    def otransfer_get_sample_account_in_samplestage(self):
-        return dev.omny_samples.get_sample_account_in_samplestage()
-
     # def _otransfer_modify_sample(_ocontainer, _oposition, _ostatus, _oname):
     #   #_ocontainer is A, B, C for the pin containers
     #   #it can also be FZP, OSA and omny
@@ -1331,23 +1327,11 @@ class OMNYSampleTransferMixin:
                 # is there a sample available?
                 if dev.omny_samples.is_sample_slot_used(installedshuttle, _osampleposition):
                     if _picked_it == 1:
-                        samplename = dev.omny_samples.get_sample_name(
-                            installedshuttle, _osampleposition
-                        )
-                        owner = dev.omny_samples.get_sample_owner(
-                            installedshuttle, _osampleposition
-                        )
-                        status = dev.omny_samples.get_sample_status(
-                            installedshuttle, _osampleposition
-                        )
-                        account = dev.omny_samples.get_sample_account(
-                            installedshuttle, _osampleposition
-                        )
-                        # remove sample from slot and put to gripper -- owner/status/account
+                        # remove sample from slot and put to gripper -- name/owner/status/date
                         # carry over with it, the same physical sample
-                        dev.omny_samples.unset_sample_slot(installedshuttle, _osampleposition)
-                        dev.omny_samples.set_sample_in_gripper(samplename, owner)
-                        dev.omny_samples.set_sample_status_in_gripper(status, account)
+                        dev.omny_samples.transfer_sample(
+                            (installedshuttle, _osampleposition), "GRIPPER"
+                        )
                     return True
                 else:
                     print("There is no sample availabe at that position.")
@@ -1435,13 +1419,7 @@ class OMNYSampleTransferMixin:
         ):
             if dev.omny_samples.is_sample_slot_used("O", _osampleposition):
                 if _picked_it:
-                    samplename = dev.omny_samples.get_sample_name("O", _osampleposition)
-                    owner = dev.omny_samples.get_sample_owner("O", _osampleposition)
-                    status = dev.omny_samples.get_sample_status("O", _osampleposition)
-                    account = dev.omny_samples.get_sample_account("O", _osampleposition)
-                    dev.omny_samples.unset_sample_slot("O", _osampleposition)
-                    dev.omny_samples.set_sample_in_gripper(samplename, owner)
-                    dev.omny_samples.set_sample_status_in_gripper(status, account)
+                    dev.omny_samples.transfer_sample(("O", _osampleposition), "GRIPPER")
                     # FZP was picked
                     # if (_osampleposition == 10 || _osampleposition == 11 || _osampleposition == 100)
                     #  _otransfer_modify_sample("omny",110,2,samplename)
@@ -1460,13 +1438,7 @@ class OMNYSampleTransferMixin:
         elif _osampleposition == 0:
             if dev.omny_samples.is_sample_in_samplestage():
                 if _picked_it:
-                    samplename = dev.omny_samples.get_sample_name_in_samplestage()
-                    owner = dev.omny_samples.get_sample_owner_in_samplestage()
-                    status = dev.omny_samples.get_sample_status_in_samplestage()
-                    account = dev.omny_samples.get_sample_account_in_samplestage()
-                    dev.omny_samples.unset_sample_in_samplestage()
-                    dev.omny_samples.set_sample_in_gripper(samplename, owner)
-                    dev.omny_samples.set_sample_status_in_gripper(status, account)
+                    dev.omny_samples.transfer_sample("STAGE", "GRIPPER")
                     # FZP was picked
                     # if (_osampleposition == 10 || _osampleposition == 11 || _osampleposition == 100)
                     #  _otransfer_modify_sample("omny",110,2,samplename)
@@ -1538,16 +1510,8 @@ class OMNYSampleTransferMixin:
                 # is there free position available?
                 if not dev.omny_samples.is_sample_slot_used(installedshuttle, _osampleposition):
                     if _put_it:
-                        samplename = dev.omny_samples.get_sample_name_in_gripper()
-                        owner = dev.omny_samples.get_sample_owner_in_gripper()
-                        status = dev.omny_samples.get_sample_status_in_gripper()
-                        account = dev.omny_samples.get_sample_account_in_gripper()
-                        dev.omny_samples.unset_sample_in_gripper()
-                        dev.omny_samples.set_sample_slot(
-                            installedshuttle, _osampleposition, samplename, owner
-                        )
-                        dev.omny_samples.set_sample_status(
-                            installedshuttle, _osampleposition, status, account
+                        dev.omny_samples.transfer_sample(
+                            "GRIPPER", (installedshuttle, _osampleposition)
                         )
                     return True
                 else:
@@ -1636,13 +1600,7 @@ class OMNYSampleTransferMixin:
             # is there a free slot available?
             if not dev.omny_samples.is_sample_slot_used("O", _osampleposition):
                 if _put_it:
-                    samplename = dev.omny_samples.get_sample_name_in_gripper()
-                    owner = dev.omny_samples.get_sample_owner_in_gripper()
-                    status = dev.omny_samples.get_sample_status_in_gripper()
-                    account = dev.omny_samples.get_sample_account_in_gripper()
-                    dev.omny_samples.set_sample_slot("O", _osampleposition, samplename, owner)
-                    dev.omny_samples.set_sample_status("O", _osampleposition, status, account)
-                    dev.omny_samples.unset_sample_in_gripper()
+                    dev.omny_samples.transfer_sample("GRIPPER", ("O", _osampleposition))
                 return True
             else:
                 print("There is no free space at this position.")
@@ -1652,13 +1610,7 @@ class OMNYSampleTransferMixin:
         elif _osampleposition == 0:
             if not dev.omny_samples.is_sample_in_samplestage():
                 if _put_it:
-                    samplename = dev.omny_samples.get_sample_name_in_gripper()
-                    owner = dev.omny_samples.get_sample_owner_in_gripper()
-                    status = dev.omny_samples.get_sample_status_in_gripper()
-                    account = dev.omny_samples.get_sample_account_in_gripper()
-                    dev.omny_samples.set_sample_in_samplestage(samplename, owner)
-                    dev.omny_samples.set_sample_status_in_samplestage(status, account)
-                    dev.omny_samples.unset_sample_in_gripper()
+                    dev.omny_samples.transfer_sample("GRIPPER", "STAGE")
                 return True
             else:
                 print("There is no sample in the sample stage.")
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 90e8517f..99f86b7a 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -9,13 +9,13 @@ different setups, detected at construction time (see ``SETUP_PROFILES``,
 ``_detect_setup()``) — a BEC session is always exactly one setup, never
 both at once:
 
-Both setups require every sample slot to carry a name *and* an owner, but
-via different backend mechanisms:
+Both setups require every sample slot to carry a name *and* an owner; both
+keep one soft-IOC record per slot (USED/NAME/OWNER/STATUS/MEAS_DATE):
 
 FlOMNI (``dev.flomni_samples``)
     A flat magazine: slots 1-20, the sample stage (slot 0) and the gripper
-    (slot 100). Name and owner are packed into one EPICS DESC field (see
-    ``sample_desc_codec``) since this backend has no separate owner PV.
+    (slot 100), FLOMNI-SAMPLE:<slot>:... since 2026-10-17 (before: name and
+    owner packed into one EPICS DESC field, ``sample_desc_codec``).
 
 OMNY (``dev.omny_samples``)
     A richer structure: three shuttles (A/B/C) of 6 slots each, a sparse
@@ -23,11 +23,10 @@ OMNY (``dev.omny_samples``)
     separate sample stage and gripper, and a 6-slot "parking" carousel
     recording which shuttle letter is docked at each physical parking
     position (parking slots are a shuttle-letter assignment, not a sample,
-    so they carry no name/owner/status). Unlike FlOMNI, OMNY has a
-    dedicated owner channel and a measured-status channel (packing status
-    *and* account into one VAL -- see ``OMNY_SampleStorage.STATUS_NONE``)
-    next to each sample slot's existing placed/name channels, so no
-    packing is needed there. Whichever shuttle's parking slot matches the
+    so they carry no name/owner/status). Since 2026-10-18 every OMNY slot is
+    one record on the OMNY soft IOC, like FlOMNI's
+    (OMNY-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE, see
+    ``OMNYSampleStorage``). Whichever shuttle's parking slot matches the
     ``oparkz`` motor's current readback is "active", i.e.
     at the transfer-ready position (see ``oparkz_active_parking_slot()``).
 
@@ -66,9 +65,11 @@ FlOMNI
 Since 2026-10-17 every slot is one record on the flOMNI soft IOC
 (FLOMNI-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE); the measurement
 status travels with the sample and is no longer kept in a BEC global var.
-OMNY, stage/gripper/fixed-O/shuttle slots -- see ``_write_slot_omny()``.
-OMNY, parking      : parking_placed.parking{N}.set(used)
-                     parking_names.parking{N}.set(letter or "none")
+OMNY, stage/gripper/fixed-O/shuttle slots: set_sample_slot(container, N,
+                     name, owner) / unset_sample_slot(container, N) -- see
+                     ``_write_slot_omny()``; the same one-record-per-slot layout
+                     (OMNY-SAMPLE:<slot>:..., 2026-10-18).
+OMNY, parking      : set_shuttle_slot(letter, N) / unset_shuttle_slot(N)
 
 Polling
 -------
@@ -135,14 +136,6 @@ OMNY_PARKING_SLOTS = tuple(range(1, 7))
 # slots (which use EMPTY_NAME = "-"), parking slots are cleared to "none".
 PARKING_EMPTY_SENTINEL = "none"
 
-# Mirrors OMNYSampleStorage.STATUS_NONE, duplicated locally rather than read
-# off the device -- self._samples is the BEC *client-side* device proxy,
-# which only exposes USER_ACCESS methods/signals, not plain class
-# attributes like STATUS_NONE (reaching for self._samples.STATUS_NONE
-# raised "'Device' object has no attribute 'STATUS_NONE'" here, even though
-# it works when testing directly against the real device class).
-OMNY_STATUS_NONE = 0
-
 # colours
 # An occupied slot's name label intentionally has no fixed foreground colour
 # here (see _SlotCell.set_state()) -- it was previously hardcoded to
@@ -337,10 +330,9 @@ class _SlotCell(QFrame):
         """Update the cell's displayed state (called by the poll/refresh).
 
         `measured_status` is "started"/"completed" (FLOMNI-SAMPLE:<slot>:STATUS)
-        or None if this slot's current occupant has no measured record.
-        OMNY cells always pass measured_status=None (no measured-sample log
-        for OMNY -- see module docstring), which the measured label below
-        already renders as blank.
+        (OMNY: OMNY-SAMPLE:<slot>:STATUS) or None if this slot's current
+        occupant has no measured record, which the measured label below
+        renders as blank.
         """
         self._occupied = occupied
         self._name = name if name else EMPTY_NAME
@@ -599,11 +591,11 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         """Parse a dev.omny_samples.read(cached=True) dict into
         {key: (occupied, name, owner, measured_status)} for every
         sample-kind slot -- stage, gripper, the 10 fixed O positions, and
-        the 18 shuttle slots. Owner and measured status each have their own
-        dedicated OMNYSampleStorage signal (added alongside the existing
-        placed/name signals -- see that class's status+account VAL
-        encoding, ``STATUS_NONE``), unlike FlOMNI which packs name+owner
-        into one field via ``sample_desc_codec``.
+        the 18 shuttle slots. One record per slot on the OMNY soft IOC
+        (OMNY-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE, see
+        ``OMNYSampleStorage``); the flat keys are
+        ``omny_samples_sample_<field>_<slot>`` with <slot> the IOC slot name
+        (A1..C6, P10..P101, STAGE, GRIPPER).
         """
 
         def _val(key, default=None):
@@ -612,50 +604,22 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 return entry.get("value", default)
             return default
 
-        def _status_str(raw) -> Optional[str]:
-            # mirrors OMNYSampleStorage._val_to_status(), without a live
-            # device round-trip: this widget only has the bulk-read dict.
-            # VAL packs status+account (see that class's status+account VAL
-            # encoding comment): 0 -> no badge, negative -> "started",
-            # positive -> "completed" (the magnitude is the account, not
-            # needed here -- see _status_account() for that).
-            try:
-                val = int(round(float(raw)))
-            except (TypeError, ValueError):
-                return None
-            if val == 0:
-                return None
-            return "started" if val < 0 else "completed"
+        def _record(slot: str) -> tuple[bool, str, str, Optional[str]]:
+            used = bool(_val(f"omny_samples_sample_used_{slot}", 0))
+            name = _val(f"omny_samples_sample_names_{slot}", EMPTY_NAME) or EMPTY_NAME
+            owner = _val(f"omny_samples_sample_owners_{slot}", "") or ""
+            raw = _val(f"omny_samples_sample_status_{slot}")
+            status = str(raw) if raw is not None else ""
+            return (used, str(name), str(owner), status if used and status in ("started", "completed") else None)
 
         state: dict[tuple, tuple[bool, str, str, Optional[str]]] = {}
-
-        used = bool(_val("omny_samples_sample_in_samplestage", 0))
-        name = _val("omny_samples_sample_in_samplestage_name", EMPTY_NAME) or EMPTY_NAME
-        owner = _val("omny_samples_sample_in_samplestage_owner", "") or ""
-        status = _status_str(_val("omny_samples_sample_in_samplestage_status", 0))
-        state[("stage",)] = (used, name, owner, status)
-
-        used = bool(_val("omny_samples_sample_in_gripper", 0))
-        name = _val("omny_samples_sample_in_gripper_name", EMPTY_NAME) or EMPTY_NAME
-        owner = _val("omny_samples_sample_in_gripper_owner", "") or ""
-        status = _status_str(_val("omny_samples_sample_in_gripper_status", 0))
-        state[("gripper",)] = (used, name, owner, status)
-
+        state[("stage",)] = _record("STAGE")
+        state[("gripper",)] = _record("GRIPPER")
         for n in OMNY_FIXED_POSITIONS:
-            used = bool(_val(f"omny_samples_sample_placed_sample{n}", 0))
-            name = _val(f"omny_samples_sample_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
-            owner = _val(f"omny_samples_sample_owners_sample{n}", "") or ""
-            status = _status_str(_val(f"omny_samples_sample_status_sample{n}", 0))
-            state[("O", n)] = (used, name, owner, status)
-
+            state[("O", n)] = _record(f"P{n}")
         for letter in OMNY_SHUTTLE_LETTERS:
             for n in OMNY_SHUTTLE_SLOTS:
-                used = bool(_val(f"omny_samples_sample_shuttle_{letter}_placed_sample{n}", 0))
-                name = _val(f"omny_samples_sample_shuttle_{letter}_names_sample{n}", EMPTY_NAME) or EMPTY_NAME
-                owner = _val(f"omny_samples_sample_shuttle_{letter}_owners_sample{n}", "") or ""
-                status = _status_str(_val(f"omny_samples_sample_shuttle_{letter}_status_sample{n}", 0))
-                state[("shuttle", letter, n)] = (used, name, owner, status)
-
+                state[("shuttle", letter, n)] = _record(f"{letter}{n}")
         return state
 
     def _parse_parking_assignment_omny(self, data: dict) -> dict[int, str]:
@@ -769,39 +733,35 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         (ACCOUNT/DATE/SAMPLENAME) by assumption, not yet bench-tested
         against a real printer the way FlOMNI's template 1 is.
 
-        OMNY has no FlOMNI-style measured-sample log to pop a record from
-        -- status and account already live directly on the slot itself
-        (see ``OMNYSampleStorage``'s status+account VAL encoding), so this
-        reads them fresh from the device right before the clear, instead.
-        There's also no stored measurement date (OMNY doesn't track one),
-        so the label's DATE field is simply today's date, at print time.
+        Status, owner and measurement date live on the slot record itself
+        (OMNY-SAMPLE:<slot>:..., as FlOMNI), read fresh from the device right
+        before the clear; the owner is printed as account, as on FlOMNI.
         """
         assert key[0] == "shuttle"
         _, letter, n = key
         try:
-            was_used = self._samples.is_sample_slot_used(letter, n)
-            prev_name = self._samples.get_sample_name(letter, n)
-            status = self._samples.get_sample_status(letter, n)
-            account = self._samples.get_sample_account(letter, n)
+            record = self._samples.get_sample_record(letter, n)
         except Exception as exc:
             logger.warning(
                 f"OMNY_SampleStorage: could not read previous state of slot {key} for the"
                 f" measured-label check: {exc}"
             )
             return
-        if not was_used or status == "none":
+        if not record["used"] or record["status"] not in ("started", "completed"):
             return
+        prev_name = record["name"]
         reply = QMessageBox.question(
             self,
             "Print label?",
-            f"Sample '{prev_name}' was measured ({status}), account {account}. Print a label?",
+            f"Sample '{prev_name}' was measured ({record['status']}) on"
+            f" {record['meas_date']}. Print a label?",
             QMessageBox.StandardButton.Yes | QMessageBox.StandardButton.No,
         )
         if reply != QMessageBox.StandardButton.Yes:
             return
         fields = {
-            PTOUCH_FIELD_ACCOUNT: str(account),
-            PTOUCH_FIELD_DATE: datetime.date.today().strftime("%Y-%m-%d"),
+            PTOUCH_FIELD_ACCOUNT: record["owner"],
+            PTOUCH_FIELD_DATE: record["meas_date"],
             PTOUCH_FIELD_SAMPLENAME: prev_name,
         }
         # Retry loop, same reasoning as _offer_print_label_for_previous_occupant():
@@ -852,14 +812,11 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
     def _write_slot_omny(self, key: tuple, used: int, name: str, owner: str = "") -> bool:
         """Write (used, name, owner) to an OMNY sample-kind slot -- stage,
-        gripper, a fixed O position, or a shuttle slot -- mirroring the
-        direct-signal style of ``_write_slot()``. Unlike FlOMNI, OMNY has a
-        dedicated owner signal (added alongside placed/name -- see
-        ``OMNYSampleStorage``), so name and owner are written separately,
-        no packing needed. Measured status is reset to "none" on every
-        write here, mirroring ``OMNYSampleStorage.set_sample_slot()``'s/
-        ``unset_sample_slot()``'s own behavior -- a fresh name (even a
-        rename) or a cleared slot isn't mid-measurement.
+        gripper, a fixed O position, or a shuttle slot -- through the device
+        methods, like ``_write_slot()``. Measured status is reset to "none"
+        on every write here (``OMNYSampleStorage.set_sample_slot()``/
+        ``unset_sample_slot()`` write the whole record) -- a fresh name
+        (even a rename) or a cleared slot isn't mid-measurement.
 
         Offers a P-touch label print for the previous occupant only when
         *clearing* a *shuttle* slot (see
@@ -873,31 +830,20 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if used == 0 and kind == "shuttle":
             self._offer_print_label_for_previous_occupant_omny(key)
         try:
-            status_none = OMNY_STATUS_NONE
             if kind == "stage":
-                self._samples.sample_in_samplestage.set(used)
-                self._samples.sample_in_samplestage_name.set(name)
-                self._samples.sample_in_samplestage_owner.set(owner)
-                self._samples.sample_in_samplestage_status.set(status_none)
+                container, n = "STAGE", 0
             elif kind == "gripper":
-                self._samples.sample_in_gripper.set(used)
-                self._samples.sample_in_gripper_name.set(name)
-                self._samples.sample_in_gripper_owner.set(owner)
-                self._samples.sample_in_gripper_status.set(status_none)
+                container, n = "GRIPPER", 0
             elif kind == "O":
-                _, n = key
-                getattr(self._samples.sample_placed, f"sample{n}").set(used)
-                getattr(self._samples.sample_names, f"sample{n}").set(name)
-                getattr(self._samples.sample_owners, f"sample{n}").set(owner)
-                getattr(self._samples.sample_status, f"sample{n}").set(status_none)
+                container, n = "O", key[1]
             elif kind == "shuttle":
-                _, letter, n = key
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_placed"), f"sample{n}").set(used)
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_names"), f"sample{n}").set(name)
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_owners"), f"sample{n}").set(owner)
-                getattr(getattr(self._samples, f"sample_shuttle_{letter}_status"), f"sample{n}").set(status_none)
+                container, n = key[1], key[2]
             else:
                 raise ValueError(f"unknown OMNY slot key {key!r}")
+            if used:
+                self._samples.set_sample_slot(container, n, name, owner)
+            else:
+                self._samples.unset_sample_slot(container, n)
             self._last_state.pop(key, None)
             return True
         except Exception as exc:
@@ -921,10 +867,10 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         in-progress transfer.
         """
         try:
-            used = 1 if letter else 0
-            value = letter if letter else PARKING_EMPTY_SENTINEL
-            getattr(self._samples.parking_placed, f"parking{slot_nr}").set(used)
-            getattr(self._samples.parking_names, f"parking{slot_nr}").set(value)
+            if letter:
+                self._samples.set_shuttle_slot(letter, slot_nr)
+            else:
+                self._samples.unset_shuttle_slot(slot_nr)
             return True
         except Exception as exc:
             logger.warning(f"OMNY_SampleStorage: write of parking slot {slot_nr} failed: {exc}")
@@ -1146,9 +1092,10 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         """Return the slot key that already holds `name`, if any OTHER
         occupied slot of the active setup currently has this exact name, or
         None. Used by action_change_sample()/action_new_sample() to enforce
-        that sample names are unique -- otherwise the measured-sample log
-        (FlOMNI, keyed by name+owner) and operators reading the storage
-        overview could no longer tell two same-named samples apart.
+        that sample names are unique -- otherwise operators reading the
+        storage overview (and the measurement records, scilog entries and
+        labels keyed by sample name) could no longer tell two same-named
+        samples apart.
 
         Reads from ``self._last_state``, the same poll-refreshed snapshot
         the cells themselves are painted from, rather than issuing a fresh
@@ -1168,7 +1115,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
     def action_change_sample(self, slot, current_name: str, current_owner: str = "") -> None:
         """Replace an occupied slot's sample identity (name + owner), stays
         occupied. Named "change sample" rather than "rename" because
-        _write_sample() resets the slot's measured status/account back to
+        _write_sample() resets the slot's measured status/date back to
         "none" -- appropriate since a new name+owner means a different
         physical sample, not a correction to the existing one's record.
         Shared by both setups (see ``_SlotCell``) -- both require a name and
@@ -1484,9 +1431,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
     def _draw_report_cell(self, pdf, x, y, w, h, slot, entry) -> None:
         """Draw one slot's box, mirroring what ``_SlotCell.set_state()``
         shows on screen: slot caption, name (or "empty"), owner and measured
-        marker. Shared by both setups' report builders -- OMNY entries
-        always carry owner="" and measured_status=None, which render as
-        blank without any OMNY-specific branch here.
+        marker. Shared by both setups' report builders (same entry tuple
+        for both, no setup-specific branch here).
         """
         pdf.rect(x, y, w, h)
         occupied, name, owner, measured_status = entry if entry else (False, EMPTY_NAME, "", None)
diff --git a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
index 7bc355c2..05796e04 100644
--- a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
+++ b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
@@ -3050,7 +3050,7 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         # get_sample_name_in_samplestage device_rpc entries stuck PENDING
         # after an abort left the queue paused, plus a GUI freeze while a
         # scan was running -- the wrapper method itself is just
-        # `return str(self.sample_in_samplestage_name.get())`
+        # the NAME of the STAGE record, OMNY-SAMPLE:STAGE:NAME
         # (omny_sample_storage.py), so reading the signal directly is
         # equivalent and free of both problems. cached=True goes one step
         # further: without it, DeviceBase.get() still issues a live
@@ -3058,9 +3058,7 @@ SETUP_PROFILES: dict[str, dict[str, Any]] = {
         # cached=True reads BEC's already-locally-updated status cache
         # instead, no round-trip at all -- standard advice for GUI/widget
         # code (see e.g. sample_storage.py's oparkz.readback.get(cached=True)).
-        "sample_name_getter": lambda w: w.dev.omny_samples.sample_in_samplestage_name.get(
-            cached=True
-        ),
+        "sample_name_getter": lambda w: w.dev.omny_samples.sample_names.STAGE.get(cached=True),
         "cli_hint_name": "omny",
         # OMNY has three "equally spaced sub-tomograms" flavors (2/4/8
         # sub-tomograms), unlike flomni's/lamni's single always-8 flavor --
diff --git a/csaxs_bec/devices/omny/omny_sample_storage.py b/csaxs_bec/devices/omny/omny_sample_storage.py
index 362fc537..8cf31d0a 100644
--- a/csaxs_bec/devices/omny/omny_sample_storage.py
+++ b/csaxs_bec/devices/omny/omny_sample_storage.py
@@ -1,5 +1,33 @@
+"""OMNY sample storage on the OMNY soft IOC (``OMNYtools/softioc/ioc_omny.py`` in the OMNY repo).
+
+One record per slot, all fields autosaved by the IOC (same layout as flOMNI's
+``FLOMNI-SAMPLE:``, see ``flomni_sample_storage.py``)::
+
+    OMNY-SAMPLE:<slot>:USED       0 = free, 1 = sample present
+    OMNY-SAMPLE:<slot>:NAME       sample name (long string, up to 256 chars)
+    OMNY-SAMPLE:<slot>:OWNER      e-account of the owner
+    OMNY-SAMPLE:<slot>:STATUS     none / started / completed (measurement status)
+    OMNY-SAMPLE:<slot>:MEAS_DATE  date of the measurement
+
+    <slot> (container, slot_nr of this device in brackets):
+      A1..A6, B1..B6, C1..C6   shuttles      ("A".."C", 1-6)
+      P10..P14, P32..P34, P100, P101  fixed positions ("O", 10-14, 32-34, 100, 101)
+      STAGE                    sample stage  (set/unset_sample_in_samplestage)
+      GRIPPER                  gripper       (set/unset_sample_in_gripper)
+      PARK1..PARK6             parking slots: USED + NAME = shuttle letter (set_shuttle_slot)
+      FZP0, OSA0, OSA1         exist in the IOC, not used by the transfer yet
+
+Replaces (2026-10-18) the classic softIoc records ``XOMNY-SAMPLE_DB_<container>:<pos>``
+(VAL = placed, DESC = name) and ``...:<pos>:STATUS`` (VAL = status sign x account,
+DESC = owner). The status is now a plain enum plus a date, as on flOMNI, and travels
+with the sample: ``transfer_sample()`` moves all fields between slots, the gripper and
+the stage.
+
+An empty string cannot be written to the char-array NAME via Channel Access, so a
+free slot carries the name ``EMPTY_NAME`` ("-").
+"""
+
 import time
-from typing import Optional
 
 from ophyd import Component as Cpt
 from ophyd import Device
@@ -7,11 +35,68 @@ from ophyd import DynamicDeviceComponent as Dcpt
 from ophyd import EpicsSignal
 from prettytable import FRAME, PrettyTable
 
+PV_PREFIX = "OMNY-SAMPLE:"
+SHUTTLES = ("A", "B", "C")
+SHUTTLE_SLOTS = range(1, 7)
+FIXED_SLOTS = (10, 11, 12, 13, 14, 32, 33, 34, 100, 101)
+PARKING_SLOTS = range(1, 7)
+STAGE = "STAGE"
+GRIPPER = "GRIPPER"
+EMPTY_NAME = "-"
+NO_SHUTTLE = "none"
+STATUS_NONE = "none"
+STATUS_STARTED = "started"
+STATUS_COMPLETED = "completed"
+STATUS_VALUES = (STATUS_NONE, STATUS_STARTED, STATUS_COMPLETED)
+FIELDS = ("used", "name", "owner", "status", "meas_date")
+
+# every sample slot of the IOC that this device handles, by PV slot name
+SAMPLE_SLOTS = (
+    [f"{s}{i}" for s in SHUTTLES for i in SHUTTLE_SLOTS] + [f"P{n}" for n in FIXED_SLOTS] + [STAGE, GRIPPER]
+)
+
 
 class OMNYSampleStorageError(Exception):
     pass
 
 
+def slot_name(container: str, slot_nr: int = 0) -> str:
+    """("A", 3) -> "A3", ("O", 10) -> "P10"; "STAGE"/"GRIPPER" (and a slot name
+    such as "A3" or "P10") are passed through."""
+    container = str(container)
+    if container.upper() in (STAGE, GRIPPER):
+        return container.upper()
+    if container in SAMPLE_SLOTS:
+        return container
+    slot_nr = int(slot_nr)
+    if container in SHUTTLES and slot_nr in SHUTTLE_SLOTS:
+        return f"{container}{slot_nr}"
+    if container == "O" and slot_nr in FIXED_SLOTS:
+        return f"P{slot_nr}"
+    raise OMNYSampleStorageError(
+        f"Invalid sample slot ({container!r}, {slot_nr}): container A/B/C with slot 1-6, "
+        f"O with {FIXED_SLOTS}, or STAGE/GRIPPER."
+    )
+
+
+def _field_pv(slot: str, field: str) -> str:
+    return f"{PV_PREFIX}{slot}:{field.upper()}"
+
+
+def _sample_signals(field: str) -> dict:
+    kwargs = {"auto_monitor": True}
+    if field != "used":
+        kwargs["string"] = True
+    return {slot: (EpicsSignal, _field_pv(slot, field), dict(kwargs)) for slot in SAMPLE_SLOTS}
+
+
+def _parking_signals(field: str) -> dict:
+    kwargs = {"auto_monitor": True}
+    if field != "used":
+        kwargs["string"] = True
+    return {f"parking{i}": (EpicsSignal, _field_pv(f"PARK{i}", field), dict(kwargs)) for i in PARKING_SLOTS}
+
+
 class OMNYSampleStorage(Device):
     USER_ACCESS = [
         "is_sample_slot_used",
@@ -26,18 +111,16 @@ class OMNYSampleStorage(Device):
         "get_sample_name_in_gripper",
         "get_sample_owner_in_samplestage",
         "get_sample_owner_in_gripper",
-        "set_sample_status_in_samplestage",
         "get_sample_status_in_samplestage",
-        "get_sample_account_in_samplestage",
-        "set_sample_status_in_gripper",
         "get_sample_status_in_gripper",
-        "get_sample_account_in_gripper",
         "get_sample_name",
         "get_sample_owner",
         "get_sample_name_and_owner",
-        "set_sample_status",
         "get_sample_status",
-        "get_sample_account",
+        "get_sample_meas_date",
+        "get_sample_record",
+        "set_sample_measured",
+        "transfer_sample",
         "is_sample_in_samplestage",
         "set_shuttle_slot",
         "unset_shuttle_slot",
@@ -50,482 +133,197 @@ class OMNYSampleStorage(Device):
     SUB_VALUE = "value"
     _default_sub = SUB_VALUE
 
-    # Measured status *and* account, packed into one number -- an "ai"
-    # record's VAL (see omny_samples_status.template in the OMNY/OMNY.git
-    # IOC repo), not a proper EPICS enum: this IOC's sample DB uses plain
-    # "ai" records uniformly even for boolean-ish fields (see the
-    # placed-flag records), so the STATUS record follows the same
-    # convention rather than introducing a new record type used nowhere
-    # else here.
-    #
-    # Encoding: VAL == 0 means "not measured"; otherwise VAL's magnitude is
-    # the 5-digit beamtime account and its sign is the status -- negative
-    # while a measurement is in progress ("started"), positive once it's
-    # done ("completed"). This packs status+account into the one VAL this
-    # IOC's "ai"-record convention already gives us, with no new EPICS
-    # record needed. An account that isn't exactly 5 digits (e.g. a
-    # non-numeric test account) falls back to FALLBACK_ACCOUNT (11111) --
-    # safe because real account numbers are already above 20000, so this
-    # sentinel can never collide with a real one, and only ever shows up
-    # for test accounts.
-    STATUS_NONE = 0
-    FALLBACK_ACCOUNT = 11111
+    # sample slots, attribute = PV slot name (A1 ... C6, P10 ... P101, STAGE, GRIPPER)
+    sample_used = Dcpt(_sample_signals("used"))
+    sample_names = Dcpt(_sample_signals("name"))
+    sample_owners = Dcpt(_sample_signals("owner"))
+    sample_status = Dcpt(_sample_signals("status"))
+    sample_meas_date = Dcpt(_sample_signals("meas_date"))
 
-    sample_shuttle_A_placed = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}", {"auto_monitor": True}) for i in range(1, 7)
-    }
-    sample_shuttle_A_placed = Dcpt(sample_shuttle_A_placed)
-
-    sample_shuttle_B_placed = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_B:{i}", {"auto_monitor": True}) for i in range(1, 7)
-    }
-    sample_shuttle_B_placed = Dcpt(sample_shuttle_B_placed)
-
-    sample_shuttle_C_placed = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_C:{i}", {"auto_monitor": True}) for i in range(1, 7)
-    }
-    sample_shuttle_C_placed = Dcpt(sample_shuttle_C_placed)
-
-    sample_shuttle_C_placed = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_C:{i}", {"auto_monitor": True}) for i in range(1, 7)
-    }
-    sample_shuttle_C_placed = Dcpt(sample_shuttle_C_placed)
-
-    parking_placed = {
-        f"parking{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_parking:{i}", {"auto_monitor": True}) for i in range(1, 7)
-    }
-    parking_placed = Dcpt(parking_placed)
-
-    sample_placed = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_omny:{i}", {"auto_monitor": True})
-        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]
-    }
-    sample_placed = Dcpt(sample_placed)
-
-    sample_shuttle_A_names = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}.DESC", {"string": True, "auto_monitor": True})
-        for i in range(1, 7)
-    }
-    sample_shuttle_A_names = Dcpt(sample_shuttle_A_names)
-
-    sample_shuttle_B_names = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_B:{i}.DESC", {"string": True, "auto_monitor": True})
-        for i in range(1, 7)
-    }
-    sample_shuttle_B_names = Dcpt(sample_shuttle_B_names)
-
-    sample_shuttle_C_names = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_C:{i}.DESC", {"string": True, "auto_monitor": True})
-        for i in range(1, 7)
-    }
-    sample_shuttle_C_names = Dcpt(sample_shuttle_C_names)
-
-    parking_names = {
-        f"parking{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_parking:{i}.DESC", {"string": True, "auto_monitor": True})
-        for i in range(1, 7)
-    }
-    parking_names = Dcpt(parking_names)
-
-    sample_names = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_omny:{i}.DESC", {"string": True, "auto_monitor": True})
-        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]
-    }
-    sample_names = Dcpt(sample_names)
-
-    # Measured status+account (VAL) + owner (DESC) -- one new record per
-    # sample position, added alongside the existing placed/name records
-    # (see the status+account VAL encoding described above and
-    # omny_samples_status.template in OMNY/OMNY.git). Parking slots have no
-    # equivalent -- they hold a shuttle letter, not a sample.
-    sample_shuttle_A_status = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_A:{i}:STATUS", {"auto_monitor": True})
-        for i in range(1, 7)
-    }
-    sample_shuttle_A_status = Dcpt(sample_shuttle_A_status)
-
-    sample_shuttle_B_status = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_B:{i}:STATUS", {"auto_monitor": True})
-        for i in range(1, 7)
-    }
-    sample_shuttle_B_status = Dcpt(sample_shuttle_B_status)
-
-    sample_shuttle_C_status = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_shuttle_C:{i}:STATUS", {"auto_monitor": True})
-        for i in range(1, 7)
-    }
-    sample_shuttle_C_status = Dcpt(sample_shuttle_C_status)
-
-    sample_status = {
-        f"sample{i}": (EpicsSignal, f"XOMNY-SAMPLE_DB_omny:{i}:STATUS", {"auto_monitor": True})
-        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]
-    }
-    sample_status = Dcpt(sample_status)
-
-    sample_shuttle_A_owners = {
-        f"sample{i}": (
-            EpicsSignal,
-            f"XOMNY-SAMPLE_DB_shuttle_A:{i}:STATUS.DESC",
-            {"string": True, "auto_monitor": True},
-        )
-        for i in range(1, 7)
-    }
-    sample_shuttle_A_owners = Dcpt(sample_shuttle_A_owners)
-
-    sample_shuttle_B_owners = {
-        f"sample{i}": (
-            EpicsSignal,
-            f"XOMNY-SAMPLE_DB_shuttle_B:{i}:STATUS.DESC",
-            {"string": True, "auto_monitor": True},
-        )
-        for i in range(1, 7)
-    }
-    sample_shuttle_B_owners = Dcpt(sample_shuttle_B_owners)
-
-    sample_shuttle_C_owners = {
-        f"sample{i}": (
-            EpicsSignal,
-            f"XOMNY-SAMPLE_DB_shuttle_C:{i}:STATUS.DESC",
-            {"string": True, "auto_monitor": True},
-        )
-        for i in range(1, 7)
-    }
-    sample_shuttle_C_owners = Dcpt(sample_shuttle_C_owners)
-
-    sample_owners = {
-        f"sample{i}": (
-            EpicsSignal,
-            f"XOMNY-SAMPLE_DB_omny:{i}:STATUS.DESC",
-            {"string": True, "auto_monitor": True},
-        )
-        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]
-    }
-    sample_owners = Dcpt(sample_owners)
-
-    sample_in_gripper = Cpt(
-        EpicsSignal, name="sample_in_gripper", read_pv="XOMNY-SAMPLE_DB_omny:110.VAL", auto_monitor=True
-    )
-    sample_in_gripper_name = Cpt(
-        EpicsSignal,
-        name="sample_in_gripper_name",
-        read_pv="XOMNY-SAMPLE_DB_omny:110.DESC",
-        string=True,
-        auto_monitor=True
-    )
-
-    sample_in_samplestage = Cpt(
-        EpicsSignal, name="sample_in_samplestage", read_pv="XOMNY-SAMPLE_DB_omny:0.VAL", auto_monitor=True
-    )
-    sample_in_samplestage_name = Cpt(
-        EpicsSignal,
-        name="sample_in_samplestage_name",
-        read_pv="XOMNY-SAMPLE_DB_omny:0.DESC",
-        string=True,
-        auto_monitor=True
-    )
-
-    sample_in_gripper_status = Cpt(
-        EpicsSignal, name="sample_in_gripper_status", read_pv="XOMNY-SAMPLE_DB_omny:110:STATUS", auto_monitor=True
-    )
-    sample_in_gripper_owner = Cpt(
-        EpicsSignal,
-        name="sample_in_gripper_owner",
-        read_pv="XOMNY-SAMPLE_DB_omny:110:STATUS.DESC",
-        string=True,
-        auto_monitor=True,
-    )
-
-    sample_in_samplestage_status = Cpt(
-        EpicsSignal, name="sample_in_samplestage_status", read_pv="XOMNY-SAMPLE_DB_omny:0:STATUS", auto_monitor=True
-    )
-    sample_in_samplestage_owner = Cpt(
-        EpicsSignal,
-        name="sample_in_samplestage_owner",
-        read_pv="XOMNY-SAMPLE_DB_omny:0:STATUS.DESC",
-        string=True,
-        auto_monitor=True,
-    )
+    # parking slots 1-6: which shuttle (letter in NAME) is docked
+    parking_placed = Dcpt(_parking_signals("used"))
+    parking_names = Dcpt(_parking_signals("name"))
 
     def __init__(self, prefix="", *, name, **kwargs):
         super().__init__(prefix, name=name, **kwargs)
-        self.sample_shuttle_A_placed.sample1.subscribe(self._emit_value)
+        self.sample_used.A1.subscribe(self._emit_value)
 
     def _emit_value(self, **kwargs):
         timestamp = kwargs.pop("timestamp", time.time())
         self.wait_for_connection()
         self._run_subs(sub_type=self.SUB_VALUE, timestamp=timestamp, obj=self)
 
-    @classmethod
-    def _normalize_account(cls, account) -> int:
-        """A positive 5-digit account number for the status+account VAL
-        encoding (see the class docstring comment above), or
-        FALLBACK_ACCOUNT if `account` doesn't parse as exactly 5 digits.
+    # ── slot addressing ──────────────────────────────────────────────────────
+    def _sig(self, field: str, slot: str) -> EpicsSignal:
+        group = {
+            "used": self.sample_used,
+            "name": self.sample_names,
+            "owner": self.sample_owners,
+            "status": self.sample_status,
+            "meas_date": self.sample_meas_date,
+        }[field]
+        return getattr(group, slot)
+
+    @staticmethod
+    def _check_parking(slot_nr: int) -> int:
+        slot_nr = int(slot_nr)
+        if slot_nr not in PARKING_SLOTS:
+            raise OMNYSampleStorageError(f"Invalid parking slot {slot_nr} (1-6).")
+        return slot_nr
+
+    @staticmethod
+    def _str(val) -> str:
+        return "" if val is None else str(val)
+
+    # ── write ────────────────────────────────────────────────────────────────
+    def _write(self, slot: str, used: int, name: str, owner: str, status: str, meas_date: str):
+        if status not in STATUS_VALUES:
+            raise OMNYSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
+        name = name if name else EMPTY_NAME
+        # name/owner/status/date first, USED last: a client watching USED sees a complete record
+        self._sig("name", slot).set(name).wait(timeout=5)
+        self._sig("owner", slot).set(owner or "").wait(timeout=5)
+        self._sig("status", slot).set(status).wait(timeout=5)
+        self._sig("meas_date", slot).set(meas_date or "").wait(timeout=5)
+        self._sig("used", slot).set(int(used)).wait(timeout=5)
+
+    def set_sample_slot(
+        self,
+        container: str,
+        slot_nr: int,
+        name: str,
+        owner: str = "",
+        status: str = STATUS_NONE,
+        meas_date: str = "",
+    ):
+        """Place a sample record in (container, slot_nr): A/B/C 1-6, O 10-14/32-34/100/101."""
+        self._write(slot_name(container, slot_nr), 1, name, owner, status, meas_date)
+
+    def unset_sample_slot(self, container: str, slot_nr: int):
+        """Clear (container, slot_nr)."""
+        self._write(slot_name(container, slot_nr), 0, EMPTY_NAME, "", STATUS_NONE, "")
+
+    def set_sample_in_gripper(self, name: str, owner: str = "", status: str = STATUS_NONE, meas_date: str = ""):
+        self.set_sample_slot(GRIPPER, 0, name, owner, status, meas_date)
+
+    def unset_sample_in_gripper(self):
+        self.unset_sample_slot(GRIPPER, 0)
+
+    def set_sample_in_samplestage(
+        self, name: str, owner: str = "", status: str = STATUS_NONE, meas_date: str = ""
+    ):
+        self.set_sample_slot(STAGE, 0, name, owner, status, meas_date)
+
+    def unset_sample_in_samplestage(self):
+        self.unset_sample_slot(STAGE, 0)
+
+    def set_sample_measured(self, container: str, slot_nr: int, status: str, meas_date: str, owner_if_empty: str = ""):
+        """Record the measurement status/date of the sample in (container, slot_nr)
+        (container "STAGE" for the sample stage).
+
+        If the sample has no owner yet, `owner_if_empty` (e.g. the active
+        e-account) is stored as owner -- the label printed when a measured
+        sample is cleared uses the owner as account.
         """
-        digits = "".join(ch for ch in str(account) if ch.isdigit()) if account is not None else ""
-        if len(digits) == 5:
-            val = int(digits)
-            if 10000 <= val <= 99999:
-                return val
-        return cls.FALLBACK_ACCOUNT
+        if status not in STATUS_VALUES:
+            raise OMNYSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
+        slot = slot_name(container, slot_nr)
+        if owner_if_empty and not self._str(self._sig("owner", slot).get()):
+            self._sig("owner", slot).set(owner_if_empty).wait(timeout=5)
+        self._sig("status", slot).set(status).wait(timeout=5)
+        self._sig("meas_date", slot).set(meas_date or "").wait(timeout=5)
 
-    @classmethod
-    def _status_to_val(cls, status: str, account=None) -> int:
-        status = (status or "none").strip().lower()
-        if status == "none":
-            return 0
-        if status not in ("started", "completed"):
-            raise OMNYSampleStorageError(
-                f"Invalid status {status!r}; expected one of ['none', 'started', 'completed']."
-            )
-        acc = cls._normalize_account(account)
-        return -acc if status == "started" else acc
+    def transfer_sample(self, from_slot, to_slot):
+        """Move the complete record (name, owner, status, date) from one slot to
+        another and clear the source. Slots as (container, slot_nr) tuples or slot
+        names: e.g. transfer_sample(("A", 3), "GRIPPER"), transfer_sample("GRIPPER", "STAGE")."""
+        src = slot_name(*from_slot) if isinstance(from_slot, tuple) else slot_name(from_slot)
+        dst = slot_name(*to_slot) if isinstance(to_slot, tuple) else slot_name(to_slot)
+        rec = self.get_sample_record(src)
+        self._write(dst, 1, rec["name"], rec["owner"], rec["status"], rec["meas_date"])
+        self._write(src, 0, EMPTY_NAME, "", STATUS_NONE, "")
 
-    @classmethod
-    def _val_to_status(cls, val) -> str:
-        try:
-            v = int(round(float(val)))
-        except (TypeError, ValueError):
-            return "none"
-        if v == 0:
-            return "none"
-        return "started" if v < 0 else "completed"
+    def set_shuttle_slot(self, container: str, slot_nr: int):
+        """Shuttle `container` (A/B/C) is docked at parking slot `slot_nr` (1-6)."""
+        slot_nr = self._check_parking(slot_nr)
+        getattr(self.parking_names, f"parking{slot_nr}").set(container).wait(timeout=5)
+        getattr(self.parking_placed, f"parking{slot_nr}").set(1).wait(timeout=5)
 
-    @classmethod
-    def _val_to_account(cls, val) -> Optional[int]:
-        try:
-            v = int(round(float(val)))
-        except (TypeError, ValueError):
-            return None
-        return abs(v) if v != 0 else None
+    def unset_shuttle_slot(self, slot_nr: int):
+        slot_nr = self._check_parking(slot_nr)
+        getattr(self.parking_names, f"parking{slot_nr}").set(NO_SHUTTLE).wait(timeout=5)
+        getattr(self.parking_placed, f"parking{slot_nr}").set(0).wait(timeout=5)
 
-    def set_sample_slot(self, container: str, slot_nr: int, name: str, owner: str = "") -> bool:
-        if slot_nr > 20:
-            raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
-
-        status = self._status_to_val("none")
-        if container == "A":
-            getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").set(1)
-            getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").set(name)
-            getattr(self.sample_shuttle_A_owners, f"sample{slot_nr}").set(owner)
-            getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(status)
-        elif container == "B":
-            getattr(self.sample_shuttle_B_placed, f"sample{slot_nr}").set(1)
-            getattr(self.sample_shuttle_B_names, f"sample{slot_nr}").set(name)
-            getattr(self.sample_shuttle_B_owners, f"sample{slot_nr}").set(owner)
-            getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").set(status)
-        elif container == "C":
-            getattr(self.sample_shuttle_C_placed, f"sample{slot_nr}").set(1)
-            getattr(self.sample_shuttle_C_names, f"sample{slot_nr}").set(name)
-            getattr(self.sample_shuttle_C_owners, f"sample{slot_nr}").set(owner)
-            getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").set(status)
-        elif container == "O":
-            getattr(self.sample_placed, f"sample{slot_nr}").set(1)
-            getattr(self.sample_names, f"sample{slot_nr}").set(name)
-            getattr(self.sample_owners, f"sample{slot_nr}").set(owner)
-            getattr(self.sample_status, f"sample{slot_nr}").set(status)
-
-    def unset_sample_slot(self, container: str, slot_nr: int) -> bool:
-        if slot_nr > 20:
-            raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
-
-        status = self._status_to_val("none")
-        if container == "A":
-            getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").set(0)
-            getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").set("-")
-            getattr(self.sample_shuttle_A_owners, f"sample{slot_nr}").set("")
-            getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(status)
-        elif container == "B":
-            getattr(self.sample_shuttle_B_placed, f"sample{slot_nr}").set(0)
-            getattr(self.sample_shuttle_B_names, f"sample{slot_nr}").set("-")
-            getattr(self.sample_shuttle_B_owners, f"sample{slot_nr}").set("")
-            getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").set(status)
-        elif container == "C":
-            getattr(self.sample_shuttle_C_placed, f"sample{slot_nr}").set(0)
-            getattr(self.sample_shuttle_C_names, f"sample{slot_nr}").set("-")
-            getattr(self.sample_shuttle_C_owners, f"sample{slot_nr}").set("")
-            getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").set(status)
-        elif container == "O":
-            getattr(self.sample_placed, f"sample{slot_nr}").set(0)
-            getattr(self.sample_names, f"sample{slot_nr}").set("-")
-            getattr(self.sample_owners, f"sample{slot_nr}").set("")
-            getattr(self.sample_status, f"sample{slot_nr}").set(status)
-
-    def set_sample_status(self, container: str, slot_nr: int, status: str, account=None) -> bool:
-        val = self._status_to_val(status, account)
-        if container == "A":
-            getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").set(val)
-        elif container == "B":
-            getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").set(val)
-        elif container == "C":
-            getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").set(val)
-        elif container == "O":
-            getattr(self.sample_status, f"sample{slot_nr}").set(val)
-
-    def get_sample_status(self, container: str, slot_nr: int) -> str:
-        if container == "A":
-            val = getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").get()
-        elif container == "B":
-            val = getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").get()
-        elif container == "C":
-            val = getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").get()
-        elif container == "O":
-            val = getattr(self.sample_status, f"sample{slot_nr}").get()
-        else:
-            return "none"
-        return self._val_to_status(val)
-
-    def get_sample_account(self, container: str, slot_nr: int) -> Optional[int]:
-        """The account packed into this slot's status VAL (see the
-        status+account encoding described above ``STATUS_NONE``), or None
-        if the slot isn't measured ("none" status).
-        """
-        if container == "A":
-            val = getattr(self.sample_shuttle_A_status, f"sample{slot_nr}").get()
-        elif container == "B":
-            val = getattr(self.sample_shuttle_B_status, f"sample{slot_nr}").get()
-        elif container == "C":
-            val = getattr(self.sample_shuttle_C_status, f"sample{slot_nr}").get()
-        elif container == "O":
-            val = getattr(self.sample_status, f"sample{slot_nr}").get()
-        else:
-            return None
-        return self._val_to_account(val)
-
-    def get_sample_owner(self, container: str, slot_nr: int) -> str:
-        if container == "A":
-            val = getattr(self.sample_shuttle_A_owners, f"sample{slot_nr}").get()
-        elif container == "B":
-            val = getattr(self.sample_shuttle_B_owners, f"sample{slot_nr}").get()
-        elif container == "C":
-            val = getattr(self.sample_shuttle_C_owners, f"sample{slot_nr}").get()
-        elif container == "O":
-            val = getattr(self.sample_owners, f"sample{slot_nr}").get()
-        else:
-            return ""
-        return str(val) if val else ""
-
-    def get_sample_name_and_owner(self, container: str, slot_nr: int) -> tuple:
-        return self.get_sample_name(container, slot_nr), self.get_sample_owner(container, slot_nr)
-
-    def set_shuttle_slot(self, container: str, slot_nr: int) -> bool:
-        if slot_nr > 6:
-            raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
-        getattr(self.parking_placed, f"parking{slot_nr}").set(1)
-        getattr(self.parking_names, f"parking{slot_nr}").set(container)
-
-    def unset_shuttle_slot(self, slot_nr: int) -> bool:
-        if slot_nr > 6:
-            raise OMNYSampleStorageError(f"Invalid slot number {slot_nr}.")
-        getattr(self.parking_placed, f"parking{slot_nr}").set(0)
-        getattr(self.parking_names, f"parking{slot_nr}").set("none")
-
-    def set_sample_in_gripper(self, name: str, owner: str = "") -> bool:
-        self.sample_in_gripper.set(1)
-        self.sample_in_gripper_name.set(name)
-        self.sample_in_gripper_owner.set(owner)
-        self.sample_in_gripper_status.set(self._status_to_val("none"))
-
-    def unset_sample_in_gripper(self) -> bool:
-        self.sample_in_gripper.set(0)
-        self.sample_in_gripper_name.set("-")
-        self.sample_in_gripper_owner.set("")
-        self.sample_in_gripper_status.set(self._status_to_val("none"))
-
-    def set_sample_in_samplestage(self, name: str, owner: str = "") -> bool:
-        self.sample_in_samplestage.set(1)
-        self.sample_in_samplestage_name.set(name)
-        self.sample_in_samplestage_owner.set(owner)
-        self.sample_in_samplestage_status.set(self._status_to_val("none"))
-
-    def unset_sample_in_samplestage(self) -> bool:
-        self.sample_in_samplestage.set(0)
-        self.sample_in_samplestage_name.set("-")
-        self.sample_in_samplestage_owner.set("")
-        self.sample_in_samplestage_status.set(self._status_to_val("none"))
-
-    def get_sample_owner_in_gripper(self) -> str:
-        val = self.sample_in_gripper_owner.get()
-        return str(val) if val else ""
-
-    def get_sample_owner_in_samplestage(self) -> str:
-        val = self.sample_in_samplestage_owner.get()
-        return str(val) if val else ""
-
-    def set_sample_status_in_gripper(self, status: str, account=None) -> bool:
-        self.sample_in_gripper_status.set(self._status_to_val(status, account))
-
-    def get_sample_status_in_gripper(self) -> str:
-        return self._val_to_status(self.sample_in_gripper_status.get())
-
-    def get_sample_account_in_gripper(self) -> Optional[int]:
-        return self._val_to_account(self.sample_in_gripper_status.get())
-
-    def set_sample_status_in_samplestage(self, status: str, account=None) -> bool:
-        self.sample_in_samplestage_status.set(self._status_to_val(status, account))
-
-    def get_sample_status_in_samplestage(self) -> str:
-        return self._val_to_status(self.sample_in_samplestage_status.get())
-
-    def get_sample_account_in_samplestage(self) -> Optional[int]:
-        return self._val_to_account(self.sample_in_samplestage_status.get())
-
-    def is_sample_slot_used(self, container, slot_nr: int) -> bool:
-        if container == "A":
-            val = getattr(self.sample_shuttle_A_placed, f"sample{slot_nr}").get()
-        if container == "B":
-            val = getattr(self.sample_shuttle_B_placed, f"sample{slot_nr}").get()
-        if container == "C":
-            val = getattr(self.sample_shuttle_C_placed, f"sample{slot_nr}").get()
-        elif container == "O":
-            val = getattr(self.sample_placed, f"sample{slot_nr}").get()
-        return bool(val)
-
-    def is_shuttle_slot_used(self, slot_nr: int) -> bool:
-        val = getattr(self.parking_placed, f"parking{slot_nr}").get()
-        return bool(val)
+    # ── read ─────────────────────────────────────────────────────────────────
+    def is_sample_slot_used(self, container: str, slot_nr: int = 0) -> bool:
+        return bool(self._sig("used", slot_name(container, slot_nr)).get())
 
     def is_sample_in_gripper(self) -> bool:
-        val = self.sample_in_gripper.get()
-        return bool(val)
+        return self.is_sample_slot_used(GRIPPER)
 
     def is_sample_in_samplestage(self) -> bool:
-        val = self.sample_in_samplestage.get()
-        return bool(val)
+        return self.is_sample_slot_used(STAGE)
 
-    def get_sample_name(self, container, slot_nr) -> str:
-        if container == "A":
-            val = getattr(self.sample_shuttle_A_names, f"sample{slot_nr}").get()
-        elif container == "B":
-            val = getattr(self.sample_shuttle_B_names, f"sample{slot_nr}").get()
-        elif container == "C":
-            val = getattr(self.sample_shuttle_C_names, f"sample{slot_nr}").get()
-        elif container == "O":
-            val = getattr(self.sample_names, f"sample{slot_nr}").get()
-        else:
-            val = "unknown container"
-        return str(val)
+    def get_sample_name(self, container: str, slot_nr: int = 0) -> str:
+        name = self._str(self._sig("name", slot_name(container, slot_nr)).get())
+        return name if name else EMPTY_NAME
 
-    def get_shuttle_name_slot(self, slot_nr: int) -> str:
-        val = getattr(self.parking_names, f"parking{slot_nr}").get()
-        return str(val)
+    def get_sample_owner(self, container: str, slot_nr: int = 0) -> str:
+        return self._str(self._sig("owner", slot_name(container, slot_nr)).get())
+
+    def get_sample_name_and_owner(self, container: str, slot_nr: int = 0) -> tuple:
+        return self.get_sample_name(container, slot_nr), self.get_sample_owner(container, slot_nr)
+
+    def get_sample_status(self, container: str, slot_nr: int = 0) -> str:
+        status = self._str(self._sig("status", slot_name(container, slot_nr)).get())
+        return status if status in STATUS_VALUES else STATUS_NONE
+
+    def get_sample_meas_date(self, container: str, slot_nr: int = 0) -> str:
+        return self._str(self._sig("meas_date", slot_name(container, slot_nr)).get())
+
+    def get_sample_record(self, container: str, slot_nr: int = 0) -> dict:
+        return {
+            "used": self.is_sample_slot_used(container, slot_nr),
+            "name": self.get_sample_name(container, slot_nr),
+            "owner": self.get_sample_owner(container, slot_nr),
+            "status": self.get_sample_status(container, slot_nr),
+            "meas_date": self.get_sample_meas_date(container, slot_nr),
+        }
 
     def get_sample_name_in_gripper(self) -> str:
-        val = self.sample_in_gripper_name.get()
-        return str(val)
+        return self.get_sample_name(GRIPPER)
 
     def get_sample_name_in_samplestage(self) -> str:
-        val = self.sample_in_samplestage_name.get()
-        return str(val)
+        return self.get_sample_name(STAGE)
+
+    def get_sample_owner_in_gripper(self) -> str:
+        return self.get_sample_owner(GRIPPER)
+
+    def get_sample_owner_in_samplestage(self) -> str:
+        return self.get_sample_owner(STAGE)
+
+    def get_sample_status_in_gripper(self) -> str:
+        return self.get_sample_status(GRIPPER)
+
+    def get_sample_status_in_samplestage(self) -> str:
+        return self.get_sample_status(STAGE)
+
+    def is_shuttle_slot_used(self, slot_nr: int) -> bool:
+        return bool(getattr(self.parking_placed, f"parking{self._check_parking(slot_nr)}").get())
+
+    def get_shuttle_name_slot(self, slot_nr: int) -> str:
+        return self._str(getattr(self.parking_names, f"parking{self._check_parking(slot_nr)}").get())
 
     def search_shuttle_in_slot(self, shuttle: str) -> int:
         returnvalue = 0
-        for i in range(1, 7):
+        for i in PARKING_SLOTS:
             if self.get_shuttle_name_slot(i) == shuttle:
                 returnvalue = i
         return returnvalue
 
-    def _describe_slot(self, container: str, slot_nr: int) -> str:
+    def _describe_slot(self, container: str, slot_nr: int = 0) -> str:
         """Sample name, plus owner/measured-status suffix when occupied --
-        e.g. "sample1 (bob)  ◐ started". Used by show_all() so the
+        e.g. "sample1 (e12345)  ◐ started 2026-10". Used by show_all() so the
         overview surfaces owner+status without changing get_sample_name()'s
         own plain-name contract (still used elsewhere, e.g. transfers)."""
         name = self.get_sample_name(container, slot_nr)
@@ -533,13 +331,12 @@ class OMNYSampleStorage(Device):
             return name
         owner = self.get_sample_owner(container, slot_nr)
         status = self.get_sample_status(container, slot_nr)
+        date = self.get_sample_meas_date(container, slot_nr)
         suffix = f" ({owner})" if owner else ""
-        if status == "started":
-            account = self.get_sample_account(container, slot_nr)
-            suffix += f"  ◐ started (acc {account})"
-        elif status == "completed":
-            account = self.get_sample_account(container, slot_nr)
-            suffix += f"  ✓ completed (acc {account})"
+        if status == STATUS_STARTED:
+            suffix += "  ◐ started" + (f" {date}" if date else "")
+        elif status == STATUS_COMPLETED:
+            suffix += "  ✓ completed" + (f" {date}" if date else "")
         return name + suffix
 
     def show_all(self):
@@ -547,14 +344,13 @@ class OMNYSampleStorage(Device):
         red = "\x1b[91m"
         green = "\x1b[92m"
         white = "\x1b[0m"
-        for ch in ["A", "B", "C"]:
+        for ch in SHUTTLES:
             t.clear()
             shuttle_in_slot = self.search_shuttle_in_slot(ch)
             if shuttle_in_slot > 0:
                 t.title = green + "Shuttle " + ch + " in OMNY slot " + str(shuttle_in_slot) + white
             else:
                 t.title = red + "Shuttle " + ch + white
-            field_names = [""]
             for ax in [1, 3, 5]:
                 row = []
                 row.extend([self._describe_slot(ch, ax)])
@@ -567,28 +363,18 @@ class OMNYSampleStorage(Device):
             print(t)
 
         if self.is_sample_in_samplestage():
-            name = self.get_sample_name_in_samplestage()
-            owner = self.get_sample_owner_in_samplestage()
-            status = self.get_sample_status_in_samplestage()
-            suffix = f" ({owner})" if owner else ""
-            if status == "started":
-                suffix += f"  ◐ started (acc {self.get_sample_account_in_samplestage()})"
-            elif status == "completed":
-                suffix += f"  ✓ completed (acc {self.get_sample_account_in_samplestage()})"
-            print(f"\n\n  Sample stage:   {name}{suffix}")
+            print(f"\n\n  Sample stage:   {self._describe_slot(STAGE)}")
         else:
             print(f"\n\n  Sample stage:   no sample")
 
         if self.is_sample_in_gripper():
-            name = self.get_sample_name_in_gripper()
-            owner = self.get_sample_owner_in_gripper()
-            print(f"\n  Gripper:        {name}" + (f" ({owner})" if owner else "") + "\n")
+            print(f"\n  Gripper:        {self._describe_slot(GRIPPER)}\n")
         else:
             print(f"\n  Gripper:        no sample\n")
 
         t.clear()
         t.title = "Fixed positions in OMNY"
-        for i in [10, 11, 12, 13, 14, 32, 33, 34, 100, 101]:
+        for i in FIXED_SLOTS:
             row = []
             row.extend([f"Position {i:3d}"])
             if self.is_sample_slot_used("O", i):
@@ -608,12 +394,10 @@ class OMNYSampleStorage(Device):
         print(" dev.omny_samples.set_sample_slot('system',position,'name','owner')")
         print("   system can be A, B, C, O")
         print(" dev.omny_samples.get_sample_owner('system',position)")
-        print(" dev.omny_samples.set_sample_status('system',position,'status',account)")
-        print("   status is one of 'none', 'started', 'completed'")
-        print("   account is required for 'started'/'completed' (a 5-digit account number,")
-        print("   falls back to 11111 if not exactly 5 digits)")
-        print(" dev.omny_samples.get_sample_status('system',position)")
-        print(" dev.omny_samples.get_sample_account('system',position)")
+        print(" dev.omny_samples.get_sample_record('system',position)")
+        print(" dev.omny_samples.set_sample_measured('system',position,'status','YYYY-MM')")
+        print("   status is one of 'none', 'started', 'completed'; system 'STAGE' for the sample stage")
+        print(" dev.omny_samples.transfer_sample(('A',3), 'GRIPPER')  (name, owner, status move along)")
         print(" dev.omny_samples.set_sample_in_gripper('name','owner') / unset_sample_in_gripper()")
         print(" dev.omny_samples.set_sample_in_samplestage('name','owner'), unset_sample_in_samplestage()")
         print(" dev.omny_samples.set_shuttle_slot(container, slot_nr) / unset_shuttle_slot(slot_nr)")
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 4f91b56d..458d3f17 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -28,7 +28,11 @@ from ophyd_devices.tests.utils import patched_device
 
 from csaxs_bec.devices.omny.galil.ogalil_ophyd import OMNYGalilMotor
 from csaxs_bec.devices.omny.omny_dewar import OMNYDewar
-from csaxs_bec.devices.omny.omny_sample_storage import OMNYSampleStorage
+from csaxs_bec.devices.omny.omny_sample_storage import (
+    PARKING_SLOTS,
+    SAMPLE_SLOTS,
+    OMNYSampleStorage,
+)
 from csaxs_bec.devices.omny.omny_temperatures import OMNYTemperatures
 from csaxs_bec.devices.omny.rt.rt_omny_ophyd import RtOMNYFlyer, RtOMNYMotor
 from csaxs_bec.devices.sim.sim_galil import SimGalilSocket, SimGalilState, _sim_state_kwargs
@@ -262,53 +266,11 @@ class SimOMNYSampleStorage(OMNYSampleStorage):
             # real backend's own empty sentinels ("-" for sample slots, "none"
             # for parking) -- explicitly unset every slot first, the same way
             # SimFlomniSampleStorage does, so untouched slots read back as
-            # genuinely empty instead of a stray "0" name/shuttle-letter.
-            #
-            # Writes go directly to the Dcpt signals rather than through
-            # unset_sample_slot()/set_sample_slot() -- those reject any
-            # slot_nr > 20 (a pre-existing bug: it's copied from Flomni's
-            # 0-20-only range check, but OMNY's own "O" fixed positions
-            # legitimately include 32-34/100/101), which would raise here
-            # for exactly the positions this needs to clear.
-            # Same clearing for the owner/status signals added alongside
-            # placed/names -- untouched positions should read owner="" and
-            # status="none", not the mock-PV "0" default (an invalid status
-            # string, would fail _status_val_to_str's lookup silently back
-            # to "none" anyway, but owner would show a stray "0").
-            for shuttle_placed, shuttle_names, shuttle_owners, shuttle_status in (
-                (
-                    storage.sample_shuttle_A_placed,
-                    storage.sample_shuttle_A_names,
-                    storage.sample_shuttle_A_owners,
-                    storage.sample_shuttle_A_status,
-                ),
-                (
-                    storage.sample_shuttle_B_placed,
-                    storage.sample_shuttle_B_names,
-                    storage.sample_shuttle_B_owners,
-                    storage.sample_shuttle_B_status,
-                ),
-                (
-                    storage.sample_shuttle_C_placed,
-                    storage.sample_shuttle_C_names,
-                    storage.sample_shuttle_C_owners,
-                    storage.sample_shuttle_C_status,
-                ),
-            ):
-                for slot_nr in shuttle_placed.component_names:
-                    getattr(shuttle_placed, slot_nr).set(0)
-                    getattr(shuttle_names, slot_nr).set("-")
-                    getattr(shuttle_owners, slot_nr).set("")
-                    getattr(shuttle_status, slot_nr).set(OMNYSampleStorage.STATUS_NONE)
-            for slot_nr in storage.sample_placed.component_names:
-                getattr(storage.sample_placed, slot_nr).set(0)
-                getattr(storage.sample_names, slot_nr).set("-")
-                getattr(storage.sample_owners, slot_nr).set("")
-                getattr(storage.sample_status, slot_nr).set(OMNYSampleStorage.STATUS_NONE)
-            for slot_nr in storage.parking_placed.component_names:
-                getattr(storage.parking_placed, slot_nr).set(0)
-                getattr(storage.parking_names, slot_nr).set("none")
-            storage.unset_sample_in_gripper()
+            # genuinely empty (owner "", status "none") instead of a stray "0".
+            for slot in SAMPLE_SLOTS:
+                storage.unset_sample_slot(slot, 0)
+            for slot_nr in PARKING_SLOTS:
+                storage.unset_shuttle_slot(slot_nr)
             storage.set_sample_in_samplestage("sim_stage_sample")
             for slot_nr, name in samples.items():
                 storage.set_sample_slot("A", int(slot_nr), str(name))
diff --git a/docs/user/ptychography/omny.md b/docs/user/ptychography/omny.md
index 95ac8743..dcb17b4a 100644
--- a/docs/user/ptychography/omny.md
+++ b/docs/user/ptychography/omny.md
@@ -89,7 +89,7 @@ Day to day, sample storage is viewed and adjusted through the __OMNY Sample Stor
 The widget shows every position (shuttle pins A/B/C, fixed "O" positions, the gripper, and the sample stage) with its occupied state, sample name, owner, and measured status (unmeasured / ◐ started / ✓ completed). The parking-carousel view also shows which shuttle is in which parking slot and marks the currently __ACTIVE__ one (oparkz is physically sitting there, ready for transfer).
 
 Right-click a slot for:
-- __Change sample…__ — set a new name and owner for an occupied slot (replaces the sample record, including resetting its measured status back to unmeasured — use this when a physically different sample is now there, not to correct a typo in the current one's account).
+- __Change sample…__ — set a new name and owner for an occupied slot (replaces the sample record, including resetting its measured status back to unmeasured — use this when a physically different sample is now there, not to correct a typo in the current one's record).
 - __Clear (set empty)__ — mark a slot empty after physically removing the sample. Only offered for shuttle slots, since only samples in a shuttle can leave vacuum: this also offers to print a P-touch label for the sample that was just removed.
 - __New sample…__ — occupy an empty slot with a name and owner.
 - __Set parking slot…__ / __Clear parking assignment__ (shuttle labels) — record which parking slot a shuttle occupies; a slot already held by a different shuttle is rejected, clear it there first.
@@ -145,10 +145,11 @@ The shuttles are mounted in the parking station. Typically oparkz slot 3 is used
 `dev.omny_samples.set_shuttle_slot(container, slot_nr)`  
 Here is an _example_: dev.omny_samples.set_shuttle_slot('A',2)
 
-Measured status/account (normally set automatically during a tomographic scan) can be read and, if really needed, corrected manually via the `omny.otransfer_*` wrappers, e.g.:  
+Measured status and date (set automatically when a tomographic scan starts and finishes: "started"/"completed" with the month) travel with the sample on every transfer. They can be read and, if really needed, corrected manually:  
+`dev.omny_samples.get_sample_record('system', position)` returns used/name/owner/status/meas_date (`'STAGE'`/`'GRIPPER'` as system for the sample stage and the gripper)  
+`dev.omny_samples.set_sample_measured('system', position, status, 'YYYY-MM')` (`status` is one of `"none"`/`"started"`/`"completed"`; also as `omny.otransfer_set_sample_measured`)  
 `omny.otransfer_get_sample_status('system', position)` / `otransfer_get_sample_status_in_gripper()` / `otransfer_get_sample_status_in_samplestage()`  
-`omny.otransfer_set_sample_status('system', position, status, account)` (`status` is one of `"none"`/`"started"`/`"completed"`) and the matching `_in_gripper`/`_in_samplestage` variants  
-`omny.otransfer_get_sample_account(...)` and its `_in_gripper`/`_in_samplestage` variants read back the account tied to a "started"/"completed" status.
+Each position is one record on the OMNY soft IOC, `OMNY-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE` (slots `A1`…`C6`, `P10`…`P101`, `STAGE`, `GRIPPER`, `PARK1`…`PARK6`).
 
 ### Status of OMNY
 
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
index a3e1a411..d295853e 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_angles.py
@@ -301,7 +301,10 @@ def test_tomo_parameters_forces_type_1_for_non_superuser(monkeypatch, fake_bec):
     omny.tomo_angle_stepsize = 10.0
     omny.tomo_type = 1
     fake_dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
     monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
     omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
@@ -335,7 +338,10 @@ def test_tomo_parameters_allows_superuser_to_unlock_8_subtomo_mode(monkeypatch,
     omny.tomo_angle_stepsize = 10.0
     omny.tomo_type = 1
     fake_dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
     monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
     omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
@@ -371,7 +377,10 @@ def test_tomo_parameters_clamps_type_3_step_size_to_max_2_5_degrees(monkeypatch,
     omny.tomo_angle_stepsize = 10.0
     omny.tomo_type = 1
     fake_dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
     monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
     omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
@@ -413,7 +422,10 @@ def test_tomo_parameters_warns_when_fermat_positions_below_minimum(monkeypatch,
     omny.tomo_angle_stepsize = 10.0
     omny.tomo_type = 1
     fake_dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
     monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
     omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: True)  # accept as-is, no edits
@@ -440,7 +452,10 @@ def test_tomo_parameters_no_warning_when_fermat_positions_sufficient(monkeypatch
     omny.tomo_angle_stepsize = 10.0
     omny.tomo_type = 1
     fake_dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
     monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
     omny.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: True)
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
index f5b2796e..e6cd8a25 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
@@ -9,6 +9,8 @@ grid: OMNY has three "equally spaced sub-tomograms" flavors (tomo_type
 N*n_subtomos total, where n_subtomos = {1: 2, 4: 4, 5: 8}[tomo_type].
 """
 
+import types
+
 import pytest
 
 from csaxs_bec.bec_ipython_client.plugins.omny.omny import OMNY
@@ -245,7 +247,7 @@ def test_omny_sample_name_getter_reads_signal_not_rpc_method():
 
     class _FakeOmnySamples:
         def __init__(self):
-            self.sample_in_samplestage_name = _FakeSignal("my_sample")
+            self.sample_names = types.SimpleNamespace(STAGE=_FakeSignal("my_sample"))
 
         def get_sample_name_in_samplestage(self):
             raise AssertionError(
@@ -259,7 +261,7 @@ def test_omny_sample_name_getter_reads_signal_not_rpc_method():
     class _FakeWidget:
         dev = _FakeDev()
 
-    signal = _FakeDev.omny_samples.sample_in_samplestage_name
+    signal = _FakeDev.omny_samples.sample_names.STAGE
     result = SETUP_PROFILES["omny"]["sample_name_getter"](_FakeWidget())
 
     assert result == "my_sample"
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
index 736a54b2..11284244 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
@@ -45,7 +45,10 @@ def make_omny(fake_client=None):
     # real BEC session only) -- stand in a fake so tomo_queue_execute()'s
     # confirmation prompt (which reads self.sample_name) doesn't NameError.
     omny_module.dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
 
     obj = object.__new__(OMNY)
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 4be38cca..15213c57 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -57,7 +57,10 @@ def make_omny_for_tomo_scan(monkeypatch, tomo_angle_stepsize: float, active_acco
     # real BEC session only) -- stand in a fake so tomo_scan()'s sample-
     # database registration (which reads self.sample_name) doesn't NameError.
     omny_module.dev = types.SimpleNamespace(
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample")
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        )
     )
 
     obj = object.__new__(OMNY)
@@ -525,7 +528,10 @@ def test_write_tomo_scan_number_creates_missing_directory(monkeypatch, tmp_path)
     omny.tomo_id = 1
     fake_dev = types.SimpleNamespace(
         osamroy=types.SimpleNamespace(read=lambda: {"osamroy": {"value": 12.5}}),
-        omny_samples=types.SimpleNamespace(get_sample_name_in_samplestage=lambda: "test_sample"),
+        omny_samples=types.SimpleNamespace(
+            get_sample_name_in_samplestage=lambda: "test_sample",
+            set_sample_measured=lambda *a, **k: None,
+        ),
     )
     monkeypatch.setattr(omny_module, "dev", fake_dev, raising=False)
 
diff --git a/tests/tests_devices/test_omny_sample_storage.py b/tests/tests_devices/test_omny_sample_storage.py
index 71a730e2..1b3ec4c9 100644
--- a/tests/tests_devices/test_omny_sample_storage.py
+++ b/tests/tests_devices/test_omny_sample_storage.py
@@ -1,47 +1,90 @@
+"""OMNYSampleStorage on the OMNY soft IOC records (OMNY-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE)."""
+
 import pytest
 
-from csaxs_bec.devices.omny.omny_sample_storage import OMNYSampleStorage, OMNYSampleStorageError
+from csaxs_bec.devices.omny.omny_sample_storage import (
+    SAMPLE_SLOTS,
+    OMNYSampleStorage,
+    OMNYSampleStorageError,
+    slot_name,
+)
+from csaxs_bec.devices.sim.sim_omny import SimOMNYSampleStorage
 
 
-def test_status_none_encodes_to_zero():
-    assert OMNYSampleStorage._status_to_val("none") == 0
-    assert OMNYSampleStorage._val_to_status(0) == "none"
-    assert OMNYSampleStorage._val_to_account(0) is None
+@pytest.fixture
+def storage():
+    dev = SimOMNYSampleStorage(name="omny_samples", sim_samples={})
+    try:
+        yield dev
+    finally:
+        dev.destroy()
 
 
-@pytest.mark.parametrize("account", [20123, "20123", "e20123"])
-def test_started_encodes_negative_account(account):
-    val = OMNYSampleStorage._status_to_val("started", account)
-    assert val == -20123
-    assert OMNYSampleStorage._val_to_status(val) == "started"
-    assert OMNYSampleStorage._val_to_account(val) == 20123
+@pytest.mark.parametrize(
+    "container, slot_nr, expected",
+    [("A", 1, "A1"), ("C", 6, "C6"), ("O", 10, "P10"), ("O", 101, "P101"), ("STAGE", 0, "STAGE"),
+     ("gripper", 0, "GRIPPER"), ("B4", 0, "B4"), ("P32", 0, "P32")],
+)
+def test_slot_name(container, slot_nr, expected):
+    assert slot_name(container, slot_nr) == expected
 
 
-@pytest.mark.parametrize("account", [20123, "20123", "e20123"])
-def test_completed_encodes_positive_account(account):
-    val = OMNYSampleStorage._status_to_val("completed", account)
-    assert val == 20123
-    assert OMNYSampleStorage._val_to_status(val) == "completed"
-    assert OMNYSampleStorage._val_to_account(val) == 20123
-
-
-@pytest.mark.parametrize("bad_account", [None, "", "not-a-number", "123", "123456", "e-test"])
-def test_unparseable_account_falls_back_to_sentinel(bad_account):
-    val = OMNYSampleStorage._status_to_val("started", bad_account)
-    assert OMNYSampleStorage._val_to_account(val) == OMNYSampleStorage.FALLBACK_ACCOUNT
-    assert OMNYSampleStorage.FALLBACK_ACCOUNT == 11111
-
-
-def test_invalid_status_raises():
+@pytest.mark.parametrize("container, slot_nr", [("A", 0), ("A", 7), ("O", 15), ("O", 1), ("D", 1)])
+def test_slot_name_rejects_unknown_slots(container, slot_nr):
     with pytest.raises(OMNYSampleStorageError):
-        OMNYSampleStorage._status_to_val("bogus")
+        slot_name(container, slot_nr)
 
 
-@pytest.mark.parametrize("raw", ["not-a-number", None, object()])
-def test_val_to_status_defaults_to_none_on_bad_input(raw):
-    assert OMNYSampleStorage._val_to_status(raw) == "none"
+def test_pv_names_match_the_ioc():
+    assert OMNYSampleStorage.sample_used.defn["A1"][1] == "OMNY-SAMPLE:A1:USED"
+    assert OMNYSampleStorage.sample_names.defn["P100"][1] == "OMNY-SAMPLE:P100:NAME"
+    assert OMNYSampleStorage.sample_status.defn["STAGE"][1] == "OMNY-SAMPLE:STAGE:STATUS"
+    assert OMNYSampleStorage.sample_meas_date.defn["GRIPPER"][1] == "OMNY-SAMPLE:GRIPPER:MEAS_DATE"
+    assert OMNYSampleStorage.parking_names.defn["parking3"][1] == "OMNY-SAMPLE:PARK3:NAME"
+    assert len(SAMPLE_SLOTS) == 18 + 10 + 2
 
 
-@pytest.mark.parametrize("raw", ["not-a-number", None, object()])
-def test_val_to_account_defaults_to_none_on_bad_input(raw):
-    assert OMNYSampleStorage._val_to_account(raw) is None
+def test_set_and_unset_slot(storage):
+    storage.set_sample_slot("O", 32, "pin1", "e12345")
+    assert storage.get_sample_record("O", 32) == {
+        "used": True, "name": "pin1", "owner": "e12345", "status": "none", "meas_date": ""}
+    storage.unset_sample_slot("O", 32)
+    rec = storage.get_sample_record("O", 32)
+    assert rec["used"] is False and rec["name"] == "-" and rec["owner"] == ""
+
+
+def test_status_travels_with_the_sample(storage):
+    storage.set_sample_slot("B", 2, "pin2", "e11111")
+    storage.set_sample_measured("B", 2, "completed", "2026-10")
+    storage.transfer_sample(("B", 2), "GRIPPER")
+    storage.transfer_sample("GRIPPER", "STAGE")
+    assert not storage.is_sample_slot_used("B", 2)
+    assert not storage.is_sample_in_gripper()
+    assert storage.get_sample_record("STAGE") == {
+        "used": True, "name": "pin2", "owner": "e11111", "status": "completed", "meas_date": "2026-10"}
+
+
+def test_set_sample_measured_owner_if_empty(storage):
+    storage.set_sample_in_samplestage("pin3")
+    storage.set_sample_measured("STAGE", 0, "started", "2026-10", owner_if_empty="e22222")
+    assert storage.get_sample_owner_in_samplestage() == "e22222"
+    assert storage.get_sample_status_in_samplestage() == "started"
+    # an existing owner is kept
+    storage.set_sample_measured("STAGE", 0, "completed", "2026-10", owner_if_empty="e33333")
+    assert storage.get_sample_owner_in_samplestage() == "e22222"
+
+
+def test_invalid_status_raises(storage):
+    storage.set_sample_slot("A", 1, "pin4")
+    with pytest.raises(OMNYSampleStorageError):
+        storage.set_sample_measured("A", 1, "bogus", "")
+
+
+def test_parking(storage):
+    storage.set_shuttle_slot("C", 2)
+    assert storage.is_shuttle_slot_used(2) and storage.get_shuttle_name_slot(2) == "C"
+    assert storage.search_shuttle_in_slot("C") == 2
+    storage.unset_shuttle_slot(2)
+    assert not storage.is_shuttle_slot_used(2) and storage.get_shuttle_name_slot(2) == "none"
+    with pytest.raises(OMNYSampleStorageError):
+        storage.set_shuttle_slot("A", 7)
diff --git a/tests/tests_devices/test_sim_omny_sample_storage_defaults.py b/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
index 9aac632f..66c0f910 100644
--- a/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
+++ b/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
@@ -29,3 +29,10 @@ def test_default_samples_still_seeded_in_shuttle_a(storage):
     assert storage.get_sample_name("A", 1) == "sim_sample_1"
     assert storage.get_sample_name("A", 2) == "sim_sample_2"
     assert storage.get_sample_name("A", 3) == "sim_sample_3"
+
+
+def test_untouched_slots_read_empty(storage):
+    rec = storage.get_sample_record("O", 100)
+    assert rec == {"used": False, "name": "-", "owner": "", "status": "none", "meas_date": ""}
+    assert storage.get_sample_name_in_samplestage() == "sim_stage_sample"
+    assert not storage.is_sample_in_gripper()

From 06c391571f29358a23b56dc58e3983fd84859a17 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 20 Oct 2026 08:32:47 +0200
Subject: [PATCH 067/102] feat(flomni): detector-trigger stability via the
 ConstEmitter (emitter_get_ontarget, emitter_set_ontarget_tolerance /
 _hold_ms) and emitter_help

Control loop (flOMNI system-identification branch): OnTargetTrigger triggers a step-scan point when the
relative position sample vs FZP is within ontarget_tolerance_um in x and y for ontarget_hold_ms; both are
ConstEmitter values, live over the CommunicationServer (eo<um>, eh<ms>, eg). 'es' is unchanged (4 values).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNtKEk4jAyjebMDQFwRHJQ
---
 csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py | 67 ++++++++++++++++++++
 1 file changed, 67 insertions(+)

diff --git a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
index 0cf66f39..7309dd5b 100644
--- a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
@@ -51,6 +51,10 @@ class RtFlomniController(Controller):
         "emitter_set_tracking_target_z",
         "emitter_set_intensity_threshold_laser",
         "emitter_set_psd_intensity_threshold_tracking_low",
+        "emitter_get_ontarget",
+        "emitter_set_ontarget_tolerance",
+        "emitter_set_ontarget_hold_ms",
+        "emitter_help",
     ]
 
     def __init__(
@@ -432,8 +436,71 @@ class RtFlomniController(Controller):
         t.field_names = ["Name", "Value"]
         for key, val in self.emitter_get().items():
             t.add_row([key, val])
+        for key, val in self.emitter_get_ontarget().items():
+            t.add_row([key, val])
         print(t)
 
+    def emitter_get_ontarget(self) -> dict:
+        """Read the detector-trigger stability criterion (OnTargetTrigger in the control loop).
+
+        A step-scan point is triggered when the relative position sample vs FZP is within
+        ``ontarget_tolerance_um`` in x and in y (each averaged over 0.5 ms) for ``ontarget_hold_ms``
+        without interruption.
+
+        Returns:
+            dict: ontarget_tolerance_um, ontarget_hold_ms.
+        """
+        ret = self.socket_put_and_receive("eg")
+        ret = ret.split("\n")[0]
+        values = [float(val) for val in ret.split(",")]
+        if len(values) != 2:
+            raise RtCommunicationError(
+                f"Expected to receive 2 on-target values. Instead received {values}"
+            )
+        return {"ontarget_tolerance_um": values[0], "ontarget_hold_ms": values[1]}
+
+    def emitter_set_ontarget_tolerance(self, val_um: float) -> None:
+        """Set the detector-trigger tolerance in um, per axis.
+
+        E.g. 0.030 for a low-resolution scan, 0.002 for the highest resolution. A value <= 0 selects
+        the former criterion (on-target flags of the FZP PID loops, set in their parameter files).
+        """
+        self.socket_put(f"eo{val_um:.6f}")
+
+    def emitter_set_ontarget_hold_ms(self, val_ms: float) -> None:
+        """Set the time in ms the position must stay within the tolerance before the trigger."""
+        self.socket_put(f"eh{val_ms:.3f}")
+
+    def emitter_help(self) -> None:
+        """Print the ConstEmitter commands (loop runtime constants) with a short explanation."""
+        t = PrettyTable()
+        t.title = "ConstEmitter commands (rt controller)"
+        t.field_names = ["Method", "Wire", "Explanation"]
+        t.align = "l"
+        rows = [
+            ("emitter_show_all()", "es, eg", "print all runtime constants"),
+            ("emitter_get()", "es", "dict: tracking targets y/z, laser and PSD thresholds"),
+            ("emitter_get_ontarget()", "eg", "dict: detector-trigger tolerance (um), hold (ms)"),
+            ("emitter_set_tracking_target_y(val)", "ey", "target of the tracking loop y (PSD)"),
+            ("emitter_set_tracking_target_z(val)", "ez", "target of the tracking loop z (PSD)"),
+            ("emitter_set_intensity_threshold_laser(val)", "et",
+             "interferometer signal below this: slew limiters and x/y/z, FZP PIDs stop"),
+            ("emitter_set_psd_intensity_threshold_tracking_low(val)", "el",
+             "PSD intensity below this: tracking PIDs y/z stop"),
+            ("emitter_set_ontarget_tolerance(val_um)", "eo",
+             "detector trigger: |relative error| x and y <= val um (e.g. 0.030 coarse, 0.002 fine);"
+             " <= 0: FZP PID flags"),
+            ("emitter_set_ontarget_hold_ms(val_ms)", "eh",
+             "detector trigger: ... held for val ms without interruption"),
+        ]
+        for row in rows:
+            t.add_row(row)
+        print(t)
+        print(
+            "Values are live in the control loop; the start values after a loop restart come from"
+            " ConstEmitter.xmp."
+        )
+
     def emitter_set_tracking_target_y(self, val: float) -> None:
         """Set the y tracking target position (PID_tracking_y)."""
         self.socket_put(f"ey{val:.4f}")

From d9b23b9dc28d3c8db1a1884aa344b004b1789303 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 20 Oct 2026 10:23:24 +0200
Subject: [PATCH 068/102] feat(flomni): user commands
 interferometer_trigger_show / _set_tolerance_nm / _set_hold_ms / _help for
 the detector-trigger stability; user docs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNtKEk4jAyjebMDQFwRHJQ
---
 .../plugins/flomni/flomni.py                  | 60 +++++++++++++++++++
 docs/user/ptychography/flomni.md              | 25 ++++++++
 2 files changed, 85 insertions(+)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 329a2b41..5be8b558 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -710,6 +710,66 @@ class FlomniSampleTransferMixin:
         else:
             print("The rt feedback is \x1b[91mNOT\x1b[0m running.")
 
+    def interferometer_trigger_show(self):
+        """Show the detector-trigger stability criterion of the interferometer feedback.
+
+        A step-scan point is triggered when the relative position sample vs FZP (interferometer
+        minus FZP cap sensor) is within the tolerance in x and in y, each averaged over 0.5 ms,
+        for the hold time without interruption.
+        """
+        values = dev.rtx.controller.emitter_get_ontarget()
+        tol_nm = values["ontarget_tolerance_um"] * 1000
+        if tol_nm > 0:
+            print(f"Detector trigger: |position error| x and y <= {tol_nm:.1f} nm "
+                  f"for {values['ontarget_hold_ms']:.1f} ms.")
+        else:
+            print("Detector trigger: former criterion (on-target flags of the FZP PID loops).")
+
+    def interferometer_trigger_set_tolerance_nm(self, tolerance_nm: float):
+        """Set the detector-trigger tolerance in nm (per axis, x and y).
+
+        Typical: 30 nm for a fast low-resolution scan, 10 nm standard, 2 nm for the highest
+        resolution (needs a few ms more per point). 0 selects the former criterion (on-target flags
+        of the FZP PID loops).
+
+        Args:
+            tolerance_nm (float): tolerance in nm, 0 or 1 ... 1000.
+        """
+        if tolerance_nm != 0 and not 1 <= tolerance_nm <= 1000:
+            raise FlomniError(
+                "The trigger tolerance must be 0 (former criterion) or 1 ... 1000 nm."
+            )
+        dev.rtx.controller.emitter_set_ontarget_tolerance(tolerance_nm / 1000)
+        self.interferometer_trigger_show()
+
+    def interferometer_trigger_set_hold_ms(self, hold_ms: float):
+        """Set how long (ms) the position must stay within the tolerance before the trigger.
+
+        Typical 3 ms. Longer = safer against a position that is only passing through the tolerance.
+
+        Args:
+            hold_ms (float): hold time in ms, 0 ... 100.
+        """
+        if not 0 <= hold_ms <= 100:
+            raise FlomniError("The trigger hold time must be 0 ... 100 ms.")
+        dev.rtx.controller.emitter_set_ontarget_hold_ms(hold_ms)
+        self.interferometer_trigger_show()
+
+    def interferometer_trigger_help(self):
+        """Print the detector-trigger commands with a short explanation."""
+        lines = [
+            "Detector trigger (step scans): a point is triggered when the relative position",
+            "sample vs FZP is within the tolerance in x and y (0.5 ms average) for the hold time.",
+            "  flomni.interferometer_trigger_show()                 tolerance and hold time",
+            "  flomni.interferometer_trigger_set_tolerance_nm(val)  30 coarse, 10 standard,",
+            "                                                       2 finest; 0 = former",
+            "                                                       criterion (FZP PID flags)",
+            "  flomni.interferometer_trigger_set_hold_ms(val)       e.g. 3",
+            "The values are live; after a restart of the control loop the start values",
+            "(10 nm, 3 ms) from the loop parameter file apply again.",
+        ]
+        print("\n".join(lines))
+
     def lights_off(self):
         self.device_manager.devices.fsamx.controller.lights_off()
 
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index b7fe0c6e..238ec211 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -218,6 +218,23 @@ _There is also an enable without reset, which is used during tomography scans, w
 - `flomni.feedback_disable()`
 - `flomni.feedback_status()`
 
+#### Detector trigger: position stability
+
+In step scans the detector is triggered when the sample is stable at the scan point: the relative position
+sample vs FZP (interferometer minus FZP cap sensor) must stay within a tolerance in x and in y (each averaged
+over 0.5 ms) for a hold time. Both values are live and can be changed between scans:
+
+- `flomni.interferometer_trigger_show()` — current tolerance and hold time
+- `flomni.interferometer_trigger_set_tolerance_nm(10)` — tolerance per axis in nm: about 30 for a fast
+  low-resolution scan, 10 standard, 2 for the highest resolution (a few ms more per point);
+  0 selects the former criterion (on-target flags of the FZP loops)
+- `flomni.interferometer_trigger_set_hold_ms(3)` — hold time in ms
+- `flomni.interferometer_trigger_help()` — this list
+
+After a restart of the control loop the start values (10 nm, 3 ms) apply again. Measured with 3 µm steps
+(2026-10-20): the trigger comes about 36 ms (x) / 48 ms (y) after the step at 10 nm, 40 / 55 ms at 2 nm;
+after the trigger the position stays within about 4 nm even at a 30 nm tolerance.
+
 ### Scanning in 2D and sample alignment
 
 #### flOMNI Fermat scan
@@ -760,6 +777,14 @@ removed later.
 
 [See short version](flomni.md#sample-storage-and-transfer)
 
+### Detector trigger and interferometer tuning
+
+The trigger tolerance and hold time: [Detector trigger: position stability](#detector-trigger-position-stability)
+(`flomni.interferometer_trigger_*`). The control loops of the sample stage, the FZP scanner and the laser
+tracker were characterized and retuned in October 2026; results, the present parameters and how to retune them
+are documented in the flOMNI control repository (`FeedbackLoop/feedback_report.md` with PDF,
+`FeedbackLoop/tuning_guide.md`).
+
 ### Heater
 
 The [heater](https://www.dora.lib4ri.ch/psi/islandora/object/psi:45302) can be moved up and down by

From 87969539139714fbd12e48e57a2ddde924b21fa5 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 20 Oct 2026 11:47:36 +0200
Subject: [PATCH 069/102] feat(flomni): trigger after a position change
 (interferometer_trigger_set_after_move, emitter_set_trigger_on_move -> em),
 three-axis move (controller.move_xyz -> p<x>,<y>,<z>); eg with 3 values

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNtKEk4jAyjebMDQFwRHJQ
---
 .../plugins/flomni/flomni.py                  | 16 ++++++++
 csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py  | 41 +++++++++++++++++--
 docs/user/ptychography/flomni.md              |  4 ++
 3 files changed, 57 insertions(+), 4 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 5be8b558..36c5ec29 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -724,6 +724,9 @@ class FlomniSampleTransferMixin:
                   f"for {values['ontarget_hold_ms']:.1f} ms.")
         else:
             print("Detector trigger: former criterion (on-target flags of the FZP PID loops).")
+        if values.get("trigger_on_move") is not None:
+            mode = "on" if values["trigger_on_move"] else "off"
+            print(f"Trigger after every position change (not only at scan points): {mode}.")
 
     def interferometer_trigger_set_tolerance_nm(self, tolerance_nm: float):
         """Set the detector-trigger tolerance in nm (per axis, x and y).
@@ -755,6 +758,16 @@ class FlomniSampleTransferMixin:
         dev.rtx.controller.emitter_set_ontarget_hold_ms(hold_ms)
         self.interferometer_trigger_show()
 
+    def interferometer_trigger_set_after_move(self, enable: bool):
+        """Send one detector trigger after every position change, not only at scan points.
+
+        With True every direct move of the sample stage (e.g. umv of rtx / rty / rtz, or
+        dev.rtx.controller.move_xyz) gives exactly one trigger, as soon as the position is stable
+        (same tolerance and hold time as for scan points). False: triggers at scan points only.
+        """
+        dev.rtx.controller.emitter_set_trigger_on_move(1 if enable else 0)
+        self.interferometer_trigger_show()
+
     def interferometer_trigger_help(self):
         """Print the detector-trigger commands with a short explanation."""
         lines = [
@@ -765,6 +778,9 @@ class FlomniSampleTransferMixin:
             "                                                       2 finest; 0 = former",
             "                                                       criterion (FZP PID flags)",
             "  flomni.interferometer_trigger_set_hold_ms(val)       e.g. 3",
+            "  flomni.interferometer_trigger_set_after_move(True)   also one trigger after every",
+            "                                                       position change (False: off)",
+            "  dev.rtx.controller.move_xyz(x, y, z)                 move all three axes at once",
             "The values are live; after a restart of the control loop the start values",
             "(10 nm, 3 ms) from the loop parameter file apply again.",
         ]
diff --git a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
index 7309dd5b..afa49424 100644
--- a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
@@ -55,6 +55,8 @@ class RtFlomniController(Controller):
         "emitter_set_ontarget_tolerance",
         "emitter_set_ontarget_hold_ms",
         "emitter_help",
+        "emitter_set_trigger_on_move",
+        "move_xyz",
     ]
 
     def __init__(
@@ -448,16 +450,21 @@ class RtFlomniController(Controller):
         without interruption.
 
         Returns:
-            dict: ontarget_tolerance_um, ontarget_hold_ms.
+            dict: ontarget_tolerance_um, ontarget_hold_ms, trigger_on_move (None from a server
+            that does not report it yet).
         """
         ret = self.socket_put_and_receive("eg")
         ret = ret.split("\n")[0]
         values = [float(val) for val in ret.split(",")]
-        if len(values) != 2:
+        if len(values) not in (2, 3):
             raise RtCommunicationError(
-                f"Expected to receive 2 on-target values. Instead received {values}"
+                f"Expected to receive 2 or 3 on-target values. Instead received {values}"
             )
-        return {"ontarget_tolerance_um": values[0], "ontarget_hold_ms": values[1]}
+        return {
+            "ontarget_tolerance_um": values[0],
+            "ontarget_hold_ms": values[1],
+            "trigger_on_move": values[2] if len(values) == 3 else None,
+        }
 
     def emitter_set_ontarget_tolerance(self, val_um: float) -> None:
         """Set the detector-trigger tolerance in um, per axis.
@@ -471,6 +478,30 @@ class RtFlomniController(Controller):
         """Set the time in ms the position must stay within the tolerance before the trigger."""
         self.socket_put(f"eh{val_ms:.3f}")
 
+    def emitter_set_trigger_on_move(self, val: int) -> None:
+        """1: send one detector trigger after every direct position change (pa / p), once on target
+        (same criterion as a step-scan point); 0: triggers at step-scan points only."""
+        self.socket_put(f"em{1 if val else 0}")
+
+    def move_xyz(self, x: float, y: float, z: float) -> None:
+        """Move rtx, rty and rtz with one command (CommunicationServer p<x>,<y>,<z>).
+
+        The three targets change in the same loop step, so with trigger_on_move there is exactly one
+        detector trigger for the move. Values as for the rtx / rty / rtz axes (axis sign applied).
+        Does not wait for the move.
+        """
+        if self.laser_tracker_check_signalstrength() == "toolow":
+            raise RtError(
+                "The interferometer signal is too low for movements. Realignment required."
+            )
+        targets = []
+        for name, val in (("rtx", x), ("rty", y), ("rtz", z)):
+            axis = self.get_axis_by_name(name)
+            target_val = val * axis.sign
+            axis.user_setpoint.setpoint = target_val
+            targets.append(target_val)
+        self.socket_put(f"p{targets[0]:.4f},{targets[1]:.4f},{targets[2]:.4f}")
+
     def emitter_help(self) -> None:
         """Print the ConstEmitter commands (loop runtime constants) with a short explanation."""
         t = PrettyTable()
@@ -492,6 +523,8 @@ class RtFlomniController(Controller):
              " <= 0: FZP PID flags"),
             ("emitter_set_ontarget_hold_ms(val_ms)", "eh",
              "detector trigger: ... held for val ms without interruption"),
+            ("emitter_set_trigger_on_move(val)", "em",
+             "1: one detector trigger after every direct move (pa / p) once on target; 0: off"),
         ]
         for row in rows:
             t.add_row(row)
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 238ec211..8031e5d2 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -229,6 +229,10 @@ over 0.5 ms) for a hold time. Both values are live and can be changed between sc
   low-resolution scan, 10 standard, 2 for the highest resolution (a few ms more per point);
   0 selects the former criterion (on-target flags of the FZP loops)
 - `flomni.interferometer_trigger_set_hold_ms(3)` — hold time in ms
+- `flomni.interferometer_trigger_set_after_move(True)` — additionally one trigger after every position change
+  of the sample stage (e.g. `umv(dev.rtx, ...)`), as soon as the position is stable with the same tolerance and
+  hold time; `False` (default): triggers at scan points only
+- `dev.rtx.controller.move_xyz(x, y, z)` — moves rtx, rty and rtz with one command (one trigger for the move)
 - `flomni.interferometer_trigger_help()` — this list
 
 After a restart of the control loop the start values (10 nm, 3 ms) apply again. Measured with 3 µm steps

From 7c6cda681c47cd1f52f0e3da66f9f79f0f3de13d Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 20 Oct 2026 15:12:51 +0200
Subject: [PATCH 070/102] test(xrayeye): keep the ellipse-ROI test items in a
 module-lifetime QGraphicsScene

Unparented pyqtgraph ROIs could be garbage-collected while the next ROI was being
built, which crashed PySide6 in CI with --random-order (segfault in
GraphicsObject.itemChange during garbage collection). Test logic unchanged.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01TNtKEk4jAyjebMDQFwRHJQ
---
 .../test_x_ray_eye_ellipse_roi.py               | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/tests/tests_bec_widgets/test_x_ray_eye_ellipse_roi.py b/tests/tests_bec_widgets/test_x_ray_eye_ellipse_roi.py
index e07ece3b..b16ad85b 100644
--- a/tests/tests_bec_widgets/test_x_ray_eye_ellipse_roi.py
+++ b/tests/tests_bec_widgets/test_x_ray_eye_ellipse_roi.py
@@ -27,6 +27,22 @@ def _qapp():
     return pg.mkQApp()
 
 
+# All test ROIs go into one scene that lives for the whole module: Qt then owns the items, and the
+# Python garbage collector cannot delete an unparented ROI while the next one is being built (that
+# crashed PySide6 / pyqtgraph in CI with --random-order: "Fatal Python error: Segmentation fault" in
+# GraphicsObject.itemChange during garbage collection).
+_SCENE = None
+
+
+@pytest.fixture(autouse=True, scope="module")
+def _scene(_qapp):
+    global _SCENE
+    _SCENE = pg.QtWidgets.QGraphicsScene()
+    yield _SCENE
+    _SCENE.clear()
+    _SCENE = None
+
+
 class _FakeEllipticalROI(pg.EllipseROI):
     """pg ellipse standing in for bec_widgets' EllipticalROI in isinstance checks."""
 
@@ -39,6 +55,7 @@ def _patch_roi_class():
 
 def _roi(pos=(10.0, 20.0), size=(40.0, 20.0), angle=0.0):
     roi = _FakeEllipticalROI(pos, size, angle=angle)
+    _SCENE.addItem(roi)
     return roi
 
 

From 26b16347945642ee791eac68e85f8be4a05dc6c5 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 20 Oct 2026 23:14:43 +0200
Subject: [PATCH 071/102] docs(flomni): FZP calibration / range how-tos updated
 for the PREEMPT_RT loop (original text kept)

Markdown sources next to the PDFs; new section 'Update 2026-10-20': 7-element FAST_FZP_PID_LOOP, Feedforward,
AbbeCorrection, TargetSelect use_final, OnTargetTrigger WaitForSlew / MinDelay, FZP limits +-1.5 V, current defaults,
exposure during the motion after the calibration.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YZDvHhkb4fXGmia6jLzyCS
---
 ...ct_only-howto_calibrate_the_fzp_scanner.md | 128 ++++++++++++++++++
 ...t_only-howto_calibrate_the_fzp_scanner.pdf | Bin 31150 -> 60296 bytes
 ..._only-howto_limit_the_fzp_scanner_range.md |  36 +++++
 ...only-howto_limit_the_fzp_scanner_range.pdf | Bin 20066 -> 48163 bytes
 4 files changed, 164 insertions(+)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
new file mode 100644
index 00000000..03fe6cd2
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
@@ -0,0 +1,128 @@
+# How to calibrate the FZP scanner of flOMNI
+
+Source of `local_contact_only-howto_calibrate_the_fzp_scanner.pdf`. The original text is kept unchanged; the
+section "Update 2026-10-20" at the end lists what the present flOMNI loop (PREEMPT_RT, 100 µs, branch `rt_preemt`)
+needs in addition.
+
+```text
+This is a description of how to calibrate the FZP scanner of flOMNI
+
+Rmemeber to do all modifications for both directions x and y!
+
+1. Align flOMNI without the FZP scanner. This implies disabling the
+FZP scanner completely. To do so, in OrchestraHMI edit the parameters
+of the FZP scanner as follows.
+(a) Module PID_i_FZP: Set Param FAST_FZP_PID_LOOP(0) to 2. Then the FZP
+will just remain
+statically centered to the capacitive sensor position in closed loop.
+(b) Module PID_i: Set Param FAST_FZP_PID_LOOP(0) to 0. If this is
+negative, the FZP scanner will move ahead in a point-by-point scan by
+that amount.
+(c) Module PID_i: Set Param FAST_FZP_PID_LOOP(5) to 0. If this is
+larger than zero the sample stage motion is stopped if the position is
+reached by the FZP scanner (which is the case when the scanner is not
+active). Zero means thus full compensation by the sample stage.
+
+In this state the setup can be aligned, and the affine matrix for
+ptychography can be found. This refers then purely to the alignment of
+the interferometer and X-ray detector.
+
+2. In the next step we perform a scan (with a small beam and small
+range) such that only the FZP scanner is used and the sample stage
+will not move.
+
+Before we start ensure that the Correction Matrix for the capacitive
+sensors is cleared.
+
+To do this change the parameters of the flOMNI control
+loop as follows:
+
+(a) Module AnalogInput_6259: Set parameter MatrixCorr to 1 0 0 1
+(b) Module PID_j_fzp: Set Param FAST_FZP_PID_LOOP(0) to 1 to re-activate
+the FZP scanner.
+(c) Module PID_i: Set Param FAST_FZP_PID_LOOP(5) to 10, so up to 10
+volts output of the fast PID is accepted before starting a movement of
+the sample stage.
+(d) Module PID_i: Param FAST_FZP_PID_LOOP(4) 0
+(e) Module PID_i: Param FAST_FZP_PID_LOOP(6) 1
+ with d and e it will now stabilize the sample stage position at zero
+(f) Module PID_i: Param FAST_FZP_PID_LOOP(0) remains 0 (no move ahead
+in a scan)
+
+With these settings perform a scan. Use a field of view matching the
+range of the FZP scanner. Watch the sample stage position in Orchestra
+to ensure it does not change!
+A good range should be 2.8 microns in x and 1.8 microns in y.
+Reconstruct this scan with Michal's position refinement code and ask
+for an update of the FZP matrix. This can then be put into the
+AnalogInput_6259 module.
+I guess one has to have the matrix found for the interferometer in the
+reconsturction code, such that the new matrix of the FZP scanner will
+adjust the coordinate system of the FZP scanner to the system of the
+interferometer. Later these positions are used together and should
+match in direction.
+
+3. Back to default operating values:
+(a)  Module PID_i: Set Param FAST_FZP_PID_LOOP(0) to -0.5, for up to
+0.5 microns move ahead in a scan.
+All other parameters are already as supposed to be.
+Default values for the sample stage pid, fast FZP parameter are "-
+0.5,0,0,0,0.1,0.5,0"
+Default values for the fzp pid, fast FZP parameter are "1,0.0001,0.1,-
+4,0,0,0"
+```
+
+## Update 2026-10-20 (flOMNI loop on PREEMPT_RT, mpc2844)
+
+The loop has new modules since the text above was written (flOMNI `FeedbackLoop/tuning_guide.md`,
+`feedback_report.md` 5.6, 6n, 6o, 6q). Parameters are changed in the web HMI (`http://mpc2844:8080`, tab
+Parameters) instead of OrchestraHMI. `i` = x or y, as above. Module names now: `PID_x`, `PID_y` (sample stage),
+`PID_x_fzp`, `PID_y_fzp` (FZP scanner), `AnalogInput_6289` (was `AnalogInput_6259`).
+
+**FAST_FZP_PID_LOOP has 7 elements** (`PID.cpp`). Sample stage PIDs: (0) move-ahead (negative, µm, point-by-point
+scans only), (4) FZP error threshold (µm) and (5) FZP drive limit (V) for holding the sample stage while the FZP
+takes the step (5 = 0: never held), (6) 1 = hold the sample stage at 0. FZP PIDs: (0) mode (1 operation, 2 FZP
+centred on its cap sensor = disabled, 3 not commissioned, 4 debug), (1)–(3) min / max / gain of the old velocity
+correction (−4 before 2026-10-19, now 0: replaced by the feedforward).
+
+**In addition to step 1 (FZP disabled):**
+
+- `Feedforward`: `enable` 0,0 — the static FZP feedforward adds its drive also in FZP mode 2.
+- `AbbeCorrection`: `enable` 0 (default until the signs are known).
+- `TargetSelect_x`, `TargetSelect_y`: `use_final` 0; `OnTargetTrigger`: `WaitForSlew` 1 (defaults).
+- `FreqGen`: `enable` 0 (excitation for measurements; default).
+
+**In addition to step 2 (FZP-only calibration scan):**
+
+- FZP range: `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` are ±1.5 V in operation (the cap sensors are calibrated over
+  about ±2 V only). For the field of view above (2.8 × 1.8 µm) widen them, e.g. to ±10 V (FZP ≈ 0.13 µm/V in x,
+  ≈ 0.05 µm/V in y). The feedforward stays off (`enable` 0,0) during this scan.
+- The detector trigger (`OnTargetTrigger`) checks the relative error sample vs FZP (tolerance / hold time from the
+  ConstEmitter, BEC `interferometer_trigger_*`, default 10 nm / 3 ms) and waits `MinDelay_ms` (15 ms).
+
+**Step 3, default operating values (replace the values in the text above):**
+
+| Module | Parameter | Value |
+|---|---|---|
+| `PID_x`, `PID_y` | `FAST_FZP_PID_LOOP` | `0,0,0,0,0.1,0,0` (no move-ahead: −0.5 µm does not fit the ±1.5 V FZP range) |
+| `PID_x_fzp` | `FAST_FZP_PID_LOOP`, `Ub` / `Lb` | `1,0.0001,0.1,0,0,0,0`, ±1.5 V |
+| `PID_y_fzp` | `FAST_FZP_PID_LOOP`, `Ub` / `Lb` | `1,0.0005,0.02,0,0,0,0`, ±1.5 V |
+| `Feedforward` | `enable`; `ff_limit`, `out_min` / `out_max` | 1,1; ±1.5 V (as the FZP `Ub` / `Lb`) |
+| `OnTargetTrigger` | `WaitForSlew`, `MinDelay_ms` | 1, 15 |
+| `TargetSelect_x`, `TargetSelect_y` | `use_final` | 0 |
+| `AbbeCorrection` | `enable` | 0 (until the signs are known) |
+| `AnalogInput_6289` | `MatrixCorr` | the new matrix from the calibration |
+
+Check afterwards: web HMI tab **Loop check**, level 1 (it expects these values and lists live values that differ
+from the `.xmp` files); save the new values as default (Parameters → Unsaved changes) or in the `.xmp`.
+
+**After the calibration (per experiment): faster scans, exposure during the motion.** With the FZP calibrated
+over a wider range the FZP can take the small steps alone (flOMNI `feedback_report.md` 6q, tested at ±7 V):
+
+- `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` and the `Feedforward` limits to the calibrated range (e.g. ±7 V);
+- `TargetSelect_x` / `_y` `use_final` 1 (the FZP aims at the new point at once, the sample stage follows its
+  S-curve) and `OnTargetTrigger` `WaitForSlew` 0 (trigger on the relative error only); optionally `MinDelay_ms` 0;
+- optionally move-ahead, sized to the FZP range: `PID_x` (0) e.g. −0.5, `PID_y` (0) e.g. −0.2.
+
+Measured with 101 ms exposures: 0.2–1 µm steps trigger after 4.5–5.8 ms instead of 17–32 ms; the error during the
+exposure grows with the step (1 µm: ≈ 6 nm max instead of 2.5 nm), so the setting depends on the experiment.
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf
index 81ce9c8a5479ba327965c1f1f11cb88a10381c23..013f519d23ece88fb94c9016565d452bc0b31443 100644
GIT binary patch
literal 60296
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
CXlw=m

literal 31150
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
P$-@FiK_Q_a3HQGMWG+-C

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
new file mode 100644
index 00000000..a953ca6a
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
@@ -0,0 +1,36 @@
+# How to limit the FZP scanner range of flOMNI
+
+Source of `local_contact_only-howto_limit_the_fzp_scanner_range.pdf`. The original text is kept unchanged; the
+section "Update 2026-10-20" lists what the present flOMNI loop (PREEMPT_RT, 100 µs, branch `rt_preemt`) needs in
+addition.
+
+```text
+to limit the fzp scanner ranges
+in PID_ FAST FZP PID LOOP
+0: reduce to small ahead movement range, such as -0.05
+4: reduce error threshold, eg 0.01
+5: inform PID that FZP range is small, such as 0.1
+
+in PID_ _FZP
+limit the analog output LB and UB
+```
+
+## Update 2026-10-20 (flOMNI loop on PREEMPT_RT, mpc2844)
+
+The limited range is the present operating state: `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` = ±1.5 V because the cap
+sensors are calibrated over about ±2 V only (flOMNI `feedback_report.md` 6n). FZP ≈ 0.13 µm/V in x, ≈ 0.05 µm/V in y,
+so ±1.5 V ≈ ±0.19 µm (x) / ±0.08 µm (y). In the sample stage PIDs (`PID_x`, `PID_y`) `FAST_FZP_PID_LOOP` is
+`0,0,0,0,0.1,0,0`: no move-ahead, (5) = 0 (the sample stage always compensates fully).
+
+Changing the FZP range now involves, in addition to the text above:
+
+- **`Feedforward`** (static FZP feedforward): `ff_limit`, `out_min` / `out_max` to the same values as the FZP `Ub` /
+  `Lb` (they limit drive + feedforward).
+- **`FreqGen`** `out_min` / `out_max` (channels 0 / 1) limit the FZP drive only while an excitation is running
+  (measurements).
+- **`OnTargetTrigger`** `WaitForSlew` and **`TargetSelect_x` / `_y`** `use_final`: keep the defaults (1 / 0) with a
+  small range. `use_final` 1 + `WaitForSlew` 0 ("exposure during the motion") only makes sense when the FZP range
+  covers the scan step; steps larger than the range then still wait for the sample stage.
+- Move-ahead (0) must fit into the range: at ±1.5 V at most ≈ −0.05 µm (x) — so in operation it stays 0.
+- After a change: web HMI tab **Loop check** level 1 (expected settings) and, with the beamline ready, the scan test
+  (level 4: positioning time, stability during the exposure per step size).
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.pdf
index 66e18ac1f531e6555db57952dcbde5a96f8c3661..abf9ea982947a3a5e249073437b2a3c5983970a1 100644
GIT binary patch
literal 48163
zcmb@tbyQrzvNwvm1$QP1t~1yS9^8U!aCdiiLVy6lJ&@o8hu}_dcXxMpdy{j{z31HZ
zt?$0~$J=Yx?C$ES>Z;nkYt3~1nnqDff(69NiAFPdxWA4D0ssN_MpkJ2{A{95riL!|
zP5^pQ3nzP9OIKS4G&V&idlOe<Qz%iz+R~5>Dhsd$adAUO{=sc&ZzpExVhW%a<7Ef3
zbAy1;ZxD!+1IPpf(m_8^J~?}n|D8op5Y5!i<gX1J|F*^05CB4B6OjY3$=f^G8ruAu
ziRa%;5|%bDP}A5XY@jxXnHt-hn4+<LG_^B#u>f%Ka03Me0nRQ^r)<$YGLCh%%gGxY
z{j&7OW5NTkF4UW0A`xApbA2y@@nHS9@yj#XwM<Nr`$n<*S}Py|S)ZpTId-LL4NIf@
zCYx0W`io=Ky2s~KU%-XJn6KPb{u1Ur#9=X63T>G+1><C-F3Q{XIl80*;vAZ`6DcJ(
zUCBaOFLzDrvy=98d{&})9s32B<wAafQGO{euct!Thoky}nSOWkSXnP_5y4zmXB`;4
zb&rFVsw-iEuVDXrhNp}DtE=^^E^ja~*ynCLx4?4$Eg0f+=kuV%aG8rwlD8M7JisV!
z_~8CB-=Z-fz$9+<!Z)?*s36k-d0wQ>JJQZ8$vkXPW_@*(iT(bvwMvtASTxfB{++p0
zE_=V5^%?us_hDV=Wmlo?<!%$(Uhw7F|MhAX+yAAl4g2+CQ2*8SZogoC|M+rW(ss3(
zt?lmQcGQz`CP6)6S|)Y3Xs1gImb8YVG&N;jxwAJFcP3e3W3QP#=_wnkndd1bj7!79
ziCa^JY2zXkU7|pfsZe#SFbA7^?{}x1Z^(EWj=*6Ti`;%foRVQ_isib5aZBBd9#x|3
zC6OQrMJAv9!E)GSN?$HC7=xqvXM+VQ*@2w~Dx@`wG~Rw=UKpVlQ;LEiO216t)v)Ss
zIb88$!_B$^ZM$Vg<w8XX3bE-<;G-iri%~Y#J4Xyv98@>fjr{n7(MlCn6gHGvVn@hj
zQA+|k18Aijg3i!+a@L5xe7QV%o9Zc&*=9<>kgH|*DHQw0iK;n>-(sKxEi7$9fIv>=
z&2aFa%k1y#+`ifCjo?B!OpP2=BR>Sy*oP4@q9qHLExt?sh+_tX7&@|~&3;SSj!g9P
zn=$?~6rE9hqBwB)h(-}bFgwF%hmn-yb?mkjPai`{JCa0fZV6h}Q(+a4Aj9urApFt^
zZAa<v%@;PRgM@F40p^|8`3AclJChgJ#!lQtb0F+nJIX{yb-LLfH$xM?!X)S|5xN-F
zXGUC@RXD|#iXLw!9jO#IaO8Ag^!MC3mUWd!($WzQ+o!|-ASmF(QeYDe&@YkV2(9ts
z4_}U{^Bgl-A9KcVBE9=HUzmL+f@O5xPz8^2_rr3ZKX=VHv!S*S&M#ImG>tEY@zW;L
z{BJyWtaRMbob_xj0dK0+;$X*Q#AuBVmSN-x_BquuCDSPh7vXaUTZ1!kt-=*{OC0zM
z%hKu5f_DQ-Hk47~$6eckMh9=%$knR3&OCK;rU|k)e9{&Khm-D3vlJX_!fPgfgRKc!
zn{tB;7aKB@LS}Mg`+NShj$f)L1S$8cb^s%rX@3R1P2D51*u6-SS$7JZbj<l_*ARZY
zP!KxIfJk*n<Yp-|Z%|TpI5NTSys74p?=)Fb&^j*h$-iZTX)Clvlx22kVz)(QW$fN#
z(;_Y+{5CpG`82Q5y?UN@Mzva0%YKxJw}!FQLj9MBLDcy%p}oyUD#QqPsxVNoE1Aj2
z$kZPD8{zOb9qz*Dp7Eb#nWH^g+aHZ9R=$X9ss=u^Ya$c}q{x()Wv$=3NWfnYxy9i>
zyMF3|gS%F%%x~>-!ClO%XRt^S`HipMt|ah5C94Bv{(`LLJQ(zFc3m)?eQaeFQ7Iit
zI2UOY@1Tlo6z{R4J7+S>8oCS1hV=)GMtmGr&%1;=o*%IbTW5IgKmoUO?(kd|x@R%g
zLFJEwmG<Nmk3d5?OsPEg6D{}wxS>MmW;dn`{L(_$Urtc&I@ch6h%<5UW~%%017DH&
zQ#*k-XPdA$c+TT#91od-&{r~N-uh1og*Te&@meKvTfkz;T|MM%D6{}hP;2{ks1PnI
ztOEPq7hoe(hWeqDVgc7eC{`Qk4*h)ku_bzD=V!&?LX1Y?ZFZ4a{jhH~vfP^kc>ONH
zYnK&HL^eAmDhJ9abXa?toRM{cqR+m6bQe81gB=ej7d@&5xugGFHLdn+%Ye!P_`d11
z5iasMRT*oG9dQOLP}D#7$GoS<=nDvtGt5J@-MmAuGnXdILzcb4l3m#A?oxj5)t_9m
zRMJsf;}O-~btj(qND+X*->RP%di9g=1xs2ieg06Xk&G)ugA<K-f;(Gcl00r~xpX}3
zyBF{2B}CM>-P2$jrC8;$R+B7D>UPdh_hDp=@~->DS7Lw(Ex6L%aK@GH^pt8g$$oAl
z3d{Pl(Kd!PiehZ&4g8VlQUdulhf$tCa?YQw-xfQU4#~0#;5`q@rkrKms<>b)r)>EY
zcq<Xi{PBd_yZh6G<AdhlQPbj?<Zr3cefH?}MIcd{?|mOdwKu$+N)%prdQm<N=n+q5
zT`)B;V=tGyykSinXV@5F!wa7zu905=naABavsux8&Z4_b7~bEHIlw}$vTGRh4ngK{
zLG78%tB#K#QK^wo8I`M?3&UA?+!(xse+K=Du8eUo^!w7w?BezL++@sO>&OTFzOqXN
zM{i%WR})f9+2AygiX|aDD<^o_;~6Jwl>C~ugkF;xCSSIRzI6`SM2#n_ZyMI^UjS+z
zo~~Dz*phOYW<hFa1wS0q7WOX_Qo9O|H&7boEbWb21T5cUY#t)s`n@sEjK(wWTL0?G
z8^zYHJ~bs<!KI9Pz5-P1`I&+id37#a$GQ&+TVf{^=1hLr`N;S+hRB%xK#%jCv02Oj
zFN1}Si%Ne_tg@_^6hk%dJ8LQ__YA&{AU203#E8AgH$H))&l4r7))ajbjW38UhlycG
zhR?VXzPd_LUSAPTwZqz)ibMH!qOVHegMU}FqPPMa>vyo+KS|+MqWJ=Zw#-&yqfcXi
zuK?@h>KlGawX*ZmGwU5O>S?@zPB5l4%Ghs~`F-A4+JGoY!>i*8le{0}HJEa321nW7
z>eM<0n75i+2)msT<$19$8gK{+G)wgG2oqJ(r${O5Hoq3Xx9R-ZY)Hq99r?2~1YOOF
zlzDq|!-Ghu;5k>NoDOSBZ#$3(=eNrSpX3qB1(w<uw(LsyQ1VVf$-WOU2tIt{BrPJ*
zBbr~;Eb!eUgM}4|zw+mFd7*B%fCI&AT6DSTetjXvh0obhBpS7kC5>c&>k9kfht6fR
z+FK4Wp}5t;AP=$pK~f_cCCJK+vJ-{VdnE8V{0zPF`r^6b?4F+RL~*?hZ_p*|Yy*|D
zo=ZUJL-Au!)jdfN7}N30v^v*iPm@P~yqsq}oqo6MI2Sd=4^Hm-&3CXX)4C@ozj}XG
z2N7SiciB71QC>+)Ts>}Q1O#Bct5jv!TTGvgXK}Kk;V76>6G}%Fgz}=sLaD%caYfVM
z2_XE9R#Z>AN!^-UnBex*#*3hAbKld1TSY&{jR&>nq(#DTfFH#=ynS(*HkO&oxT#{Q
z(%FC^+q=@)+jpg4=RYsO42%27KNCsGYW4ZXO>lpy{rJUw;*mP-#sB{3eUMa)yDt9K
zIZA(nEYALH=$Izo&JieSaDBau^<6&~r)}-0pqL~bQ9F$9Y5ScH*u=FLQNDrjx?>Cc
zeySRX<6azIiOfPpWaja$8Np|rQZ}l7;;wur@8D>&yKXTz_=G%V2pd4y!(bbQ$YJn(
z6qo!A9avPKGnJ;<?T~{lZPDICZjMWD*%{fp-gP`@HJye~-cR%)F(d5T1q#ZdV<rYi
zT&J%Y@?uPrk<b~g2Xf_D7yK9jJUTx<GK!O4!`|K-6|JX(Va{95g^VV)%F@?2_x{@?
z1xhMx2g5$Ek3TgITv;_-&S>4&x?!gR&Sc*?5Dc{NHadwkQtFDH^e*r6bXImqJX_&>
z&>PSA?5b*RslxX(?u}PU8P?40`)96trm+?SeXUnsv4&~21=D8xj0we-w-cr@<i~UX
z${9JXV_4<68&94Mu?}a~Zv3?|PoB@qtp$JTTcU;pczx$Lsmxq6G2@{hR0o3StUt%x
zZ>}}}fYe(^<|PheA?0ZBLi7i|p0_6O9Dkk38`?jj)N37??ns(=QrhPO$LFsOMWuHr
z?~kP`6Y8EZ_{(`(%=3YhcVLrOhd9Oz8D$wlJ9geSJq3~lyS~-Z+aJhZsfqR6X`Ys~
z|1mTb%|Kh8<~R>Ruy)<pta~qx7Q2wTFrIIrv&LDO^OkJK&un2{DISF9e32`c)~cQx
zRGmR(Hdw2i<)1aZ&%R4;s<b#}I?}i=w<{f=<)z)5cah6M+|^SKWw$Xa9*E)eZJ7{D
zj6suAUodT-e3(-Fv~9S@S!rPy#<<CHq}h;9YgQco$W-9$m>7C3O3S5!?HAXe);d!O
z<k9IJqD~r)?!S>iu0>M!s+{hmADo#UfcFp7Ff`lJXFs8F*rU?Pew)^k@+qM8z^c!D
zhalrtYP16WGQ8aeANWM*_4%3>jk^fu6A5LEMoTGh%^}`(*)myp)W9UJHTNBsTpPSI
zo$;meiAF2Ds^$WFbjeA7>{pfvrm-SsMTLf{hPzEz&tDd~`wtv?w}PPr<!k4^u|oK=
zLRjA~x#~kMXt@qcQsrEpqOve$k?weJ;GMy1O{zR#-XFx~7GD#z?D%PUC-TGPdJ7Po
z<)g;MZ1pkI*FcN=ers{5tKo+RDp@oO?vIyI>(6{%VK+JCLSb`<f$eO${hJfaE`N5g
zYFe=z>t(3DRlyjniGNtbgo@K82#f@)4t4CK&*XlQsoGwF7Aw`y^%5quqIeUQBg4B(
z4O<uP#y>{OQPg<-iK1-<2L8Gicb-@?>;S9%iSZp+=Nal`XqI+3e^yYDHexI#&B27<
zpKAY^JITYG7RipWOEMNe$ZoJprkU`S(Ieih!h&_s0}naXX`Ya9I8V=#iiA0BFzAwo
z*a5cQ>C<O%U--zKiLJOB3_=!D2AbqpPWHw?@lV@9U6tJG?PdG6p*M5&>L}l${1MU9
zQ_Cve<@BQou`iT<*#2m0O{$r2-eohdegK`!Wym=i-u|7P;<!$&xVUs!&;>}5lgJeK
z?T+8I9wuT(IsK<R2L7-q$rl@o646j*4YR!pSaE5h5Wd%L;qfAm#E=KWM3NQJ#4_F_
z#!%NGHNE?zViOJCDT0c)NR~toSUgkmGi`~`)NmsyPQKjJy6RS>@VJJ9hsO7P_^GlI
zFLv?;6eWq2wv405GYrR*IZshrF9Vkvh8bCq662@Zb!0iqjO%6R;#KWc%pE%)w3BJz
zp88q`G2>z94G@KKKE`9qyEi>(>>JVIgcH%Abtf~*r-a9Et;$WCe2$4;nL8@0n=u!h
zG`gSdcAXdGblzRe^8nd#%tP>-UODYJ1~>>=?KnOegWvFfCi^r%e&p(!%s1NPDYh=i
z+eJ{lb3o{CX2aceWPFjc0sE3o93Gdm;KWIcC;R<YT~N<+L)!=ccAXesi#)g!sW-c#
z8$_?;aQZHyTkI=&Z+1PjtJevlw{ygZAiFKospZvCJ51c@X^EsKs7_XnG*C2}6MrsS
zm~IZU3Y@J}m2HV`Sh(_Wn|>&FDFg`TX@ufIOqtFUJq>D07_V8}gj<JZ9M6KD2%7=^
zsLg<d03tEZ5j^Tj`GkuY!QX3$O0aOu$ZTI~*AT}M&w?z_^`QTsatWL1yAz*l5ZOGi
zKjuPdQy`AFrq#w9%@cv)0=Dhw@*1^qP>qEdXdGnQdx%BaKLKrM`W`Jh%O4ieLNPaB
zbQ@F>$!9-gb}6lo7^>?-81Egt*<9(rs-*aC53wG$mSDREQvqsETFB_yxM}%~UU~1m
z8Hx4rn&3NAoR8=bNFMX?Bpt*tr`!fL`)R<cU1hoB3F3NTz+;{RkG`pppgwQ;Fpb98
zFRSSZve+L@>*3+7VOfxuN2}~>E<t*@Vy6k*{4L{f6Jk_GAL|<4&27<EF8Fp~<qgp4
zKOxntE@z~4S#m6Fh`TQ89bMIAoWvmsMdL5LHPTdL9owk6;nRz1zBo}0i#>{Xk5&-K
zZ`_{7HwF2HCxbohs@D4c{mpxJ?=Ey7i13~OU?ey?)~sQfX;c8laTC7M@{9ki9k*kj
z!DMp?NQ>Uz12z1c&f{FH0fs2`#nX1-hU@1ey}=+lm0e@*=?#Hs9Exk=0`xLQ|5pRa
zFOG%{TiTWto1|9dn@Jyevc%s~X2C3Nt#KG}-W7au7f2C}sSUxtk{WUJw7?(cE2|x_
zY-@mj7~mSBrKT!ky6ZfGU3-Wg?EaN`yUOdQJ<oQNTZr2WccYudjfNDbbnn~Jd`a<1
zcWbL#=IdPAHyzacZQo7F=G<yg^2d|LN1cJ~qW(5)s)*TCJ2T1X;!VnJ&phm+Dy43d
zWm7G#6HHz5BN@i(_q^oyU)sf{9+sCp-5akKC8opjj=qow+i?J`!Pu-72T26eDA%FL
zD%jE{e%U(9N#ZT`>wq`|KNo@TOsnh7#}0q?(mb1f-Z?1UgwWD>y`K`iW+pEy<5}LM
z{>*rju?s9ngovu?W2ne{cxy}koA*>pm%LezvhQgI&i6EN?y}w;UMtjt&5yeQWEzHh
z(z8`6=x#h9zH9ff!R8R!o396LS2=_8b!uIW2lDRU8$kz-mZBJvZI@G=_8Z9Jv!1<V
zAW3z#j%G%Qk$9Na#@Dr$UfR!2&;<BO!TmBlS&+JafcM9usu2scP%1BhnW*7T-Gg0i
zs$FESlh&+8mYlESb~2GLSj#H6lIslZxlqO=4%VJ)HeB&jG9_m=ac);d$*QpOyIWr5
zL-IZ2Nt5%7JP1M`3<*eAL<!2FneQ_+^BF)hp9M7Y(Lgg_DS>N8Ubths{+epae2Q*b
znSHGrCSF)Mz27U(@9kL)jj|+aAex~3A2worzJ9jWzI*+{$c)|K$s0=}U*FjHCpoWR
ze#?Du68Dz4ecc_Rce2tKQA|7UlNs^uC$+ofkC*l8v!eFyUH}csOb4c^MQW7grXX-j
z9or07NLW^G-BEm#Kqjr(hVgg#O$}CEg@PY~E6rJ1tySIc`<D<pfx?cYI;UVWhT5Gi
zLe_)kO7liaLhBo$V_tTaRYHs@tlM^j?2%^2Pr+K%JyfZL7xi=)Wdfo+WX^)MJsB}%
z#v{F@pxw>TCDN4wIlCwwvj~3n<+%c*jg*;`%c4K-X9-;mNBngXtcyD{eR;bLTr%@k
zLx|I)&cB_wsI17QN7h=@B6FjEX|cLKP4}#Gl+GyTNpqz!9v6Fd7wKSD4*c`+MDb8T
zr^EIf5tFn3K}=D~visbVbm?b3=;`18&wJbN?Pj)MU=(y@CTTD$aYakJ3|~X~Oj|qp
zwmo;y-nN0)jJEtGjzwd?T|HoR&gpB3ja=!~Ezupm8SPD~lVP|F=V0wd<~kdDSw&_J
z4*Vp(+Y&55{PqKOtt7(UYN6?^fKO<pmPHpXF=6YAj~1^|kA>*bcRbRY;hgU->AMJ=
zjpajI#rDmPpCfM`^BPP#5l3?|rtg|1_!y6Lgymy7h|K&?JloJr2G9cp=mgMBNOiw@
z3TJRYcJZV~bnC;GYOcx@&MSIiXgqakhNJ(WIk-j!QZ&5Z!%7xN>EDFBGV%+146?59
zZ9}H8vT(no_ho+l<6Xcn`0!RqV<Y)eZ)W@P4R#r4lk?>WrWKl~#N2!IyrXYzTkoZA
z4&ntBCdQ8U=)=BMBB$#d=v~d=9q4R?);}gv3CkGqXog|O&U(r?eJrV5*|yqq6zt}!
zZQIn*e8ej5Aq$~W^+{fQ`_o}?A@)VPm5bctKIZD;JHBMgB1Bc>&Tih-6Mj|KnzjE<
zDNr|cs{qRj?pog5y<l}W^C#NF2?J#QUW*S{4C5tabjpe#v^vOA)zSJ!t929qbN$ug
zcBB}?-k_xXuLn>fU)moXDUG{Z>;j<-KR(mp{shTN_P*j_DV}fpF>Pdi0?%$$n=WlX
zK0i$Mj&74B!l&m`wfgWrpH))`KHE-=Y~YOkT<Us)`#fV+sb$XLFuupVN?rYIM!QGL
zeWlF5+O3{Bp-(1F+xH6J)9lmncc=beTk8MXvuFSJcD$;mgDHSb(a;>a3$JYIZ13u1
zZ0Zbv78amI1Y;Fb7l8IZ>IZD9rXDT;HfdWZqsYJRqW`)}>!PuVd$>rdxcsduKt&}v
z0Dr3j%Fz9PHVJz>m%lU#P5|d$8kE8X;QCjK8^Haq78n5jR|^7w{A~$BFK8XY)Wp(I
z#NGp-4TKW8c(_=3Ks-E97EX3n2n0H>C{(?vor^QzZ-oJ>T-DIX8Nj9jt$`RiLFoX{
zU%9`A{LAxy^#4^l`M2xNe-*j@Wk+L^wKQ=CX#b6nvhIJ#{YS~=pK_vxE`~Pt=6`20
zhequGnCL%Z{LktJ2*3#hgSnvr_+Kg@U>+Xu|EPfYczfWh)t+j3PnVUI`MEdpo#v*G
zh4bU#;-X+%zS&|B6Qc#h!bp2q0C2w<!qI-+yfX<A1|cQv0>8X5UK?Nn7M_O!4?yEe
zVqx%K%Riqxytmpr$|x_!6C2Io+kJ9ueO!K=wjWn(vN~PxF8w{LXFV-H831DtMhc++
z?qhA{=BZ#!10#q9Gr5yAT4tf2SVa;r4c8vtaLatH@9z)**Deb)H&qqkxm{Py*9O}T
zgqa#m*Zl-b3xo}Dv(0p$ji{=uSVs%UAqKR1`t2X#zUsH}Vg+!(0_<O&CgyL5aN%Jf
z#4uhXZ2Av_XB@4ou=xBa!2LPh$lVdY^QK*Xm=-TMlOcwz=fQ|O`)xm%GXa=8qG47x
z%$ZdOHkd@1>_SbQhMG(KA((bZX{(X6W%t1Rq98Jm0tWc}28NivotG~V2G)qw0{1FV
zKZt-B@)jY@gh&$x|69NZ$zA=Lmls%^c2(9m*o?r_q^EDkkfP-VLJ;Nyg<EgnJJaRR
zPtk^}BE>&vGe$0FU9#G=apyN7mfw*J9cPy7t`Mx@u-cvPRA5qY1t!B3dzN5^e&Y1w
z8pq9Wy9}own&!y1W4|zcyg|X9NgX)10U4N^7pOO_Qagtei|Dsi2O{<+a)#J3T($8C
zjFq2`vOdelx51*3+AuvK^YWpi<%tQl1k!OSDq4OEvNV6G9^iO>kf*1=qG~^sh&ecL
zb2%^c^QBwTnrjbQm@eE8{Lt2#Bf0OoP>9Jt*B-nXLH6Xl`$**`n8CeeXuki=??ER}
z5dHg}O&~Hg1O}$10~@z+Elh6=yUGx-)nQPN+9M46F>uiUX((vE0*29mfw`^IW&YWL
z;wp5gtTxAx`C|wJ@b|A{oqD_^u|>D<&*h3smqJ;`{&09hW4YgkU{Vlen+8w>>vMjU
zeA=lgV-KXdXdIZ}GR1QIHlddE77<25n1MND9*CLLQ3@m@6sEZfj;$a*3BpZ5%Bw(N
zG=ydTEWQ?Ivxm(C+@n*tFBjZxd(gSPr>bjuLnw+^5<pV{v(w?DS#0gjdNm>07sT8L
zD>M{H;1z>zz@XZxtO=I~Bpdj_c4tV=9MmvI_2dA*gy<efm9KOBOSz3PR3`J*I~!jn
zTd43gROzxTnwP+=OF$6|-L+wN-)HFa{p;`>f5vB>l=49#1^fN5`9?86&1~yhxTFs9
zdUV2eoikBX=Fd*cNJN2X0j4Rzreg^DaBB{8NXH3i7{m#NseWa>ML3^np(FKLjZ_6j
zBuTP-0fr>1vUI<H2k-!qPmlt#Yv9w@a5BQ!b)u~AGzCSiOSMyHW=&rh{kkqc3F6Ca
zPdF4QX|Zq_k+8-O<W7$P5~c5t1T5oKX<FW^3IFIJk)IMIrBV#r1YsU%Qbc!pkax>>
z4)VUfufPhssJmYrLo3yUxmLs;OpUN#qZ#@mV)KWy9wQk<zyV6$-VlExcg`kU$q^|N
zq2T{)R~SkQLET;F*9nqAt-zq%EG@yd57k)5@Il#yHF#_FOEC4}TzzGrEl{@tr_%w6
z#6D3VKR~soH4M1Y>sECN!X#mLF=ou`q;OGYOj`Ly8B~!^VUi$P#2M#gkv|huXGAg8
zLDGPsA=S;RW~mg>GJsVP?|?5a`iq-4y}wwKBBMvZ17#V;LFgnlLe4o?tT6sCSERmh
zA8Eyyt`ZB~#g`v0rVoCtin<HT`6e<?H?0TIr!UbSVA*{1856SNLUja}Ev$%03FCnt
z*hWr+pt@x;2QVGuz>(-tcRj?^XqQe>a5jjSKRkyi34>QG;`?(&=GSEfq(Hzy>Oc$;
z0Ktd`7%NyHcXFP=8pf1)3tYKrrH+-)7IYc{J_h0fKF(Oj11M4OxL$)$A2L0ji3_NV
zuX7ZHyvE_(*7l~$YuF9H>bV_CA}<&cIJoR-K!rc6d*DMBuDrP+NVr<#aFc<DTp{X(
zu&6ABBD@YQpU2?de!JoeF?*I47fNd{rut2{)kF7qNoJ%tv%T@4G@%{K`eyPp+b=|M
zm+_$adq{R)Vk`f<JsEu~qN}c3<2&qMdyk+iT|QmHtI}+4;nzo?F7B0mQ0tqkTl_})
zJrT`qB7{&iw6NUrHs$--`Kv@3{n|;QL!T#f;jFsJ)rI{hUMeBBy^QSYpcl0<5@COW
ztJG|T#r-Qf$0rw5UtGz8+T1f0nyYh3;TK0fU;Ny*W}+>B%K~hnvombpE8$=9{%b$f
z>3%ocue11ht%|%}=zV*Y<!h-M>0L#iXo}IkZ?e1^$r5<Vba}Xx2ESH^$v5u*fzBEG
z(cXLSPCM-0QP{ra)1Ot|kM`42_MdrIQ7*udd&A$ZB);hpU1_0mmAhV;376B3GX?1p
zx*REp-c`CiOkRdRDTwav#Ul7|rblx&+{GeT@gA+ovGV%#4Pf)_eM`hDyF3pL!a`X%
z%}ZXoYC|~2tI<$2W^N%?z!daazZZKE;XC#ej6Jn1*qyz<y9`%t8|gjN7<UeGE10Yf
zazlN{$<7RV$)3OxUaXtHcN1Pbs$rqFU5@LltDQ`86>Oym<u1QGA3nYs+Ejn}h%3Ni
zG1=4Q6Q3RBD(<ssxS;udT7YoNRa})Q?mMpPqlv#B(_a5ejbUbty%ehJ1RgXlcz#|>
zGKbK~A5gCzT?Jpfg%4+V?|G?8T_=o%A2PGKf+z{DzGR0X3Q+HLAO}4O3u7bf*9Dyr
zU8UPJ+QUC<jadnEovW5kv;?W6YB3ZRXZlUcGa<0FnbYaB?tRa!v9WxoKO--TS5%dm
zRPwV4QH}Xzkmxo~{8)8G-u?GvW)LBo7Qo^~hbb#d?h+x<RK+rUKo&8vP!%_BXGG~<
zhiO>J(ycOibmc?$-bS}xTHXXjPz1uT7*Q6(-VI6klbbNdShqR#go|+K@fEu8<XE?8
z<|M*0t%ViZ^1%;=x<8i;$1doNcP!_sK%VbJHIrM?tb#n>X&d%-@Y5h2U36ZSogPG4
zYd_96k9?XVd*&@|_@Wy6yLvtLX|bd13Y5SL_w>li76q|jg!?|XMp)ga&wx+~h=<hJ
zm&0S9kl?bq$umQ4!6nHq8_t@L&nN@8V+O*(M)Yjpz+FTJ_w2A;TE!EPWwzBOyZ~o~
z#6W-T1v&P1NUjYNX5T_TGRlAm(ddG7s`>$y=<@^C`tw3jIk@i;>xUrCR8xo-YU7A3
zNhRy|Sdo1{w0y-;P9p5<{ZtW4)&p4Xm7GjCEVK~nwlHNi8R;KexgOuibEzdU6e0?8
z;Zc6LD*uea-Jm-QQNxd6r4$O>K<IAl+r@O!=kpxzZV|pnQ2ZLX6r{7a!74n0>ok|S
z^hPw=IBr?`hP3}PtDQBSHTNe~vbwuI<@ZJ0%A#?fzP;<CmfB%VMs!T{kcwLfm-+G|
zl0z7UJDL@aY#o-l!5{PH{uTbrKRxhOnA)1>Q|cTb@top=LC_TKH|WnElaKzW1TQ%8
zfa(SsewYlF^&|)NuS{!bNIHS+sP7UJh<Vt!Q;t^kwcg!MtU$>A(8QU5=Kx$=0TlVi
zZg?_inmTclCtt<Vs+aHY;oC`2%?$yW+gL8xXnjM6j`7rjJ_oml)|DD^a=+`ZC@6Vc
z(ez(#f{48yYKVVcH;d{RtsV-{h1yhzuGrP3swQKYxYu%;hcz`t^*irknUKI{Egl-?
zQ*c4AxnFM2r&+kktQ&^~3Y*qMtpxAoGjYLw1=m`v^3^`g*pNSAC0EQxand44pehbr
zJD%}r({^!7(CPZqsg~@S;CZwMLbBy3YY(kkk}nd%$@3A<9Lrm&k)$2iHJeE)G-fkd
zK1$Q9@X3cJk6kIkozf3D)ma^+;jqeP)gx|;;mkuFoMx{zo2&AdGgJe=c~U1mlguyd
z+u<s|5k`P!`3hH>`jyC#1+7btoV_<PVjaZNlbmf0ce|Ng@(ZrN>B{TNyHWDKT|-Xx
z%N0OZFVm@aFr60BVTlfp>6Y9e{tSel1pVnGc7JKU6UlhpK>vzoEyh#UE29%}DBjR>
zxeKGSQJUT9`j+iDc8;>O2f=$tCL`kmPVe}JjU^V?TF2yb^`grqN`1W@RarY2qGr>(
z==esy1y>?bk1X<Hj;UdT9bg0hO>lGd135qL0b)OHve7tE@=yc*mZO3GVZ~GvSo#bu
z^3th-Nsx_pfnnvoKLlxUsx$aQW-pS0eRNHT?)`n))32PSi_2=-B`pi51-5#lOF4Nz
zLoaNMyz04?)|E;zgP3i{%F0Sdfow^en0lSQsNpCw)XjUjN^mz%L^cXn>$%quMdAL$
zRwJeJQ{3$P^f~I<lYw8%z>|EgK{KDTU;2^yKM1^+y~**qJwN{8cz;UqJ9}p*98#;$
zcJ|oj^(t-vR9PjnL`34Q2W|BRMA_f~st^O2^99H)qew~_srw>KuIDmilMIK~ZFEzd
zS-LvsPgs?5(Uo|Hh_eHjdK2@DX1ZC!N$NR5u1iZd&Z9$>ZF`Mt=-9=57+QttqLGoN
zGtE6o+fWGiP=iH^K#HgFhw&w3HVTkKZyT9nOs!$mbNsK;Ut;8rNv3S}GcJv)?d0DK
zXA9P+WQ7WtluL3HE(PxI9mJ$5m-S}YoOv~3GB5UyBqu?y#H0;@YBz!@D(C2urf2@1
z$l31OjT#S<<n=wz@(PYy*T78tbwA&iDNcg`i^n~(a}vQ2bO+RzacqQNyrWKac9)jl
zP>n@qyFYOp2$v}Ye)hXQkz@G%$x*L5(Tf)1MdvX&j2cdouqK6lHRL2Q68hdS%GSMg
zFq29be>a0Dljzc)QM^KE2kVIB%ZL@4mw<BnDu=s)-beS~8cKHW!?HZt(?;ih+{%lN
zFc7TnUVDfnWyvzVAZ}K~<VIIi^3F&G$b95$s`GrlHzA8wt<Cs`>2!;m29@XY@0{r-
z?`y%To5^Z(Azg0-`*b}We&2@@BU=_OSSfQ4CQSg-R%~>?<UB|-hg>B#U2Y4$iue8c
zQPPgtaLQt*?RrUaMlGCnXjBEgguc9zRUA2m>|Aqn!CW*`fyXZhODk?c_eo*Qc#lVV
zT@cAbh>k|@S|N6}1Try9s_wEj8Z$vsmW%&yXQkz3*IxK>zkAcn+e1;%QHqml5LdCy
zJ1X#|+Dz9xJiu9Vv7**Nz3&hZwzY;eZ|FpiSZkymYFjP$oJw7vhS@XyvvE_-wmurH
z>E}&V`*SmpReH{0S^H)gn~lR3zn>&^Y%PWNM+eXKO=mC+4k^E`JO8J<xcD#+Sh|*1
z+ERs;g_T{cQs*z2pEzx$_TB^LNi1i+3lO<ZDVe#1>ZMZ4OJ;FwU#eGhW{L77m@9u|
z#!mg2`6X42W2dN?r!b8;P~@yCG@ZbxPt7wR7YnA!a{c{L#I*Wlg@ao)Q>``EB|2@v
z#PztkYfdmuq=>26jw1Pv>JC>PW06_;LRgf6@w^H5IH%GxV!B;g*@$_hT;w#}oR(?n
z{ihiND@8o&1e7DeuXF`1U?fYFoe2|+abnXn_GKM|teDF})lU|zwX5a)Hh#+COhG?W
z0(cI#Cluo!m@*<J&t%W*=cZ}h!mpdToIWcrK1$`hE1>ttLoG}7<tV|RNx!HOh~l58
zM&?@ASFis{%l&~J^NUu>Nl1?JuKs2RwXQmzh>}G%V=#>#<yT{eW`4|qLBu3ah(2pA
zd1tbTH@_@Uchu?Q=9~#3`*M$2%D^04e4bP_#gv(hxi_|Kw-YFD^XmvmYHUR^=u2yx
z>Wrs4>tRIt{10N!7_u8paD(;c&@*{(VOHJf=!RJz+<7Hv<ZkHh%{h5wMOaewmWlNz
z1lL~0WW2(X^+XL)J)iAFB1gfQi2I-F{4_i3Dif0La9^~<6d!oM;`T(~o`=i<WE}8V
z|L{5D0d@Vc_mw!2kV1TB1ZW2-HI1VyQxzR=;+Z3``|xx{%AS05y}jsd5!kGZtVd+f
zaxH(l-xt!VNA*KKG`}A~Q;Pbf&E$9e3vFfLe0r9G;&?&{^s6~{t8A~2{Y+gEfJ%vC
zN=I9fduO6w!p6$OJwx>Mwg^<w%Y0f{7Ov(Ca@_hDkt|%5+DCNAneIa<6W#c=f=P(G
zZ7_vv<YM`LHicu>==h2<%27IvrhvAGriYH2nwFM&+w;;VrzOXCvU$=6ks)tIS>G`t
z2gUWxg8@H!ec8kMTnfx}FXzpC1R}b+4c@fPJ2QhJV{5u{v=+JnJyMrj3QnV*<|>g&
zEu9nSTi5#1u_^i3@Jl07q@*MTuJG9KBD9&{<2Ssj!SPVR6dzy;(?}93=D`#yrrWZu
z!?NujiL5q+51mYOhiW-)ATm@|6}@2Rx$I*cDc9jC|DgVM=~_^RV#(l7AnF~+yOd<6
zo**l&+>`cJEpotalF)ZX_D4!Y$}mW2l{AXE>_ajG*ZKhgwm>tSMx@4{w~m_4o!akz
zVcV_vd@FwctNYgmWM|#sgMfd%w!W*g2x@|j@<$o=_k^m^9i+TH1hz30Ce!m(Y-(<O
zC589#J9`6@8IN4?Ii??qGMFQhaT5U7$`|zdB!&&)J&f@zlNL#)mEB7CcxP66Z;9X&
zCw5~;EgT+a@xSQol<G?$g-_~FXnP?s#nIpt1hls*kY$)!?TZYCGhZP&{obaNrw~BH
zK;s*gDVJ8u7Qy+Bb<I79lVug?AMPu;V&gx%Efo9UHnCH)S*FF5+pU~2Y*US)K$C86
z(FpzJVux;S-t;pPkoM*2cw;;A-b-~9O>St2_=Jj*IM%WHb>~BD8+}Dz8@)sM>&gf5
zo}3p+c!kF-EdEn}L5Dy7)N8}?{W2{englOv8R3JagpH|36)WZ0f)csqq$--<puD%!
zpK@7l%7zReNV<VKeEHW>vlGD?S=0eG+TF`_tI7{RRvd-s<vOoX$-Q>U)7KmK#PU`3
z`)=hSF)}|P$EU*d*~D9~Y~$;Zs-JarEpCAQ+WzOq943bQ(||?^r#!|lVZuKUAb~7#
z&mpDa%Lj3_J(TX#v?&q`?HrsPB$gv5ZXbUh|GZp`{Pbu>qfW=pd@#`Za|z379#qQr
z9Ou+qn$^4><G%#F?jM`l^?$p9*W^fQMkq*!Nt9(`-g0&|$!3C$Q=qKkh~qUL8LZ63
z##4RCTsKJRAcBj5Mbl#!>V8~S`lOpT<40Z>F9}D6PV=<}V_GMGn=Z{T)0&US?R!(o
zZ+j;h$A}TtY*}kkHlBIG1Nk4#lvKxm?ti-ZY*xAdF;!jt)ab6g9YK&Nt6q{#t9~cy
zvAC29!9qptB@ka(_-#7KdW`p*vP@=y)#cq1F<QVan}y(ynzLc`C!k&RWBqS#hVeoC
za!d(Oy0Jyvi2fy)bXI;t<o%~d_IOEZ>yKXW40kGd_kohT$-iQ|YUN^9d=1rp7ZRRE
z5IMlzd_W9~{5=@C`?}EYG;q>#+oSX@gA2wPM7RtQYp!awnXVFF@aluf=Bh$AT1!%l
zi_cM;XWTTKvrE1$X6`|t<*1vN;A8&2XDwTYTxCINp$TCxX_%+@eR(7`=c(k)G17@s
z4w|MfL20oR*fRP0kjJSZf70Geu66nF$1sKEh53M#Ou+}>-Ac)6rA#MQs|f1MeP-Lc
zWVG9GvqYrsa0R|i_`U@=`+oNOkG&h6{qI(5LA%BD+UaLdv+TZl#k{EAtCXij`H5@6
zxf3hz;KpJkYt#?lcyFRxGfn&{a~}6>?!n52Mz+J)@9Ps>>9Vubb2ZM;$jAT0ETv24
zitfGN;2E#U_B^3@w6mXkqt|?qoJha~t>|&!+1s=Qfrm1hI5u#T|9tX?F}`#<bo<t9
zEV{fyp<puyi*gOK#NrJgbP{#sMpYEp_M7!yYFLgQLNeCjPVXv0ygaI{`0h}XIk{;*
z)4Fk&c30@R(}<LBE~XJ(CVjl!-MjpAX6GvUSYPS=LB&y0GGWUF;o>sL79{xFPf0|p
z=TgDdhuWLhZJ434@U<H?r6;r&Ji%m=tk9)r$+u|{-(CcH-*r`^aoO<JIj~_)$FK|}
zD<qNN#XQ-A<Eng~$WkTgGeI+pHV@CpPkKS0@#Z-6*eo@Nn#lsbfQHmncbxM;$Hq^+
z5b}K^&x4W;n=2~EF`q=0nkdaIm2i?@PwrOgwofe|dEajz_T`Huhd>9ok4z4kp`+Kw
z=L>s8)cR(kWr<X3Z^S1C{Sn4F0iV1J81HXFKcBt}^n)4o1lpW_B$59d;j-&wp(vQA
z21$R!ajl}ecxQKnL$P?~JI=-^nyjvT)8&?5$-<NK2$S~C1601o)hzp_5!YlC+t7CU
z2nl!`UkpG&7iqz5v8y(LYqN=P&bVkxm*`cwq3up-->hZi_AKe$p-fM+kaf$Kbbjp&
z{#H`@y${H;Cb4?O9)`&`%YBq_b8s{fm%xm{qs&poj>gW&ZpA)h*8I(oQN(wpr4iPp
z=_Y{bps424#liK&52Y|BJwaBhH}+|&wJG5XV+o!FKM8kZeC$>xBo=tuo;K#AEp19z
z7!2<-o4DP5hI%L)FXs#R1mhyyhZxHO?9vm9UxJ5Eo_o2yPqG$EZnNf&dR&*enFvnD
zKGqI~nMtX6VJ)%YzqfboQa^NLL8jbKk$T@E>YoJP#z}7`_C(C0-*BUQzi^e@((E%`
zygdm06ZaXGoCPa#^iRPCAo@q~ZmpfK{3GBCSX?utI~_tSus7Zc?8?^rxakg6o<Tw?
z^8y+nubbT{r~&gB=F;R!k`;WnIq-7)&UbsMh}T?<7L{H@xeuBJ4lJd~_nd0qU=?p%
z@D1J^7nT$km*`X)Y4-|#S_TzJ9T8Fd6g^`5DLiVo@>D`;dDZZ<LKTsf82_T-$ZQ_L
zW$2>*x!$u}I?*;8vYa;GZDCfhM<)NEB{b{CI&n0Chx>HT*{uwzroUXL<Mfj_)!jbv
zr7(SHW_$VZ{v838rmBoib!=#+c^;24fk`{vk8i^RM@h{IQ~0du_#DYo%~Mke*;dlh
ziOpX5Ydq_=;fqIc+{iIaR^_rvEJfk8^<0h-%f^g*j+d@!r*^1WlNqjle(on{rAd7C
z#{P{YW~T#_1d&MvtA^a^YSrCFzvqUqz9$*TRnW|BlKUpU?7Ud{%lcdUYqR;cvQP1=
zQdp4~Q5dBgP?ks6eXWcB%~Ho&N1=?Bid_`O999x$Biv*Io+oIUFI!*^wt4S0d|*1m
zJz18|Ttt6gqme@OzNh`_<CL4xMU5$u_I*c5RRf+`OnXYshWB{uU1u@hD6?*bgU<bz
zHY)4Lp=V7}*4F-kf&SykRU`Sui=`D`OUpfSh=Y`$dcK_W{7qQT1HN2&I805j5Ijhc
zQl`SWTUcASUSl4u*a*Z?jlf;7C^+pr%-tD+l<ekk=r~{2yS+oT>Ev8*o3f+MnT!jD
zllWtyuLlU5TxT>uR9#~+>&7Qgb-t!tRdhl0%H6eEU+8u^vpb)==D_|E&%(ydePRBG
zDH9MBkL21J$>M<qTaFx336pP9L|k%rIOg$b@Z7WN4?%Y>R!t#p@(?^vGBZ30$Tj;D
zjS+Kd3PDK<h5=@AM(oG4RPjnJ)oR@5orG?L+7mEkByGlZ?{Xa8^5dKNR}a1oAv*<w
zJ$t?B@|`N3?|IQmqE=Fwc`JG9zc5Pzxz3PQvMG&w@4OG14)o{s?^mZasV=`sIyn~{
zaq<w<&F4HY@6W|wueWTi$WS>e$d091j)v-x_kF&2dx0|vFs*P6@x>sM1WOy=6PuQ}
z^2){MGt{LQXyt30&kt%=a)uENcIO-AiLul&8xttglz(ITNHC!MyYm7@kp5M|v+qfJ
z@cm5hQ4AAVsr516e07bASJJDn=S=ft)#3v#WrDskmX?06882%KO<h&Yp6I@@pWgk%
z6L?T#X7M^RR&46UustZS5>ma7a%0IG#L+Ej)E!G(DZ&^nCUx*lb8CRm=*^p9n0u*t
zcs&%T;rNL*nzm{-Bja|Ds#!_oA=QiT=&o+7zHvyzk|&j#S#sF8r`|4T?o?QF2np!k
zd5-iJ&yj6NJ34LvzY=8~dS($ydX{II`@wYhOQ{$n%9H(gL%I&p0#Uhd+C8DQ8Rg8;
z&)j8A@HoZA_b4^UV@qQdee@DWlQk4fAKhu&>}`^cZjd2y`n&`H_X(xgvD<QHYS7ZR
zsoXF<4xjJvUs4U}7d}rh{+3y`Pqnt3=xgi;1Y@xG{eS;@k=)mZ&5c)_c{a8@Dt*0-
zDH><B$kwgcJot^a&51~OIQkj(jyI)iwqw^P^G0a>`Y=^@_n_>u_;sed&T^DFjP^Ju
zaa+Q|=y<$Jj|f{Xe{d{!Iaxu3L}+=sOyg=OIgnA~b?)WBnJ&ji7rm&d3<K@@Fh{Wu
zyW^uCR;Vf>iC4p$gL$Q6vKbg3nVOQ1!OIK2dZl%<hkLkFvgMs3UiyzWcKG?Y$KI7l
z7{ow>_5fJ;|34dNue5jKeRu8;Qbb4pC+q?AA7>T+S;YT~P7pJ7Hg>XffF7d!Ct5+?
z&=!h_5dO!-BxY)5sP3v_Xy?o#VsB#t<*+d{cLs2xu?agH{{<NEutQkc+1a_Fb^X7J
z{*qYOIk;FM96S&xmx_z2tvY}Q#0uu&hJd-CI0HimDN{>x3l{(f7lidM6O>CD3MH^K
z7Pd3DF$DnsX@$r?P!B91AU6*y2L~4qCxC?$#Kj8a-~n<2Ks;b*lLrh2fI!d|I}bY#
z7z&2?>kSlKV9E{v{R6-7AMl00*o*%Gd-%)yPl<o~5BNubpePCvLub>!4FC5qsJI%r
z`~x{6DlPVx^KUrWq25W0soG0Qi^&-}K*1p<&}dk?c>aT|;^_<xg|wZS{a-YQvZ=Wx
z6q4czpcjT7A~l7cI8|^mF?F)EGY8QBml%|&;_BdFV`}?1sL*qvXlxpPaUj~<K;U2J
zx&LBEfB+6o2rGz_lZ!(a8jQb=b8>;9VFIyp0YF>;Z4NLG6e+?Efub+|JA6<fZfMjv
zI5{9tAszrb7{CpMmOy|&Fa!$HfN}!3AsnnAAQvYXz{vs7hH!90fhU~M$a8?%S%F}v
z`hU#L%>ia*|Jw!dK;@y&0;=rayb!McvJ=d~4wVOj{#pzML#ZGhuD@%M8^X>CVu$d6
z01yyVFH`}$E`S>Z&<3;r<N0!PL%R^D$6!vVb)4LPK`vZ8?5tog2PY>040Q;?{?`_6
z@V^!z)LN(@7le!FKSseI(0^GEh0Xj^7CJXH1pi!39RE!P0Xd<pJnT?6{w)MuxBoQl
zKU6|v!~+cw_ur8GMdh%AI3ZAg57Z1GJJhy+1c!&618N=w1br}E(21Z<L6x(EfIOVK
z(6uV20j2(ZsQ(4b`HKnq*9!gL05Tlh?Ei_6(Ty9l3jtz?-`+<sn-k`QoTbU2pr*X5
z+!M{agv9{i7a`!YqrbFveh-^Ml<KX_^rndX$*X4OpyRVpRN8TF2VCf6*R@4|f_pYd
zDX6E^a)19+XUxH&q*~ymOa3)+pEij)Ba&?|tb0E3lwCmAVDwMev;p$u<#I#e?Z>HE
z&zI0QUpM3O7-q*nO3hrC-W+g5nr?-h#NhgC2i61go?BjcjXugEOFGQKr5XdWNqE`Z
z1omy|Pf4Z&?R);a-*c;EXJ0r8C!Z7Olo?a)wz{SKK3s|5zu6X(q!toGBNz{-7e&KY
zlEw#!Q!1yt?RFf%9UUEzvtcEOXesiF@JajGWGZYV9mE{VFWnKOI<ZXIuR<+M5#FbO
zqYP}DHT>qqc(6aI3U{#I>%MCd`58~_7T;x8<t$OTkbj{6!d7*Prq!Fqd6CSv=}I%;
z#)^eF3_UESRp8cOtup?S(_U@y7MUHp@$mmlrvI0W^52Q!Z$^OTvj6u~B5nsg1OE5T
z|L=ssBK2R%)Wi^)(V*!CipT=}olqINa#Zcr>@5Et8~^)$|4(q&-}mcZYv{i*S6tAg
z2~BkW3+4(0;($Q@b5R}pp!z^TSGNtfOWNAy)B7W>?u4C5DL4R}yr>|XU?m_NDJIUl
zH8@h(x9o-_xbJ|lZ-qf3svl6kfY?(2Wnyn)$4UBz&f0tFg(ad=QhUE*x!ASptI;vH
zdJf(`w;s3Xzbf#mEvva6t~ihC)sdmV%o#EO@RtQa0+&CQc+_F4-oT)l@$=h$f86}-
z4ZFty<KWd3)Vpcu_7Mw)3iE?le={<rpUYSf4@@pRjGGX!)P=GS03UF^^3X0CDI>z|
zyM;uIj|ntbDM_7-*c5!;afWeXgTeUDWxd0>I8*2W!;TLVXD0A;hgVH`;?LGz!v%xq
z_dK>lGI_;z7XvdR5irGrt>A5>=Mi*85A%cqa~|{2+rvy`J!%zZZ4+kePjf?FjC)p4
z5e)SbMDVmS_44zeKN5^5CrlP13_gDL@^Zij7?GQG>OJJ@b~OBqGiG|2AyH9bSR@qM
z##e)yTkH=oTVdiD0lH6TO|tHD1;kl8k>6&A7503GPdyU8JW@3HheEpfFYedw@>&+D
z{C27AvwnU@0(#9Xa#zQ@w!?Z5`V$8HL8`s;rvJeTV-<@-Ai<!G79a?te=2Y(D?u2H
zy}_o^&$47v{RHIEM#z2qSm$_!`Dp`#A@JpVL?Vqpzkb}kck3=DpBiKDHNNg#o~QNA
z1(|K+MtW1zC0#YWU|y^w*r;lvFRn%ZNgKJ1c+6ktW$Uh|EVk~ZhPP^O2KKpEE@Me5
zKFYmLURnw|yj8jb+RTsQZ-}LfVX*p|1!8((*i~6ERNyhkB7@n{3FJXPX}1X^Blban
zfqzR$JolCo_bnz;mqYy<yU$8Mq>CRg`JK-|vYiei4@^ITQ+XGf=vJE{NXqVQpdWCG
z|CNv!Qz)2k__ClQ_-u}AH~!@0r1}-MW%c<5Y~J?idHCRL){pn{6}1mIO-!HyD~0s+
zc%BXiE!gV@Q~G$dI%d{qq-=f{hjI-|MHmhYvxLTBi1jfTE(IIUkdz-TPZ5S=9Yh~G
z4<w=t^ymu-{DvqBz~1T9@i=R=-YC~`MIQ?FtU#d*o<D;b3hI4J`OuCb#i897fYBG^
zk%AQopu8~P=EurAgYYA9Kow#<zoqPHe-G@+C{15~>j6E~Kf+|2n09I=QZ!$O2*isp
z1X#R=H(|9p%}N6?3ER7Xz2vj-W<vQLC9nN_dO{B*z(Mj?_?^^q;4rxo{}4A17<;G7
z#RJ8x3*$?eQ3^VC7w2V)MAZ+H=uRaMY|`xLqX08{*Z|3O`l(4;P1MUDBv`RIxe-_a
zITi4{>k!TlH00e#NG8lC9ZE2eeg+-tcmt}bSn>^8o~l0qat4ocnI);2=Dh|eOs2h>
zZ<uI4-MwR5<MV(W?Z7TXkN!Z;8PB1JhJ0o{)ERuFZWhMjfkC!L&J9F@k^DhgD@?)}
zoIVulq$P10Vg(tB=`fqaa9*b;f3Mx=xEBI%f>_hR(YI$YC$g|6073H)CV+$|!5a{=
z1a3MI*LHvkKMyMo1k}C3L^wuX{JH|)?sDmmfwg8!>ng&N&_O*%%Oz_!FB_dsz9@_p
zi)9Hv)#cbsMAfZgLUUP_X~U_C3<(fd9A4}*+axUtVKx${O(ZFu3@!P>**;q$^&QLf
zED-b#W=`^St2Y|~O9YiUA;aM-1|3r+T5$)26ux(>l9}S*E8!LmkO*eSsFp#}w1Ozj
z0A@yniv|6w25ILj(zIf4Yc`Fd+{{E<2dJ4~B0EGkK)H)qnB@b9?!jRz^I06(>-Voh
zW*gYQ@4$R7YHQ+wuW?`fD>t*OD>+Eo{141t{vYD*GB|E7O%$-1nVFfH*)cQ3%*@Q}
zm^o&)V~!m&Gc(4_%*;%;GxP1t?9SHK-uvfPSGiPD9~~W#T5i41+a2Ao4NtoCZaTg8
zjN6<bT?C>2qkXp^U8DWZ=cvyuS~h?;Z3rMw`K3=z>Gd+sUc(0Zqj^xEelEx4F78+c
zmgqbw$XxAZK0yX{c?0&>M!w{>!?Do_rmz+|<c~WL2m5A=_94Dy4kC#DWF0tUb)8sH
z^M)EIVSK$S%SUq6m(26Ygd+$wpcWVg*2#FqA9xAlBeAs#vWeoMxRnWlc(kM(KdueN
z(REE>kMT74A@VVp`8259_^CeP<DXZB`}n$4mEf4$y=Yw{wPg*03*JfNV9(rXG{oPQ
z_?%<3w!XE~mRQph(w5Vje%Tt#3*JfR5Y~OputsrJgn9l}B<nLB%ZO(DuEKfyqP0fj
zFm|ifDYkX1R_@L4Z4rIfIWzmM1#0cA-<;h?e5+UscayAoA(UNVecam0aTkJja|x1j
z>H1iv*>645r=#0-KE!7|v)PXN*M})f6+^!j;j1Z2C3>^jy-=t4)=A)#su&BPN6WQL
zx4+uynD&fDn&@dpqtm+T#YfY+zJ+w7kGXb=Y&qelLhH~}>-?yCJ(Nkg%7xXb1<R!y
ztd%0rONovGXFz!h#>doh3=F*m7x06YVca%Oy_%NcQrOZ7jDzx_0wzS`l9<|crr5Cw
ztV`Jf^&((I=29`J>Ba^rfz9H8i(=UJRii`mi0du|DUn@xN|NEy>}wMxeOgb~AiAoQ
zBJfiukiXgbva^TUcP-Dk!ORi7NzAnQtqC^kij^{#=*nCk4<N>ukObtnmYC%QIKYPb
zm!7aFV;i?^K_upPhPB$iZqd5{b?u`ZbVP8*iRN}AgV?uD57;~H#<U>#6~H=&t$I{e
ztp@hla>*LRcISz%`5cksu`G>*H9I;qh9J5bHG)G97^T3o+E-u626AdJk*@c$+N9a_
z1cIsx{Eh%sJ<E-Ff1$Yb8(89;7<i>H&VYR_q_`E}G`3<XCe!wa1Wlw*Bl}IuG#v=t
zKZ2@*r628>%EU1^XdJ~n7&`4m5Ql-~3Qc;;Br>&&4AK|HOvm;u3>uDHo&YD1AkZ$5
z7(~~Lz#V$-7^w0v&l#F0a+=|{8T>v+pxVyff?_??T-Hw*)gz!vsHAl&bW&3JNw60_
zNk|7Y$%w>RV96{f5Ght_y_S@_*D9bV|MftBOlF|(9w8T<p=H}ZcmZx8WJ!1AO^Nq=
zq+YnbsC|yaei8b$j%Vs;V7IJ-amRTRKCFV2<Wi_b<TEIiO?Q?7d)H1KKJrp(3CZg7
zekX9QZ3oABLsg2&YNio&d=|_0MGIl&6O9(DCacPTSKNc*tH|pq!a>?m+L6a-`mWBF
z&B9Rg1$2a?%47K_^va5;AOy9fFpTo|Z)k-?;QwWD#$VxP>Cc9Dd*aJau`<{he@m+e
zpRMQKS#&FCIr#rv>TWXwBZMP!vzrRJp*+|g6bzfhSIrH(aO}(Wev+`)X+$h;w`czD
z7YXt3oF9~wN6_SOZ$()9f|ORKuW|mKveKY1ga)AR8BOW7d(U`TZ{K=YLL8yFOe1Fn
zE2r5lb&Q7#y(yZ2&i&kv&^|2-wxe3`)3N&xhZTLTI<*QXRZi#KRa?Fv>G2Cco|xEy
z%2{pM>e|-lUW0(d>@e2LIt9XqKH<%<R*%>v0_&m#Teuxs?h+(w3$fZUS56yV1lb=Y
zJ&YspQyxM%yzsJwf8n=NPvZ<RLv(`AGesX$FE6hG@GmJRUvfJhe?2(CNBZZhICDvB
zNTel-50S%+$EaIwlU+X+;Han&Dg*bN$qtW(_3!11sY7z6mj>z&M6DH_jm5={et;)j
z3BN@5a-IvY9?rRMdY*6he2E-T0&;iY=(g^Ue<bi=bKf&T&633#x#m0^zBu#R1>B*w
ze5@_N<x_gVxsjPr9yO;T9PxD4opRxKYc5_x7?%Vh0D)+?>h2*yZ6R&f?O<pS6O$q%
zF>t@*Qwl)eIZCELb`WO|HPN@JoFQML5F$}gm|Jk`0z<v{{Va$Ea?bha&w7ad4yGW&
z9CN}Wp>D(4iRcOwa0YIe^$Jn`L;QC9nA6Lu@toiFtr=<1-L&=AB9R&q)W<HIEa|r-
z*m!}qA$EZfQ^&l?>OgF?BP!*X{73e6MuKE*cq$FNt{}%%W0#<fq`B#%rrHE=4~XH`
zeTd{e!_THl_X=qB0{j}R^9UIC7hVRO-Z{UTK2PExGUfH-(NULU`HT$cR@C;0LI2j)
zi|51B9RH8!Lq^oEZw}A3Pk}%A^zl%0!;N>aMo2VGkVeWdi}FQOBb94Y=t!bQw2bHU
zfvQW}Cy>Z<DG^VxD-Op@eyS&PQR5KDYGhG*6~<uAEKK7VNF9iYIu6QZ@sY=$IsXWn
z?j?rinUbGmp-}x^v!ls!Ys|9HRS}pRYe(Q)S^*q>EeFbx;x58wb6q6<McmM%eiHjA
ztB&sw_C;K~!<#?I3r0Q$g`Q_TLOD9mFh^<^N0f4%wQ}0F3>$~%w^#n|y1T2oyn=nD
zA?If-n>g=%bry9*f2t=Y?H2frQDYiocv<v!>}n{Ck$jK4-D;r>LQR}|k2|NI;Ti-j
zd{&-!@=Mr7m?DNw-zbT_nc!L?Oc157DWshq<j80fJ=YTGfJ^f)pNCQt8Z>A99-Ic=
zhjKN1jBawnz4!Q$cZ@_u`$TH}mijUW>B=YC_7ibgKJPv{Ru2cl?E{5$0pl~un};}l
z3lF9cu9i3WwLfgm+vffRg1S|}FUY;4e(+XV%fbcf2QLW^`382(1=m+;)-)uZQuntq
z?vDjjd`#XuCY2?g6~;z)uCCTCHYxXg6Qo=%JYIS`EgwgaAQ2Q9KD(6fX$cwlGPNv_
z=7`eA61AYbi|~jN<^EDW6dx{|+uVr)UQg$J^sA2-Rm(Rstf-rQ<#)qLRpIxkX?TmR
z7q?wxl!UFsb&W5W?7SG0wDdC4%b0|pnZ=auxK6ro-Hq2AKMaCQJF$#Jafw!Lfasn0
zDVt@<)!_5VLp0^u%+lE^r_B(?t>DhS*jY;y+l^blMy$oks>>S~Eh8_F#9^tdEQ0tN
zvdIQ6S0m+sa3|dbq0JydCPMGIot`&>D2p5<4m2k$!Q?5DL#Gv)d$t!R3ri`I)QV}Z
z##g?2)PB+t+?t=G-4`Bxw=|!uHQIn+cF3I?BQfph#YWX+Y&*^V%AtigW@Ei)TVpu=
zrO)DbmU8*5LS;7QA$#MprG?CC1cLb~xM(0e{Kv^Rm3j!XAtr&=9_Op(?N&=>vt8%t
zqq0lEmQV5oGWqb!OI|kXlQzW8o9m&fwd-E8jRm3{H?IB=`wzMg976xQ(CBwp*Vjbl
z01;Qf=vuENlBJ!=z{Gc}8HT(lmJ0B=wAF2BB{vIr$<?we#l(igM+^ox|1>G-D%drW
zXtOk0c|TVl7&;Vykr-k2f{Uvuc>76aA7vX^6jJz|Oq#&m;zw0K>vs=S>IZ~=T>G?w
z;Bm!P+xdlxUuw4N(sS2SF`q}x#vZdl`bZ2sU1+*HAS0AYySaVaka|Ab6P)@U*Fd^+
zSxF=xB%NJtiawv`>N~izLUNR=#xeGal@|hIYMBK$B0Ot5G6+o~zGbR}ygxP?1l;6K
zWU#jv3OlEB3N6BL&LbiREF?r!Ljhs*jx`N^c=A=DX_rn;ES2~oH$n;gRMfPrbBeYq
zQtc5^%RvxfcR5>fNk=EHt4&qfO~!3Yoj&|7pSRdGe#^6r5rlqE!f(~KcQ5E;oHiPr
zM*Qyv&ZheZhcq;tnEjmezVCHYdipD9xle}oBZBY8Cih_`E4yQ<f*(&e`$C4AfKDFa
zC0@&-tir<-rXkALTb(?~qhYJuXc2IctHs05MnZv&h?wSZ&RAh|yYu>1)vxbuPF>Hw
z^FHieuo2_OdGNlpz}3>@`un~C7FKE-NhM#0*lkBH_)PdadRk^b+6*sU9PeG!wd<|`
z&jr@P-EYDH)19{jqUizaowX+(CzUC<L3YX_BwR=IH5t53KQR$G%G$4Ms4|@Qleu}f
z*+6?pw;4*x^-~NL2D}E~`(W6?wDSIT62*okj1W4dc`?~TakvP{p5VU&{5h-Ch?g-%
z)C1Z>Dgy8`${kR8h;&#pnRI>IHm^d61I=UsaU)mH<Fu{v5N`q@iG|_0y_nu!#z8zZ
z^UNWr5PAiy73u0EU0`uil-wO;(U_ghb#*;&0_<0s#qhIRzMB(2Pz|z_`c#m0Md4jw
z!ZXU9DX<C4c&s8Fi4YYlnQidY(KT7Rs>+=vcKD`o%+l)D9#HW+FeY5Ss&kCGchr2V
z5hSmn-jJ5eW1JGkn<M5$gOm*gXF^;Epg|3h{#mPtA`Clhl40)~FrKgQ9sEwpCz?Jf
zSCM9frgiQG&KJX4Q==OS=NgjYM=AjtrbR6kuY|K-TiNNySKGA>^gwUMd(wR)Y$U34
zfiV?N$}imp`i1A<uX+{Yl#JbaYN(BR`l!?rOGJI=(Jp|y25+z##quuQ;ibdy$f*3n
z-}Ny3DF#<aaqpv<iaA<Nex97+@;hYJZ$2Ygmwv>0$Wc<@=^EGgxf^buzB|=VL0r@b
zo9>_2(*+}HH$drPjT;bXu|QYi8xSx@Our8Uaa^%W9ckuDf#a%8Me0X&%<2md_xASg
zhP70bpol}hT*klefjMW24~IsPW%frf_AA9pG$v3e)0##2FvpbW>q+*G2+iaMpCe`V
zD_=V+!S*-vYEP_o8?9-V8P-FjP_v(*$Dn>4v@lQ$!l%^Ij={}*8@7n7Lsqs}dCplx
zwmFL|3~O^biu=ffV-+aNJGBv2IMv&LpecOT;jgGuN0T2fZV;LcB*up4r31tp@PAWj
zJD7f}9E^+Mkl=KI4;0GuX<pv_5NJ{s)i<n`O*Dx<5dAu{YS>kp+;X1&5gT3XQ`e>G
z^(_ZoQYqF)_Val+t_?--z*g6_{z+M|;F8}q5#9`p?+V@{8E1l-RLBv>4{@AoIyxg_
zDy7GlFBkLLsxw(e{B(nq(0_cD;r`T8B68Q(AjI7#NHG;X{Un%X5TdlK^vfa}yFwy0
z4OA5kMkS3T^kSifTOtPh_`#j~Qw-EFRxmPau<lnnmF%RP-))vT>xxAnY;%%D8DXva
zNc17a!`Duc7*+5Ibq&jRQd$&@GbuCsH%_+r@TUFWh{<3&3I&U4eCLG8FkzFZPh?GF
zTZJ?W8Az>bLixfjM5y4T6eH5-JR>gnMIgSD7iPgd2_+Gt?^m=>RBgqjzFcz&GBw|c
zO`Vyfvvv++(w>SV<jK?~QK}gK&>>-oF$>zyS$>2>skvK=9nab@IO5%92b=(tND%si
z20W?+a`uVlvnZa_$>jOc1Sr%oB*ukpBPNy<>GbpoY6&HUIJKH9R*o6I6kaJg25w7I
z*4kp`i&<(LZrriHj-`aJJ5G3tvlv<J6r!b$!g55S5e_DX!9&<~ZkHKw1B%sjtejHt
zRN2pjDhg2y-%1ovNm>;W4fmjHq<yFakdjT12^lj6xUZ8fC<>&=B1j6FBE0)C`i8#S
znzSNAg5Bj-u-^-Ug+BL6#mq7RGn5o7nrQ?ew;F=10hc0#2dC#f(IF^gnFk;GP5mOU
zTlp67DkIO-tGf_)q*p6kzTWOxfh8@_YIAp4`;=DV?)&0mIxx#Sne*~CR+-KJV2)xR
zgcKgS=(Ai#Qb2J${QWfAFsHveXk4YB)!Jr^E?Va2FC=`cL#;1hvl7h>7PL{!yo*+M
z@`y`6bqb;?@q#KR&?m-=Mlh{2J_m?{K`FDOsaO#`!ZSmSuw+6_5@c1FzDmcdB%!ej
zxG`bNO2jL<VB}66+=dYUD*SrGI>YLulZX8g7UJPZbZnkNxD#V>2t(^|K4Hp<&-*;N
zG_R2Lk>>NIyDR^fG@q`@EgL^p>&2lF26a{T#@B&WzsIl!$fI*zOd9oa4a=jd_^!@j
zUSf2=i?IgH(sdEzT_g15QJk2lsEJv+8pm<b?%QwP#vU<~RtCm5UcPd<8WSj(<f2BZ
z!M*`_+wy0-eCsRQmllh<z^mtMiRrNZZCh_wk<zR1m3KD9WE|WxP}FOLsVO;b-Z&6^
zvDm-+--EtTX5S5Z*ti^1KHB^HZpRMjf9UxzOin%fS!xa$SK*bf={)QYk)2i5eMZ>7
z8Vqk0!J3UnM;*C4eU1p475Z~H&6VW}-k9h-1-QHWFXey;wK4)T6_AkiY2@m%RIpzg
zvOP5eF5?&WoTiMdLDAN86movBXiU<`FjVW82=ifZ**mbn><C%?QoAN4Cn|@f+Fu)x
zyibTwUOP{Frz>IGE4Gz!InPa09yN0YSA`&R8CCOI!98MpV_?Q~r0Y47zVuC0{yJEc
z6!ubOsT;yI`~L1oJWs4G`n$S2uv=~FL}{|Pz#Fln>+vTSX(!5IKla8!?xyFP2W92M
zCarwbW_%~v$dRZ$A6XA>r)sftM1i~#3&;4AFKQVoi0AO|F9R_CZti$*<DA%W|1pL`
z+R$hP$g`-Xn$;&&oo}>?DMH0CtaNFa;<b_+n97nca>kZ?nvv?EB7l4O7P?f#c=0|-
zmV{VC<0so0G^+2?M>ZUpjG^Erz`Fey*UvM```AllMd%`iAS23B7<tBR0(|oF3H~p(
zi-v&nGuqd8<Y&h^Z1=8gRQn{R=?jTiiR5h(jz%cEjxdoY9NEOM`n=TOI1Y3!8r7Hj
zQ+1KpQyBpP!jcR;hLUMCZi62Zv@{Y?ASsH`s#z&6G8_j~q;yT&8vAZzx?Ez^J<Fpy
zV<J8x)J--G!5N_|qR~!ZQdFkwA3l6O&*C<Bg59ee`Z=rB=@pPO>%>NB+GoIELsbTt
zz@u5>bWZuCK^`cz>9040{W&LAr1FfX0%H)>EWe4c5nhx@cjyeu@ZCbB=-v1`NiKw3
zqM9`IQO!b_;F?M!$q~>WhtW#9b`w$Y)6)YT8yofS^v@jpEDqFK4cmR<O!`gw&H7FI
z&B;v2VkPefo{W4QJ3aKjF)|BM2yzHA2nq-i3o;A3>Ya=NLfA)}N1sN6lOs-*PgQtT
zjJ+ApJAOWX%U{ZG&VR}e_N=+xIT)Cd(ZFeAv$K4g3BIzv{f#?<w4P~O$W0BnF*GOF
z(Vm7Xvd>+vv$?3FpO_#;s9bTbKV`{dw5M4Sv^-c<`7BB_OHPtw<ZofL^;xV9O|ZP|
zcv@(yyqO1u<R~nDf!D)75*TZgva1$igS!_qh?>u94EA2&$|&Fv3m9|NZvLuFB9ZRK
zf18heTaU|q7>3F6fH}YrQxPYoEa~N3Q9j<&FPr2_c~4PXi1Q4a<NbVGqR*kH+lBX_
zwM_YY{atF=x=%~X;$`~wFphxVKW9UePYw@FFp_Yf$8vy|oD<2T{*^Ar+!P6z)JI8C
zSdG~`#5Q>$zb>WPjP#59vO&GKN#X3~25vs@zyR!ImmbraVG^sA<y`B}7b^Km<}6MA
zJTD`KpRtFOe7T=5VT7GIpKrmrwv1;eU8JDlE{jog-U?lQ=5hGEt5y1<$|x-nOA%3U
zw;=3Z1I5yI4iL@g%OGy<u<8p-nIjZ%#y@_qx}=(#L}M43o9S(<ow}~Ed{b~{DaDoy
zPO!dl@TqC>T(VXmI1jxjQ0QE6ecCU{-DtT5w0ZFTuCvSij4nsqjvPj5xMDWAB+Qrp
zoyOdBE0ikjPzD51i8kr$T3yr?2CXM+`@p=7E-L<hUZg~z<J>+Lwyj&ud^tVNIBb#_
z0|d)OJu>sH(TTA@)N%ASsR0<au!M*Bm+KFw)`ZH3MZkj;mek4n@fc-TLUybygVwxX
zmWpZ=!xXcoY8Upk1m4Dz+sCW|-ikVCVNw~NG9;X{=f60bmX3W@HU;=Bes6TXk0|EH
zBRNGqwY$!Cc4)&{XCVmrC#@lYsQ65;NtKT>M5y*sw7Do25VH)^sM{cnc{FWfvh^`)
zL|6Oh6s)gtmaEzQ5^QRiH>IhM2jXHhX_ZyqzTNXa;SW{0r;uhQ+e&F))(mx;Cd4&=
zi!O}XtY_o6@Re~A%oMa1ZxF=ySK;5DScj+*1I`>B?FR8RD4)VLj8W1>C(ffsu#vjv
zC?QbQ#<Le2Ec_B+)FJ28vLjKP?wS$6Ro@5+CQ^@`H94}RKj&__`O+ykoySDkak6et
z#-G14Itm9rHrb2Wv}m)|>1#akU`EU!x9U8EuYK`0-<efR>3{zC`7%<RW#+XjQKI1Q
z@^p7>Kajd}nzpp~`sjO_?QJGY*$0Ip9x9hRZE*Dn1Vqd6%sY%3Nb@6GGTE(TxmAi(
zH4r+~6weeQvv}nYr-))5Jtc8kb&r`<zKY<e_F}$noJXIE*3R!{B!i!x-m_}T|5CKI
z;#9BI^faZZ$@Q!BMI}9JR2L`Rq&JXB{2s?C#=DQ(vF!s6USSp$oVadje*J4q^@8Vq
z3kv5fN8QgGJ!fZUR@zn_#+I%Ne2MHm2zZ2-8MHp@F|Tg($2pc8G<jsiUW%_f!BQ|v
z21(@K9Zmw13i!`5k_wsx42ucm>jWGH3o=loRV;BXOVEC!yaXsqW8Uo7M}8_V3t2x?
z?314;x6mlTS~(HQn)-SOmgb(-P4<#lqgR@I^{G&$w;z;q0__}s93vd=O7!oRe+zW2
z9qyIr!OGcgkJ&pBf|dJdv}W|Jt~+&z+IyIyFmGdUJI~vwoC?(G>+0t;KxG$q-p7ue
zIyjROKfIP_08e|+bFSO_@RmTV+QU+Vh+vveC25&+fRtpe9n!)^jhj${B+X(uLJ*6;
zaUF;!#IO7kdy@fpHo1xH0TZ9O>NhPb3NL&WVnVi0IU%E!s+y~sdnZ4WUU)&4jFv$_
zH0NC5ql1p7Afz}W-r4px-=s~DsoznsUlU^OUSA(=p;Pa{sm9;3Ri%$(bSsig%;7Q?
zHPvyetWHk5^4fhzStUtN8-#@A(=kWzHl)0|LEG>e$(QSOq_DqmOE^qVyJ8(~+ub|K
z*&qNn_##q>fmyGS8ACU{-wdjo6EEl)yMG%SP8Gybs>7f@I`34mrff#vl)O5Izdz~J
zG5(cs8aq#4-?H<<QT=$3zs;KCY`HEkvAI8FQZVW=BG!D8klX1)fe`<rRo;h;r{8^t
zX@r=#UoI3UM+dFiwtW0fj`KO+%U7k&7v2*Vaqx&?%(ghJbug88b=7-4Q33v`L~xKr
zIn5`8oj>-C2U34!#%VroHm_sD*L+b=%DQ<lG11-|U)5m4fsPgwpT);+ge1tWN7}p2
zOL2h=JV}Y6PckFJzoy{6pE4A8C6%z2y+5rc;IorQ*N}_DPWH1kRa+|*Ujv(k3Foop
zuE5@%y(YhdoRtd_#JO#1$50KT)S;8oI&&$pUamc(UKqU8=mJLJYcuj!GEV)8m5XTQ
zv)Ubbyyc;z`H0inMuZZj^p8{U#d}R{`x%JR&>jyit*FK?+K^@M4Ie2V3)?3Sw#}x^
z^C*bdWDyV3FB&hQg>AF^zM`-F4-qm^3Nn(?6~Afd&=+7b$DUlJq{-!Kf1ul1NI>#1
zgOD=A6lg|gWaMy=oPX5c)E8Nv&YaBh%=W_OT}|f}hb27fmxKk?v4}d}2WPANDl4|f
zn{Is%6O`q@QydAKO{q$6S#5ev7yM{7A;hg|QplA`^f5*`^UbX&TfMyR%+BWDk9B+=
zi7m|7*M8{7apndK_z1BNL?VT#bsh+86QYDnmY&G}nH0F=vJ8*Uwr+2xu!7{Vm7F+z
zXVvYEC9sIkvv$=@y&QTuKO&+`p%zQ)ds@+mNlW{TaqZ`-?mHhmq3tgdRW>3Qdbzaf
zn<B^2unFJiJFR~2A0v*?npwf|)lr*55nS98&UGAGQq}taos?<uw$czx<j&fuKc_q6
zj6J%Wc4DHbo#V43Zn$I*XnmU9_H?1CX}Wgo-doztWk=rljuWKXNev7|=b`Aq16!n}
zMwlk>iwh8S97($|+4m#|h}vr(%{FCjHi9DTDeueU3DeIYw1g)=?u^Mi)A}s6-$gF`
z>*DCU;xuJu4P+>!nlOdm*<_8cr8!Iz4Y{ICsR|6xu!D@3s06fbsKFJ5inq{Gs*;4D
z(_`wEL48tG3&+ETq_9(Jo_%WSQPdJ>%8kCZi<E_E)kfG2nlG{XB-ST((XrE9(wHaN
z?Ng8%vZBge#)J*~?sbapY{--k3qn8YR6>G)11WRRg3vxMaE5M@JAPGJ*3F1?x5S9q
z5c@fhFD3pm;yUOpou^if6J2*;nUx=W6$^-UX8Q{LhF2yAp&bymi{rYB-7@xsY4lbH
zwq$XY9Bo|>K~RSi@{M-wovgg1I_){mx<tLPLxDWJDsxs5XB4%;#ug60Pr_2*oWKjQ
zOJ;15ATRC;#TJ>qB+7%ks&Hz?{7L+rh=15$4so}HFH{Ac+-y6;NGUx;o1YCtRFf=D
zIbXGDz?i*EOD`i5nl7DEI>M<op^U;38l#FG60)vGI+ndpAToAPX?*CWS>a|xU|;QC
z?OZKt>Y@&}PDAK+8UIcGSe{!y{ipoQMeTTi5liA^Pr404F6l%(p;Cz^LG@(ARM@i#
zvhFv9YI2_%RR;Q$v3<%UF{>7>V)|;j8nv0P?JJ$o9Pu$OpbIsJ%}R3KYS%@JT1_kN
z-3YZYc75wMoSWq53GTG3<y9;GV)}heOPTGOzC#<*h})EB#+}1S;Z#O%$W<X8uo+!E
z?l-@jCwAsW1V8u5Xm1vG@OE8W2&~_o1G*i68pF{8L)Lb12V#1eX5&W&Ls><jPm)lg
z5Wv`U=fi7iENV%9wdN0dW{g9rY~dH&7+ffc)jq(47npy@DKW!fb?~@1q)nGSj`nwv
zqkL*X=1ybHlB7$>Oxu}oTDaG=?T=_hGzQR_!R`$;G}yE}(5;Sgj3`*2*5jLCdMDea
z>d%}sSioZ+mYGF-L45ofpTZ`)Jz}LV({773(nIX?olj$;#$;)5i%LKl-}-vF7^_vf
zWNW=$D1!u(3j733rqj0a99r4VJJu%2J<-;w;9O-DTf2#V-Q!NIgXX$S9B3qRAgFM=
zkc$W*i>xYYNIrorVKB0F(xpQpW59wZB{Wh(s=;#POQ7Wlo=L+chGt$F0z%LP5JKAp
zP?%iPO83%|ZH8Fg2}V?kdEHO>>MLoVF+1*~`qlCb8e%GhgK92sN+ITDyOz-Nlx`!0
z#8ZBD-uKpTR|@s<{+KD2SM4ewm69|oA`MKLvj+{PtAiFz)~Gfr^Q9|z6*G-<jXei5
zLMr62O<HFd5?I%Yl+HIy6Sj`pr04Oms*)s9Y&iqBY(;Sy<>Z<P<)w|C51p|dzECEK
zHW@uEPl~qHfav_6^g}tj!@unz2(Oh0U(%{1KyT;bS8N-ZAD9tx1)wj8+<&(*<?i2t
z95b{CwP<%}w~aZax<>j&lIk-Ole?sFtO~3u6{b=vEaf_=_Nbglk4al6SB&cId#F{^
z%xQ40a`HB6Hfp-By7S`PE8MesH3`%q!L($9rBp-{nX$*&rBz>#z$3=wCM6SvLXMx8
z$6?qL=rTvhUD@}CMW<)M1(awY|Ga8voS{2O-|yfv#l-8^)e#1X27~b)6hS+k@70@%
z<W-T-V%7efAkoh;L{>Snb%`FQkL*K<RgxAY-(bOVPJ)Z-sfed&vQxSkq#k`wAyNJ!
zQyq?eeJtH#TDt#LX3o{LQ^HYx(W7;$EBN9xV<gh;MZtC{Vk9)KtF>_w7}R(BjTQTJ
zi#1u}^o+wfCj0BPMZ&CQdFHY2fgedzU+${ox(M&Cz#?7aDUY4NyP1(xkcNmF+jsO-
zcdRM$$4C&jSae~&xA9aw6y&fxlrl9khA>rZe5+veD>aee6J_+VU@p>XNvJ)Hiojke
z?}LH0*x68n%<F-V=KlPC1=MRw<U#hLlBBtAe_#7sm1JD&jE)g2AD0!Z%VA#p^wW}5
z)kk#jgavl5_rYx5W3A7q7H*8w!Rp`8&rO>Gh9ZlXJvx_<4LTB->8^^cuvme2*6Ob#
zqW*8;3|i({o(TwBB}bQ4+SnF+Cg=Q%I!HqPn+8tVT+h_)P|Qqt;!isegZp<Oz!Aj#
z*rqY(+U}zAx+K4%Y8OKG277@dDsTJe@4-vnDS4vVt++d?;EZC~*av>lnvPa01_2(g
zg}t>&JeMw4DR}Q$%BA2<t#f)#x$Le(z;bS&pLuN&;>|YO5EMA;=Q25QiPEfd`6bkh
zQ77BsNqm$ZKWxNNa$uV)CfVVcmw!3GG46b0(*O$RT*cmj838Heq2^chH<0MKQlP)Q
z@ej%zPGt)+SnLXqtc3lz1X+w%ZW(=AcP4GK<8zU$e9@*(v({cuV^mM4_lkz-Kr79W
zlOE&5tN66h?a;Z8@o#I^ZXS?jNznO0o%Rg>R!F%lUr08FzB9w`V*9MRUA5`>W8+8?
z$~9hWj-j<x0JY|0c@rqldg8P!02oWt7UCdNS84I1kWrI>Quz)iW~L$RWYJg6-$k@#
zI^9^eBv__hDu)zs>Dn+J7H+NaQgRA{B-xVBC18i?O;QZYq=pH#nt76RHjO}D<PE9m
zoj+7|z~rJm-?k6yG}|of6_%fI?iy_;8vm-6jx8YLuIdZ;cezMOz7A`(j)hCn8h1m*
zpH!285qFhjFJ*90UC*BR#NOZDlG%#yDN|_wJVrf+1<&%OwS;A9c8FL&Vu>oBX`+lu
z{-8Dvk^KepC})~Cv#(ahG`U(z9dYI7G_&EusL%K8tJxVse3?A4cE^Sn^CUTs<%WAf
zxAC_L2UHhVgDCIqApbki8!X5eEI?eEuO(qt;V(m2e%JvQ_N;t4AU-%6Pb{CFz8@)J
z!uW_mMg$Pr9$2cli&sn<6MY8Qw%_Dez_h(qTOJ5};;-jm0v1I|lOQCT@nfqe1`~CF
zB6^U$><zjwXFR!j-yOc-AQqi@Y++S}lCHrgpV>T;`@v**t+qSGvFwga-y8g1H?*4)
z#dhxlRs)H1;^Z6U*;0DJmE?SAfkpU@SD**ptp|5DCb1oG&CP3`<KMkEtHIU%(xY?N
zi*)g=<BVvHsv;D`4Jj1&m2T|H{`2*^$^#q1`%__!GMwle6v_YHpHEiB?x(L)e-(WC
z1QmSG>Gj8abH`Ul5`I$$0<~!W5L?7q{ak#9`JZ<EvDnQn$>}F?=?_%Py0rc8Vb;ul
z@?!p*-1w*2_`BiwyIB$WuVw|X@&ARZumM~F0H&}4;->$vxe5yt13Q3GFax*>2Ovi$
zK&!A4F>?a20DxrxbOr!Iu(2@zEp_LgxbDBS%HOhp{)+|plL7SK+WhZY<*$^X{|qtz
zZ#v)~@#z2mp$ao60~aU2KL8rX#?B4M3Gs(Q{DoEktcQV_m4g#Nci8@T6Tn;l)^)7^
zD8$Oa^mkN5^e^lF!=?P4v2YP_09LTDG6C2M3pWufz`6X#8;Dq0{&ly1;LIO>!p6Y#
zN09tk<^~WFz|a8X$3K7y2P-q6%0Kpq9iWW<n3X^5g_9j%L;#DdfI8S109b_U&v5;D
zaREl0^N&R$;sl@^fL8%*;RNUrK$}?s$Hv6^4;{h*D9Ht=js<YUYz&+n?0{JU_#wK#
z8psK#m-`QT`cFsr_apv`xBTT|0BYv%75;NK>}&w=^EWH=&vhICDf2h(13*^*XY*%*
z{%ggotPGrgx*Gt20R7JT_YPqPz##zHVgJ{)+yIBe{D-grO8-Y04uG!V0!SEu!udy2
z{tzN&z<B;)N9=$zg8R={6R`s14%43#>t9N<|3$+9DQ*8T(*IodFH0<du4V$X;m?Et
zu%>^`kiU2RKL%cxh=q%Z6Tl^yn3!|{qyA?euyC;gSkiw?DRw3{7J$70xF!ykziiZh
z=W+f_)Blaf;rcg^6U2lh_V@wAm?;*lzeh}52qb1S9VUGX3<eRY3g?t1_R)C*Ctb)O
z#B;E5J#L!cPD8`%Mc~`oQqgnkSDzhp>f=m*1q)YTs(fu{^Dg~lS7K(Uq=$b0eqvZ=
zBUnea&G+)nu-(i3kg>$BvpZCbuo9GWC9o^&)~hf7rID_SDezvWnr$Edj&5`_W4|Lk
zK*C~G4PQg><@F(JQDNZG7r62}x$EpCzD{Z}_~H_<21zgywZdpEoeD(b>!WUEqs-<9
z8^S)%egu+qp(Jy>h%$&2<`;+&Nitoc0ZOuhaOpz+`EkjXP1J!vc~c_tLg*wyQS>6R
zjZ{pW5xnaAh9UE@DP-1iDkrN4p^7e&5mJ0J4=O3@<4lU8mH6N!@mXSO^m(?zIcp%c
zxI8>I)4~w~6;(6%uruC_wcicQ%kFc^vJYuDtB`GTn!^ewbW~%q!|XsATyKNbc5(QY
z_LG74&56yJhNR-KaSgf$<juXekVT-qr2qcm@h_(8561!g=px{n`-j#2h4=o===?Vq
z(ElyZ`CHcJ|IBm#Ord|tz0C4ws{R+A!wdk9f5hYez;igcSpHK=<aJMfov&Y8AL|zC
z7Cu}N4$pkK9G)fuXNBeBLBnA_w!-uCi&J7EBl7d}q_oUT_riDCnVGEUpqvw!hoX;*
zjm6U7Gj@_R7pY1qtnnl=2T4vje#Q`BxIaMPpDuWBP947QzWZG0WpylUc%L`q-oJea
z009F*ssf2zCs|rzyZhYP(Exek0TnY+Wj1A<ZzBM`kO8$fZf$tCAD)=-2He2|!P9B^
zc`w`E#j5-PIyqgw8<G0}#0zxL@cvNr3!{R2GYR|$B4l`rMyrFK)VThXFQ||iX!q94
zOvr5#g%*@hC`dPak?G@_zlFLFERZwk_nD$GjB#)Ky;WAAD>Wbs>P+`fr-&K>peuYJ
zkIO9eMy6KUQ$nCOVIZfe8&legV*%(U;O|to&o^zD3{#%FKj40N0q<!5{rCZNegOgI
zyy^TC|D_L~2pAmyL>PFBH5?cZi%3J_QGyA!JLCO52x!=pgdm_nxAe^IHszDUywx>q
z(o#>!<9b}@@Cx?(PYpx?{IiPY75&mPl6J8XU?%FeRt{^@I1tFK^mc*(vb(z{V!C_)
z%t=&L#VR@rOOn$~(gzW~>IF^EZXUsCiO!;ia4LIEdcH&do5=yz^F_SJOge+!;G2Cl
zGgLkaAk^`4U2cOczJS)=x4pQ?;Yl30>E-9MLwrf*AHU>%S3y)LK}h3rEpAHpxEZ=*
z$kgYfaP985WPMcZ@?<Y&qNa8g`oKC(f1c-G>k4~?jePXLO!6XJAbi;8D`y;+YA^v$
zL0jvXaRLp}1^N!6XFwE)2_eE`B8;%tgM|eP&IDcDJM||Ma!WN<N+0O@dNDya5L7qO
zaG=uSfn1<v$L&E6zJt5F`(yfN%X>J++uZi2U?X1|w5g&v$R5Y9`NXLzjxwJr`jU$J
zWEh&?_6?<K+ExvlJDPPh&o=npi5(;M4J)LJE39wW)Y3F5Zj$&;iVUfrg<oh;lb}a4
zrAuA{UU=_mZL2vnv@3kAaSgN$ye9>g{kUu_G+Iih6}?<Z%g;Z(0N;X-m@SA)Yv6J(
zzJ7QuKwwsB+ap^CWe|E^t|?SO`z=85dJo}xzdA4S3wo_T^_>pVYU1LxT(m|u2;*1>
zO$e^xS_f4K-mL%XXbD>cY%;S|+<4{n(d}w-*MqbUf>?ks?Rey@<*+zj-$bzpb9KOy
z1~NcN>IH<E8>W=5%d)@Yj$h!TUiDsW)Ew79+{a$GzMi!*hf#%};>#dG0vQ_+(*=4m
z;j8tsr9ry)!Zbst^ki4V759lW<EnKVovy%QGa<1ULhbdiXh698T<TsnG<7U)5W<fc
zaF>5;Gh|*vC~`pb$YZ1n@LSLVh7zLiFcc^UVchF6YKBzn=6B$v3-(lm0PThacc7#T
z2;2%$szyushH2N*xBzo%MO<F}vmFyd1R4%tYgFk2l%pzFE7JAS%quQK1{Pvd`lQnk
zWel0=fEbgyS*U_M7g*slw$tvd$>M}r=|BR^mV_38Iu<gvneafZCafujhQ)7a@Pe|D
zz8O~|bduwA3Ws*{$W*dwqTmJLELnAE2Icli`@nC66*!=%?HrQf>W3Kb`AU+M{J`e;
zIHg?zr0`^F6yk2&l1-2tHGuR41{%#vrwd}Q$ICdTR|LJ((0W3!34pK0cI#&G7|OT7
z_k<G&N&NxCvn}O?VAdmZMT2K3Mbtfg3qON^X$WsyNP0x_^BbumsI~#DCggebH{fZZ
zZp#h%*FFS~k(rO@>g1+dN;$tPw~fiJKztx1#y^rsVx#G)F|l2I=Gep|*Fq7YX~(7=
zRw3bjeCVRjSy2=?$`Bgw@H_$6%7k!EGHRGc&8ET0+5b*JO%`W6YcJ(+*IiLQaSO_(
z!42*Tr6WY)AW@DHSljTIYvnPw3{QJdsv$m~I5_sypb^8I5O*e+La!Up5$G6@0k&BW
ziU!2KkBUN&xJ9sPC$zPtCnBdL1wOF$F^Mub`yEL;=$Hc>T%Z`z)Ks6>O~M|;clAD)
z4ZF}R-}-M~&V1X$<046s6=5Ywet=*(1_6<6FD!#I2pMS@uk-L4!V)=Z>{fT^$L<!q
zk-@2fqVPTeN5HcHMVM8TXw{)P0HG}7$SmO5#iY9uR`AZXihc_L3F)q!$3pQC+uDbF
z8}fUzW7lidm|%o%cloZ{t~ku7wmSghmd6^RPt^}AypaCQ|C1x;^PR;nGxU@C3O7*S
ze9M#5?`sr3piX=c-i)@@Z|i4cj!y$EC?8_<IkY`p&~I;5HE+&={xJhnU^yM2Q&4YX
zethqT7Je@*AKW+!^E<g<el%B!iO2w}L`izJtM#@kf&3N+BDi9*O9)7Z{_8pj&t}tP
z_ng~9Wb5_P^36B!(sGI7N;hzbkmKo^>n%?54`XWZC?B1QgZ7cxnx20u?&bvh5Z;QX
zHw5q)!$01M;cANlSMX>M)XnDk-EV{B>ahy_dh>E<Q@wie;q}>C>`CkU`Qz>{kjHr=
z=LxEh$nN3{rS@Z%&UW(XF0!iulr`;dUCvtsm=_pN-=N&KyI_6vw(ND6sIFRc5k7Pv
zE}XXNc;P>6^w%u6?A;1)Hp>U`OP`{<&q4g@s|~f;?5TQe6;6G$*#s(ftJv0Pu1e_*
z->3t%d#gW20^9Yr5<zP!&CsfT4XjW;+-e0X@agsEF2yORRu2*0-ws7xT@$U+U8RB$
zde2P}uExc^)D(|SS&MIzX4<?VbK2D!x+dqUry9)nK~&xB_CeU8X;3=^b%!nBz7YqW
z!oP6_o`QY!4)1oQg<6BFt;JdUb!Jo{Ki$qZ^8f^s#zi+I*aqd5ULfsd&26&0&ay1g
z6LZ^8>?58Dtxhw^@CAlPYWF@!>N<A}<F5hUv6ma(5<^XW9h$3HI2{rPM~D=?!PUoI
zl0aDS6et}g!9YeNE<zUpLEuAZIt(uLtt?FrfuTS#a;{gocH5Mg&4WQr4mvch*%($Z
zdCaG}C5w+bIKV)$1vWvod$P-;a}C5Kf^U3LewG8FJRgeibrcas%Vh$C6>swpMvI+_
z+t~$=#XaBIm3FZ4LnCY>ye)7Tx4<N11(P_$_Nj-J;G8v3H1#aV;+yJjH-iyQj)CEM
zqN0qoqJRvdfjwC9{2kb1ri`qrS*g3<;x=we(PIFOOYHzAwNJ{h>k!!YVienLLmFqE
zy7l`GOTdK$0hx<yegYD9JR>{^gxTl!mvOj$0F}ZPCzwJ?%Q-nXX2uHdsaNGxi0Tcr
zA|q@jRDle>Rpl(^P`RxGbqPX*8Um(hX(<1U@!Qbfim@W=nvQ$7K)9r=uId&5QOP=r
z8{hr#Y43>;2po~8RKQ5vliQd2HJuq5fy&%7ybBGo3qCj?e#;eD^W%2OA{rTso=N%#
zB}<(5ppnTJnz->ksHRC$<>?Azt|Pv+7zWa~HZUBrWL(dmyxBUOikI8jvxbNAlsw)Z
zhfuT4eX+3w8zIYI35pFhSfM-n&uCWU)^U1mK-k$6tU=}_Rb7(6rOA?IKw5C)4;<Q~
zlM0<Og1}tlm62V@CJIg7DP}(Xr+`1Zpr8Et00Gl#G*+6_o4`;kWSwRMVn7kinc=;Q
zN)VP6lsq%Sg42%qq)2vT*dJu1rAfjT;Dez8s13EdZT6QbFThB(npwr032dyX@GDo?
zOAN%M*F@=;o!JOpKS_mHNPlC>Gla(4XbR25Mm3nkJexsthnTwH6Jg2y7QzND&b4Uh
z#37PGmMRP`(@i~U#TSx|78WEu4*0>@<0ic`(Sm>c-K^5?X}Co(yfA7vpt|!FF0;Q2
z7}uj)qTT@RL)>+qeCagb3iZT3Trxa4frw){{d<x}5W&e2*K}U40_3}md6?fv|Fh6l
z5St{aB^&&#2984F%pM!LoZRe;P0M!~CrgGuNrh<lM_Z&TGk)!_6nCSsgvd`9Fa15(
zW&U8Lv4`W&Gbvje+)WDG#3t(1IolPERl6lQx7qdP%=3e`qV*d))23GKRa;&l$YEeF
zAjE3Ww*VI*fggB^h!&7G#{Q9M8w%Sx9H~>u2cyo(EoIN!xmrh|fG_zW;3vn!qa9>A
z_mZwmtd1(j;ZpNv1s0ag*NM&TaQIwKlFsr_7wyZ+R_-Lf&XelvH(%W^W@q2MeJ@o3
zgaPtJ*r8uW7VOYpGeCduF@b_+3x6HZx`uTWEF}}9w3Z}CLglQjX~$=igl?^go#xS_
z7R@euDg*-~tU0FS(GpDoV&#z|zoo?H8_Ts!b8`QVcMX#Mf`N_aRTp28HOIH@<XuqO
z5CycvvVnlsOT?Ha*~<in)OQ19>x56KQHs(A0S%Lw^?-}#Mdf1TArTs%jbLd$5l_p@
z<hUZMX)a-!O-L`RCWT^#la4IVXHI51t&&gp%yb;Zxxuy45I7Xp+3zlr&fBl1?9^Sp
zFz1qMSlW)iWB7$BedL<iwN|M}aHkTsz*P}jjggbW0K@|&JO$3n=o^6*e8a;@N|6rc
z)M@^FGCq_-q$G=Y!Z=*GLl7f(k%Ah?$T(IOJJmoc-N=xoxw`cyHt2`Ai{rtJuLQ-E
zpX){)<E8(@0ll%OcY%kjd*rRYOSpaehC9p5qmBL2=_BZQ4Z^}u?ZJ`();hve-8l;7
zH5}UdTFc1cB!LRE*91A5k?)txVT>WU$rs?ITMTn{4;C(%H!v*oxvBKCL)jbWNmW6s
zNJ93VMMY3S@Gta$5PeebYUTYh5*f94>3z!#xzEBr;~U?nWyPVdjkNkBJfG4R&uw;v
zK3~(?)x||3zcJ%*<v~~l5Z5S$x)qNm+#oGWCX-N+q<vwDKur8CA+st~@U#x@RDV8M
z2`jVOTottqoBEn~pTAZva1LhRe(k2%4a67?^^%__uX3uBTqysln{OB;52sEADIr2O
z6)vMr+=DJTBZ`lm7mJD?O3Axg*iq1zr0o`f)p67F3)DZsRMH6~!lBMDc<uf^X9W;N
z{Jzh)SmCQ9OH}3eu-@vLnTw7&AlR?rRew5rBiFSii5U?;roQ>L_7;)R-e(2hvweHX
z@rRjQ@cN95`KCdzYKfXiwhBlIjd3WyuKaIM2L3tZ6Q)}4h?6s@r;Z?ae)19XVDFya
zd4$ZvGQZy!rtPR0h-XKzt}`sqY<a7`Uz_YC(>`9aT{r(k>OxXT`yHNkkI9kP6a>Qw
z)<-_ek(cl;zfGn)2!>Ut>0@#JoZ{ChVK|X{iN|o7A&2S4?>as=a2=y78jyyLM{(^|
z9Vm!ZnQl#8F27>}MKR3urQwuPw$kiQ%WJS<zcwMduz*XXUAR^>Osdf%sEJcgb9QNX
zA%o2is#})KTpYbkj7X~61&b_QV72}*R;YQOPJmB*RfN2~V^OsHOrXz9|Nf)Lp<yz@
z6}e&Zg=)AOF@;4(Qwf8!%IgiN<>Z-#RcCuK#&I{4{vMZO&VKpoqo}enDpdq<8RS+L
zGV0eKpv~8OOa77wavkuKNRTqw1hf<hU1%Z_UE5NM74HSIKr;J7Ayxf&hCPI33)@f>
zUQ&^Doj=k{1Hy<~&?(!f28#1k0gkZrIsZjnn=?XcuV^ed@`6^sePFgVR<P6W{UF<1
z-tQ%~QkNpPtaYjy`VIF8^b-RQ*{lR1Q;?WhSgEx985I@vhD}?9gcO;vH8-Y=bvWvZ
z?$_-i&b==xo3>Fo9CgidtV>f?Hr~;%FxfDl1&4d8jFDV|CQ}cu^Tq4r?U9Rfn8Zh#
zxq1ybi1cAJQ)yY)7%WMj5#?ZBmUxZ9YktU7afpO+VNMgXFGhebL7c7JQuu53I)ZlE
ze(#{VmwS}dcRKDH%WV3_1ZQV#^fq;|+C06qVI;le&un_Pyib*u5@JLzYjnQp*}G`T
z^ksf7LqZh-SD&}zn}oyi6cUh+^neX-NBZ@mIIXaU++s^v+Js2*Q@q?h433?*ca3yR
zteY=Ejg>sYdSxAfhy$Khd1b3oaG^%KWB>&QTfZbsTSn3$*_q&6NX9jk5R*!!cv6ob
z7+ts!E&GgL+*M`>?0%4yyjPsnc*e+JaK=tf<&j>EeD5fy@>;su?#nl49Ei%BnbMoW
zPf298*^A%!1h3}UKyc&2$Lk}nw4#|+owLCqpEH{!>na~!n`+J<o{O79aNB|O&Kabp
zq3V(07_ggFEjlCw=fIxXxVY}h+pbUtU)r^<dN$Op>HRStm(ka|*P&EK{hK=?Z5V}}
z_3)@F{diK*79)GWmOvY(1Nr?-d_(=X>cy7&fi5FRlP(NV#c58svFAa1Ta6`ZvLD-q
zr%SF?u2U>MZ?YbJ*<M}x{MVIUqjbmO0qr*uQr46-|D!tO&G?ML$J{Dzr<3lQCWNa8
zT4N^eJ80{cHNs0+TQDQFrX}N)s!_y2YQIP{Ir%+mSH%cd9cJqiOCoSK+6|mVox-AO
ze#1f4uOZ(_So_gJD8<rBO);caq9jDK)9`AiWppFjeaDhbW3&M~qWi*UjcOXO<%698
z4Vv-bX0L`5pER&iSr}1Usv>7^e2^iahQM(I=?-B(XA*wBQjo>MCN?r(Sx9pk_;iA+
zrE{-jNERu^%Qhk~I93=Q&v}wvTw`i-hqUI^$ZE2Z;kPl&QLDQgO3RBBjYtO39#|;k
z1j_auV&w<>QlkWi2TndtKCTg-ScjPzjo|`PU#cm!!NQN8KFJi*Z%!%c#%W&C+Tw37
z>5wS`&mhZ9_DfOdUB0iQn~d>c98=sLtNHJ&zha{$uV=>FQW$kUK7PGZxK^xdvOM0O
zzakC@)>~cuI1uo)YautTYnfeao2pJvz_mew3^b6P6I3#6P^pOh>E75cfDX^F*i6+%
zHV_@N$ji&Z;)TLH)`zpa3~aQ|!9RzRSe_HiTBHy>HQc{4dXLEeb|rdB+cpX3VKuGo
z&+A@Z=x5-}D)+jzn|Mws@SL{cKPKy_>O<d&CSfMKYLfB{g?Ay)_g0RVPfU+xTm{4X
zQ}pXy&#=|puX&8}IB54}VI157_eL`v*N6PucE4?(?n@#8S{n+}FJ6@`w25)!g4^m%
z;orHW-h$WLO`UoU^8Ni?KW_&VVn;7FbK%JCb|^&c@vdHeW(jtAzui^GQ|OPjO);hJ
zL3D&M;;k{yBe*vxUs@0=<b?%(8Ny~*^+;qa?(UkxWW}r_TSRpwi4c=ipb4+b$b?)-
z#p8V((1vY-GT(o>|N8ZGQQZg^|2-~NZr1F(A=x)9lVLbRKtmPe>vP|pX!uz*xxWbE
z?Ln##p+u+^*(H!<hO6R>>%~<f*hBw{lfWtY6_0|}-*Tt7q9r%A*;iIqOmmWbsJkrQ
zSbE#>7STM~0=N%bD=@J!I~otfG$WwX_IcuP6!Vd7-}G@PP3Ko@`S8r1OegQSIrx31
z{_;q<OqR7IrTBI{{BZbS!@dvM{UT`x6(-z+Rf*a*Ll$r4F-nX-W6=ypliHib(d1|3
zVQt}I9coHp&MJcc@(h<c(gLMli>Bbk@2#c`m}u$c3aj5ThqY>oHR}^UraGuvPVGB=
zh2^N=SFI>Gy9^v9qRlJyyzvRoP;C{$&kOQ@(eNo($cLA^8QsIvLr?bkBCan{;*h;^
zjqFR~_!n#}uh8<opDiyCh|aH0Wxl=SxrMbIcadyBd1YJhYo>Eq_pQLk&8b!{|MvN~
zmEtX#u*Z7;vL8S>rq%V7?`mnQ#X2GIu^l!P_jzr6Z7CVNW0VPju+%A`$#2dvLd>Eh
zIeDj<;?LrVX?<-c#3T(!@#$H~p>?KU87$32ESqd&yk3m2WyaOs7pYy`_#923Opj#H
z0*TRPKcZ{>D<gB(z2fQIxxUmI#J0?PFL~3=_WPPHZzN_GM@u7SKurAF|0(V)!`gh(
zwvV(0in|9XQnWxI1c%}d4estz+}+(>iUlbSMGKVTUbJYTI20&aiuX<X?C!s^yYKFo
z=g9|-9K&SpWHNIfxvn{{-<kK62n|hwN#4MICO1$N$JPiuC_y8LLT6PcD#U(cBWdA|
zS;|LRH(7371{jP!!ltB1tQ*fMlFO!x7#*zuC#yk%Je<#Xob<`zY^pbnWA8cP#l3tU
zF$|Didx=!GmVjTh^vEGH*#pZmw~Jwo%3UT2Z%pY~1WinU_v_{PiG+zH9rQ!67njE_
zy6=!W$7_<iiUG<j_CtaQMj4uzHDwtB@*X56<6Y|3#O2`wMn)M<PYt}dRHKc@&?o1s
zKASK>BKqq536?1W!9d8fd~YOHvnXiq31i!f>O{3c2XQ65T+4X5l#6hi3tp{(4526o
zv221<?nbH4N<5ah^{suAZ4K0f$eeI&@-o3}QYfM2{#r@5$RLMgBB@5{m)&v}%bz3c
z2ndj|+&0*z9zLs+yDhP{W4bw7vezT<qbZR(2ohTHT*JCsSEf`lqc&5+7(9}zQA{2#
z;~-u$rse6<JLpZF6P;*93x%{uXWA@nWRnrPK;$|U53`&5efN3<`YM}7myp;$AcYZx
zhH4Y_n6kTE%qyU(k<QPXSz(hA8o&eM5gdh4O5s@yhGRy)Y)EWMZ1-*SZS`&TZPTe3
z+%Nx#|13l&U!@dZE2NUHt`CB%imQtY!PUl9$JI~z_()vsd3ZG4EW@WaoS-gGDL0xY
zxiyCKRTZ_6u!EsorTE+ZdTCTgdX}Ek_0z?kva0Kyg=)2AzxNHHRkvm>^Yv?Mt1ZUW
z^XN?9>|LF9`VY4D;}+z5z8P>=xTjfy@IbCF4A)uojj6E97Vgiu0tuCL$JlowiHJ>G
zKKM~3lnc^WD-C_2CDziq-6@>O0{A#jwa5~_0lOVj=U!a|ohQ*R3SGFDyDQ#^XA>MI
zsTgf7BFbCaVo%LiRxCwIWxQ>+#xCnsR>WA(ckebOHSdM)88!Hx?>FRaylEU>etg@$
z<FnG?W2SU<V{gy$l77WzCt`^d<U*eED$^3!L(xOHX6@kopk<u2ZIpKf2d*(TB?ul8
zxSD7q%2qQrQ2<Efl1Au-!XoCQ)%melT>C65eB>*a@d!Kjx3X;#a0oOIOd=8F#0k&w
z^oNi^6`z-@jMM_F*ZPjfH7?zN$L<}LD;)ty?_*lr*s4g}*Cp-U+TTSgE;rF#K7gPu
zz;4VDDWVh_#AsUKgHx#K{3sD99>*xk1ZI)`jE?aw<<uAws-zVQD@M~_V-DfvAx5;4
z0n9B)r`PAfp@#u<x;kv9Xlea2>s5#f?ajMkSkkQkYN#?URfY?%x4BIBtC`Ju{frt1
zNWa%qX6n-2LM0}@v&i7e`EcAyW<!$c8_wq+N2ll%j(Ch3VHMyj+t!0aT1pxT3gi)4
zvp1e@I9M7;op^Vg!J?jQLvQivK>;Ed4Dy*q5C%kPH=Yg(Lq6WHrp#1Z#&%-uH`~T&
zt>HF=PFofHzE|#r#737>YfAF!-9e|^hx`&z)&m2}ZOo~omjN*|)*JC3UR9&0APo0;
zG9t96e_|}<(0tB9E5ozo-G8Fb-)66W<>V&tCTgD}W`vWy_0!O~?x~DIRvk0EfoTO1
zjRw(v7@*#0lPWoj{22<(8hrf8<1Q*zhoazmgn_g#W4Q~{^U;U>p?U@?>1|Dzv`To+
z>Emi5A?ymb$pi@nM{+aF!YO2wmnQr04qw$Pz|Ks9e$Z9MK;vEmdI`1_i3F>cp;BB~
zeP9TWd18O?^IQP(_HMxQ+&#*r{1<`GbA-@WJ!=+KAFHRg&6Z^(t1qgU$p(wzC>pcH
zil2hH)S_x>7a)`&XN3%HFQygG84&m9o!Q={)@{Np+XeI)l=>Iw=1Q1=GsKNguc=#!
z2y1)2BU;B@pZNI0+*V4LZDn1oCZ>bKC-{|Rr>~~&ylKb>!>rdEp4y`5j>tARwmwj=
z<=Th8%WIT~Vx*qMqF~3?pIQyow-s8VVLkM4I0UGXwZ?6^G<@u1LU&f4C4jt4f}8VH
zyLrca(DKp!bAm~PNBp2!KXLv&fn=O4BxDPK>LWArDHCxufk^6YOO8i!0ixOGu@(W;
z8JYnRm|oV2#JLnHH*pq$Hpf5_+QhbS=F~&lauaE~I%Z33Eez74QKKm?XgFTkbP3K2
zt3EG~B=e)ug96QcYx+^6`NblN-R{WOckgH9^axv=`D1Y0;^{|nQX_Y5SePCVa^5@b
z=8t8A*xINxWL?IrIt0jm1-r2EiDEhh^9W!_YUBa{4=@_E1Z}_=A*8Lqk&3s?c<KR<
zgqH55zGwCNgg-xD^<t?^b)+^iFQ2vieCW)}<t0%h(*l4zbxq0vgX>{5g1TY4nVKt2
z#t_Ej3zH0`&LwlYF%qzy$Vq3Ixsaag>Ar)}kReAzG@qP|Isj{BQ!cm7RDmgr%#$oF
zlTYA5r!$B`C7n20bP5L#lgp`@4je2`7i(SwSL8i<R!S@svL2QR79?UP3S+zki(~`<
zQ$m`>G$Sw{FSv}~p%uGU7Vka1-fgX-pS#h`SF|FXz&z4#+fa-8^W2@|54Yg&2k-w}
zv?cnxXiMJS&i?PhEf_HPzu^pX0e`TFxnMBj|5CWc1%nZD@c_BGC|Q6okqg&%6fKPR
z%KbN7EIS(vbNpQx!wx&)|4X>_<3#`G6aJq}kAD^%{QBuBe@xFWnBjjh3I7l({O^mm
zcwq7vw!dkG{zo436ReiwCy?~NlP&-`xqjw~euvfmC5|x}d1OfwoSgUrR(lB-h!m+3
zZJK@GPk&VwrwlcEj14Fl#By??@@d)O*s{Nvx_?oRNp{M;0sR=&rQM7J=E1%s<7*qb
zz?P6!VwFpV4z-g^Er!8rKV1#ZX9$tcxaXteQm7>yxb(jm^Jp+EXeBw7MYQZkOf}U}
z9u~V(%lhg`$?84ds8XbRxOKo&4Io~rrviAU)>ul2CzX-bHGB?-ieTL%R*Wim%psw5
zd+jSc1GV+F+N&>&E)l_cF#q&qgMruc;n&<XB4@Y*VV)g0M&Xu{ogG+}>o`#49r)f`
zyD!b!0-?g942EGHI8_{>8!yqMFQY$xicDq;NDW4Aj2)+C#af~YKcNXU@g_C*I8Xw-
zS$^hy)Qg0>A8*j-)2tA}le+RoC+T_~q;4(E=a+Wl!Ad`G-Kx(G%!FEb+`$!b*L(cA
z|9;}Y{=5wTv7G+Uz5I*y_aACsU^2Gf(X>BS$j>|DCtU8|(X=qC^Z$oT%L(H8MO`(j
z;pMC{)AH@$^g!USKVxvj<Ro{H4Tb7(aQMhk7!O<Qo)~fj9Tf_$w3Jj}JT+m#GvVHk
zwxkJ*)Q<QGo(YZ#5)R7RQ!`;&>Zvsq(DxD+wq7L+jjybD=Ucvx+>30~ZTDMhuzSZ{
ze=fMac)hst^%~&y0`Wm-=mF*QN@E3hTF_+<q2>vqMs0C>e$vViCIa)rj|p5~&o2~M
zFZwuznc?SxSaPfvxs%mb5Fcm3d;8dmy3wDFBaZiJzi<4~I5PU?g1mD9QNx$m(#}HW
z`b)JCoCb^kkW^92TX5;f{W%x7VzC7;5ce#JBEp%Ize}S_g=KTT&mAUQCc?**^U%>8
zZ>}7qBNVumtI+eUiojh=gw}dEzRCHC4?qV%IsDelMUL)hPL!Qr9U9vb(sSEb1jOVB
z6fDlydw8fP6KLdkrO4fI<ES<d?}3qzt=IZX;nxa<yx4_TSb=bYWY%df!cYCU%v^3F
z9A`ha^m?2gHom)gREOr!=atfNpuV8twXf^2Ttg-|wI69CSkZ<6AI@=nuag6pr9FtC
z7v-^8dxEo$^2Iin_N1dRu6Hv^J8znE?d_GTYd&EAHsUKik_D4RY6~6q^8nFPT}Blw
zx%9Zj8Zx&+c<YHskaHfYz)ns&+;d#J?mDo&e0CFnbUa8NmPsVM1KpxeSLv-x@7<#h
z$?q%ys0X5E#)jGJ?_S?A`We36w)1(p>_#RVtL^0zgo`VycEVZvsaZ-$L8RLOfEIlt
zuq9>qwu_d@r(eI_VYz6UbZ;A<fLW*Uq#0-W^H$}_H7crIHsQ8q6oByUI(2j2U9-J>
z&)4`XC4(zbtJAZm@*noUIcWuN3rc=Vp?u$Ybw`I@1K(Q)PQf3dGL2@m5IQK~UgwlB
zZVPlfwet=28xbOaI$UAqsLzguVP9VBU2HdBuqhlH+T0)+TM4<X^oOmtT)xp=m+_i4
z@e<3b9^C8(_k~S>FWbIl@^B>`oX#FuU$CLdo%0Dkdh-ydL5x~sY=fyFl2N4GNYpU*
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

literal 20066
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%0DNW
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


From ea9f8cdf01eadd17c20940d7636d2fc8f0e0b5b2 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 10:34:48 +0000
Subject: [PATCH 072/102] docs(flomni): FZP how-tos as Markdown, updated for
 the PREEMPT_RT loop, move-ahead renamed to move-beyond

Markdown versions of local_contact_only-howto_calibrate_the_fzp_scanner.pdf and
local_contact_only-howto_limit_the_fzp_scanner_range.pdf (original text kept, update sections for the present
flOMNI loop). New section "Move-beyond" (FAST_FZP_PID_LOOP(0) < 0 of the sample PIDs): mechanism, sizing (about
half the FZP stroke), Abbe correction on the FZP side, hold (5) now reads the FZP drive incl. feedforward
(flomni repo, branch fzp-move-beyond, 6a15f68). The PDFs are kept.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 ...ct_only-howto_calibrate_the_fzp_scanner.md | 183 ++++++++++++++++++
 ..._only-howto_limit_the_fzp_scanner_range.md |  41 ++++
 2 files changed, 224 insertions(+)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
new file mode 100644
index 00000000..3d29d0b5
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
@@ -0,0 +1,183 @@
+# How to calibrate the FZP scanner of flOMNI
+
+Source of `local_contact_only-howto_calibrate_the_fzp_scanner.pdf`. The original text is kept unchanged; the
+section "Update 2026-10-20" at the end lists what the present flOMNI loop (PREEMPT_RT, 100 µs, branch `rt_preemt`)
+needs in addition (corrected 2026-10-23: "move-ahead" → **move-beyond**, see the section at the end).
+
+```text
+This is a description of how to calibrate the FZP scanner of flOMNI
+
+Rmemeber to do all modifications for both directions x and y!
+
+1. Align flOMNI without the FZP scanner. This implies disabling the
+FZP scanner completely. To do so, in OrchestraHMI edit the parameters
+of the FZP scanner as follows.
+(a) Module PID_i_FZP: Set Param FAST_FZP_PID_LOOP(0) to 2. Then the FZP
+will just remain
+statically centered to the capacitive sensor position in closed loop.
+(b) Module PID_i: Set Param FAST_FZP_PID_LOOP(0) to 0. If this is
+negative, the FZP scanner will move ahead in a point-by-point scan by
+that amount.
+(c) Module PID_i: Set Param FAST_FZP_PID_LOOP(5) to 0. If this is
+larger than zero the sample stage motion is stopped if the position is
+reached by the FZP scanner (which is the case when the scanner is not
+active). Zero means thus full compensation by the sample stage.
+
+In this state the setup can be aligned, and the affine matrix for
+ptychography can be found. This refers then purely to the alignment of
+the interferometer and X-ray detector.
+
+2. In the next step we perform a scan (with a small beam and small
+range) such that only the FZP scanner is used and the sample stage
+will not move.
+
+Before we start ensure that the Correction Matrix for the capacitive
+sensors is cleared.
+
+To do this change the parameters of the flOMNI control
+loop as follows:
+
+(a) Module AnalogInput_6259: Set parameter MatrixCorr to 1 0 0 1
+(b) Module PID_j_fzp: Set Param FAST_FZP_PID_LOOP(0) to 1 to re-activate
+the FZP scanner.
+(c) Module PID_i: Set Param FAST_FZP_PID_LOOP(5) to 10, so up to 10
+volts output of the fast PID is accepted before starting a movement of
+the sample stage.
+(d) Module PID_i: Param FAST_FZP_PID_LOOP(4) 0
+(e) Module PID_i: Param FAST_FZP_PID_LOOP(6) 1
+ with d and e it will now stabilize the sample stage position at zero
+(f) Module PID_i: Param FAST_FZP_PID_LOOP(0) remains 0 (no move ahead
+in a scan)
+
+With these settings perform a scan. Use a field of view matching the
+range of the FZP scanner. Watch the sample stage position in Orchestra
+to ensure it does not change!
+A good range should be 2.8 microns in x and 1.8 microns in y.
+Reconstruct this scan with Michal's position refinement code and ask
+for an update of the FZP matrix. This can then be put into the
+AnalogInput_6259 module.
+I guess one has to have the matrix found for the interferometer in the
+reconsturction code, such that the new matrix of the FZP scanner will
+adjust the coordinate system of the FZP scanner to the system of the
+interferometer. Later these positions are used together and should
+match in direction.
+
+3. Back to default operating values:
+(a)  Module PID_i: Set Param FAST_FZP_PID_LOOP(0) to -0.5, for up to
+0.5 microns move ahead in a scan.
+All other parameters are already as supposed to be.
+Default values for the sample stage pid, fast FZP parameter are "-
+0.5,0,0,0,0.1,0.5,0"
+Default values for the fzp pid, fast FZP parameter are "1,0.0001,0.1,-
+4,0,0,0"
+```
+
+Naming: "move ahead" in the text above (sample PIDs `FAST_FZP_PID_LOOP(0)` < 0) is called **move-beyond** from
+2026-10-23 on: the sample stage moves *beyond* the scan point towards the next one, the FZP compensates and so sits
+beyond its centre during the exposure, on the side that gives it more stroke for the next step. It is not a
+"pre-move" of the FZP to the next point (that is `TargetSelect` `use_final` 1, see below).
+
+## Update 2026-10-20 (flOMNI loop on PREEMPT_RT, mpc2844)
+
+The loop has new modules since the text above was written (flOMNI `FeedbackLoop/tuning_guide.md`,
+`feedback_report.md` 5.6, 6n, 6o, 6q). Parameters are changed in the web HMI (`http://mpc2844:8080`, tab
+Parameters) instead of OrchestraHMI. `i` = x or y, as above. Module names now: `PID_x`, `PID_y` (sample stage),
+`PID_x_fzp`, `PID_y_fzp` (FZP scanner), `AnalogInput_6289` (was `AnalogInput_6259`).
+
+**FAST_FZP_PID_LOOP has 7 elements** (`PID.cpp`). Sample stage PIDs: (0) move-beyond (negative, µm, point-by-point
+scans only; section "Move-beyond" below), (4) FZP error threshold (µm) and (5) FZP drive limit (V) for holding the sample stage while the FZP
+takes the step (5 = 0: never held), (6) 1 = hold the sample stage at 0. FZP PIDs: (0) mode (1 operation, 2 FZP
+centred on its cap sensor = disabled, 3 not commissioned, 4 debug), (1)–(3) min / max / gain of the old velocity
+correction (−4 before 2026-10-19, now 0: replaced by the feedforward).
+
+**In addition to step 1 (FZP disabled):**
+
+- `Feedforward`: `enable` 0,0 — the static FZP feedforward adds its drive also in FZP mode 2.
+- `AbbeCorrection`: `enable` 0 (default until the signs are known).
+- `TargetSelect_x`, `TargetSelect_y`: `use_final` 0; `OnTargetTrigger`: `WaitForSlew` 1 (defaults).
+- `FreqGen`: `enable` 0 (excitation for measurements; default).
+
+**In addition to step 2 (FZP-only calibration scan):**
+
+- FZP range: `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` are ±1.5 V in operation (the cap sensors are calibrated over
+  about ±2 V only). For the field of view above (2.8 × 1.8 µm) widen them, e.g. to ±10 V (FZP ≈ 0.13 µm/V in x,
+  ≈ 0.05 µm/V in y). The feedforward stays off (`enable` 0,0) during this scan.
+- The detector trigger (`OnTargetTrigger`) checks the relative error sample vs FZP (tolerance / hold time from the
+  ConstEmitter, BEC `interferometer_trigger_*`, default 10 nm / 3 ms) and waits `MinDelay_ms` (15 ms).
+
+**Step 3, default operating values (replace the values in the text above):**
+
+| Module | Parameter | Value |
+|---|---|---|
+| `PID_x`, `PID_y` | `FAST_FZP_PID_LOOP` | `0,0,0,0,0.1,0,0` (no move-beyond: −0.5 µm is larger than the ±1.5 V FZP stroke, x ≈ ±0.19 µm, y ≈ ±0.08 µm) |
+| `PID_x_fzp` | `FAST_FZP_PID_LOOP`, `Ub` / `Lb` | `1,0.0001,0.1,0,0,0,0`, ±1.5 V |
+| `PID_y_fzp` | `FAST_FZP_PID_LOOP`, `Ub` / `Lb` | `1,0.0005,0.02,0,0,0,0`, ±1.5 V |
+| `Feedforward` | `enable`; `ff_limit`, `out_min` / `out_max` | 1,1; ±1.5 V (as the FZP `Ub` / `Lb`) |
+| `OnTargetTrigger` | `WaitForSlew`, `MinDelay_ms` | 1, 15 |
+| `TargetSelect_x`, `TargetSelect_y` | `use_final` | 0 |
+| `AbbeCorrection` | `enable` | 0 (until the signs are known) |
+| `AnalogInput_6289` | `MatrixCorr` | the new matrix from the calibration |
+
+Check afterwards: web HMI tab **Loop check**, level 1 (it expects these values and lists live values that differ
+from the `.xmp` files); save the new values as default (Parameters → Unsaved changes) or in the `.xmp`.
+
+**After the calibration (per experiment): faster scans, exposure during the motion.** With the FZP calibrated
+over a wider range the FZP can take the small steps alone (flOMNI `feedback_report.md` 6q, tested at ±7 V):
+
+- `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` and the `Feedforward` limits to the calibrated range (e.g. ±7 V);
+- `TargetSelect_x` / `_y` `use_final` 1 (the FZP aims at the new point at once, the sample stage follows its
+  S-curve) and `OnTargetTrigger` `WaitForSlew` 0 (trigger on the relative error only); optionally `MinDelay_ms` 0;
+- optionally move-beyond, sized to the FZP stroke (≈ half of it, see below): at ±7 V (x ≈ ±0.9 µm, y ≈ ±0.36 µm)
+  `PID_x` (0) e.g. −0.5, `PID_y` (0) e.g. −0.2 (the values tested in `feedback_report.md` 6q).
+
+Measured with 101 ms exposures: 0.2–1 µm steps trigger after 4.5–5.8 ms instead of 17–32 ms; the error during the
+exposure grows with the step (1 µm: ≈ 6 nm max instead of 2.5 nm), so the setting depends on the experiment.
+
+## Move-beyond (`PID_x` / `PID_y` `FAST_FZP_PID_LOOP(0)` < 0), 2026-10-23
+
+**What it does** (`PID.cpp`, unchanged since the original loop). Only in point-by-point scans (scan state 2). The
+TrajectoryGenerator gives the next scan point (outputs 5 / 6, PID input 9). The sample PID then aims not at the
+target T but at T + m · sign(next − T), m = min(|FAST_FZP_PID_LOOP(0)|, |next − T|): the sample stage moves *beyond*
+the point towards the next one, by at most the step. The FZP loop keeps its own target T (it does not see m), so the
+FZP compensates the offset: during the exposure it holds the relative position at T while sitting at +m off its
+centre. At the next point the FZP then has stroke R + m in the step direction instead of R (R = stroke from the centre),
+so larger steps are taken by the FZP alone. Steps smaller than |FAST_FZP_PID_LOOP(0)|: the sample stage is one point
+ahead, the FZP moves between 0 and +step only. The offset is not shaped (InputSlew acts on T only); the sample stage
+moves to it with its own (slow) loop, i.e. partly during the exposure, and the FZP compensates that motion.
+
+**Is it still the same in the new loop?** Yes. The relative position is computed as before:
+FZP error = Cap − (Chan − target) (mode 1), `Position sample vs FZP` = Chan − Cap (PID output 3, RT_sampler). The
+sample PIDs still get the shaped target (InputSlew) + move-beyond and the raw interferometer. The FZP side now has
+two additions that act on the FZP side only: `TargetSelect` (`use_final` 0 = shaped target as before, 1 = final
+target) and `AbbeCorrection` (Chan corrected for the stage tilt, see below). The `Feedforward` uses the same FZP
+target and Chan, so it supplies the +m offset of the FZP directly (static term m / K).
+
+**Sizing.** During the exposure the FZP has to hold m + Abbe correction + noise / settling inside its stroke:
+|m| ≤ R − reserve, as a rule ≈ R / 2. R per axis = `Ub` × K (K ≈ 0.13 µm/V x, ≈ 0.05 µm/V y):
+
+| FZP `Ub`/`Lb` | R x / y | move-beyond x / y (≈ R/2) |
+|---|---|---|
+| ±1.5 V (production) | ±0.19 / ±0.08 µm | ≈ −0.1 / ≈ −0.04 µm (production: 0) |
+| ±7 V (after calibration) | ±0.9 / ±0.36 µm | −0.5 / −0.2 µm (tested, 6q) |
+
+The original default −0.5 µm in both axes dates from the ±9 V limits of the old loop (x ≈ ±1.2 µm, about R/2; in y
+±9 V ≈ ±0.45 µm, i.e. about the full stroke). When the FZP saturates while holding the offset, the relative error grows and the trigger
+waits.
+
+**Abbe correction.** `AbbeCorrection` adds a new term to the measured sample x / y on the FZP side only:
+x = Chan2_x + θz · offset_y_for_x, y = Chan1_y + θz · offset_x_for_y (θz = Chan3 / 13 mm). So yes: it is an error of
+the sample x / y position (stage tilt about z, not seen by the x / y interferometer beams) that is corrected by the
+FZP x / y, not by the sample stage (`PID_x` / `PID_y` keep the raw Chan, the rotZ piezo is too slow). The positions
+recorded for the reconstruction (`Position sample vs FZP`) contain it as well. It uses FZP stroke (limited to
+`correction_limit_um` 0.1 µm per axis; y at rest ≈ 2 nm, ≈ 30–37 nm during 20 µm x steps) — keep this in the reserve
+of the move-beyond, in y it is a large part of the ±0.08 µm stroke. Keep it off (`enable` 0) during the FZP
+calibration scan (step 2).
+
+**Notes.**
+- Hold of the sample stage, (4) / (5): input 8 of `PID_x` / `PID_y` was the FZP PID output *before* the
+  `Feedforward` (with the feedforward on only the remainder, not the real FZP drive). Since 2026-10-23 it is the
+  `Feedforward` output (FZP drive incl. feedforward), so (5) again compares the real FZP drive. No change with the
+  feedforward off or with (5) = 0 (production).
+- On the last point of a scan the next point output is 0, so the move-beyond points towards 0 (as in the old loop).
+- `TargetSelect` `use_final` 1 is a different thing: the FZP aims at the new point at once while the sample stage
+  follows the S-curve. Both can be combined (6q, E0).
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
new file mode 100644
index 00000000..89755f1e
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
@@ -0,0 +1,41 @@
+# How to limit the FZP scanner range of flOMNI
+
+Source of `local_contact_only-howto_limit_the_fzp_scanner_range.pdf`. The original text is kept unchanged; the
+section "Update 2026-10-20" lists what the present flOMNI loop (PREEMPT_RT, 100 µs, branch `rt_preemt`) needs in
+addition. "ahead movement" (element 0) is called **move-beyond** from 2026-10-23 on: the sample stage moves beyond the
+scan point towards the next one, the FZP compensates and sits off-centre, which gives it stroke for the next step.
+
+```text
+to limit the fzp scanner ranges
+in PID_ FAST FZP PID LOOP
+0: reduce to small ahead movement range, such as -0.05
+4: reduce error threshold, eg 0.01
+5: inform PID that FZP range is small, such as 0.1
+
+in PID_ _FZP
+limit the analog output LB and UB
+```
+
+## Update 2026-10-20 (flOMNI loop on PREEMPT_RT, mpc2844)
+
+The limited range is the present operating state: `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` = ±1.5 V because the cap
+sensors are calibrated over about ±2 V only (flOMNI `feedback_report.md` 6n). FZP ≈ 0.13 µm/V in x, ≈ 0.05 µm/V in y,
+so ±1.5 V ≈ ±0.19 µm (x) / ±0.08 µm (y). In the sample stage PIDs (`PID_x`, `PID_y`) `FAST_FZP_PID_LOOP` is
+`0,0,0,0,0.1,0,0`: no move-beyond, (5) = 0 (the sample stage always compensates fully).
+
+Changing the FZP range now involves, in addition to the text above:
+
+- **`Feedforward`** (static FZP feedforward): `ff_limit`, `out_min` / `out_max` to the same values as the FZP `Ub` /
+  `Lb` (they limit drive + feedforward).
+- **`FreqGen`** `out_min` / `out_max` (channels 0 / 1) limit the FZP drive only while an excitation is running
+  (measurements).
+- **`OnTargetTrigger`** `WaitForSlew` and **`TargetSelect_x` / `_y`** `use_final`: keep the defaults (1 / 0) with a
+  small range. `use_final` 1 + `WaitForSlew` 0 ("exposure during the motion") only makes sense when the FZP range
+  covers the scan step; steps larger than the range then still wait for the sample stage.
+- Move-beyond (0) must fit into the stroke: the FZP holds it during the exposure, together with the Abbe correction
+  (up to `correction_limit_um` 0.1 µm when enabled) and noise. Rule ≈ half the stroke: at ±1.5 V ≈ −0.1 µm (x),
+  ≈ −0.04 µm (y); at ±7 V −0.5 / −0.2 µm (tested). Production: 0. Details: calibration how-to, section "Move-beyond".
+- (5) compares the real FZP drive incl. the feedforward (input 8 of `PID_x` / `PID_y` = `Feedforward` output since
+  2026-10-23; before it was the FZP PID output without the feedforward).
+- After a change: web HMI tab **Loop check** level 1 (expected settings) and, with the beamline ready, the scan test
+  (level 4: positioning time, stability during the exposure per step size).

From 79f5cced428dbd9612058f59e05a0e5578d4468f Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 12:55:31 +0000
Subject: [PATCH 073/102] feat(flomni): flomni.realtime_system - loop settings
 through the web HMI; ConstEmitter emitter_* removed

The ConstEmitter is no longer in the flOMNI loop (flOMNI 773df74, branch fzp-move-beyond): its values are module
parameters, set with their rules by the web HMI on mpc2844 (RT-system webhmi/loopsettings.py, REST /api/settings).

- flomni_realtime_system.py (new): FlomniRealtimeSystem, flomni.realtime_system: show / get / check / set
  (refused with the reason, adjust=True for the dependent settings) / profiles / apply_profile / unsaved /
  save_as_default, shortcuts trigger_* and tracking_targets; stdlib HTTP, API token from ~/.flomni_webhmi_token
  (FLOMNI_WEBHMI_TOKEN_FILE), URL http://<rtx host>:8080 (FLOMNI_WEBHMI_URL). No logic of its own: the same rules
  as the web page.
- flomni.py: flomni.realtime_system; laser_parameters_* and laser_parameters_tweak_tracking() through it;
  interferometer_trigger_* are aliases of realtime_system.trigger_* (renamed, Mirko: "interferometer" was
  confusing next to flomni.laser_*)
- rt_flomni_ophyd.py: emitter_* methods and their USER_ACCESS entries removed (the e-commands now answer with an
  error line); move_xyz stays
- tests: test_flomni_realtime_system.py against a small local HTTP server standing in for the web HMI

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/flomni/flomni.py                  | 123 +++------
 .../plugins/flomni/flomni_realtime_system.py  | 256 ++++++++++++++++++
 csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py  | 145 +---------
 .../test_flomni_realtime_system.py            | 140 ++++++++++
 4 files changed, 439 insertions(+), 225 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
 create mode 100644 tests/tests_bec_ipython_client/test_flomni_realtime_system.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 36c5ec29..bf19f6af 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -17,6 +17,7 @@ from typeguard import typechecked
 
 from csaxs_bec.bec_ipython_client.plugins.cSAXS import cSAXSBeamlineChecks
 from csaxs_bec.bec_ipython_client.plugins.flomni.flomni_optics_mixin import FlomniOpticsMixin
+from csaxs_bec.bec_ipython_client.plugins.flomni.flomni_realtime_system import FlomniRealtimeSystem
 from csaxs_bec.bec_ipython_client.plugins.flomni.gui_tools import flomniGuiTools
 from csaxs_bec.bec_ipython_client.plugins.flomni.x_ray_eye_align import XrayEyeAlign
 from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.angle_file import (
@@ -503,25 +504,27 @@ class FlomniSampleTransferMixin:
     def laser_tracker_off(self):
         dev.rtx.controller.laser_tracker_off()
 
+    # laser tracker targets and thresholds: settings of the real-time loop (flomni.realtime_system, group
+    # "tracking"; until 2026-10-23 ConstEmitter lines set through the CommunicationServer e-commands)
     def laser_parameters_show_all(self):
-        dev.rtx.controller.emitter_show_all()
+        self.realtime_system.show(group="tracking")
 
     def laser_parameters_set_targety(self, val: float):
-        dev.rtx.controller.emitter_set_tracking_target_y(val)
+        self.realtime_system.set(tracking_target_y=val)
 
     def laser_parameters_set_targetz(self, val: float):
-        dev.rtx.controller.emitter_set_tracking_target_z(val)
+        self.realtime_system.set(tracking_target_z=val)
 
     def laser_parameters_set_intensity_threshold_laser(self, val: float):
-        dev.rtx.controller.emitter_set_intensity_threshold_laser(val)
+        self.realtime_system.set(interferometer_threshold=val)
 
     def laser_parameters_set_psd_intensity_threshold_tracking_low(self, val: float):
-        dev.rtx.controller.emitter_set_psd_intensity_threshold_tracking_low(val)
+        self.realtime_system.set(psd_threshold_low=val)
 
     def laser_parameters_tweak_tracking(self):
         """Interactive tweak of the two laser tracking target positions.
 
-        Arrow keys nudge the ConstEmitter tracking targets by a fixed step of
+        Arrow keys nudge the tracking targets (realtime_system tracking_target_y / _z) by a fixed step of
         0.01 (absolute set of current +/- step):
             left / right : target y  -/+
             up   / down  : target z  +/-
@@ -542,6 +545,7 @@ class FlomniSampleTransferMixin:
         import tty
 
         controller = dev.rtx.controller
+        rts = self.realtime_system
 
         if not controller.laser_tracker_check_enabled():
             print(
@@ -554,11 +558,7 @@ class FlomniSampleTransferMixin:
         step = 0.02
 
         def read_targets():
-            values = controller.emitter_get()
-            return (
-                values["targetpos_tracking_y"],
-                values["targetpos_tracking_z"],
-            )
+            return rts.tracking_targets()
 
         def signal_fzpx():
             # second channel (index 1) of show_signal_strength_interferometer,
@@ -597,8 +597,7 @@ class FlomniSampleTransferMixin:
                         print("\n\rExiting tweak mode\r")
                         break
                     elif key == "s":
-                        controller.emitter_set_tracking_target_y(start_y)
-                        controller.emitter_set_tracking_target_z(start_z)
+                        rts.set(tracking_target_y=start_y, tracking_target_z=start_z, quiet=True)
                         print("\rReturned to start positions\r")
                         print_status()
                     elif key == "\x1b":  # escape sequences for arrow keys
@@ -606,16 +605,16 @@ class FlomniSampleTransferMixin:
                         if next1 == "[":
                             target_y, target_z = read_targets()
                             if next2 == "A":  # up: target z +
-                                controller.emitter_set_tracking_target_z(target_z + step)
+                                rts.set(tracking_target_z=target_z + step, quiet=True)
                                 print_status()
                             elif next2 == "B":  # down: target z -
-                                controller.emitter_set_tracking_target_z(target_z - step)
+                                rts.set(tracking_target_z=target_z - step, quiet=True)
                                 print_status()
                             elif next2 == "C":  # right: target y +
-                                controller.emitter_set_tracking_target_y(target_y + step)
+                                rts.set(tracking_target_y=target_y + step, quiet=True)
                                 print_status()
                             elif next2 == "D":  # left: target y -
-                                controller.emitter_set_tracking_target_y(target_y - step)
+                                rts.set(tracking_target_y=target_y - step, quiet=True)
                                 print_status()
                 except IOError:
                     pass
@@ -710,81 +709,36 @@ class FlomniSampleTransferMixin:
         else:
             print("The rt feedback is \x1b[91mNOT\x1b[0m running.")
 
-    def interferometer_trigger_show(self):
-        """Show the detector-trigger stability criterion of the interferometer feedback.
+    # detector trigger: renamed to flomni.realtime_system.trigger_* (2026-10-23, Mirko: "interferometer" was
+    # confusing next to flomni.laser_*); the values are settings of the real-time loop (OnTargetTrigger parameters,
+    # until 2026-10-23 ConstEmitter lines). The old names stay as aliases.
+    def _renamed(self, old, new):
+        print(f"flomni.{old} is now flomni.realtime_system.{new}")
 
-        A step-scan point is triggered when the relative position sample vs FZP (interferometer
-        minus FZP cap sensor) is within the tolerance in x and in y, each averaged over 0.5 ms,
-        for the hold time without interruption.
-        """
-        values = dev.rtx.controller.emitter_get_ontarget()
-        tol_nm = values["ontarget_tolerance_um"] * 1000
-        if tol_nm > 0:
-            print(f"Detector trigger: |position error| x and y <= {tol_nm:.1f} nm "
-                  f"for {values['ontarget_hold_ms']:.1f} ms.")
-        else:
-            print("Detector trigger: former criterion (on-target flags of the FZP PID loops).")
-        if values.get("trigger_on_move") is not None:
-            mode = "on" if values["trigger_on_move"] else "off"
-            print(f"Trigger after every position change (not only at scan points): {mode}.")
+    def interferometer_trigger_show(self):
+        """Alias of flomni.realtime_system.trigger_show()."""
+        self._renamed("interferometer_trigger_show()", "trigger_show()")
+        self.realtime_system.trigger_show()
 
     def interferometer_trigger_set_tolerance_nm(self, tolerance_nm: float):
-        """Set the detector-trigger tolerance in nm (per axis, x and y).
-
-        Typical: 30 nm for a fast low-resolution scan, 10 nm standard, 2 nm for the highest
-        resolution (needs a few ms more per point). 0 selects the former criterion (on-target flags
-        of the FZP PID loops).
-
-        Args:
-            tolerance_nm (float): tolerance in nm, 0 or 1 ... 1000.
-        """
-        if tolerance_nm != 0 and not 1 <= tolerance_nm <= 1000:
-            raise FlomniError(
-                "The trigger tolerance must be 0 (former criterion) or 1 ... 1000 nm."
-            )
-        dev.rtx.controller.emitter_set_ontarget_tolerance(tolerance_nm / 1000)
-        self.interferometer_trigger_show()
+        """Alias of flomni.realtime_system.trigger_set_tolerance_nm()."""
+        self._renamed("interferometer_trigger_set_tolerance_nm()", "trigger_set_tolerance_nm()")
+        self.realtime_system.trigger_set_tolerance_nm(tolerance_nm)
 
     def interferometer_trigger_set_hold_ms(self, hold_ms: float):
-        """Set how long (ms) the position must stay within the tolerance before the trigger.
-
-        Typical 3 ms. Longer = safer against a position that is only passing through the tolerance.
-
-        Args:
-            hold_ms (float): hold time in ms, 0 ... 100.
-        """
-        if not 0 <= hold_ms <= 100:
-            raise FlomniError("The trigger hold time must be 0 ... 100 ms.")
-        dev.rtx.controller.emitter_set_ontarget_hold_ms(hold_ms)
-        self.interferometer_trigger_show()
+        """Alias of flomni.realtime_system.trigger_set_hold_ms()."""
+        self._renamed("interferometer_trigger_set_hold_ms()", "trigger_set_hold_ms()")
+        self.realtime_system.trigger_set_hold_ms(hold_ms)
 
     def interferometer_trigger_set_after_move(self, enable: bool):
-        """Send one detector trigger after every position change, not only at scan points.
-
-        With True every direct move of the sample stage (e.g. umv of rtx / rty / rtz, or
-        dev.rtx.controller.move_xyz) gives exactly one trigger, as soon as the position is stable
-        (same tolerance and hold time as for scan points). False: triggers at scan points only.
-        """
-        dev.rtx.controller.emitter_set_trigger_on_move(1 if enable else 0)
-        self.interferometer_trigger_show()
+        """Alias of flomni.realtime_system.trigger_set_after_move()."""
+        self._renamed("interferometer_trigger_set_after_move()", "trigger_set_after_move()")
+        self.realtime_system.trigger_set_after_move(enable)
 
     def interferometer_trigger_help(self):
-        """Print the detector-trigger commands with a short explanation."""
-        lines = [
-            "Detector trigger (step scans): a point is triggered when the relative position",
-            "sample vs FZP is within the tolerance in x and y (0.5 ms average) for the hold time.",
-            "  flomni.interferometer_trigger_show()                 tolerance and hold time",
-            "  flomni.interferometer_trigger_set_tolerance_nm(val)  30 coarse, 10 standard,",
-            "                                                       2 finest; 0 = former",
-            "                                                       criterion (FZP PID flags)",
-            "  flomni.interferometer_trigger_set_hold_ms(val)       e.g. 3",
-            "  flomni.interferometer_trigger_set_after_move(True)   also one trigger after every",
-            "                                                       position change (False: off)",
-            "  dev.rtx.controller.move_xyz(x, y, z)                 move all three axes at once",
-            "The values are live; after a restart of the control loop the start values",
-            "(10 nm, 3 ms) from the loop parameter file apply again.",
-        ]
-        print("\n".join(lines))
+        """Alias of flomni.realtime_system.help()."""
+        self._renamed("interferometer_trigger_help()", "help()")
+        self.realtime_system.help()
 
     def lights_off(self):
         self.device_manager.devices.fsamx.controller.lights_off()
@@ -1819,6 +1773,9 @@ class Flomni(
         self._webpage_gen.start()
 
         self.OMNYTools = OMNYTools(self.client)
+        # expert functions of the real-time loop (settings with rules, via the web HMI on the loop machine;
+        # flomni_realtime_system.py): flomni.realtime_system.show() / .set(...) / .help()
+        self.realtime_system = FlomniRealtimeSystem(device_manager=self.device_manager)
         self.reconstructor = PtychoReconstructor(self.ptycho_reconstruct_foldername)
         self.tomo_id_manager = TomoIDManager()
         self.align = XrayEyeAlign(self.client, self)
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
new file mode 100644
index 00000000..79eaaec0
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -0,0 +1,256 @@
+"""flomni.realtime_system: the operating settings of the flOMNI real-time loop (expert functions).
+
+The settings, the parameters they map onto and the rules between them live in the flOMNI instrument repository
+(FeedbackLoop/loopsettings/flomni.json) and are applied by the web HMI on the loop machine (RT-system
+webhmi/loopsettings.py). This client only talks to its REST API (/api/settings); it holds no logic of its own, so the
+web page (tab "Loop settings") and BEC always behave the same way.
+
+    flomni.realtime_system.show()                          all settings, rules, scan state
+    flomni.realtime_system.set(trigger_tolerance_nm=5)     change (refused if a rule objects)
+    flomni.realtime_system.set(fzp_enable=0, adjust=True)  ... and adjust the dependent settings
+    flomni.realtime_system.check(fzp_range_V_x=1.0)        dry run
+    flomni.realtime_system.apply_profile("fzp_off")        a named set of settings
+    flomni.realtime_system.save_as_default()               write the live values into the .xmp files
+
+Changes are live only: the next start of the control loop uses the .xmp files again (save_as_default keeps them).
+
+Connection: the web HMI URL (default http://<rtx host>:8080, env FLOMNI_WEBHMI_URL) and an API token in a file
+(default ~/.flomni_webhmi_token, env FLOMNI_WEBHMI_TOKEN_FILE; the same token as in the web HMI's api_token_file on
+the loop machine, see flOMNI FeedbackLoop/loopsettings/README.md).
+"""
+
+import json
+import os
+import urllib.error
+import urllib.request
+
+DEFAULT_TOKEN_FILE = "~/.flomni_webhmi_token"
+DEFAULT_PORT = 8080
+
+
+class RealtimeSystemError(Exception):
+    """A request was refused (rules, scan running) or the web HMI could not be reached."""
+
+
+def _fmt(v):
+    if v is None:
+        return "-"
+    if isinstance(v, float):
+        return f"{v:.6g}"
+    return str(v)
+
+
+class FlomniRealtimeSystem:
+    def __init__(self, url=None, token_file=None, device_manager=None, timeout=5.0):
+        self._url = url
+        self._token_file = token_file
+        self._device_manager = device_manager
+        self.timeout = timeout
+
+    # ── connection ────────────────────────────────────────────────────────────
+
+    @property
+    def url(self):
+        if self._url:
+            return self._url.rstrip("/")
+        env = os.environ.get("FLOMNI_WEBHMI_URL")
+        if env:
+            return env.rstrip("/")
+        host = "mpc2844.psi.ch"
+        try:                                    # the host of the rt controller (device config of rtx)
+            host = self._device_manager.devices.rtx._config["deviceConfig"]["host"] or host
+        except Exception:  # noqa: BLE001
+            pass
+        return f"http://{host}:{DEFAULT_PORT}"
+
+    def _token(self):
+        path = os.path.expanduser(self._token_file or os.environ.get("FLOMNI_WEBHMI_TOKEN_FILE") or DEFAULT_TOKEN_FILE)
+        try:
+            with open(path) as f:
+                tok = f.readline().strip()
+        except OSError:
+            raise RealtimeSystemError(
+                f"No API token for the web HMI: {path} not readable. Copy the token from the loop machine "
+                "(~/loop-data/webhmi/api_token of the user control) into this file (mode 600), or set "
+                "FLOMNI_WEBHMI_TOKEN_FILE.") from None
+        if not tok:
+            raise RealtimeSystemError(f"API token file {path} is empty")
+        return tok
+
+    def _request(self, path, body=None):
+        data = None if body is None else json.dumps(body).encode()
+        req = urllib.request.Request(self.url + path, data=data, method="GET" if body is None else "POST",
+                                     headers={"Authorization": "Bearer " + self._token(), "X-Client": "BEC",
+                                              "Content-Type": "application/json"})
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                return json.load(r)
+        except urllib.error.HTTPError as exc:
+            try:
+                detail = json.load(exc).get("detail", exc.reason)
+            except Exception:  # noqa: BLE001
+                detail = exc.reason
+            if exc.code == 401:
+                detail = f"{detail} (API token not accepted by the web HMI: compare with its api_token_file)"
+            raise RealtimeSystemError(f"web HMI {self.url}{path}: {exc.code} {detail}") from None
+        except (urllib.error.URLError, OSError) as exc:
+            raise RealtimeSystemError(f"web HMI {self.url} not reachable: {exc}") from None
+
+    # ── reading ───────────────────────────────────────────────────────────────
+
+    def read(self) -> dict:
+        """The full state as the web HMI reports it (settings, rules, scan state, profiles)."""
+        return self._request("/api/settings")
+
+    def get(self, name: str = None):
+        """Live value of one setting, or a dict of all values."""
+        values = {s["name"]: s["value"] for s in self.read()["settings"]}
+        if name is None:
+            return values
+        if name not in values:
+            raise RealtimeSystemError(f"unknown setting '{name}'; known: {', '.join(values)}")
+        return values[name]
+
+    def show(self, group: str = None, expert: bool = False):
+        """Print the settings (live value, .xmp value, markers), the violated rules and the scan state."""
+        snap = self.read()
+        groups = {g["name"]: g for g in snap["groups"]}
+        sc = snap.get("scan") or {}
+        print(f"Loop settings {snap.get('instrument', '')} ({self.url}) - "
+              + (f"scan running (mode {_fmt(sc.get('mode'))})" if sc.get("active") else "no scan"))
+        for gname, g in groups.items():
+            if group and gname != group:
+                continue
+            if g.get("expert") and not expert and not group:
+                continue
+            rows = [s for s in snap["settings"] if s["group"] == gname]
+            if not rows:
+                continue
+            print(f"\n{g.get('title', gname)}" + ("  (changed only between scans)" if g.get("interlock") else ""))
+            for s in rows:
+                info = f"  ({s['info']['label']} {s['info']['value']:.4g} {s['info']['unit']})" if s.get("info") else ""
+                mark = ("  NOT SAVED (.xmp " + _fmt(s["saved"]) + ")" if s["unsaved"] else "") + \
+                       ("  INCONSISTENT: " + "; ".join(s["issues"]) if not s["consistent"] else "")
+                print(f"  {s['name']:30s} {_fmt(s['value']):>10s} {s.get('unit', ''):3s}{info}{mark}")
+        bad = [r for r in snap["rules"] if not r["ok"]]
+        if bad:
+            print()
+            for r in bad:
+                print(f"{r['severity'].upper()}: {r['message']}")
+        if not expert and not group and any(g.get("expert") for g in snap["groups"]):
+            print("\n(expert groups hidden: show(expert=True))")
+        print("\n" + (snap.get("note") or ""))
+
+    def profiles(self):
+        """Print the named profiles and their values."""
+        for p in self.read()["profiles"]:
+            print(f"{p['name']:18s} {p.get('title', '')}")
+            if p.get("help"):
+                print(f"{'':18s} {p['help']}")
+            print(f"{'':18s} " + ", ".join(f"{k}={_fmt(v)}" for k, v in p["values"].items()))
+
+    def unsaved(self):
+        """Print the parameters whose live value differs from the .xmp (settings only)."""
+        un = self._request("/api/settings/unsaved")
+        if not un:
+            print("All settings are saved: the .xmp files hold the live values.")
+        for u in un:
+            print(f"  {u['module']}.{u['param']}: .xmp {u['saved']} -> live {u['live']}")
+        return un
+
+    # ── changing ──────────────────────────────────────────────────────────────
+
+    @staticmethod
+    def _print_result(r, dry=False):
+        head = ("Check: " if dry else "") + ("applied" if r.get("applied") else ("ok" if r["ok"] else "REFUSED"))
+        if r["ok"] and not r["params"]:
+            head = "no change"
+        print(head + (f" (profile {r['profile']})" if r.get("profile") else ""))
+        for c in r["changes"]:
+            print(f"  {c['name']}: {_fmt(c['old'])} -> {_fmt(c['new'])}"
+                  + (f"   (adjusted by rule {c['adjusted']})" if c.get("adjusted") else ""))
+        for e in r["errors"]:
+            print(f"  ERROR: {e}")
+        for w in r["warnings"]:
+            print(f"  warning: {w}")
+        if r.get("applied"):
+            print("  " + r.get("note", "Live only: save_as_default() to keep it."))
+
+    def check(self, adjust: bool = False, **changes) -> dict:
+        """Dry run: what would change, which rules object. Nothing is sent to the loop."""
+        r = self._request("/api/settings/plan", {"changes": changes, "profile": None, "adjust": adjust})
+        self._print_result(r, dry=True)
+        return r
+
+    def set(self, adjust: bool = False, quiet: bool = False, **changes) -> dict:
+        """Change settings, e.g. set(trigger_tolerance_nm=5). All parameters change in one loop step.
+
+        A rule that objects refuses the request (RealtimeSystemError); with adjust=True the settings the rule names
+        are changed with it (never the ones given here). Live only until save_as_default(). quiet: print nothing
+        (interactive tools); a refusal still raises.
+        """
+        if not changes:
+            raise RealtimeSystemError("nothing to set: e.g. set(trigger_tolerance_nm=5); show() lists the names")
+        r = self._request("/api/settings/apply", {"changes": changes, "profile": None, "adjust": adjust})
+        if not quiet:
+            self._print_result(r)
+        if not r["ok"]:
+            raise RealtimeSystemError("; ".join(r["errors"]))
+        return r
+
+    def apply_profile(self, name: str, adjust: bool = False, **changes) -> dict:
+        """Apply a named profile (profiles() lists them); extra keyword values override the profile's."""
+        r = self._request("/api/settings/apply", {"changes": changes, "profile": name, "adjust": adjust})
+        self._print_result(r)
+        if not r["ok"]:
+            raise RealtimeSystemError("; ".join(r["errors"]))
+        return r
+
+    def save_as_default(self, *names: str, confirm: bool = True) -> dict:
+        """Write the live values of the settings' parameters (all, or the named settings) into the .xmp files, so the
+        next loop start uses them (the web HMI keeps a backup of each file)."""
+        un = self._request("/api/settings/unsaved")
+        if not un:
+            print("Nothing to save: the .xmp files hold the live values.")
+            return {"saved": []}
+        if not names:
+            print("Save as default (written into the .xmp files of the loop):")
+            for u in un:
+                print(f"  {u['module']}.{u['param']}: {u['saved']} -> {u['live']}")
+            if confirm and input("Save? [y/N] ").strip().lower() not in ("y", "yes"):
+                print("not saved")
+                return {"saved": []}
+        r = self._request("/api/settings/save", {"names": list(names) or None})
+        print(r.get("message", ""), "; ".join(r.get("saved", [])))
+        return r
+
+    # ── shortcuts (detector trigger, laser tracker) ────────────────────────────
+
+    def trigger_show(self):
+        """Detector trigger (step scans): tolerance, hold time, minimum delay, trigger after every move."""
+        self.show(group="trigger")
+
+    def trigger_set_tolerance_nm(self, tolerance_nm: float):
+        """|relative position sample vs FZP| x and y within this (nm) for the hold time. 30 coarse, 10 standard, 2 finest;
+        0 = the former criterion (OnTarget_legacy flags of the FZP PIDs)."""
+        return self.set(trigger_tolerance_nm=tolerance_nm)
+
+    def trigger_set_hold_ms(self, hold_ms: float):
+        """How long the position must stay within the tolerance before the trigger (ms), typical 3."""
+        return self.set(trigger_hold_ms=hold_ms)
+
+    def trigger_set_after_move(self, enable: bool):
+        """True: one detector trigger after every direct position change (umv rtx / rty / rtz, move_xyz) once on target;
+        False: triggers at step-scan points only."""
+        return self.set(trigger_on_move=1 if enable else 0)
+
+    def tracking_targets(self):
+        """-> (target y, target z) of the laser tracker on the PSD."""
+        v = self.get()
+        return v["tracking_target_y"], v["tracking_target_z"]
+
+    def help(self):
+        """Print the functions with a short explanation."""
+        print(__doc__.split("\n\nConnection:")[0])
+        print("\nShortcuts: trigger_show(), trigger_set_tolerance_nm(v), trigger_set_hold_ms(v),"
+              " trigger_set_after_move(True/False), tracking_targets(); profiles(), unsaved(), get(name)")
diff --git a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
index afa49424..3ef464b1 100644
--- a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
@@ -45,17 +45,6 @@ class RtFlomniController(Controller):
         "laser_tracker_check_signalstrength",
         "laser_tracker_check_enabled",
         "is_axis_moving",
-        "emitter_show_all",
-        "emitter_get",
-        "emitter_set_tracking_target_y",
-        "emitter_set_tracking_target_z",
-        "emitter_set_intensity_threshold_laser",
-        "emitter_set_psd_intensity_threshold_tracking_low",
-        "emitter_get_ontarget",
-        "emitter_set_ontarget_tolerance",
-        "emitter_set_ontarget_hold_ms",
-        "emitter_help",
-        "emitter_set_trigger_on_move",
         "move_xyz",
     ]
 
@@ -404,84 +393,9 @@ class RtFlomniController(Controller):
             return True
         return False
 
-    def emitter_get(self) -> dict:
-        """Read the runtime constants served by the ConstEmitter Orchestra module.
-
-        These are values that used to live in individual module parameter files
-        (tracking targets and intensity thresholds) and are now emitted centrally
-        so they can be tweaked live. The rotation-loop laser threshold
-        (intensity_threshold_rot_laser) is a pure startup constant and is
-        intentionally not reported here.
-
-        Returns:
-            dict: current emitter values.
-        """
-        ret = self.socket_put_and_receive("es")
-        # remove trailing \n
-        ret = ret.split("\n")[0]
-        values = [float(val) for val in ret.split(",")]
-        if len(values) != 4:
-            raise RtCommunicationError(
-                f"Expected to receive 4 emitter values. Instead received {values}"
-            )
-        return {
-            "targetpos_tracking_y": values[0],
-            "targetpos_tracking_z": values[1],
-            "intensity_threshold_laser": values[2],
-            "PSD_intensity_threshold_tracking_low": values[3],
-        }
-
-    def emitter_show_all(self):
-        """Print all ConstEmitter runtime constants as a table."""
-        t = PrettyTable()
-        t.title = "ConstEmitter Runtime Constants"
-        t.field_names = ["Name", "Value"]
-        for key, val in self.emitter_get().items():
-            t.add_row([key, val])
-        for key, val in self.emitter_get_ontarget().items():
-            t.add_row([key, val])
-        print(t)
-
-    def emitter_get_ontarget(self) -> dict:
-        """Read the detector-trigger stability criterion (OnTargetTrigger in the control loop).
-
-        A step-scan point is triggered when the relative position sample vs FZP is within
-        ``ontarget_tolerance_um`` in x and in y (each averaged over 0.5 ms) for ``ontarget_hold_ms``
-        without interruption.
-
-        Returns:
-            dict: ontarget_tolerance_um, ontarget_hold_ms, trigger_on_move (None from a server
-            that does not report it yet).
-        """
-        ret = self.socket_put_and_receive("eg")
-        ret = ret.split("\n")[0]
-        values = [float(val) for val in ret.split(",")]
-        if len(values) not in (2, 3):
-            raise RtCommunicationError(
-                f"Expected to receive 2 or 3 on-target values. Instead received {values}"
-            )
-        return {
-            "ontarget_tolerance_um": values[0],
-            "ontarget_hold_ms": values[1],
-            "trigger_on_move": values[2] if len(values) == 3 else None,
-        }
-
-    def emitter_set_ontarget_tolerance(self, val_um: float) -> None:
-        """Set the detector-trigger tolerance in um, per axis.
-
-        E.g. 0.030 for a low-resolution scan, 0.002 for the highest resolution. A value <= 0 selects
-        the former criterion (on-target flags of the FZP PID loops, set in their parameter files).
-        """
-        self.socket_put(f"eo{val_um:.6f}")
-
-    def emitter_set_ontarget_hold_ms(self, val_ms: float) -> None:
-        """Set the time in ms the position must stay within the tolerance before the trigger."""
-        self.socket_put(f"eh{val_ms:.3f}")
-
-    def emitter_set_trigger_on_move(self, val: int) -> None:
-        """1: send one detector trigger after every direct position change (pa / p), once on target
-        (same criterion as a step-scan point); 0: triggers at step-scan points only."""
-        self.socket_put(f"em{1 if val else 0}")
+    # emitter_* (ConstEmitter get / set through the CommunicationServer e-commands) removed 2026-10-23: the
+    # ConstEmitter is no longer in the loop; its values are loop settings, set through the web HMI
+    # (flomni.realtime_system, csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py).
 
     def move_xyz(self, x: float, y: float, z: float) -> None:
         """Move rtx, rty and rtz with one command (CommunicationServer p<x>,<y>,<z>).
@@ -502,59 +416,6 @@ class RtFlomniController(Controller):
             targets.append(target_val)
         self.socket_put(f"p{targets[0]:.4f},{targets[1]:.4f},{targets[2]:.4f}")
 
-    def emitter_help(self) -> None:
-        """Print the ConstEmitter commands (loop runtime constants) with a short explanation."""
-        t = PrettyTable()
-        t.title = "ConstEmitter commands (rt controller)"
-        t.field_names = ["Method", "Wire", "Explanation"]
-        t.align = "l"
-        rows = [
-            ("emitter_show_all()", "es, eg", "print all runtime constants"),
-            ("emitter_get()", "es", "dict: tracking targets y/z, laser and PSD thresholds"),
-            ("emitter_get_ontarget()", "eg", "dict: detector-trigger tolerance (um), hold (ms)"),
-            ("emitter_set_tracking_target_y(val)", "ey", "target of the tracking loop y (PSD)"),
-            ("emitter_set_tracking_target_z(val)", "ez", "target of the tracking loop z (PSD)"),
-            ("emitter_set_intensity_threshold_laser(val)", "et",
-             "interferometer signal below this: slew limiters and x/y/z, FZP PIDs stop"),
-            ("emitter_set_psd_intensity_threshold_tracking_low(val)", "el",
-             "PSD intensity below this: tracking PIDs y/z stop"),
-            ("emitter_set_ontarget_tolerance(val_um)", "eo",
-             "detector trigger: |relative error| x and y <= val um (e.g. 0.030 coarse, 0.002 fine);"
-             " <= 0: FZP PID flags"),
-            ("emitter_set_ontarget_hold_ms(val_ms)", "eh",
-             "detector trigger: ... held for val ms without interruption"),
-            ("emitter_set_trigger_on_move(val)", "em",
-             "1: one detector trigger after every direct move (pa / p) once on target; 0: off"),
-        ]
-        for row in rows:
-            t.add_row(row)
-        print(t)
-        print(
-            "Values are live in the control loop; the start values after a loop restart come from"
-            " ConstEmitter.xmp."
-        )
-
-    def emitter_set_tracking_target_y(self, val: float) -> None:
-        """Set the y tracking target position (PID_tracking_y)."""
-        self.socket_put(f"ey{val:.4f}")
-
-    def emitter_set_tracking_target_z(self, val: float) -> None:
-        """Set the z tracking target position (PID_tracking_z)."""
-        self.socket_put(f"ez{val:.4f}")
-
-    def emitter_set_intensity_threshold_laser(self, val: float) -> None:
-        """Set the shared laser intensity threshold.
-
-        Wired into the slew-rate limiters (x/y/z) and the PID loops
-        (x/y/z and the fast FZP x/y loops). Does not affect the
-        rotation loops, which use a separate fixed threshold.
-        """
-        self.socket_put(f"et{val:.4f}")
-
-    def emitter_set_psd_intensity_threshold_tracking_low(self, val: float) -> None:
-        """Set the low PSD intensity threshold used by the tracking PIDs (y and z)."""
-        self.socket_put(f"el{val:.4f}")
-
     def pid_y(self) -> float:
         ret = float(self.socket_put_and_receive("G").strip())
         return ret
diff --git a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
new file mode 100644
index 00000000..16265a7a
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
@@ -0,0 +1,140 @@
+"""Tests for flomni.realtime_system (flomni_realtime_system.py): the client of the web HMI loop-settings API on the
+flOMNI loop machine. A small local HTTP server stands in for the web HMI (RT-system webhmi, /api/settings*); it checks
+the token header and answers like the real server. No BEC service, no loop."""
+
+import json
+import threading
+from http.server import BaseHTTPRequestHandler, HTTPServer
+
+import pytest
+
+from csaxs_bec.bec_ipython_client.plugins.flomni.flomni_realtime_system import (
+    FlomniRealtimeSystem,
+    RealtimeSystemError,
+)
+
+TOKEN = "test-token-0123456789abcdef"
+
+SNAP = {
+    "instrument": "flOMNI", "note": "Live only.", "scan": {"mode": 0, "active": False, "text": ""},
+    "groups": [{"name": "trigger", "title": "Detector trigger"}, {"name": "tracking", "title": "Tracker"}],
+    "settings": [
+        {"name": "trigger_tolerance_nm", "group": "trigger", "unit": "nm", "value": 10.0, "saved": 10.0,
+         "unsaved": False, "consistent": True, "issues": [], "info": None},
+        {"name": "tracking_target_y", "group": "tracking", "unit": "", "value": 0.13, "saved": 0.13,
+         "unsaved": False, "consistent": True, "issues": [], "info": None},
+        {"name": "tracking_target_z", "group": "tracking", "unit": "", "value": 0.2, "saved": 0.2,
+         "unsaved": False, "consistent": True, "issues": [], "info": None},
+    ],
+    "rules": [], "profiles": [{"name": "production", "title": "Production", "help": "", "values": {}}],
+}
+
+
+class _Handler(BaseHTTPRequestHandler):
+    requests = []
+
+    def log_message(self, *args):
+        pass
+
+    def _reply(self, code, body):
+        data = json.dumps(body).encode()
+        self.send_response(code)
+        self.send_header("Content-Type", "application/json")
+        self.send_header("Content-Length", str(len(data)))
+        self.end_headers()
+        self.wfile.write(data)
+
+    def _auth(self):
+        if self.headers.get("Authorization") != "Bearer " + TOKEN:
+            self._reply(401, {"detail": "login required"})
+            return False
+        return True
+
+    def do_GET(self):
+        if not self._auth():
+            return
+        if self.path == "/api/settings":
+            self._reply(200, SNAP)
+        elif self.path == "/api/settings/unsaved":
+            self._reply(200, [])
+        else:
+            self._reply(404, {"detail": "not found"})
+
+    def do_POST(self):
+        if not self._auth():
+            return
+        body = json.loads(self.rfile.read(int(self.headers["Content-Length"])))
+        _Handler.requests.append((self.path, body, self.headers.get("X-Client")))
+        changes = body.get("changes", {})
+        if "move_beyond_um_x" in changes:
+            self._reply(200, {"ok": False, "errors": ["Move-beyond x does not fit"], "warnings": [], "changes": [],
+                              "params": [], "profile": None, "applied": False})
+            return
+        ch = [{"name": k, "old": 0, "new": v, "adjusted": None} for k, v in changes.items()]
+        self._reply(200, {"ok": True, "errors": [], "warnings": [], "changes": ch,
+                          "params": [{"module": "M", "param": "p", "old": [0], "new": [1]}] if ch or body.get("profile") else [],
+                          "profile": body.get("profile"), "applied": self.path.endswith("apply"),
+                          "note": "Live only: save as default to keep them."})
+
+
+@pytest.fixture
+def server(tmp_path):
+    _Handler.requests = []
+    srv = HTTPServer(("127.0.0.1", 0), _Handler)
+    threading.Thread(target=srv.serve_forever, daemon=True).start()
+    tok = tmp_path / "token"
+    tok.write_text(TOKEN + "\n")
+    yield f"http://127.0.0.1:{srv.server_address[1]}", str(tok), tmp_path
+    srv.shutdown()
+
+
+def test_read_and_shortcuts(server, capsys):
+    url, tok, _ = server
+    rts = FlomniRealtimeSystem(url=url, token_file=tok)
+    assert rts.get("trigger_tolerance_nm") == 10.0
+    assert rts.tracking_targets() == (0.13, 0.2)
+    rts.show()
+    out = capsys.readouterr().out
+    assert "trigger_tolerance_nm" in out and "Live only." in out
+    with pytest.raises(RealtimeSystemError):
+        rts.get("nosuch")
+
+
+def test_set_sends_changes_and_token(server, capsys):
+    url, tok, _ = server
+    rts = FlomniRealtimeSystem(url=url, token_file=tok)
+    r = rts.trigger_set_tolerance_nm(5)
+    assert r["applied"]
+    path, body, client = _Handler.requests[-1]
+    assert path == "/api/settings/apply" and body == {"changes": {"trigger_tolerance_nm": 5}, "profile": None,
+                                                       "adjust": False} and client == "BEC"
+    assert "Live only" in capsys.readouterr().out
+    rts.set(tracking_target_y=0.2, quiet=True)
+    assert capsys.readouterr().out == ""
+    rts.apply_profile("production", adjust=True)
+    assert _Handler.requests[-1][1] == {"changes": {}, "profile": "production", "adjust": True}
+    rts.check(fzp_enable=0, adjust=True)
+    assert _Handler.requests[-1][0] == "/api/settings/plan"
+
+
+def test_refused_raises(server):
+    url, tok, _ = server
+    with pytest.raises(RealtimeSystemError, match="does not fit"):
+        FlomniRealtimeSystem(url=url, token_file=tok).set(move_beyond_um_x=0.5)
+    with pytest.raises(RealtimeSystemError, match="nothing to set"):
+        FlomniRealtimeSystem(url=url, token_file=tok).set()
+
+
+def test_token_errors(server):
+    url, _, tmp = server
+    with pytest.raises(RealtimeSystemError, match="No API token"):
+        FlomniRealtimeSystem(url=url, token_file=str(tmp / "missing")).get()
+    bad = tmp / "bad"
+    bad.write_text("wrong-token-xxxxxxxxxxxx")
+    with pytest.raises(RealtimeSystemError, match="401"):
+        FlomniRealtimeSystem(url=url, token_file=str(bad)).get()
+
+
+def test_unreachable():
+    with pytest.raises(RealtimeSystemError, match="not reachable"):
+        FlomniRealtimeSystem(url="http://127.0.0.1:9", token_file=__file__, timeout=1).get()

From 6dbf8784fff22a322384d669c90b74965f238088 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 12:55:32 +0000
Subject: [PATCH 074/102] docs(flomni): realtime_system in the user guide; FZP
 how-tos with the loop-settings profiles

- user guide: detector-trigger commands under flomni.realtime_system.trigger_* (old names still work), new section
  "Real-time loop settings (expert)"
- calibration how-to: steps 1-3 as profiles fzp_off / fzp_calibration / production (+ fast_scan); trigger values are
  OnTargetTrigger parameters; move-beyond sizing with the loop-settings rule (0.6 x stroke - Abbe limit)
- range how-to: FZP range through the loop settings (Ub / Lb and Feedforward limits together)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 ...ct_only-howto_calibrate_the_fzp_scanner.md | 27 ++++++++++++--
 ..._only-howto_limit_the_fzp_scanner_range.md |  7 +++-
 docs/user/ptychography/flomni.md              | 36 +++++++++++++++----
 3 files changed, 59 insertions(+), 11 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
index 3d29d0b5..e0214cbd 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
@@ -102,8 +102,9 @@ correction (−4 before 2026-10-19, now 0: replaced by the feedforward).
 - FZP range: `PID_x_fzp` / `PID_y_fzp` `Ub` / `Lb` are ±1.5 V in operation (the cap sensors are calibrated over
   about ±2 V only). For the field of view above (2.8 × 1.8 µm) widen them, e.g. to ±10 V (FZP ≈ 0.13 µm/V in x,
   ≈ 0.05 µm/V in y). The feedforward stays off (`enable` 0,0) during this scan.
-- The detector trigger (`OnTargetTrigger`) checks the relative error sample vs FZP (tolerance / hold time from the
-  ConstEmitter, BEC `interferometer_trigger_*`, default 10 nm / 3 ms) and waits `MinDelay_ms` (15 ms).
+- The detector trigger (`OnTargetTrigger`) checks the relative error sample vs FZP (parameters
+  `ontarget_tolerance_um` / `ontarget_hold_ms`, BEC `flomni.realtime_system.trigger_*`, default 10 nm / 3 ms; until
+  2026-10-23 ConstEmitter lines) and waits `MinDelay_ms` (15 ms).
 
 **Step 3, default operating values (replace the values in the text above):**
 
@@ -133,6 +134,24 @@ over a wider range the FZP can take the small steps alone (flOMNI `feedback_repo
 Measured with 101 ms exposures: 0.2–1 µm steps trigger after 4.5–5.8 ms instead of 17–32 ms; the error during the
 exposure grows with the step (1 µm: ≈ 6 nm max instead of 2.5 nm), so the setting depends on the experiment.
 
+## With the loop settings (since 2026-10-23)
+
+The steps above are profiles of the loop settings (web HMI tab *Loop settings*, BEC `flomni.realtime_system`;
+flOMNI `FeedbackLoop/loopsettings/`). The rules keep the modules consistent, so the individual parameters above do
+not have to be set by hand:
+
+| Step | Profile | BEC |
+|---|---|---|
+| 1, FZP disabled (alignment, affine matrix) | `fzp_off` | `flomni.realtime_system.apply_profile("fzp_off")` |
+| 2, FZP-only calibration scan (clear `MatrixCorr` first: not part of the settings) | `fzp_calibration` | `apply_profile("fzp_calibration")` |
+| 3, back to operation | `production` | `apply_profile("production")` |
+| afterwards, faster scans (calibrated over ±7 V) | `fast_scan` | `apply_profile("fast_scan")` |
+
+Single values: `flomni.realtime_system.set(fzp_range_V_x=7, fzp_range_V_y=7)`,
+`set(move_beyond_um_x=0.3)`, `set(exposure_during_motion=1)`; refused with the reason if a rule objects
+(`adjust=True` changes the dependent settings too). FZP settings only between scans. Live only until
+`save_as_default()`.
+
 ## Move-beyond (`PID_x` / `PID_y` `FAST_FZP_PID_LOOP(0)` < 0), 2026-10-23
 
 **What it does** (`PID.cpp`, unchanged since the original loop). Only in point-by-point scans (scan state 2). The
@@ -153,7 +172,9 @@ target) and `AbbeCorrection` (Chan corrected for the stage tilt, see below). The
 target and Chan, so it supplies the +m offset of the FZP directly (static term m / K).
 
 **Sizing.** During the exposure the FZP has to hold m + Abbe correction + noise / settling inside its stroke:
-|m| ≤ R − reserve, as a rule ≈ R / 2. R per axis = `Ub` × K (K ≈ 0.13 µm/V x, ≈ 0.05 µm/V y):
+|m| ≤ R − reserve, as a rule ≈ R / 2. R per axis = `Ub` × K (K ≈ 0.13 µm/V x, ≈ 0.05 µm/V y). The loop settings
+refuse more than 0.6 × R minus the Abbe limit (rule `move_beyond_*_fits`, constant `move_beyond_fraction`; the
+tested ±7 V values are 0.56 × R):
 
 | FZP `Ub`/`Lb` | R x / y | move-beyond x / y (≈ R/2) |
 |---|---|---|
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
index 89755f1e..488462ee 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
@@ -33,9 +33,14 @@ Changing the FZP range now involves, in addition to the text above:
   small range. `use_final` 1 + `WaitForSlew` 0 ("exposure during the motion") only makes sense when the FZP range
   covers the scan step; steps larger than the range then still wait for the sample stage.
 - Move-beyond (0) must fit into the stroke: the FZP holds it during the exposure, together with the Abbe correction
-  (up to `correction_limit_um` 0.1 µm when enabled) and noise. Rule ≈ half the stroke: at ±1.5 V ≈ −0.1 µm (x),
+  (up to `correction_limit_um` 0.1 µm when enabled) and noise. Rule ≈ half the stroke (the loop settings refuse more than 0.6 × stroke minus the Abbe limit): at ±1.5 V ≈ −0.1 µm (x),
   ≈ −0.04 µm (y); at ±7 V −0.5 / −0.2 µm (tested). Production: 0. Details: calibration how-to, section "Move-beyond".
 - (5) compares the real FZP drive incl. the feedforward (input 8 of `PID_x` / `PID_y` = `Feedforward` output since
   2026-10-23; before it was the FZP PID output without the feedforward).
 - After a change: web HMI tab **Loop check** level 1 (expected settings) and, with the beamline ready, the scan test
   (level 4: positioning time, stability during the exposure per step size).
+
+**With the loop settings (since 2026-10-23):** `flomni.realtime_system.set(fzp_range_V_x=..., fzp_range_V_y=...)`
+(web HMI tab *Loop settings*) sets `PID_*_fzp` `Ub` / `Lb` and the `Feedforward` limits together; a move-beyond that
+no longer fits is refused, or clamped with `adjust=True` (rule `move_beyond_*_fits`). `FreqGen` limits stay
+manual (measurements only).
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 8031e5d2..2a28802f 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -224,18 +224,19 @@ In step scans the detector is triggered when the sample is stable at the scan po
 sample vs FZP (interferometer minus FZP cap sensor) must stay within a tolerance in x and in y (each averaged
 over 0.5 ms) for a hold time. Both values are live and can be changed between scans:
 
-- `flomni.interferometer_trigger_show()` — current tolerance and hold time
-- `flomni.interferometer_trigger_set_tolerance_nm(10)` — tolerance per axis in nm: about 30 for a fast
+- `flomni.realtime_system.trigger_show()` — current tolerance, hold time, minimum delay, trigger after a move
+- `flomni.realtime_system.trigger_set_tolerance_nm(10)` — tolerance per axis in nm: about 30 for a fast
   low-resolution scan, 10 standard, 2 for the highest resolution (a few ms more per point);
   0 selects the former criterion (on-target flags of the FZP loops)
-- `flomni.interferometer_trigger_set_hold_ms(3)` — hold time in ms
-- `flomni.interferometer_trigger_set_after_move(True)` — additionally one trigger after every position change
+- `flomni.realtime_system.trigger_set_hold_ms(3)` — hold time in ms
+- `flomni.realtime_system.trigger_set_after_move(True)` — additionally one trigger after every position change
   of the sample stage (e.g. `umv(dev.rtx, ...)`), as soon as the position is stable with the same tolerance and
   hold time; `False` (default): triggers at scan points only
 - `dev.rtx.controller.move_xyz(x, y, z)` — moves rtx, rty and rtz with one command (one trigger for the move)
-- `flomni.interferometer_trigger_help()` — this list
 
-After a restart of the control loop the start values (10 nm, 3 ms) apply again. Measured with 3 µm steps
+The former names `flomni.interferometer_trigger_*` still work (they print the new name). The values are live; after
+a restart of the control loop the values of the loop's parameter files (10 nm, 3 ms) apply again, unless they were
+saved with `flomni.realtime_system.save_as_default()`. Measured with 3 µm steps
 (2026-10-20): the trigger comes about 36 ms (x) / 48 ms (y) after the step at 10 nm, 40 / 55 ms at 2 nm;
 after the trigger the position stays within about 4 nm even at a 30 nm tolerance.
 
@@ -781,10 +782,31 @@ removed later.
 
 [See short version](flomni.md#sample-storage-and-transfer)
 
+### Real-time loop settings (expert): `flomni.realtime_system`
+
+The operating settings of the real-time loop — FZP scanner on/off, FZP range, feedforward, move-beyond, exposure
+during the motion, Abbe correction, detector trigger, laser tracker targets and thresholds — with the rules between
+them. The rules and the mapping onto the loop parameters are kept on the loop machine (web HMI tab *Loop settings*,
+`http://mpc2844:8080/?tab=settings`; definition in the flOMNI control repository,
+`FeedbackLoop/loopsettings/flomni.json` and `README.md`); BEC and the web page use the same rules.
+
+- `flomni.realtime_system.show()` — all settings with live and saved value, violated rules, scan state
+  (`show(expert=True)` also the FZP calibration group)
+- `flomni.realtime_system.set(name=value, ...)` — change; refused (with the reason) if a rule objects, e.g. the
+  feedforward must be off while the FZP loop is off; `set(..., adjust=True)` changes the dependent settings too
+- `flomni.realtime_system.check(name=value)` — dry run
+- `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "fast_scan")`
+- `flomni.realtime_system.unsaved()`, `save_as_default()` — the changes are live only until the next start of the
+  control loop; `save_as_default()` writes them into the loop's parameter files
+- `flomni.realtime_system.help()`
+
+FZP settings can only be changed between scans. BEC needs the API token of the web HMI in `~/.flomni_webhmi_token`
+(local contact; flOMNI `FeedbackLoop/loopsettings/README.md`).
+
 ### Detector trigger and interferometer tuning
 
 The trigger tolerance and hold time: [Detector trigger: position stability](#detector-trigger-position-stability)
-(`flomni.interferometer_trigger_*`). The control loops of the sample stage, the FZP scanner and the laser
+(`flomni.realtime_system.trigger_*`). The control loops of the sample stage, the FZP scanner and the laser
 tracker were characterized and retuned in October 2026; results, the present parameters and how to retune them
 are documented in the flOMNI control repository (`FeedbackLoop/feedback_report.md` with PDF,
 `FeedbackLoop/tuning_guide.md`).

From 1806b721b1d10606ba45964bba86158e569c69f5 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 14:02:37 +0000
Subject: [PATCH 075/102] flomni: interferometer_trigger_* removed (use
 realtime_system.trigger_*); realtime_system falls back to port 80

- the former flomni.interferometer_trigger_* aliases are removed (Mirko 2026-10-23); user guide updated
- flomni.realtime_system: when the default URL http://<rtx host>:8080 is not reachable, the request goes to port
  80 of the same host (nftables redirect to the web HMI on the loop machine) and that URL is kept; an explicit URL
  (argument or FLOMNI_WEBHMI_URL) gets no fallback; test added

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/flomni/flomni.py                  | 32 ++-----------------
 .../plugins/flomni/flomni_realtime_system.py  | 31 +++++++++++++++---
 docs/user/ptychography/flomni.md              |  2 +-
 .../test_flomni_realtime_system.py            | 27 ++++++++++++++++
 4 files changed, 57 insertions(+), 35 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index bf19f6af..fc2768a1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -709,36 +709,8 @@ class FlomniSampleTransferMixin:
         else:
             print("The rt feedback is \x1b[91mNOT\x1b[0m running.")
 
-    # detector trigger: renamed to flomni.realtime_system.trigger_* (2026-10-23, Mirko: "interferometer" was
-    # confusing next to flomni.laser_*); the values are settings of the real-time loop (OnTargetTrigger parameters,
-    # until 2026-10-23 ConstEmitter lines). The old names stay as aliases.
-    def _renamed(self, old, new):
-        print(f"flomni.{old} is now flomni.realtime_system.{new}")
-
-    def interferometer_trigger_show(self):
-        """Alias of flomni.realtime_system.trigger_show()."""
-        self._renamed("interferometer_trigger_show()", "trigger_show()")
-        self.realtime_system.trigger_show()
-
-    def interferometer_trigger_set_tolerance_nm(self, tolerance_nm: float):
-        """Alias of flomni.realtime_system.trigger_set_tolerance_nm()."""
-        self._renamed("interferometer_trigger_set_tolerance_nm()", "trigger_set_tolerance_nm()")
-        self.realtime_system.trigger_set_tolerance_nm(tolerance_nm)
-
-    def interferometer_trigger_set_hold_ms(self, hold_ms: float):
-        """Alias of flomni.realtime_system.trigger_set_hold_ms()."""
-        self._renamed("interferometer_trigger_set_hold_ms()", "trigger_set_hold_ms()")
-        self.realtime_system.trigger_set_hold_ms(hold_ms)
-
-    def interferometer_trigger_set_after_move(self, enable: bool):
-        """Alias of flomni.realtime_system.trigger_set_after_move()."""
-        self._renamed("interferometer_trigger_set_after_move()", "trigger_set_after_move()")
-        self.realtime_system.trigger_set_after_move(enable)
-
-    def interferometer_trigger_help(self):
-        """Alias of flomni.realtime_system.help()."""
-        self._renamed("interferometer_trigger_help()", "help()")
-        self.realtime_system.help()
+    # detector trigger: flomni.realtime_system.trigger_* (the former flomni.interferometer_trigger_* removed
+    # 2026-10-23, Mirko: "interferometer" was confusing next to flomni.laser_*)
 
     def lights_off(self):
         self.device_manager.devices.fsamx.controller.lights_off()
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index 79eaaec0..d023a0e9 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -14,7 +14,8 @@ web page (tab "Loop settings") and BEC always behave the same way.
 
 Changes are live only: the next start of the control loop uses the .xmp files again (save_as_default keeps them).
 
-Connection: the web HMI URL (default http://<rtx host>:8080, env FLOMNI_WEBHMI_URL) and an API token in a file
+Connection: the web HMI URL (default http://<rtx host>:8080, and http://<rtx host> (port 80, nftables redirect to
+8080 on the loop machine) when 8080 cannot be reached; env FLOMNI_WEBHMI_URL) and an API token in a file
 (default ~/.flomni_webhmi_token, env FLOMNI_WEBHMI_TOKEN_FILE; the same token as in the web HMI's api_token_file on
 the loop machine, see flOMNI FeedbackLoop/loopsettings/README.md).
 """
@@ -43,6 +44,7 @@ def _fmt(v):
 class FlomniRealtimeSystem:
     def __init__(self, url=None, token_file=None, device_manager=None, timeout=5.0):
         self._url = url
+        self._fallback = None                   # port-80 URL that answered when 8080 did not (kept for the session)
         self._token_file = token_file
         self._device_manager = device_manager
         self.timeout = timeout
@@ -51,6 +53,8 @@ class FlomniRealtimeSystem:
 
     @property
     def url(self):
+        if self._fallback:
+            return self._fallback
         if self._url:
             return self._url.rstrip("/")
         env = os.environ.get("FLOMNI_WEBHMI_URL")
@@ -63,6 +67,9 @@ class FlomniRealtimeSystem:
             pass
         return f"http://{host}:{DEFAULT_PORT}"
 
+    def _explicit_url(self):
+        return bool(self._url or os.environ.get("FLOMNI_WEBHMI_URL"))
+
     def _token(self):
         path = os.path.expanduser(self._token_file or os.environ.get("FLOMNI_WEBHMI_TOKEN_FILE") or DEFAULT_TOKEN_FILE)
         try:
@@ -78,8 +85,21 @@ class FlomniRealtimeSystem:
         return tok
 
     def _request(self, path, body=None):
+        try:
+            return self._request_once(self.url, path, body)
+        except RealtimeSystemError as exc:
+            # default URL on port 8080 not reachable: the loop machine also serves the web HMI on port 80
+            # (nftables redirect 80 -> 8080, the port the PSI gateway passes); not for an explicit URL
+            if getattr(exc, "unreachable", False) and not self._explicit_url() and not self._fallback:
+                alt = self.url.replace(f":{DEFAULT_PORT}", "")
+                r = self._request_once(alt, path, body)
+                self._fallback = alt
+                return r
+            raise
+
+    def _request_once(self, url, path, body=None):
         data = None if body is None else json.dumps(body).encode()
-        req = urllib.request.Request(self.url + path, data=data, method="GET" if body is None else "POST",
+        req = urllib.request.Request(url + path, data=data, method="GET" if body is None else "POST",
                                      headers={"Authorization": "Bearer " + self._token(), "X-Client": "BEC",
                                               "Content-Type": "application/json"})
         try:
@@ -92,9 +112,11 @@ class FlomniRealtimeSystem:
                 detail = exc.reason
             if exc.code == 401:
                 detail = f"{detail} (API token not accepted by the web HMI: compare with its api_token_file)"
-            raise RealtimeSystemError(f"web HMI {self.url}{path}: {exc.code} {detail}") from None
+            raise RealtimeSystemError(f"web HMI {url}{path}: {exc.code} {detail}") from None
         except (urllib.error.URLError, OSError) as exc:
-            raise RealtimeSystemError(f"web HMI {self.url} not reachable: {exc}") from None
+            err = RealtimeSystemError(f"web HMI {url} not reachable: {exc}")
+            err.unreachable = True
+            raise err from None
 
     # ── reading ───────────────────────────────────────────────────────────────
 
@@ -226,6 +248,7 @@ class FlomniRealtimeSystem:
 
     # ── shortcuts (detector trigger, laser tracker) ────────────────────────────
 
+    # the former flomni.interferometer_trigger_* (removed 2026-10-23)
     def trigger_show(self):
         """Detector trigger (step scans): tolerance, hold time, minimum delay, trigger after every move."""
         self.show(group="trigger")
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 2a28802f..0ef07084 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -234,7 +234,7 @@ over 0.5 ms) for a hold time. Both values are live and can be changed between sc
   hold time; `False` (default): triggers at scan points only
 - `dev.rtx.controller.move_xyz(x, y, z)` — moves rtx, rty and rtz with one command (one trigger for the move)
 
-The former names `flomni.interferometer_trigger_*` still work (they print the new name). The values are live; after
+The former names `flomni.interferometer_trigger_*` were removed (2026-10-23). The values are live; after
 a restart of the control loop the values of the loop's parameter files (10 nm, 3 ms) apply again, unless they were
 saved with `flomni.realtime_system.save_as_default()`. Measured with 3 µm steps
 (2026-10-20): the trigger comes about 36 ms (x) / 48 ms (y) after the step at 10 nm, 40 / 55 ms at 2 nm;
diff --git a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
index 16265a7a..728f5527 100644
--- a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
+++ b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
@@ -138,3 +138,30 @@ def test_token_errors(server):
 def test_unreachable():
     with pytest.raises(RealtimeSystemError, match="not reachable"):
         FlomniRealtimeSystem(url="http://127.0.0.1:9", token_file=__file__, timeout=1).get()
+
+
+def test_port_80_fallback(monkeypatch):
+    """Default URL (rtx host, port 8080) not reachable: the same request goes to port 80 (nftables redirect on the
+    loop machine) and that URL is kept; an explicit URL gets no fallback."""
+    monkeypatch.delenv("FLOMNI_WEBHMI_URL", raising=False)
+    dm = type("DM", (), {})()
+    dm.devices = type("D", (), {})()
+    dm.devices.rtx = type("R", (), {"_config": {"deviceConfig": {"host": "loophost"}}})()
+    rts = FlomniRealtimeSystem(device_manager=dm, token_file=__file__)
+    calls = []
+
+    def once(url, path, body=None):
+        calls.append(url)
+        if url.endswith(":8080"):
+            err = RealtimeSystemError("not reachable")
+            err.unreachable = True
+            raise err
+        return {"ok": True}
+
+    monkeypatch.setattr(rts, "_request_once", once)
+    assert rts._request("/api/settings") == {"ok": True}
+    assert calls == ["http://loophost:8080", "http://loophost"] and rts.url == "http://loophost"
+    explicit = FlomniRealtimeSystem(url="http://other:8080", token_file=__file__)
+    monkeypatch.setattr(explicit, "_request_once", once)
+    with pytest.raises(RealtimeSystemError):
+        explicit._request("/api/settings")

From e418f96a1e5dc5e0899e30a0086c1e151679b3d2 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 16:36:46 +0000
Subject: [PATCH 076/102] feat(flomni): baseline device flomni_loop_settings -
 the loop settings stored with every scan

Decisions Mirko 2026-10-23: settings only (not all loop parameters), snapshot at the scan start, web HMI down ->
marked unavailable and the scan continues, flOMNI only for now, token part of the device configuration.

- devices/omny/flomni_loop_settings.py (new): FlomniLoopSettings, readoutPriority baseline (the Fermat scan reads
  the baseline devices in prepare_scan): one signal per setting (21, NaN when not available), available, message,
  unsaved / inconsistent counts, violated error rules, definition path + sha1, compact snapshot_json; never
  raises; after a failure no new attempt for 60 s (a tomogram does not wait for the timeout at every projection);
  show() / snapshot() for the user
- devices/omny/webhmi_client.py (new): the HTTP client (URL with port-80 fallback, token value or file, errors)
  shared by the device and flomni.realtime_system (which now uses it; behaviour unchanged)
- ptycho_flomni.yaml: flomni_loop_settings with token_file (the token value only in a config that is not
  committed), host mpc2844.psi.ch, timeout 2 s
- tests: tests_devices/test_flomni_loop_settings.py (stub web HMI: values, counts, unavailable / back-off,
  unreachable, token file); checked end-to-end against the web HMI with the flOMNI definition and fakecore (all
  21 settings filled)
- user guide: the settings are stored with every scan

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/flomni/flomni_realtime_system.py  |  93 +-----------
 csaxs_bec/device_configs/ptycho_flomni.yaml   |  20 +++
 .../devices/omny/flomni_loop_settings.py      | 142 ++++++++++++++++++
 csaxs_bec/devices/omny/webhmi_client.py       | 116 ++++++++++++++
 docs/user/ptychography/flomni.md              |   4 +
 .../test_flomni_loop_settings.py              |  97 ++++++++++++
 6 files changed, 386 insertions(+), 86 deletions(-)
 create mode 100644 csaxs_bec/devices/omny/flomni_loop_settings.py
 create mode 100644 csaxs_bec/devices/omny/webhmi_client.py
 create mode 100644 tests/tests_devices/test_flomni_loop_settings.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index d023a0e9..19dd75e0 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -20,17 +20,8 @@ Connection: the web HMI URL (default http://<rtx host>:8080, and http://<rtx hos
 the loop machine, see flOMNI FeedbackLoop/loopsettings/README.md).
 """
 
-import json
-import os
-import urllib.error
-import urllib.request
-
-DEFAULT_TOKEN_FILE = "~/.flomni_webhmi_token"
-DEFAULT_PORT = 8080
-
-
-class RealtimeSystemError(Exception):
-    """A request was refused (rules, scan running) or the web HMI could not be reached."""
+from csaxs_bec.devices.omny.webhmi_client import WebHmiClient
+from csaxs_bec.devices.omny.webhmi_client import WebHmiError as RealtimeSystemError  # name kept for BEC users
 
 
 def _fmt(v):
@@ -41,82 +32,12 @@ def _fmt(v):
     return str(v)
 
 
-class FlomniRealtimeSystem:
-    def __init__(self, url=None, token_file=None, device_manager=None, timeout=5.0):
-        self._url = url
-        self._fallback = None                   # port-80 URL that answered when 8080 did not (kept for the session)
-        self._token_file = token_file
-        self._device_manager = device_manager
-        self.timeout = timeout
+class FlomniRealtimeSystem(WebHmiClient):
+    """Connection (URL with port-80 fallback, token, errors): WebHmiClient (devices/omny/webhmi_client.py), shared
+    with the baseline device flomni_loop_settings."""
 
-    # ── connection ────────────────────────────────────────────────────────────
-
-    @property
-    def url(self):
-        if self._fallback:
-            return self._fallback
-        if self._url:
-            return self._url.rstrip("/")
-        env = os.environ.get("FLOMNI_WEBHMI_URL")
-        if env:
-            return env.rstrip("/")
-        host = "mpc2844.psi.ch"
-        try:                                    # the host of the rt controller (device config of rtx)
-            host = self._device_manager.devices.rtx._config["deviceConfig"]["host"] or host
-        except Exception:  # noqa: BLE001
-            pass
-        return f"http://{host}:{DEFAULT_PORT}"
-
-    def _explicit_url(self):
-        return bool(self._url or os.environ.get("FLOMNI_WEBHMI_URL"))
-
-    def _token(self):
-        path = os.path.expanduser(self._token_file or os.environ.get("FLOMNI_WEBHMI_TOKEN_FILE") or DEFAULT_TOKEN_FILE)
-        try:
-            with open(path) as f:
-                tok = f.readline().strip()
-        except OSError:
-            raise RealtimeSystemError(
-                f"No API token for the web HMI: {path} not readable. Copy the token from the loop machine "
-                "(~/loop-data/webhmi/api_token of the user control) into this file (mode 600), or set "
-                "FLOMNI_WEBHMI_TOKEN_FILE.") from None
-        if not tok:
-            raise RealtimeSystemError(f"API token file {path} is empty")
-        return tok
-
-    def _request(self, path, body=None):
-        try:
-            return self._request_once(self.url, path, body)
-        except RealtimeSystemError as exc:
-            # default URL on port 8080 not reachable: the loop machine also serves the web HMI on port 80
-            # (nftables redirect 80 -> 8080, the port the PSI gateway passes); not for an explicit URL
-            if getattr(exc, "unreachable", False) and not self._explicit_url() and not self._fallback:
-                alt = self.url.replace(f":{DEFAULT_PORT}", "")
-                r = self._request_once(alt, path, body)
-                self._fallback = alt
-                return r
-            raise
-
-    def _request_once(self, url, path, body=None):
-        data = None if body is None else json.dumps(body).encode()
-        req = urllib.request.Request(url + path, data=data, method="GET" if body is None else "POST",
-                                     headers={"Authorization": "Bearer " + self._token(), "X-Client": "BEC",
-                                              "Content-Type": "application/json"})
-        try:
-            with urllib.request.urlopen(req, timeout=self.timeout) as r:
-                return json.load(r)
-        except urllib.error.HTTPError as exc:
-            try:
-                detail = json.load(exc).get("detail", exc.reason)
-            except Exception:  # noqa: BLE001
-                detail = exc.reason
-            if exc.code == 401:
-                detail = f"{detail} (API token not accepted by the web HMI: compare with its api_token_file)"
-            raise RealtimeSystemError(f"web HMI {url}{path}: {exc.code} {detail}") from None
-        except (urllib.error.URLError, OSError) as exc:
-            err = RealtimeSystemError(f"web HMI {url} not reachable: {exc}")
-            err.unreachable = True
-            raise err from None
+    def __init__(self, url=None, token_file=None, device_manager=None, timeout=5.0, token=None):
+        super().__init__(url=url, token=token, token_file=token_file, device_manager=device_manager, timeout=timeout)
 
     # ── reading ───────────────────────────────────────────────────────────────
 
diff --git a/csaxs_bec/device_configs/ptycho_flomni.yaml b/csaxs_bec/device_configs/ptycho_flomni.yaml
index 9b3c278d..3aacbcaa 100644
--- a/csaxs_bec/device_configs/ptycho_flomni.yaml
+++ b/csaxs_bec/device_configs/ptycho_flomni.yaml
@@ -616,6 +616,26 @@ flomni_temphum:
   deviceTags:
     - ptycho_flomni
 # ############################################################
+# ############ flOMNI real-time loop settings #################
+# ############################################################
+# The loop settings (FZP, trigger, tracker; flOMNI FeedbackLoop/loopsettings) stored with every scan: read from the
+# web HMI on the loop machine at the start of each scan (baseline). Web HMI down: available = 0, the scan continues.
+# token_file: a file with the web HMI API token on the machine of the device server (mode 600). The token itself can
+# be given as "token: <value>" instead, but only in a config that is not committed - never put it in this file.
+flomni_loop_settings:
+  description: flOMNI real-time loop settings (web HMI loop settings, snapshot at scan start)
+  deviceClass: csaxs_bec.devices.omny.flomni_loop_settings.FlomniLoopSettings
+  deviceConfig:
+    host: mpc2844.psi.ch
+    token_file: ~/.flomni_webhmi_token
+    timeout: 2.0
+  enabled: true
+  onFailure: buffer
+  readOnly: true
+  readoutPriority: baseline
+  deviceTags:
+    - ptycho_flomni
+# ############################################################
 # ########## OMNY / flOMNI / LamNI fast shutter ##############
 # REPLACED BY SIMULATED BEAMLINE DEVICE !!!!!!!!!!!!!!!!
 # ############################################################
diff --git a/csaxs_bec/devices/omny/flomni_loop_settings.py b/csaxs_bec/devices/omny/flomni_loop_settings.py
new file mode 100644
index 00000000..16feee75
--- /dev/null
+++ b/csaxs_bec/devices/omny/flomni_loop_settings.py
@@ -0,0 +1,142 @@
+"""flomni_loop_settings: the operating settings of the flOMNI real-time loop as a baseline device.
+
+Read at the start of every scan (readoutPriority: baseline; the flOMNI Fermat scan calls read_baseline_devices in
+prepare_scan), so each scan file holds the loop settings it ran with: FZP on/off, FZP range, feedforward,
+move-beyond, exposure during the motion, Abbe correction, detector trigger, tracker targets and thresholds
+(definition: flOMNI FeedbackLoop/loopsettings/flomni.json; served by the web HMI on the loop machine, GET
+/api/settings). Settings only, not all loop parameters (decision Mirko 2026-10-23).
+
+Signals: one per setting (float, NaN when not available; names = the setting names), and
+    available       1 = read from the web HMI, 0 = not available (the scan continues; message says why)
+    message         "" or the reason it is not available
+    unsaved         number of settings whose live value differs from the .xmp (not saved as default)
+    inconsistent    number of settings whose parameters disagree (e.g. FZP x on, y off)
+    rules_violated  number of violated error rules
+    definition      path and sha1 of the definition file on the loop machine
+    snapshot_json   JSON: every setting (value, saved, unsaved, consistent, unit), the violated rules, the
+                    scan state, the definition path and sha1
+
+deviceConfig: token (the API token itself; only in a config that is not committed) or token_file (path to a file
+with it, default ~/.flomni_webhmi_token), optional url / host / timeout (default 2 s). Connection details:
+devices/omny/webhmi_client.py.
+"""
+
+import json
+import math
+import time
+
+from ophyd import Component as Cpt
+from ophyd import Device, Kind, Signal
+
+from csaxs_bec.devices.omny.webhmi_client import WebHmiClient, WebHmiError
+
+# the settings of flomni.json (2026-10-23); a setting added to the definition later is in snapshot_json only until
+# it is added here
+SETTINGS = (
+    "fzp_enable", "fzp_range_V_x", "fzp_range_V_y", "feedforward_enable", "move_beyond_um_x", "move_beyond_um_y",
+    "exposure_during_motion", "abbe_enable", "abbe_limit_um",
+    "trigger_tolerance_nm", "trigger_hold_ms", "trigger_min_delay_ms", "trigger_on_move",
+    "tracking_target_y", "tracking_target_z", "psd_threshold_low", "interferometer_threshold",
+    "interferometer_threshold_rot",
+    "sample_hold_fzp_V", "sample_hold_err_um", "sample_hold_zero",
+)
+
+RETRY_AFTER_FAILURE_S = 60.0    # web HMI not reachable: no new attempt for this long (a tomogram does not wait each time)
+
+
+class FlomniLoopSettings(Device):
+    USER_ACCESS = ["show", "snapshot"]
+
+    available = Cpt(Signal, value=0, kind=Kind.normal)
+    message = Cpt(Signal, value="", kind=Kind.normal)
+    unsaved = Cpt(Signal, value=-1, kind=Kind.normal)
+    inconsistent = Cpt(Signal, value=-1, kind=Kind.normal)
+    rules_violated = Cpt(Signal, value=-1, kind=Kind.normal)
+    definition = Cpt(Signal, value="", kind=Kind.normal)
+    snapshot_json = Cpt(Signal, value="", kind=Kind.normal)
+
+    # one signal per setting
+    locals().update({_n: Cpt(Signal, value=math.nan, kind=Kind.normal) for _n in SETTINGS})
+
+    def __init__(self, prefix="", *, name, token=None, token_file=None, url=None, host=None, timeout=2.0,
+                 device_manager=None, **kwargs):
+        super().__init__(prefix, name=name, **kwargs)
+        self._client = WebHmiClient(url=url, token=token, token_file=token_file, host=host,
+                                    device_manager=device_manager, timeout=timeout, client_name="BEC baseline")
+        self._failed_at = None
+        self._last = None
+
+    def _unavailable(self, reason):
+        self.available.put(0)
+        self.message.put(str(reason))
+        for n in ("unsaved", "inconsistent", "rules_violated"):
+            getattr(self, n).put(-1)
+        self.definition.put("")
+        self.snapshot_json.put("")
+        for n in SETTINGS:
+            getattr(self, n).put(math.nan)
+
+    def update(self):
+        """Read the settings from the web HMI into the signals. Never raises: not available -> available 0."""
+        now = time.time()
+        if self._failed_at is not None and now - self._failed_at < RETRY_AFTER_FAILURE_S:
+            return                                  # keep the 'not available' values of the last failure
+        try:
+            snap = self._client.settings()
+        except WebHmiError as exc:
+            self._failed_at = now
+            self._unavailable(f"{exc} (next attempt after {RETRY_AFTER_FAILURE_S:.0f} s)")
+            return
+        except Exception as exc:  # noqa: BLE001  (a broken answer must not stop a scan)
+            self._failed_at = now
+            self._unavailable(f"unexpected answer from the web HMI: {exc}")
+            return
+        self._failed_at = None
+        self._last = snap
+        values = {s["name"]: s for s in snap.get("settings", [])}
+        for n in SETTINGS:
+            v = values.get(n, {}).get("value")
+            getattr(self, n).put(float(v) if isinstance(v, (int, float)) else math.nan)   # bool is an int too
+        self.unsaved.put(sum(1 for s in values.values() if s.get("unsaved")))
+        self.inconsistent.put(sum(1 for s in values.values() if not s.get("consistent", True)))
+        self.rules_violated.put(sum(1 for r in snap.get("rules", []) if not r.get("ok") and r.get("severity") == "error"))
+        self.definition.put(f"{snap.get('definition', '')} sha1 {snap.get('definition_sha1', '?')}")
+        missing = [n for n in values if n not in SETTINGS]
+        self.message.put(f"settings not stored as own signals (in snapshot_json): {', '.join(missing)}" if missing else "")
+        # compact: values and flags only (help texts and parameter mappings are in the definition, see its sha1)
+        compact = {
+            "instrument": snap.get("instrument"), "definition": snap.get("definition"),
+            "definition_sha1": snap.get("definition_sha1"), "scan": snap.get("scan"),
+            "settings": {n: {"value": s.get("value"), "saved": s.get("saved"), "unsaved": s.get("unsaved"),
+                             "consistent": s.get("consistent"), "unit": s.get("unit", "")}
+                         for n, s in values.items()},
+            "rules_violated": [{"name": r.get("name"), "severity": r.get("severity"), "message": r.get("message")}
+                               for r in snap.get("rules", []) if not r.get("ok")],
+        }
+        self.snapshot_json.put(json.dumps(compact, separators=(",", ":")))
+        self.available.put(1)
+
+    def read(self):
+        self.update()
+        return super().read()
+
+    def snapshot(self) -> dict:
+        """Read now and return {setting: value} (empty when not available)."""
+        self._failed_at = None                      # an explicit request always tries
+        self.update()
+        if not self.available.get():
+            return {}
+        return {n: getattr(self, n).get() for n in SETTINGS}
+
+    def show(self):
+        """Print the settings as they would be stored with a scan now."""
+        snap = self.snapshot()
+        if not snap:
+            print(f"loop settings not available: {self.message.get()}")
+            return
+        for n, v in snap.items():
+            print(f"  {n:30s} {v:g}")
+        print(f"unsaved {self.unsaved.get()}, inconsistent {self.inconsistent.get()}, "
+              f"rules violated {self.rules_violated.get()}; {self.definition.get()}")
+        if self.message.get():
+            print(self.message.get())
diff --git a/csaxs_bec/devices/omny/webhmi_client.py b/csaxs_bec/devices/omny/webhmi_client.py
new file mode 100644
index 00000000..92554527
--- /dev/null
+++ b/csaxs_bec/devices/omny/webhmi_client.py
@@ -0,0 +1,116 @@
+"""Client of the web HMI on an OMNY-family loop machine (RT-system webhmi): REST requests with the API token.
+
+Shared by the BEC client plugin (flomni.realtime_system, bec_ipython_client/plugins/flomni/flomni_realtime_system.py)
+and the baseline device FlomniLoopSettings (devices/omny/flomni_loop_settings.py), so both talk to the web HMI the
+same way. Standard library only (runs in the IPython client and in the device server).
+
+URL: explicit `url`, else env FLOMNI_WEBHMI_URL, else http://<host>:8080 with <host> = `host`, else the host of the
+rtx device config, else mpc2844.psi.ch. With the default URL a request that cannot reach port 8080 is repeated on
+port 80 of the same host (nftables redirect 80 -> 8080 on the loop machine, the port the PSI gateway passes); that URL
+is then kept. An explicit URL gets no fallback.
+
+Token: `token` (the value, e.g. from a device config that is not committed), else `token_file`, else env
+FLOMNI_WEBHMI_TOKEN_FILE, else ~/.flomni_webhmi_token. The same line as the web HMI's api_token_file on the loop
+machine (flOMNI FeedbackLoop/loopsettings/README.md). Never commit a token.
+"""
+
+import json
+import os
+import urllib.error
+import urllib.request
+
+DEFAULT_TOKEN_FILE = "~/.flomni_webhmi_token"
+DEFAULT_PORT = 8080
+DEFAULT_HOST = "mpc2844.psi.ch"
+
+
+class WebHmiError(Exception):
+    """A request was refused (rules, scan running) or the web HMI could not be reached (.unreachable = True)."""
+
+    unreachable = False
+
+
+class WebHmiClient:
+    def __init__(self, url=None, token=None, token_file=None, host=None, device_manager=None, timeout=5.0,
+                 client_name="BEC"):
+        self._url = url
+        self._fallback = None                   # port-80 URL that answered when 8080 did not (kept for the session)
+        self._token_value = token
+        self._token_file = token_file
+        self._host = host
+        self._device_manager = device_manager
+        self.timeout = timeout
+        self.client_name = client_name
+
+    @property
+    def url(self):
+        if self._fallback:
+            return self._fallback
+        if self._url:
+            return self._url.rstrip("/")
+        env = os.environ.get("FLOMNI_WEBHMI_URL")
+        if env:
+            return env.rstrip("/")
+        host = self._host or DEFAULT_HOST
+        if not self._host:
+            try:                                # the host of the rt controller (device config of rtx)
+                host = self._device_manager.devices.rtx._config["deviceConfig"]["host"] or host
+            except Exception:  # noqa: BLE001
+                pass
+        return f"http://{host}:{DEFAULT_PORT}"
+
+    def _explicit_url(self):
+        return bool(self._url or os.environ.get("FLOMNI_WEBHMI_URL"))
+
+    def _token(self):
+        if self._token_value:
+            return str(self._token_value).strip()
+        path = os.path.expanduser(self._token_file or os.environ.get("FLOMNI_WEBHMI_TOKEN_FILE") or DEFAULT_TOKEN_FILE)
+        try:
+            with open(path) as f:
+                tok = f.readline().strip()
+        except OSError:
+            raise WebHmiError(
+                f"No API token for the web HMI: {path} not readable. Copy the token from the loop machine "
+                "(~/loop-data/webhmi/api_token of the user control) into this file (mode 600), or set "
+                "FLOMNI_WEBHMI_TOKEN_FILE.") from None
+        if not tok:
+            raise WebHmiError(f"API token file {path} is empty")
+        return tok
+
+    def _request(self, path, body=None):
+        try:
+            return self._request_once(self.url, path, body)
+        except WebHmiError as exc:
+            # default URL on port 8080 not reachable: the loop machine also serves the web HMI on port 80
+            if exc.unreachable and not self._explicit_url() and not self._fallback:
+                alt = self.url.replace(f":{DEFAULT_PORT}", "")
+                r = self._request_once(alt, path, body)
+                self._fallback = alt
+                return r
+            raise
+
+    def _request_once(self, url, path, body=None):
+        data = None if body is None else json.dumps(body).encode()
+        req = urllib.request.Request(url + path, data=data, method="GET" if body is None else "POST",
+                                     headers={"Authorization": "Bearer " + self._token(),
+                                              "X-Client": self.client_name, "Content-Type": "application/json"})
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                return json.load(r)
+        except urllib.error.HTTPError as exc:
+            try:
+                detail = json.load(exc).get("detail", exc.reason)
+            except Exception:  # noqa: BLE001
+                detail = exc.reason
+            if exc.code == 401:
+                detail = f"{detail} (API token not accepted by the web HMI: compare with its api_token_file)"
+            raise WebHmiError(f"web HMI {url}{path}: {exc.code} {detail}") from None
+        except (urllib.error.URLError, OSError) as exc:
+            err = WebHmiError(f"web HMI {url} not reachable: {exc}")
+            err.unreachable = True
+            raise err from None
+
+    def settings(self) -> dict:
+        """GET /api/settings: settings, rules, scan state, profiles."""
+        return self._request("/api/settings")
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 0ef07084..4b7e6cbf 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -800,6 +800,10 @@ them. The rules and the mapping onto the loop parameters are kept on the loop ma
   control loop; `save_as_default()` writes them into the loop's parameter files
 - `flomni.realtime_system.help()`
 
+Every scan stores the loop settings it ran with: the baseline device `flomni_loop_settings` (one value per
+setting, `available`, unsaved / inconsistent counts, the definition's sha1, a JSON of all settings);
+`dev.flomni_loop_settings.show()` prints what a scan would store now.
+
 FZP settings can only be changed between scans. BEC needs the API token of the web HMI in `~/.flomni_webhmi_token`
 (local contact; flOMNI `FeedbackLoop/loopsettings/README.md`).
 
diff --git a/tests/tests_devices/test_flomni_loop_settings.py b/tests/tests_devices/test_flomni_loop_settings.py
new file mode 100644
index 00000000..8c594316
--- /dev/null
+++ b/tests/tests_devices/test_flomni_loop_settings.py
@@ -0,0 +1,97 @@
+"""Tests for the baseline device flomni_loop_settings (devices/omny/flomni_loop_settings.py): the loop settings of
+the flOMNI web HMI stored with every scan. A small local HTTP server stands in for the web HMI (/api/settings)."""
+
+import json
+import math
+import threading
+from http.server import BaseHTTPRequestHandler, HTTPServer
+
+import pytest
+
+from csaxs_bec.devices.omny import flomni_loop_settings as fls
+from csaxs_bec.devices.omny.flomni_loop_settings import SETTINGS, FlomniLoopSettings
+
+TOKEN = "device-token-0123456789abcdef"
+
+SNAP = {
+    "instrument": "flOMNI", "definition": "/home/control/OMNY/flOMNI/FeedbackLoop/loopsettings/flomni.json",
+    "definition_sha1": "a" * 40, "scan": {"mode": 0, "active": False, "text": ""},
+    "settings": [
+        {"name": "fzp_enable", "value": 1, "unsaved": False, "consistent": True},
+        {"name": "fzp_range_V_x", "value": 1.5, "unsaved": True, "consistent": True},
+        {"name": "trigger_tolerance_nm", "value": 10.0, "unsaved": False, "consistent": False},
+        {"name": "new_setting_later", "value": 3.0, "unsaved": False, "consistent": True},
+    ],
+    "rules": [{"name": "r1", "severity": "error", "ok": False}, {"name": "r2", "severity": "warning", "ok": False}],
+}
+
+
+class _Handler(BaseHTTPRequestHandler):
+    hits = 0
+
+    def log_message(self, *args):
+        pass
+
+    def do_GET(self):
+        _Handler.hits += 1
+        code, body = (200, SNAP) if self.headers.get("Authorization") == "Bearer " + TOKEN else (401, {"detail": "no"})
+        data = json.dumps(body).encode()
+        self.send_response(code)
+        self.send_header("Content-Type", "application/json")
+        self.send_header("Content-Length", str(len(data)))
+        self.end_headers()
+        self.wfile.write(data)
+
+
+@pytest.fixture
+def url():
+    _Handler.hits = 0
+    srv = HTTPServer(("127.0.0.1", 0), _Handler)
+    threading.Thread(target=srv.serve_forever, daemon=True).start()
+    yield f"http://127.0.0.1:{srv.server_address[1]}"
+    srv.shutdown()
+
+
+def test_read_stores_settings(url):
+    dev = FlomniLoopSettings(name="flomni_loop_settings", url=url, token=TOKEN)
+    r = dev.read()
+    assert r["flomni_loop_settings_available"]["value"] == 1
+    assert r["flomni_loop_settings_fzp_enable"]["value"] == 1.0
+    assert r["flomni_loop_settings_fzp_range_V_x"]["value"] == 1.5
+    assert math.isnan(r["flomni_loop_settings_move_beyond_um_x"]["value"])        # not in the answer
+    assert r["flomni_loop_settings_unsaved"]["value"] == 1
+    assert r["flomni_loop_settings_inconsistent"]["value"] == 1
+    assert r["flomni_loop_settings_rules_violated"]["value"] == 1                  # error rules only
+    assert r["flomni_loop_settings_definition"]["value"].endswith("sha1 " + "a" * 40)
+    assert "new_setting_later" in r["flomni_loop_settings_message"]["value"]
+    snap = json.loads(r["flomni_loop_settings_snapshot_json"]["value"])
+    assert snap["settings"]["fzp_enable"]["value"] == 1 and "profiles" not in snap
+    assert snap["settings"]["new_setting_later"]["value"] == 3.0                  # later settings: in the JSON
+    assert [r["name"] for r in snap["rules_violated"]] == ["r1", "r2"]
+    assert set(SETTINGS) <= {k.replace("flomni_loop_settings_", "") for k in r}
+
+
+def test_unavailable_does_not_raise_and_backs_off(url, monkeypatch):
+    dev = FlomniLoopSettings(name="ls", url=url, token="wrong-token-xxxxxxxxxxxx")
+    r = dev.read()
+    assert r["ls_available"]["value"] == 0 and "401" in r["ls_message"]["value"]
+    assert math.isnan(r["ls_fzp_enable"]["value"]) and r["ls_unsaved"]["value"] == -1
+    hits = _Handler.hits
+    dev.read()                                   # within the back-off: no new request
+    assert _Handler.hits == hits
+    monkeypatch.setattr(fls, "RETRY_AFTER_FAILURE_S", 0.0)
+    dev.read()
+    assert _Handler.hits == hits + 1
+
+
+def test_unreachable():
+    dev = FlomniLoopSettings(name="ls", url="http://127.0.0.1:9", token=TOKEN, timeout=0.5)
+    r = dev.read()
+    assert r["ls_available"]["value"] == 0 and "not reachable" in r["ls_message"]["value"]
+
+
+def test_token_file_and_snapshot(url, tmp_path):
+    tok = tmp_path / "token"
+    tok.write_text(TOKEN + "\n")
+    dev = FlomniLoopSettings(name="ls", url=url, token_file=str(tok))
+    assert dev.snapshot()["fzp_range_V_x"] == 1.5

From 533fca8c2437159ea192188931d523ef7221e8af Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 16:39:40 +0000
Subject: [PATCH 077/102] feat(flomni): realtime_system goes through the device
 flomni_loop_settings (RPC); token in its device config

Mirko 2026-10-23: the token goes into the device config (behind the beamline firewall like the other devices); the
user commands call the BEC device in the background.

- FlomniLoopSettings: api_get / api_post (RPC for flomni.realtime_system; only /api/settings* and /api/status;
  10 s timeout, no back-off). Not named set / put: the BEC device server treats those as ophyd writes (refused on
  a readOnly device; checked in bec_server rpc_handler.py)
- FlomniRealtimeSystem: requests through dev.flomni_loop_settings when it exists and is enabled (errors from the
  device -> RealtimeSystemError), else direct HTTP as before; show() names the route
- ptycho_flomni.yaml: token field (empty: token_file is used)
- tests: RPC methods and path check; routing through a device and back to direct HTTP when it is disabled
  (checked against bec_server: deviceConfig keys are matched to the constructor parameters, device_manager is
  passed, the constructor does no network access)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/flomni/flomni_realtime_system.py  | 37 +++++++++++++++----
 csaxs_bec/device_configs/ptycho_flomni.yaml   |  6 ++-
 .../devices/omny/flomni_loop_settings.py      | 32 ++++++++++++++--
 docs/user/ptychography/flomni.md              |  4 +-
 .../test_flomni_realtime_system.py            | 32 ++++++++++++++++
 .../test_flomni_loop_settings.py              | 11 ++++++
 6 files changed, 108 insertions(+), 14 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index 19dd75e0..374c5366 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -14,10 +14,9 @@ web page (tab "Loop settings") and BEC always behave the same way.
 
 Changes are live only: the next start of the control loop uses the .xmp files again (save_as_default keeps them).
 
-Connection: the web HMI URL (default http://<rtx host>:8080, and http://<rtx host> (port 80, nftables redirect to
-8080 on the loop machine) when 8080 cannot be reached; env FLOMNI_WEBHMI_URL) and an API token in a file
-(default ~/.flomni_webhmi_token, env FLOMNI_WEBHMI_TOKEN_FILE; the same token as in the web HMI's api_token_file on
-the loop machine, see flOMNI FeedbackLoop/loopsettings/README.md).
+Connection: through the BEC device flomni_loop_settings (RPC; the API token is in its device config,
+ptycho_flomni.yaml) when it exists and is enabled, else directly to the web HMI (devices/omny/webhmi_client.py: URL
+http://<rtx host>:8080 with port-80 fallback, token from ~/.flomni_webhmi_token or FLOMNI_WEBHMI_TOKEN_FILE).
 """
 
 from csaxs_bec.devices.omny.webhmi_client import WebHmiClient
@@ -33,12 +32,36 @@ def _fmt(v):
 
 
 class FlomniRealtimeSystem(WebHmiClient):
-    """Connection (URL with port-80 fallback, token, errors): WebHmiClient (devices/omny/webhmi_client.py), shared
-    with the baseline device flomni_loop_settings."""
+    """Requests go through the BEC device flomni_loop_settings (RPC api_get / api_post; the token is in its device
+    config) when it exists and is enabled; otherwise directly to the web HMI (WebHmiClient,
+    devices/omny/webhmi_client.py; token from token_file / ~/.flomni_webhmi_token)."""
+
+    DEVICE = "flomni_loop_settings"
 
     def __init__(self, url=None, token_file=None, device_manager=None, timeout=5.0, token=None):
         super().__init__(url=url, token=token, token_file=token_file, device_manager=device_manager, timeout=timeout)
 
+    def _device(self):
+        try:
+            dev = getattr(self._device_manager.devices, self.DEVICE)
+        except Exception:  # noqa: BLE001  (no device manager / no such device)
+            return None
+        return dev if getattr(dev, "enabled", True) else None
+
+    def _request(self, path, body=None):
+        dev = self._device()
+        if dev is None:
+            return super()._request(path, body)            # direct HTTP
+        try:
+            return dev.api_get(path) if body is None else dev.api_post(path, body)
+        except Exception as exc:  # noqa: BLE001  (RPC error with the device-side message)
+            raise RealtimeSystemError(f"via device {self.DEVICE}: {exc}") from None
+
+    @property
+    def route(self):
+        """'device flomni_loop_settings' or the direct URL."""
+        return f"device {self.DEVICE}" if self._device() is not None else self.url
+
     # ── reading ───────────────────────────────────────────────────────────────
 
     def read(self) -> dict:
@@ -59,7 +82,7 @@ class FlomniRealtimeSystem(WebHmiClient):
         snap = self.read()
         groups = {g["name"]: g for g in snap["groups"]}
         sc = snap.get("scan") or {}
-        print(f"Loop settings {snap.get('instrument', '')} ({self.url}) - "
+        print(f"Loop settings {snap.get('instrument', '')} ({self.route}) - "
               + (f"scan running (mode {_fmt(sc.get('mode'))})" if sc.get("active") else "no scan"))
         for gname, g in groups.items():
             if group and gname != group:
diff --git a/csaxs_bec/device_configs/ptycho_flomni.yaml b/csaxs_bec/device_configs/ptycho_flomni.yaml
index 3aacbcaa..677355a1 100644
--- a/csaxs_bec/device_configs/ptycho_flomni.yaml
+++ b/csaxs_bec/device_configs/ptycho_flomni.yaml
@@ -620,13 +620,15 @@ flomni_temphum:
 # ############################################################
 # The loop settings (FZP, trigger, tracker; flOMNI FeedbackLoop/loopsettings) stored with every scan: read from the
 # web HMI on the loop machine at the start of each scan (baseline). Web HMI down: available = 0, the scan continues.
-# token_file: a file with the web HMI API token on the machine of the device server (mode 600). The token itself can
-# be given as "token: <value>" instead, but only in a config that is not committed - never put it in this file.
+# The user commands flomni.realtime_system go through this device (RPC), so the token is needed only here.
+# token: the web HMI API token (~/loop-data/webhmi/api_token on mpc2844; behind the beamline firewall, Mirko
+# 2026-10-23). When empty, token_file (on the machine of the device server) is used.
 flomni_loop_settings:
   description: flOMNI real-time loop settings (web HMI loop settings, snapshot at scan start)
   deviceClass: csaxs_bec.devices.omny.flomni_loop_settings.FlomniLoopSettings
   deviceConfig:
     host: mpc2844.psi.ch
+    token: ""
     token_file: ~/.flomni_webhmi_token
     timeout: 2.0
   enabled: true
diff --git a/csaxs_bec/devices/omny/flomni_loop_settings.py b/csaxs_bec/devices/omny/flomni_loop_settings.py
index 16feee75..0a59324c 100644
--- a/csaxs_bec/devices/omny/flomni_loop_settings.py
+++ b/csaxs_bec/devices/omny/flomni_loop_settings.py
@@ -16,9 +16,12 @@ Signals: one per setting (float, NaN when not available; names = the setting nam
     snapshot_json   JSON: every setting (value, saved, unsaved, consistent, unit), the violated rules, the
                     scan state, the definition path and sha1
 
-deviceConfig: token (the API token itself; only in a config that is not committed) or token_file (path to a file
-with it, default ~/.flomni_webhmi_token), optional url / host / timeout (default 2 s). Connection details:
+deviceConfig: token (the API token itself), else token_file (path to a file with it, default
+~/.flomni_webhmi_token), optional url / host / timeout (default 2 s for the scan snapshot). Connection details:
 devices/omny/webhmi_client.py.
+
+flomni.realtime_system (the user commands) calls api_get / api_post of this device by RPC, so the token is needed
+only here.
 """
 
 import json
@@ -45,7 +48,7 @@ RETRY_AFTER_FAILURE_S = 60.0    # web HMI not reachable: no new attempt for this
 
 
 class FlomniLoopSettings(Device):
-    USER_ACCESS = ["show", "snapshot"]
+    USER_ACCESS = ["show", "snapshot", "api_get", "api_post"]
 
     available = Cpt(Signal, value=0, kind=Kind.normal)
     message = Cpt(Signal, value="", kind=Kind.normal)
@@ -63,6 +66,9 @@ class FlomniLoopSettings(Device):
         super().__init__(prefix, name=name, **kwargs)
         self._client = WebHmiClient(url=url, token=token, token_file=token_file, host=host,
                                     device_manager=device_manager, timeout=timeout, client_name="BEC baseline")
+        # requests of flomni.realtime_system (RPC from the client, below): longer timeout, no back-off
+        self._api = WebHmiClient(url=url, token=token, token_file=token_file, host=host,
+                                 device_manager=device_manager, timeout=max(timeout, 10.0), client_name="BEC")
         self._failed_at = None
         self._last = None
 
@@ -120,6 +126,26 @@ class FlomniLoopSettings(Device):
         self.update()
         return super().read()
 
+    # ── RPC for flomni.realtime_system: the user commands go through this device, so the API token is needed only
+    # in its device config (device server), not on the client. Not called set / put: the device server treats
+    # those names as ophyd writes (refused on a readOnly device).
+
+    _API_PATHS = ("/api/settings", "/api/status")
+
+    def _check_path(self, path):
+        if not any(path == p or path.startswith(p + "/") for p in self._API_PATHS):
+            raise WebHmiError(f"path {path!r} not allowed (only /api/settings*, /api/status)")
+
+    def api_get(self, path: str = "/api/settings") -> dict:
+        """GET a web HMI loop-settings endpoint; returns its JSON. Errors raise (passed to the client)."""
+        self._check_path(path)
+        return self._api._request(path)
+
+    def api_post(self, path: str, body: dict = None) -> dict:
+        """POST to a web HMI loop-settings endpoint (plan / apply / save); returns its JSON."""
+        self._check_path(path)
+        return self._api._request(path, body or {})
+
     def snapshot(self) -> dict:
         """Read now and return {setting: value} (empty when not available)."""
         self._failed_at = None                      # an explicit request always tries
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 4b7e6cbf..61baa612 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -804,8 +804,8 @@ Every scan stores the loop settings it ran with: the baseline device `flomni_loo
 setting, `available`, unsaved / inconsistent counts, the definition's sha1, a JSON of all settings);
 `dev.flomni_loop_settings.show()` prints what a scan would store now.
 
-FZP settings can only be changed between scans. BEC needs the API token of the web HMI in `~/.flomni_webhmi_token`
-(local contact; flOMNI `FeedbackLoop/loopsettings/README.md`).
+FZP settings can only be changed between scans. The commands go through the device `flomni_loop_settings`, whose
+config holds the web HMI API token (local contact; flOMNI `FeedbackLoop/loopsettings/README.md`).
 
 ### Detector trigger and interferometer tuning
 
diff --git a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
index 728f5527..18274088 100644
--- a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
+++ b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
@@ -165,3 +165,35 @@ def test_port_80_fallback(monkeypatch):
     monkeypatch.setattr(explicit, "_request_once", once)
     with pytest.raises(RealtimeSystemError):
         explicit._request("/api/settings")
+
+
+def test_routes_through_the_device():
+    """With the BEC device flomni_loop_settings present and enabled, requests go to it by RPC (api_get / api_post),
+    no token on the client; errors of the device come back as RealtimeSystemError."""
+    calls = []
+
+    class Dev:
+        enabled = True
+
+        def api_get(self, path):
+            calls.append(("get", path))
+            return {"settings": [{"name": "trigger_tolerance_nm", "value": 10.0}]}
+
+        def api_post(self, path, body):
+            calls.append(("post", path, body))
+            if "move_beyond_um_x" in body.get("changes", {}):
+                raise RuntimeError("web HMI not reachable")
+            return {"ok": True, "errors": [], "warnings": [], "changes": [], "params": [], "applied": False}
+
+    dm = type("DM", (), {})()
+    dm.devices = type("D", (), {})()
+    dm.devices.flomni_loop_settings = Dev()
+    rts = FlomniRealtimeSystem(device_manager=dm, token_file="/nonexistent")   # token never read
+    assert rts.get("trigger_tolerance_nm") == 10.0 and rts.route == "device flomni_loop_settings"
+    rts.check(fzp_enable=0)
+    assert calls[-1] == ("post", "/api/settings/plan", {"changes": {"fzp_enable": 0}, "profile": None, "adjust": False})
+    with pytest.raises(RealtimeSystemError, match="via device flomni_loop_settings: web HMI not reachable"):
+        rts.set(move_beyond_um_x=0.5)
+    dm.devices.flomni_loop_settings.enabled = False                        # disabled: direct HTTP
+    with pytest.raises(RealtimeSystemError, match="No API token"):
+        rts.get()
diff --git a/tests/tests_devices/test_flomni_loop_settings.py b/tests/tests_devices/test_flomni_loop_settings.py
index 8c594316..08066006 100644
--- a/tests/tests_devices/test_flomni_loop_settings.py
+++ b/tests/tests_devices/test_flomni_loop_settings.py
@@ -95,3 +95,14 @@ def test_token_file_and_snapshot(url, tmp_path):
     tok.write_text(TOKEN + "\n")
     dev = FlomniLoopSettings(name="ls", url=url, token_file=str(tok))
     assert dev.snapshot()["fzp_range_V_x"] == 1.5
+
+
+def test_api_methods_for_realtime_system(url):
+    """api_get / api_post: the RPC used by flomni.realtime_system (token only in the device config)."""
+    dev = FlomniLoopSettings(name="ls", url=url, token=TOKEN)
+    assert dev.api_get("/api/settings")["instrument"] == "flOMNI"
+    with pytest.raises(Exception, match="not allowed"):
+        dev.api_get("/api/params")                 # only the loop-settings endpoints
+    with pytest.raises(Exception, match="not allowed"):
+        dev.api_post("/api/loop/stop", {})
+    assert "api_get" in FlomniLoopSettings.USER_ACCESS and "set" not in FlomniLoopSettings.USER_ACCESS

From 76aa2b9e56b52044cb1855a91642f6c9b199efa8 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 18:56:12 +0000
Subject: [PATCH 078/102] feat(flomni): realtime_system.help(name) /
 help("all"); marked beamline scientists / local contact only

- help("<setting>"): what it does (help text of the flOMNI definition, as the web HMI tooltips), range, live and
  saved value, the loop parameters it sets, its rules; help("all"): every setting by group
- realtime_system is for beamline scientists / local contact only (Mirko 2026-10-23): module docstring, a line at
  show() / help(), user guide section heading and note
- tests: help output

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/flomni/flomni_realtime_system.py  | 61 +++++++++++++++++--
 docs/user/ptychography/flomni.md              | 10 ++-
 .../test_flomni_realtime_system.py            | 15 +++++
 3 files changed, 78 insertions(+), 8 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index 374c5366..be6d666f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -1,4 +1,8 @@
-"""flomni.realtime_system: the operating settings of the flOMNI real-time loop (expert functions).
+"""flomni.realtime_system: the operating settings of the flOMNI real-time loop.
+
+BEAMLINE SCIENTISTS / LOCAL CONTACT ONLY - not for users. These settings change how the FZP scanner, the detector
+trigger and the laser tracker work; a wrong combination can spoil a beamtime's data. The rules refuse combinations
+that do not work, but not ones that are only unsuitable for an experiment.
 
 The settings, the parameters they map onto and the rules between them live in the flOMNI instrument repository
 (FeedbackLoop/loopsettings/flomni.json) and are applied by the web HMI on the loop machine (RT-system
@@ -23,6 +27,9 @@ from csaxs_bec.devices.omny.webhmi_client import WebHmiClient
 from csaxs_bec.devices.omny.webhmi_client import WebHmiError as RealtimeSystemError  # name kept for BEC users
 
 
+STAFF_ONLY = "flomni.realtime_system: beamline scientists / local contact only - not for users."
+
+
 def _fmt(v):
     if v is None:
         return "-"
@@ -82,6 +89,7 @@ class FlomniRealtimeSystem(WebHmiClient):
         snap = self.read()
         groups = {g["name"]: g for g in snap["groups"]}
         sc = snap.get("scan") or {}
+        print(STAFF_ONLY)
         print(f"Loop settings {snap.get('instrument', '')} ({self.route}) - "
               + (f"scan running (mode {_fmt(sc.get('mode'))})" if sc.get("active") else "no scan"))
         for gname, g in groups.items():
@@ -216,8 +224,49 @@ class FlomniRealtimeSystem(WebHmiClient):
         v = self.get()
         return v["tracking_target_y"], v["tracking_target_z"]
 
-    def help(self):
-        """Print the functions with a short explanation."""
-        print(__doc__.split("\n\nConnection:")[0])
-        print("\nShortcuts: trigger_show(), trigger_set_tolerance_nm(v), trigger_set_hold_ms(v),"
-              " trigger_set_after_move(True/False), tracking_targets(); profiles(), unsaved(), get(name)")
+    def help(self, name: str = None):
+        """help(): the functions; help("all"): every setting with its explanation; help(name): one setting (what it
+        does, unit, range, the loop parameters it sets, live and saved value), from the definition on the loop
+        machine (the same text as the tooltips of the web HMI tab)."""
+        if name is None:
+            print(__doc__.split("\n\nConnection:")[0])
+            print("\nShortcuts: trigger_show(), trigger_set_tolerance_nm(v), trigger_set_hold_ms(v),"
+                  " trigger_set_after_move(True/False), tracking_targets(); profiles(), unsaved(), get(name)")
+            print('Explanations: help("all") or help("<setting>"), e.g. help("move_beyond_um_x")')
+            return
+        snap = self.read()
+        settings = {s["name"]: s for s in snap["settings"]}
+        groups = {g["name"]: g for g in snap["groups"]}
+        if name == "all":
+            print(STAFF_ONLY)
+            for gname, g in groups.items():
+                rows = [s for s in snap["settings"] if s["group"] == gname]
+                if not rows:
+                    continue
+                print(f"\n{g.get('title', gname)}" + ("  (only between scans)" if g.get("interlock") else ""))
+                for s in rows:
+                    unit = f" [{s['unit']}]" if s.get("unit") else ""
+                    print(f"  {s['name']}{unit}: {s.get('title', '')}")
+                    if s.get("help"):
+                        print(f"      {s['help']}")
+            return
+        s = settings.get(name)
+        if s is None:
+            raise RealtimeSystemError(f"unknown setting '{name}'; help('all') lists them")
+        g = groups.get(s["group"], {})
+        print(STAFF_ONLY)
+        print(f"{s['name']} - {s.get('title', '')} (group {g.get('title', s['group'])}"
+              + (", only between scans)" if g.get("interlock") else ")"))
+        if s.get("help"):
+            print(f"  {s['help']}")
+        rng = "0 / 1" if s.get("type") == "bool" else f"{_fmt(s.get('min'))} ... {_fmt(s.get('max'))} {s.get('unit', '')}"
+        print(f"  range: {rng}")
+        print(f"  live: {_fmt(s.get('value'))}   saved (.xmp): {_fmt(s.get('saved'))}"
+              + ("   NOT SAVED" if s.get("unsaved") else "") + ("" if s.get("consistent", True) else "   INCONSISTENT"))
+        if s.get("info"):
+            print(f"  {s['info'].get('label', '')} {s['info']['value']:.4g} {s['info'].get('unit', '')}")
+        print("  sets: " + ", ".join(f"{t['module']}.{t['param']}[{t['index']}] = {t.get('write', 'v')}"
+                                     for t in s.get("targets", [])))
+        rules = [r for r in snap.get("rules", []) if name in r.get("settings", [])]
+        if rules:
+            print("  rules: " + ", ".join(r["name"] + ("" if r.get("ok") else " (VIOLATED)") for r in rules))
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 61baa612..b8b99e4a 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -224,6 +224,8 @@ In step scans the detector is triggered when the sample is stable at the scan po
 sample vs FZP (interferometer minus FZP cap sensor) must stay within a tolerance in x and in y (each averaged
 over 0.5 ms) for a hold time. Both values are live and can be changed between scans:
 
+(Beamline scientists / local contact only, see below.)
+
 - `flomni.realtime_system.trigger_show()` — current tolerance, hold time, minimum delay, trigger after a move
 - `flomni.realtime_system.trigger_set_tolerance_nm(10)` — tolerance per axis in nm: about 30 for a fast
   low-resolution scan, 10 standard, 2 for the highest resolution (a few ms more per point);
@@ -782,7 +784,10 @@ removed later.
 
 [See short version](flomni.md#sample-storage-and-transfer)
 
-### Real-time loop settings (expert): `flomni.realtime_system`
+### Real-time loop settings: `flomni.realtime_system` (beamline scientists / local contact only)
+
+**Not for users.** These settings change how the FZP scanner, the detector trigger and the laser tracker work; a
+wrong combination can spoil the data of a beamtime. Users ask the local contact.
 
 The operating settings of the real-time loop — FZP scanner on/off, FZP range, feedforward, move-beyond, exposure
 during the motion, Abbe correction, detector trigger, laser tracker targets and thresholds — with the rules between
@@ -798,7 +803,8 @@ them. The rules and the mapping onto the loop parameters are kept on the loop ma
 - `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "fast_scan")`
 - `flomni.realtime_system.unsaved()`, `save_as_default()` — the changes are live only until the next start of the
   control loop; `save_as_default()` writes them into the loop's parameter files
-- `flomni.realtime_system.help()`
+- `flomni.realtime_system.help()`; `help("all")` explains every setting, `help("move_beyond_um_x")` one setting
+  (what it does, range, the loop parameters it sets, live and saved value, its rules)
 
 Every scan stores the loop settings it ran with: the baseline device `flomni_loop_settings` (one value per
 setting, `available`, unsaved / inconsistent counts, the definition's sha1, a JSON of all settings);
diff --git a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
index 18274088..ec664b87 100644
--- a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
+++ b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
@@ -197,3 +197,18 @@ def test_routes_through_the_device():
     dm.devices.flomni_loop_settings.enabled = False                        # disabled: direct HTTP
     with pytest.raises(RealtimeSystemError, match="No API token"):
         rts.get()
+
+
+def test_help(server, capsys):
+    """help(name) / help("all"): explanations from the definition, marked as beamline-scientist only."""
+    url, tok, _ = server
+    rts = FlomniRealtimeSystem(url=url, token_file=tok)
+    rts.help("trigger_tolerance_nm")
+    out = capsys.readouterr().out
+    assert "local contact only" in out and "trigger_tolerance_nm" in out and "live: 10" in out
+    rts.help("all")
+    assert "Detector trigger" in capsys.readouterr().out
+    rts.help()
+    assert "BEAMLINE SCIENTISTS" in capsys.readouterr().out
+    with pytest.raises(RealtimeSystemError, match="unknown setting"):
+        rts.help("nosuch")

From 7c0a15115d95731979465b93f395d350aa32aa24 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 23 Oct 2026 18:57:47 +0000
Subject: [PATCH 079/102] docs(flomni): loop settings out of the user guide;
 beamline-scientist document local_contact_only-realtime_system.md

Mirko 2026-10-23: a user could change the loop settings and even save them as the new default. The user guide now
only says that the real-time loop settings are set by the local contact, that every scan stores them, and where the
details are; the commands (realtime_system, trigger, tracker), the profiles, save_as_default, the baseline device,
the connection and the web HMI are in plugins/flomni/docs/local_contact_only-realtime_system.md. The detector
trigger section of the user guide keeps the explanation and the measured times, without commands. show() / help()
name the document.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../local_contact_only-realtime_system.md     | 81 +++++++++++++++++++
 .../plugins/flomni/flomni_realtime_system.py  |  3 +-
 docs/user/ptychography/flomni.md              | 63 +++------------
 3 files changed, 93 insertions(+), 54 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
new file mode 100644
index 00000000..0fbce70c
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
@@ -0,0 +1,81 @@
+# flOMNI real-time loop settings (beamline scientists / local contact only)
+
+**Not for users.** `flomni.realtime_system` changes how the FZP scanner, the detector trigger and the laser tracker
+work, and `save_as_default()` makes a change the default of every following loop start. A wrong combination can spoil
+the data of a beamtime. The user guide only says that these settings exist, are set by the local contact and are
+stored with every scan; the details are here.
+
+Background and reference (flOMNI control repository, `OMNY/flOMNI` on gitea):
+
+- `FeedbackLoop/loopsettings/README.md` — every setting with the loop parameters it sets and its production value,
+  the rules, the profiles; `FeedbackLoop/loopsettings/flomni.json` — the definition (help texts, rules, profiles)
+- `FeedbackLoop/tuning_guide.md`, `FeedbackLoop/feedback_report.md` — characterization, measurements, why the values
+- RT-system `docs/loop-settings.md` — design, the web HMI side, installation
+- the FZP how-tos next to this file (`local_contact_only-howto_calibrate_the_fzp_scanner.md`,
+  `local_contact_only-howto_limit_the_fzp_scanner_range.md`) — move-beyond, FZP range, calibration steps as profiles
+
+## What can be set
+
+| Group | Settings |
+|---|---|
+| FZP scanner (only between scans) | `fzp_enable` (both axes or none), `fzp_range_V_x` / `_y`, `feedforward_enable`, `move_beyond_um_x` / `_y`, `exposure_during_motion`, `abbe_enable`, `abbe_limit_um` |
+| Detector trigger | `trigger_tolerance_nm`, `trigger_hold_ms`, `trigger_min_delay_ms`, `trigger_on_move` |
+| Laser tracker and thresholds | `tracking_target_y` / `_z`, `psd_threshold_low`, `interferometer_threshold`, `interferometer_threshold_rot` |
+| FZP calibration (expert, only between scans) | `sample_hold_fzp_V`, `sample_hold_err_um`, `sample_hold_zero` |
+
+`flomni.realtime_system.help("all")` explains every setting, `help("<setting>")` one setting (what it does, range,
+live and saved value, the loop parameters it sets, its rules).
+
+## Commands
+
+- `flomni.realtime_system.show()` — all settings with live and saved value, violated rules, scan state
+  (`show(expert=True)` also the FZP calibration group)
+- `flomni.realtime_system.set(name=value, ...)` — change; refused with the reason if a rule objects (e.g. the
+  feedforward must be off while the FZP loop is off); `set(..., adjust=True)` changes the dependent settings the
+  rule names (never the ones given)
+- `flomni.realtime_system.check(name=value)` — dry run
+- `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "fast_scan")`
+- `flomni.realtime_system.unsaved()` — what differs from the loop's parameter files
+- `flomni.realtime_system.save_as_default()` — writes the live values into the loop's parameter files: the next
+  loop start uses them. Only for a change that should stay (a backup of each file is kept on the loop machine).
+- `flomni.realtime_system.help()`, `help("all")`, `help("<setting>")`
+
+Changes are live only until the next start of the control loop, unless saved. FZP settings can only be changed
+between scans (refused while a scan runs); trigger and tracker settings any time.
+
+### Detector trigger
+
+In step scans the detector is triggered when the relative position sample vs FZP (interferometer minus FZP cap
+sensor) stays within the tolerance in x and in y (each averaged over 0.5 ms) for the hold time.
+
+- `flomni.realtime_system.trigger_show()` — tolerance, hold time, minimum delay, trigger after a move
+- `flomni.realtime_system.trigger_set_tolerance_nm(10)` — about 30 for a fast low-resolution scan, 10 standard,
+  2 for the highest resolution (a few ms more per point); 0 = the former criterion (on-target flags of the FZP loops)
+- `flomni.realtime_system.trigger_set_hold_ms(3)` — hold time in ms
+- `flomni.realtime_system.trigger_set_after_move(True)` — also one trigger after every position change of the
+  sample stage (e.g. `umv(dev.rtx, ...)`, `dev.rtx.controller.move_xyz(x, y, z)`) once on target; `False` (default):
+  scan points only
+
+The former `flomni.interferometer_trigger_*` were removed 2026-10-23.
+
+### Laser tracker
+
+`flomni.laser_parameters_show_all()`, `laser_parameters_set_targety(v)` / `_targetz(v)`,
+`laser_parameters_set_intensity_threshold_laser(v)`, `laser_parameters_set_psd_intensity_threshold_tracking_low(v)`
+and the arrow-key tweak `laser_parameters_tweak_tracking()` use the same settings (`tracking_target_y` / `_z`,
+`interferometer_threshold`, `psd_threshold_low`).
+
+## Stored with every scan
+
+The baseline device `flomni_loop_settings` is read at the start of every scan: one value per setting,
+`available` (0 when the loop machine could not be reached — the scan continues), the number of settings not saved
+as default or inconsistent, violated error rules, the definition with its sha1, and a JSON of all settings.
+`dev.flomni_loop_settings.show()` prints what a scan would store now.
+
+## Connection
+
+`flomni.realtime_system` sends its requests through the device `flomni_loop_settings` (device server). The device
+talks to the web HMI on the loop machine (`http://mpc2844:8080`, REST `/api/settings`; port 80 as fallback) with the
+API token in its device config (`ptycho_flomni.yaml`, `token:`; the line of `~/loop-data/webhmi/api_token` on
+mpc2844). Without that device (e.g. a simulated config) the client talks to the web HMI directly with
+`~/.flomni_webhmi_token`. The web HMI tab *Loop settings* shows and changes the same settings with the same rules.
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index be6d666f..0c08651f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -27,7 +27,8 @@ from csaxs_bec.devices.omny.webhmi_client import WebHmiClient
 from csaxs_bec.devices.omny.webhmi_client import WebHmiError as RealtimeSystemError  # name kept for BEC users
 
 
-STAFF_ONLY = "flomni.realtime_system: beamline scientists / local contact only - not for users."
+STAFF_ONLY = ("flomni.realtime_system: beamline scientists / local contact only - not for users "
+              "(plugins/flomni/docs/local_contact_only-realtime_system.md).")
 
 
 def _fmt(v):
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index b8b99e4a..9b7f1270 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -221,26 +221,12 @@ _There is also an enable without reset, which is used during tomography scans, w
 #### Detector trigger: position stability
 
 In step scans the detector is triggered when the sample is stable at the scan point: the relative position
-sample vs FZP (interferometer minus FZP cap sensor) must stay within a tolerance in x and in y (each averaged
-over 0.5 ms) for a hold time. Both values are live and can be changed between scans:
+sample vs FZP must stay within a tolerance in x and in y for a short hold time (standard 10 nm, 3 ms). The local
+contact can choose a coarser tolerance for fast low-resolution scans or a finer one for the highest resolution.
+Measured with 3 µm steps (2026-10-20): the trigger comes about 36 ms (x) / 48 ms (y) after the step at 10 nm,
+40 / 55 ms at 2 nm; after the trigger the position stays within about 4 nm even at a 30 nm tolerance.
 
-(Beamline scientists / local contact only, see below.)
-
-- `flomni.realtime_system.trigger_show()` — current tolerance, hold time, minimum delay, trigger after a move
-- `flomni.realtime_system.trigger_set_tolerance_nm(10)` — tolerance per axis in nm: about 30 for a fast
-  low-resolution scan, 10 standard, 2 for the highest resolution (a few ms more per point);
-  0 selects the former criterion (on-target flags of the FZP loops)
-- `flomni.realtime_system.trigger_set_hold_ms(3)` — hold time in ms
-- `flomni.realtime_system.trigger_set_after_move(True)` — additionally one trigger after every position change
-  of the sample stage (e.g. `umv(dev.rtx, ...)`), as soon as the position is stable with the same tolerance and
-  hold time; `False` (default): triggers at scan points only
-- `dev.rtx.controller.move_xyz(x, y, z)` — moves rtx, rty and rtz with one command (one trigger for the move)
-
-The former names `flomni.interferometer_trigger_*` were removed (2026-10-23). The values are live; after
-a restart of the control loop the values of the loop's parameter files (10 nm, 3 ms) apply again, unless they were
-saved with `flomni.realtime_system.save_as_default()`. Measured with 3 µm steps
-(2026-10-20): the trigger comes about 36 ms (x) / 48 ms (y) after the step at 10 nm, 40 / 55 ms at 2 nm;
-after the trigger the position stays within about 4 nm even at a 30 nm tolerance.
+- `dev.rtx.controller.move_xyz(x, y, z)` — moves rtx, rty and rtz with one command
 
 ### Scanning in 2D and sample alignment
 
@@ -784,42 +770,13 @@ removed later.
 
 [See short version](flomni.md#sample-storage-and-transfer)
 
-### Real-time loop settings: `flomni.realtime_system` (beamline scientists / local contact only)
+### Real-time loop settings
 
-**Not for users.** These settings change how the FZP scanner, the detector trigger and the laser tracker work; a
-wrong combination can spoil the data of a beamtime. Users ask the local contact.
+The operating settings of the real-time control loop (FZP scanner, detector trigger, laser tracker) are set by the
+local contact; please do not change them. Every scan stores the settings it ran with (baseline device
+`flomni_loop_settings`).
 
-The operating settings of the real-time loop — FZP scanner on/off, FZP range, feedforward, move-beyond, exposure
-during the motion, Abbe correction, detector trigger, laser tracker targets and thresholds — with the rules between
-them. The rules and the mapping onto the loop parameters are kept on the loop machine (web HMI tab *Loop settings*,
-`http://mpc2844:8080/?tab=settings`; definition in the flOMNI control repository,
-`FeedbackLoop/loopsettings/flomni.json` and `README.md`); BEC and the web page use the same rules.
-
-- `flomni.realtime_system.show()` — all settings with live and saved value, violated rules, scan state
-  (`show(expert=True)` also the FZP calibration group)
-- `flomni.realtime_system.set(name=value, ...)` — change; refused (with the reason) if a rule objects, e.g. the
-  feedforward must be off while the FZP loop is off; `set(..., adjust=True)` changes the dependent settings too
-- `flomni.realtime_system.check(name=value)` — dry run
-- `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "fast_scan")`
-- `flomni.realtime_system.unsaved()`, `save_as_default()` — the changes are live only until the next start of the
-  control loop; `save_as_default()` writes them into the loop's parameter files
-- `flomni.realtime_system.help()`; `help("all")` explains every setting, `help("move_beyond_um_x")` one setting
-  (what it does, range, the loop parameters it sets, live and saved value, its rules)
-
-Every scan stores the loop settings it ran with: the baseline device `flomni_loop_settings` (one value per
-setting, `available`, unsaved / inconsistent counts, the definition's sha1, a JSON of all settings);
-`dev.flomni_loop_settings.show()` prints what a scan would store now.
-
-FZP settings can only be changed between scans. The commands go through the device `flomni_loop_settings`, whose
-config holds the web HMI API token (local contact; flOMNI `FeedbackLoop/loopsettings/README.md`).
-
-### Detector trigger and interferometer tuning
-
-The trigger tolerance and hold time: [Detector trigger: position stability](#detector-trigger-position-stability)
-(`flomni.realtime_system.trigger_*`). The control loops of the sample stage, the FZP scanner and the laser
-tracker were characterized and retuned in October 2026; results, the present parameters and how to retune them
-are documented in the flOMNI control repository (`FeedbackLoop/feedback_report.md` with PDF,
-`FeedbackLoop/tuning_guide.md`).
+Details for beamline scientists: `csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md`.
 
 ### Heater
 

From 1a5b53c03120e51aeeadbd2ad20d51bc57c50a55 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 24 Oct 2026 06:38:54 +0000
Subject: [PATCH 080/102] fix(flomni): review fixes: absolute isclose
 tolerances, alignment retry, special angles, resume after completion

- np.isclose(a, b, x) took x as rtol: fsamx out (+-1.6 mm), gripper sensor voltage (+-0.55 V / +-1.1 V at
  -2.2 V), fsamx in checks now use atol (0.2 / 0.5 mm, 0.25 / 0.5 V, fsamx out 0.5 mm = Galil tolerance)
- tomo_alignment_scan: an angle with a TimeoutError is repeated (successful was set unconditionally, the
  angle was skipped); ptychotomoalign_scannum.txt is rewritten with the accepted scans if numbers shifted
- special angles: special_angle_tolerance is used (was hard-coded 0.5; init value 20 -> 0.5), any remaining
  special angle matches (not only the first in the list), kept on tomo_scan_resume in the same session
- tomo_scan_resume after a completed scan does nothing (progress tomo_completed; re-acquired the last
  projection and repeated the end-of-scan steps before); tomo_queue_reacquire clears the flag
- laser_parameters_tweak_tracking docstring: step 0.02

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/OMNY_shared/tomo_queue_mixin.py   |   2 +
 .../plugins/flomni/flomni.py                  |  65 ++++++--
 .../test_flomni_review_fixes.py               | 141 ++++++++++++++++++
 .../test_flomni_special_angles.py             |  32 ++++
 4 files changed, 224 insertions(+), 16 deletions(-)
 create mode 100644 tests/tests_bec_ipython_client/test_flomni_review_fixes.py

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
index efa0a2c9..f46cfe3e 100644
--- a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/tomo_queue_mixin.py
@@ -1157,6 +1157,8 @@ class TomoQueueMixin:
         self.progress["estimated_finish_time"] = None
         self.progress["accumulated_idle_time"] = 0.0
         self.progress["heartbeat"] = None
+        # flOMNI: a completed scan is not resumed (tomo_scan_resume); reopened here on purpose
+        self.progress["tomo_completed"] = False
 
         job_id = job["id"]
         self._tomo_queue_proxy.update_by_id(job_id, status="incomplete")
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index fc2768a1..3f175ba5 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -82,7 +82,8 @@ class FlomniInitStagesMixin:
         sensor_voltage_target = dev.ftransy.user_parameter.get("sensor_voltage")
         sensor_voltage = float(dev.ftransy.controller.socket_put_and_receive("MG@AN[1]").strip())
 
-        if not np.isclose(sensor_voltage, sensor_voltage_target, 0.25):
+        # absolute tolerances (V, mm): the third positional argument of np.isclose is rtol
+        if not np.isclose(sensor_voltage, sensor_voltage_target, rtol=0, atol=0.25):
             print(
                 f"Sensor voltage of the gripper is {sensor_voltage}, while target from config is {sensor_voltage_target}"
             )
@@ -410,7 +411,7 @@ class FlomniSampleTransferMixin:
         self.ensure_osa_back()
 
         fsamx_in = dev.fsamx.user_parameter.get("in")
-        if not np.isclose(dev.fsamx.readback.get(), fsamx_in, 0.2):
+        if not np.isclose(dev.fsamx.readback.get(), fsamx_in, rtol=0, atol=0.2):
             raise FlomniError("fsamx not in position. Aborting.")
 
         fheater_in = dev.fheater.user_parameter.get("in")
@@ -525,7 +526,7 @@ class FlomniSampleTransferMixin:
         """Interactive tweak of the two laser tracking target positions.
 
         Arrow keys nudge the tracking targets (realtime_system tracking_target_y / _z) by a fixed step of
-        0.01 (absolute set of current +/- step):
+        0.02 (absolute set of current +/- step):
             left / right : target y  -/+
             up   / down  : target z  +/-
         Keys:
@@ -724,7 +725,7 @@ class FlomniSampleTransferMixin:
         self.flomnigui_raise()
 
         target_pos = -162
-        if np.isclose(dev.fsamx.readback.get(), target_pos, 0.01):
+        if np.isclose(dev.fsamx.readback.get(), target_pos, rtol=0, atol=0.5):
             return
 
         umv(dev.fsamroy, 0)
@@ -764,7 +765,7 @@ class FlomniSampleTransferMixin:
         sensor_voltage_target = dev.ftransy.user_parameter.get("sensor_voltage")
         sensor_voltage = float(dev.ftransy.controller.socket_put_and_receive("MG@AN[1]").strip())
 
-        if not np.isclose(sensor_voltage, sensor_voltage_target, 0.5):
+        if not np.isclose(sensor_voltage, sensor_voltage_target, rtol=0, atol=0.5):
             raise FlomniError(f"Sensor voltage is {sensor_voltage}, indicates an error. Aborting.")
 
     def ftransfer_get_sample(self, position: int):
@@ -1643,6 +1644,8 @@ class _ProgressProxy:
         "estimated_finish_time": None,
         "heartbeat": None,
         "accumulated_idle_time": 0.0,
+        # set when tomo_scan() reached its end: tomo_scan_resume() then has nothing to resume
+        "tomo_completed": False,
     }
 
     def __init__(self, client):
@@ -1718,7 +1721,7 @@ class Flomni(
         self.device_manager = client.device_manager
         self.special_angles = []
         self.special_angle_repeats = 20
-        self.special_angle_tolerance = 20
+        self.special_angle_tolerance = 0.5
         self._current_special_angles = []
         self._beam_is_okay = True
         self._progress_proxy = _ProgressProxy(self.client)
@@ -1850,7 +1853,7 @@ class Flomni(
                 self.align.align(keep_shutter_open)
             except KeyboardInterrupt as exc:
                 fsamx_in = self._get_user_param_safe(dev.fsamx, "in")
-                if np.isclose(fsamx_in, dev.fsamx.readback.get(), 0.5):
+                if np.isclose(fsamx_in, dev.fsamx.readback.get(), rtol=0, atol=0.5):
                     print("Stopping alignment. Returning to fsamx in position.")
                     self.feedback_disable()
                     umv(dev.fsamx, fsamx_in)
@@ -1911,10 +1914,14 @@ class Flomni(
     def set_special_angles(self, angles: list, repeats: int = 20, tolerance: float = 0.5):
         """Set the special angles for a tomo
 
+        The first projection of the tomogram within `tolerance` of a special angle is acquired
+        `repeats` times; each special angle is used once per tomogram (in any order), also across
+        tomo_scan_resume() in the same session.
+
         Args:
             angles (list): List of special angles
             repeats (int, optional): Number of repeats at a special angle. Defaults to 20.
-            tolerance (float, optional): Number of repeats at a special angle. Defaults to 0.5.
+            tolerance (float, optional): Angle tolerance in degrees. Defaults to 0.5.
 
         """
         self.special_angles = angles
@@ -2228,6 +2235,8 @@ class Flomni(
         self.write_alignment_scan_numbers(bec.queue.next_scan_number)
         start_angle = 0
         alignment_scan_numbers = []
+        # first scan number of the accepted attempt per angle (a retry shifts the scan numbers)
+        alignment_first_scans = []
 
         angle_end = start_angle + 180
         for angle in np.linspace(start_angle, angle_end, num=int(180 / 45) + 1, endpoint=True):
@@ -2245,16 +2254,24 @@ class Flomni(
                             bec.queue.request_queue_reset()
                             time.sleep(2)
                             error_caught = True
+                            print(f"Timeout at angle {angle}, repeating it (Ctrl-C to stop).")
                         else:
                             raise exc
                     # todo here was if blchk success, then setting to success true
-                    successful = True
+                    # repeat the angle after a timeout (it was skipped silently before, 2026-10-24)
+                    successful = not error_caught
 
                 end_scan_number = bec.queue.next_scan_number
+                alignment_first_scans.append(start_scan_number)
                 for scan_nr in range(start_scan_number, end_scan_number):
                     # self._write_tomo_scan_number(scan_nr, angle, 0)
                     alignment_scan_numbers.append(scan_nr)
 
+        consecutive = [alignment_first_scans[0] + k for k in range(len(alignment_first_scans))]
+        if alignment_first_scans != consecutive:
+            # a retry (or stitching) shifted the scan numbers: rewrite the file with the accepted scans
+            self.write_alignment_scan_numbers(alignment_first_scans[0], scans=alignment_first_scans)
+
         umv(dev.fsamroy, 0)
         self.OMNYTools.printgreenbold(
             "\n\nAlignment scan finished. Please run BEC_ptycho_align and load the new fit by flomni.read_alignment_offset() ."
@@ -2274,13 +2291,14 @@ class Flomni(
         print(scilog_content)
         self._scilog_write(scilog_content, "alignmentscan")
 
-    def write_alignment_scan_numbers(self, first_scan):
+    def write_alignment_scan_numbers(self, first_scan, scans=None):
         import os
 
         file = os.path.expanduser("~/data/raw/logs/ptychotomoalign_scannum.txt")
         os.makedirs(os.path.dirname(file), exist_ok=True)
 
-        scans = [first_scan + k for k in range(5)]
+        if scans is None:
+            scans = [first_scan + k for k in range(5)]
         angles = [0, 45, 90, 135, 180]
 
         x_vals = []
@@ -2572,10 +2590,16 @@ class Flomni(
             # succeeded, so a retried attempt still sees the same special
             # angle and repeat count.
             num_repeats = 1
-            is_special_angle = bool(
-                self._current_special_angles
-                and np.isclose(angle, self._current_special_angles[0], atol=0.5)
+            # any remaining special angle within the tolerance (not only the next one in the list)
+            special_index = next(
+                (
+                    k
+                    for k, special in enumerate(self._current_special_angles)
+                    if np.isclose(angle, special, rtol=0, atol=self.special_angle_tolerance)
+                ),
+                None,
             )
+            is_special_angle = special_index is not None
             if is_special_angle:
                 num_repeats = self.special_angle_repeats
             start_scan_number = bec.queue.next_scan_number
@@ -2585,7 +2609,7 @@ class Flomni(
                 self._at_each_angle(angle, **overrides)
             projection_duration = time.perf_counter() - projection_start
             if is_special_angle:
-                self._current_special_angles.pop(0)
+                self._current_special_angles.pop(special_index)
 
             end_scan_number = bec.queue.next_scan_number
             for scan_nr in range(start_scan_number, end_scan_number):
@@ -2733,7 +2757,9 @@ class Flomni(
         bec.builtin_actors.scan_interlock.trigger_setting = "restart_scan"
         bec.builtin_actors.scan_interlock.enabled = True
 
-        self._current_special_angles = self.special_angles.copy()
+        if is_new_scan or not self.special_angles:
+            # on a resume keep the special angles not yet acquired (they were taken again before)
+            self._current_special_angles = list(self.special_angles)
         if is_new_scan:
             # pylint: disable=undefined-variable
             # Always attempt registration (even for an empty/test account)
@@ -2762,6 +2788,7 @@ class Flomni(
             # self.progress.reset() above, before the gates -- only the actual
             # start time is set here, once the scan is genuinely committed to.
             self.progress["tomo_start_time"] = datetime.datetime.now().isoformat()
+            self.progress["tomo_completed"] = False
             if file_angles is not None:
                 self._init_angle_file_progress(file_angles, projection_number)
             self.collect_empty_frames()
@@ -2938,6 +2965,8 @@ class Flomni(
             # (120s / 90s) after a tomogram that's actually already done.
             self.progress["heartbeat"] = None
 
+        # all projections acquired: nothing left for tomo_scan_resume() (also if a step below fails)
+        self.progress["tomo_completed"] = True
         self.progress["projection"] = self.progress["total_projections"]
         self.progress["subtomo_projection"] = self.progress["subtomo_total_projections"]
         self._print_progress()
@@ -2991,6 +3020,10 @@ class Flomni(
         if self.progress.get("tomo_start_time") is None:
             print("No tomo scan in progress to resume -- nothing to do.")
             return
+        if self.progress.get("tomo_completed"):
+            # it re-acquired the last projection (and repeated the end-of-scan steps) before, 2026-10-24
+            print("The last tomo scan was completed -- nothing to resume.")
+            return
 
         if not from_queue and not self._confirm_resume_outside_queue():
             print("Aborted.")
diff --git a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
new file mode 100644
index 00000000..cb3bd58c
--- /dev/null
+++ b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
@@ -0,0 +1,141 @@
+"""Fixes from the flomni.py review 2026-10-24: tomo_scan_resume() after a completed scan, special angles kept
+on resume, the alignment scan repeats an angle after a timeout, absolute np.isclose tolerances."""
+
+import builtins
+import types
+
+import pytest
+
+import csaxs_bec.bec_ipython_client.plugins.flomni.flomni as flomni_module
+from csaxs_bec.bec_ipython_client.plugins.flomni.flomni import Flomni, FlomniError, _ProgressProxy
+
+
+class _FakeClient:
+    def __init__(self):
+        self._vars = {}
+
+    def get_global_var(self, key):
+        return self._vars.get(key)
+
+    def set_global_var(self, key, value):
+        self._vars[key] = value
+
+
+def _make_flomni():
+    obj = object.__new__(Flomni)
+    obj.client = _FakeClient()
+    obj._progress_proxy = _ProgressProxy(obj.client)
+    return obj
+
+
+def test_resume_after_completed_scan_does_nothing(monkeypatch):
+    flomni = _make_flomni()
+    flomni.progress["tomo_start_time"] = "2026-10-24T10:00:00"
+    flomni.progress["tomo_completed"] = True
+    monkeypatch.setattr(Flomni, "tomo_type", 1, raising=False)
+    flomni.tomo_scan = lambda **kw: pytest.fail("tomo_scan must not be called")
+    flomni._confirm_resume_outside_queue = lambda: True
+
+    flomni.tomo_scan_resume()
+
+
+def test_resume_of_interrupted_scan_still_resumes(monkeypatch):
+    flomni = _make_flomni()
+    flomni.progress["tomo_start_time"] = "2026-10-24T10:00:00"
+    flomni.progress["subtomo"] = 3
+    flomni.progress["angle"] = 45.0
+    monkeypatch.setattr(Flomni, "tomo_type", 1, raising=False)
+    calls = []
+    flomni.tomo_scan = lambda **kw: calls.append(kw)
+    flomni._confirm_resume_outside_queue = lambda: True
+
+    flomni.tomo_scan_resume()
+
+    assert calls == [{"subtomo_start": 3, "start_angle": 45.0}]
+
+
+def test_progress_reset_clears_completed():
+    flomni = _make_flomni()
+    flomni.progress["tomo_completed"] = True
+    flomni.progress.reset()
+    assert flomni.progress.get("tomo_completed") is False
+
+
+class _Timeout(flomni_module.AlarmBase):
+    def __init__(self):
+        Exception.__init__(self, "timeout")
+        self.alarm_type = "TimeoutError"
+
+
+class _Queue:
+    def __init__(self):
+        self.next_scan_number = 100
+        self.resets = 0
+
+    def request_queue_reset(self):
+        self.resets += 1
+
+
+def test_alignment_scan_repeats_an_angle_after_timeout(monkeypatch, tmp_path):
+    flomni = _make_flomni()
+    queue = _Queue()
+    fake_dev = types.SimpleNamespace(
+        rtx=types.SimpleNamespace(
+            controller=types.SimpleNamespace(feedback_is_running=lambda: True)
+        ),
+        fsamroy=object(),
+    )
+    monkeypatch.setitem(builtins.__dict__, "bec", types.SimpleNamespace(queue=queue))
+    monkeypatch.setitem(builtins.__dict__, "dev", fake_dev)
+    monkeypatch.setattr(flomni_module, "umv", lambda *a: None, raising=False)
+    monkeypatch.setattr(flomni_module, "filters_out_of_beam", lambda dev: (True, []))
+    monkeypatch.setattr(flomni_module.time, "sleep", lambda s: None)
+    monkeypatch.setattr(Flomni, "sample_name", "test", raising=False)
+    monkeypatch.setenv("HOME", str(tmp_path))
+    flomni.get_alignment_offset = lambda angle: (1.0, 0.0, 0.0)
+    flomni._check_eye_out_and_optics_in = lambda: True
+    flomni.OMNYTools = types.SimpleNamespace(printgreenbold=lambda msg: None)
+    flomni._scilog_write = lambda *a: True
+    angles = []
+
+    def projection(angle, _internal=False):
+        angles.append(angle)
+        queue.next_scan_number += 1  # one scan per attempt (the timed-out one included)
+        if angle == 90 and angles.count(90) == 1:
+            raise _Timeout()
+
+    flomni.tomo_scan_projection = projection
+
+    flomni.tomo_alignment_scan()
+
+    assert angles == [0, 45, 90, 90, 135, 180]
+    assert queue.resets == 1
+    lines = (tmp_path / "data/raw/logs/ptychotomoalign_scannum.txt").read_text().splitlines()
+    assert lines[0] == "100 101 103 104 105"  # the accepted scan per angle, not 100..104
+
+
+@pytest.mark.parametrize(
+    "readback, ok", [(-1.14, True), (-1.30, True), (-1.40, False), (-0.80, False)]
+)
+def test_heater_down_needs_fsamx_in_within_0_2_mm(monkeypatch, readback, ok):
+    flomni = _make_flomni()
+    fsamx = types.SimpleNamespace(
+        user_parameter={"in": -1.14}, readback=types.SimpleNamespace(get=lambda: readback)
+    )
+    fheater = types.SimpleNamespace(
+        _config={"deviceConfig": {"axis_Id": "H"}}, user_parameter={"in": 5}
+    )
+    monkeypatch.setitem(
+        builtins.__dict__, "dev", types.SimpleNamespace(fsamx=fsamx, fheater=fheater)
+    )
+    monkeypatch.setattr(flomni_module, "dev", builtins.__dict__["dev"], raising=False)
+    moved = []
+    monkeypatch.setattr(flomni_module, "umv", lambda *a: moved.append(a), raising=False)
+    flomni.ensure_osa_back = lambda: None
+    if ok:
+        flomni.move_fheater_down()
+        assert moved
+    else:
+        with pytest.raises(FlomniError):
+            flomni.move_fheater_down()
+        assert not moved
diff --git a/tests/tests_bec_ipython_client/test_flomni_special_angles.py b/tests/tests_bec_ipython_client/test_flomni_special_angles.py
index 7cfab251..4a5781f5 100644
--- a/tests/tests_bec_ipython_client/test_flomni_special_angles.py
+++ b/tests/tests_bec_ipython_client/test_flomni_special_angles.py
@@ -32,6 +32,7 @@ def _make_flomni(monkeypatch):
     obj.tomo_angle_range = 180
     obj.special_angles = []
     obj.special_angle_repeats = 3
+    obj.special_angle_tolerance = 0.5
     obj._current_special_angles = []
     obj._print_progress = lambda: None
     obj._format_duration = lambda seconds: "0s"
@@ -86,3 +87,34 @@ def test_special_angle_repeats_survive_a_retry(monkeypatch):
 
     assert len(calls) == 1 + 3, "the retry must still repeat the special angle"
     assert flomni._current_special_angles == []
+
+
+def test_special_angle_tolerance_is_used(monkeypatch):
+    """special_angle_tolerance was ignored (hard-coded 0.5) before 2026-10-24."""
+    flomni = _make_flomni(monkeypatch)
+    flomni.special_angles = [90.0]
+    flomni._current_special_angles = [90.0]
+    flomni.special_angle_tolerance = 2.0
+    calls = []
+    flomni._at_each_angle = lambda angle: calls.append(angle)
+
+    flomni._tomo_scan_at_angle(91.5, 1)
+
+    assert calls == [91.5] * 3
+    assert flomni._current_special_angles == []
+
+
+def test_special_angles_match_in_any_order(monkeypatch):
+    """An angle not reached first (e.g. a reverse sub-tomogram) no longer blocks the later ones."""
+    flomni = _make_flomni(monkeypatch)
+    flomni.special_angles = [30.0, 120.0]
+    flomni._current_special_angles = [30.0, 120.0]
+    calls = []
+    flomni._at_each_angle = lambda angle: calls.append(angle)
+
+    flomni._tomo_scan_at_angle(120.0, 1)
+    flomni._tomo_scan_at_angle(120.0, 1)  # used once only
+    flomni._tomo_scan_at_angle(30.0, 1)
+
+    assert calls == [120.0] * 3 + [120.0] + [30.0] * 3
+    assert flomni._current_special_angles == []

From b939793416d7d26e0bd357becd9ddb4d165b2bea Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 24 Oct 2026 06:43:17 +0000
Subject: [PATCH 081/102] fix(flomni): x-ray eye Ctrl-C handler looked up fsamx
 by device object; ffzp_info collision position

- start_x_ray_eye_alignment: _get_user_param_safe() needs the device name (dev[name]); with dev.fsamx the
  KeyboardInterrupt handler raised KeyError and fsamx was never returned to its in position
- ffzp_info: the OSA collides at fosaz = 33 - foptz (compute_osa_remaining_space), printed 33 - fosaz

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/flomni/flomni.py                  |  2 +-
 .../plugins/flomni/flomni_optics_mixin.py     |  3 +-
 .../test_flomni_review_fixes.py               | 38 +++++++++++++++++++
 3 files changed, 41 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 3f175ba5..c19e1af3 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -1852,7 +1852,7 @@ class Flomni(
             try:
                 self.align.align(keep_shutter_open)
             except KeyboardInterrupt as exc:
-                fsamx_in = self._get_user_param_safe(dev.fsamx, "in")
+                fsamx_in = self._get_user_param_safe("fsamx", "in")  # name: dev[...] lookup (a device raised)
                 if np.isclose(fsamx_in, dev.fsamx.readback.get(), rtol=0, atol=0.5):
                     print("Stopping alignment. Returning to fsamx in position.")
                     self.feedback_disable()
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py
index f31dd04f..162eab37 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py
@@ -420,7 +420,8 @@ class FlomniOpticsMixin:
 
         print("\nOSA Information:")
         print(f"  Current fosaz {fosaz_val:.1f}")
-        print(f"  The OSA will collide with a normal OMNY pin at fosaz \033[1m{(33-fosaz_val):.1f}\033[0m")
+        # collision where compute_osa_remaining_space() = 33 - foptz - fosaz reaches 0 (was 33 - fosaz)
+        print(f"  The OSA will collide with a normal OMNY pin at fosaz \033[1m{(33-foptz_val):.1f}\033[0m")
         print(f"  Remaining space (right now): \033[1m{remaining_current:.1f}\033[0m")
 
         diff = fosaz_val - fosaz_in  # >0: OSA is currently more "in" than nominal -> worse
diff --git a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
index cb3bd58c..c842b0b5 100644
--- a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
+++ b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
@@ -139,3 +139,41 @@ def test_heater_down_needs_fsamx_in_within_0_2_mm(monkeypatch, readback, ok):
         with pytest.raises(FlomniError):
             flomni.move_fheater_down()
         assert not moved
+
+
+class _DevContainer(dict):
+    """dict keyed by device name, like bec_lib's DeviceContainer (attribute access too)."""
+
+    def __getattr__(self, name):
+        return self[name]
+
+
+def test_xray_eye_ctrl_c_returns_fsamx_in(monkeypatch):
+    """The KeyboardInterrupt handler passed the device instead of its name: dev[device] raised."""
+    import csaxs_bec.bec_ipython_client.plugins.flomni.flomni_optics_mixin as optics_module
+
+    flomni = _make_flomni()
+    fsamx = types.SimpleNamespace(
+        user_parameter={"in": -1.14}, readback=types.SimpleNamespace(get=lambda: -1.3)
+    )
+    fake_dev = _DevContainer(fsamx=fsamx)
+    monkeypatch.setitem(builtins.__dict__, "dev", fake_dev)
+    monkeypatch.setattr(flomni_module, "dev", fake_dev, raising=False)
+    monkeypatch.setattr(optics_module, "dev", fake_dev, raising=False)
+    moved = []
+    monkeypatch.setattr(flomni_module, "umv", lambda *a: moved.append(a), raising=False)
+    flomni.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: True)
+    flomni.feedback_disable = lambda: None
+
+    class _Align:
+        def __init__(self, *a):
+            pass
+
+        def align(self, keep_shutter_open):
+            raise KeyboardInterrupt
+
+    monkeypatch.setattr(flomni_module, "XrayEyeAlign", _Align)
+
+    with pytest.raises(KeyboardInterrupt):
+        flomni.start_x_ray_eye_alignment()
+    assert moved == [(fsamx, -1.14)]

From 04aa7713fbc6bd6332cf24f5d61f728633751270 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sat, 24 Oct 2026 06:55:43 +0000
Subject: [PATCH 082/102] fix(flomni): two 0-deg shots at the start of type 1,
 stop on declined gates, arrow-key tweaks, CLI angle range

- tomo_scan type 1 with zero_deg_reference_at_each_subtomo: no extra reference before sub-tomogram 1
  of a new scan (fixed 0-deg shot + sub-tomogram 1's first projection = 2 in a row, was 3)
- tomo_scan: a declined eye/optics or filter gate raises FlomniError instead of returning (the tomo
  queue marked the job "done" without data)
- feye_out / feye_in: "no" (direct beam still visible, fttrx1 missing) raises FlomniOpticsError instead
  of returning (tomo_alignment_scan measured on with the eye in)
- tweak_cursor and laser_parameters_tweak_tracking: read_escape_suffix() waits briefly for a split
  arrow-key sequence and ignores ESC alone (read(2) unpacking raised); tweak_cursor message names the device
- tomo_parameters_cli: angle range re-asked until 180 or 360; _get_val re-asks on a non-number
- check_position_is_valid message 0-20; collect_empty_frames docstring: the sample is moved out
- omny/AI_docs/TODO_flomni_review_2026-10_findings.md: the same bugs in OMNY (x-ray eye Ctrl-C, special angles)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019aWcwG89wi7oVyrefukXX6
---
 .../plugins/OMNY_shared/omny_general_tools.py | 27 ++++++++--
 .../plugins/flomni/flomni.py                  | 38 +++++++++-----
 .../plugins/flomni/flomni_optics_mixin.py     | 12 ++---
 .../TODO_flomni_review_2026-10_findings.md    | 48 ++++++++++++++++++
 .../test_flomni_review_fixes.py               | 50 +++++++++++++++++++
 .../test_flomni_tomo_angles.py                | 27 +++++++++-
 6 files changed, 180 insertions(+), 22 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TODO_flomni_review_2026-10_findings.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py
index 0a75cb8f..3df5b45b 100644
--- a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/omny_general_tools.py
@@ -35,6 +35,26 @@ def umvr(*args):
     return scans.umv(*args, relative=True)
 
 
+def read_escape_suffix(stream, timeout: float = 0.05) -> str | None:
+    """The two characters after an ESC on a non-blocking stdin (arrow keys: "[A".."[D"),
+    or None if they do not arrive within `timeout` (ESC alone, or a slow terminal).
+
+    A plain stream.read(2) can return fewer characters, or None, before the rest of the
+    sequence has arrived; unpacking that raised and ended the tweak with a traceback."""
+    chars = ""
+    deadline = time.monotonic() + timeout
+    while len(chars) < 2 and time.monotonic() < deadline:
+        try:
+            got = stream.read(2 - len(chars))
+        except (IOError, TypeError):
+            got = None
+        if got:
+            chars += got
+        else:
+            time.sleep(0.005)
+    return chars if len(chars) == 2 else None
+
+
 class OMNYTools:
 
     HEADER = "\033[95m"
@@ -164,10 +184,10 @@ class OMNYTools:
         self, dev1, step1: float, dev2="none", step2: float = "0", special_command="none"
     ):
         if dev1 not in dev.enabled_devices:
-            print(f"Device 1 {dev} is not in enabled devices.")
+            print(f"Device 1 {dev1} is not in enabled devices.")
             return
         if dev2 not in dev.enabled_devices and dev2 != "none":
-            print(f"Device 2 {dev} is not in enabled devices.")
+            print(f"Device 2 {dev2} is not in enabled devices.")
             return
         # Save the current terminal settings
         fd = sys.stdin.fileno()
@@ -187,7 +207,8 @@ class OMNYTools:
                         print("\n\rExiting tweak mode\r")
                         break
                     elif key == "\x1b":  # Escape sequences for arrow keys
-                        next1, next2 = sys.stdin.read(2)
+                        suffix = read_escape_suffix(sys.stdin)
+                        next1, next2 = suffix if suffix else ("", "")
                         if next1 == "[":
                             if next2 == "A":
                                 if dev2 != "none":
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index c19e1af3..7e7e594b 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -40,6 +40,7 @@ from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.omny_general_tools import
     OMNYTools,
     PtychoReconstructor,
     TomoIDManager,
+    read_escape_suffix,
 )
 from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.ptouch_printer import PTouchLabelPrinter
 from csaxs_bec.devices.omny.galil.galil_ophyd import GalilError
@@ -602,7 +603,8 @@ class FlomniSampleTransferMixin:
                         print("\rReturned to start positions\r")
                         print_status()
                     elif key == "\x1b":  # escape sequences for arrow keys
-                        next1, next2 = sys.stdin.read(2)
+                        suffix = read_escape_suffix(sys.stdin)
+                        next1, next2 = suffix if suffix else ("", "")
                         if next1 == "[":
                             target_y, target_z = read_targets()
                             if next2 == "A":  # up: target z +
@@ -1065,7 +1067,7 @@ class FlomniSampleTransferMixin:
         if 0 <= position < 21:
             return
         raise FlomniError(
-            f"The given position number [{position}] is not in the valid range of 0-21. "
+            f"The given position number [{position}] is not in the valid range of 0-20. "
         )
 
     def ftransfer_controller_enable_mount_mode(self):
@@ -2626,8 +2628,8 @@ class Flomni(
             )
 
     def collect_empty_frames(self):
-        """Acquire 10 empty-frame (flat-field) images at angle 0, with fsamx
-        shifted out of the beam by half the field of view (fovx/2), in the
+        """Acquire 10 empty-frame (flat-field) images at angle 0, with the
+        sample moved out of the beam by half the field of view (fovx/2), in the
         direction opposite the normal alignment x-offset at angle 0.
 
         Called once at the start of a new tomo_scan() (not on resume).
@@ -2739,15 +2741,15 @@ class Flomni(
             if self.OMNYTools.yesno("Shall I continue?", "n"):
                 print("OK")
             else:
-                print("Stopping.")
-                return
+                # raise, not return: a return let tomo_queue_execute() mark the job "done" without data
+                raise FlomniError("Tomo scan stopped: the setup is not in measurement condition.")
 
         all_out, offending = filters_out_of_beam(dev)
         if not all_out:
             warning = f"Not all filters are out of the beam: {', '.join(offending)}."
             if not warn_and_confirm(self, warning, interactive=interactive, force=False):
-                print("Aborting tomo scan.")
-                return
+                # raise, not return (see above)
+                raise FlomniError(f"Tomo scan aborted: {warning}")
 
         self.flomnigui_show_progress()
 
@@ -2813,6 +2815,9 @@ class Flomni(
                             start_angle is None
                             and self._subtomo_starts_near_zero(ii)
                             and self.zero_deg_reference_at_each_subtomo
+                            # new scan: the fixed 0-deg shot above and sub-tomogram 1's first
+                            # projection (0 deg) are already the two at the start (Mirko 2026-10-24)
+                            and not (is_new_scan and ii == 1)
                         ):
                             # Dedicated reference shot at exactly 0 degrees, taken
                             # every time the rotation passes back through 0, for
@@ -4024,7 +4029,7 @@ class Flomni(
 
             if self.tomo_type == 1:
                 self.tomo_angle_range = self._get_val(
-                    "Angular range (180 or 360)", self.tomo_angle_range, int
+                    "Angular range (180 or 360)", self.tomo_angle_range, int, choices=(180, 360)
                 )
                 # Default shown here must be the actual achievable total
                 # (int(range/stepsize)*8), not the raw algebraic inverse of
@@ -4141,14 +4146,23 @@ class Flomni(
                 self._prompt_angle_file()
 
     @staticmethod
-    def _get_val(msg: str, default_value, data_type, min_=None, max_=None):
+    def _get_val(msg: str, default_value, data_type, min_=None, max_=None, choices=None):
         """Prompt for a value, casting to data_type. When min_/max_ are
         given, re-prompts (rather than silently clamping) until the typed
         value is in range, mirroring the Tomo Parameters GUI's spinbox
         bounds (tomo_params.py) so tomo_parameters() enforces the same
-        limits instead of accepting anything of the right type."""
+        limits instead of accepting anything of the right type. Also
+        re-prompts on a value that cannot be cast, or that is not one of
+        `choices` (when given)."""
         while True:
-            val = data_type(input(f"{msg} ({default_value}): ") or default_value)
+            try:
+                val = data_type(input(f"{msg} ({default_value}): ") or default_value)
+            except ValueError:
+                print(f"Not a valid {data_type.__name__}. Please try again.")
+                continue
+            if choices is not None and val not in choices:
+                print(f"Value must be one of {', '.join(str(c) for c in choices)}. Please try again.")
+                continue
             if min_ is not None and val < min_:
                 print(f"Value must be >= {min_}. Please try again.")
                 continue
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py
index 162eab37..0703a04a 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_optics_mixin.py
@@ -88,8 +88,10 @@ class FlomniOpticsMixin:
         if self.OMNYTools.yesno("Did the direct beam on the xray eye disappear?"):
             print("excellent.")
         else:
-            print("Aborting. With visible parts of the direct beam on the xray eye, it cannot be removed.")
-            return
+            # raise, not return: callers (tomo_alignment_scan) went on measuring with the eye in
+            raise FlomniOpticsError(
+                "Aborting. With visible parts of the direct beam on the xray eye, it cannot be removed."
+            )
         feyex_out = self._get_user_param_safe("feyex", "out")
 
         umv(dev.feyex, feyex_out)
@@ -104,8 +106,7 @@ class FlomniOpticsMixin:
                 "this could cause collisions when operating on the real "
                 "beamline."
             ):
-                print("Aborting feye_out(): fttrx1 not moved.")
-                return
+                raise FlomniOpticsError("Aborting feye_out(): fttrx1 not moved.")
         else:
             fttrx_in = self._get_user_param_safe("feyex", "fttrx_in")
             umv(dev.fttrx1, fttrx_in)
@@ -119,8 +120,7 @@ class FlomniOpticsMixin:
                 "this could cause collisions when operating on the real "
                 "beamline."
             ):
-                print("Aborting feye_in(): fttrx1 not moved.")
-                return
+                raise FlomniOpticsError("Aborting feye_in(): fttrx1 not moved.")
         else:
             fttrx_out = self._get_user_param_safe("feyex", "fttrx_out")
             umv(dev.fttrx1, fttrx_out)
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TODO_flomni_review_2026-10_findings.md b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TODO_flomni_review_2026-10_findings.md
new file mode 100644
index 00000000..0b476053
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/AI_docs/TODO_flomni_review_2026-10_findings.md
@@ -0,0 +1,48 @@
+# TODO: OMNY has bugs that were fixed in flomni (review 2026-10-24)
+
+Found while reviewing `flomni.py` and its mixins (branch `fzp-move-beyond`, csaxs_bec commits
+`1a5b53c`, `b939793` and the follow-up). OMNY was not changed; port these on the OMNY branch.
+
+## 1. X-ray eye Ctrl-C handler cannot return osamx (`omny.py`, `start_x_ray_eye_alignment`)
+
+```python
+osamx_in = self._get_user_param_safe(dev.osamx, "in")
+if np.isclose(osamx_in, dev.osamx.readback.get(), 0.5):
+```
+
+- `_get_user_param_safe()` looks the device up with `dev[device]` and needs the **name**
+  (`"osamx"`). With the device object the lookup raises (`KeyError`) inside the
+  `except KeyboardInterrupt` handler, so osamx is never returned to its in position and the
+  user sees a KeyError instead of the interrupt. flomni fix: `self._get_user_param_safe("fsamx", "in")`.
+- The third positional argument of `np.isclose` is **rtol**, not atol: `0.5` means 50 % of the
+  readback. Use `np.isclose(a, b, rtol=0, atol=0.5)` (mm).
+
+## 2. Special angles (`omny.py`, the per-angle loop of the tomo scan)
+
+```python
+if self._current_special_angles:
+    next_special_angle = self._current_special_angles[0]
+    if np.isclose(angle, next_special_angle, atol=0.5):
+        self._current_special_angles.pop(0)
+        num_repeats = self.special_angle_repeats
+else:
+    num_repeats = 1
+```
+
+- `num_repeats` is unbound when special angles are set but the angle is not the next one ->
+  `UnboundLocalError` (flomni had the same bug, fixed earlier with `num_repeats = 1` up front).
+- The angle is popped before the projection ran: a repeated attempt (timeout / beam check)
+  no longer sees it as special.
+- `special_angle_tolerance` is never used (hard-coded 0.5); `__init__` sets it to 20 while
+  `set_special_angles()` defaults to 0.5; the `tolerance` docstring says "Number of repeats".
+- Only the first list entry can match: a special angle that is never reached blocks all later ones.
+
+flomni now: match any remaining special angle within `special_angle_tolerance`, pop it only after
+the projection succeeded, keep the remaining list across a resume in the same session
+(`Flomni._tomo_scan_at_angle`, tests `tests/tests_bec_ipython_client/test_flomni_special_angles.py`).
+
+## Already shared (nothing to do for OMNY)
+
+- `OMNYTools.tweak_cursor()` (OMNY_shared) no longer ends with a traceback when an arrow-key
+  escape sequence arrives in two parts or ESC is pressed alone (`read_escape_suffix()`), and its
+  "not in enabled devices" message names the device.
diff --git a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
index c842b0b5..8e745039 100644
--- a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
+++ b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
@@ -177,3 +177,53 @@ def test_xray_eye_ctrl_c_returns_fsamx_in(monkeypatch):
     with pytest.raises(KeyboardInterrupt):
         flomni.start_x_ray_eye_alignment()
     assert moved == [(fsamx, -1.14)]
+
+
+def test_tray_position_message_says_0_to_20():
+    flomni = _make_flomni()
+    flomni.check_position_is_valid(20)
+    with pytest.raises(FlomniError, match="0-20"):
+        flomni.check_position_is_valid(21)
+
+
+def test_get_val_reasks_angle_range_and_bad_numbers(monkeypatch, capsys):
+    answers = iter(["270", "abc", "360"])
+    monkeypatch.setattr(builtins, "input", lambda prompt="": next(answers))
+    assert Flomni._get_val("Angular range", 180, int, choices=(180, 360)) == 360
+    out = capsys.readouterr().out
+    assert "one of 180, 360" in out and "Not a valid int" in out
+
+
+def test_feye_out_raises_when_direct_beam_still_visible(monkeypatch):
+    import csaxs_bec.bec_ipython_client.plugins.flomni.flomni_optics_mixin as optics_module
+
+    flomni = _make_flomni()
+    flomni.csaxs = None
+    flomni.foptics_in = lambda: None
+    flomni.flomnigui_show_xeyealign = lambda: None
+    flomni.xrayeye_update_frame = lambda: None
+    flomni.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: False)
+    fake_dev = types.SimpleNamespace(fsh=types.SimpleNamespace(fshclose=lambda: None))
+    monkeypatch.setattr(optics_module, "dev", fake_dev, raising=False)
+    monkeypatch.setitem(builtins.__dict__, "dev", fake_dev)
+    with pytest.raises(optics_module.FlomniOpticsError, match="direct beam"):
+        flomni.feye_out()
+
+
+class _SlowStream:
+    """Non-blocking stdin stand-in: returns the queued chunks one per read, None in between."""
+
+    def __init__(self, chunks):
+        self.chunks = list(chunks)
+
+    def read(self, n):
+        return self.chunks.pop(0) if self.chunks else None
+
+
+def test_read_escape_suffix_waits_for_split_sequence():
+    from csaxs_bec.bec_ipython_client.plugins.OMNY_shared.omny_general_tools import (
+        read_escape_suffix,
+    )
+
+    assert read_escape_suffix(_SlowStream(["[", None, "A"])) == "[A"
+    assert read_escape_suffix(_SlowStream([])) is None  # ESC alone
diff --git a/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py b/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py
index 71e6932c..414ff838 100644
--- a/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py
+++ b/tests/tests_bec_ipython_client/test_flomni_tomo_angles.py
@@ -681,7 +681,11 @@ def test_new_scan_resets_progress_before_eye_optics_gate_declines(monkeypatch, t
         "must not acquire -- the gate declined"
     )
 
-    flomni.tomo_scan()  # returns early, no exception
+    from csaxs_bec.bec_ipython_client.plugins.flomni.flomni import FlomniError
+
+    # raises since 2026-10-24 (a plain return let the tomo queue mark the job "done")
+    with pytest.raises(FlomniError, match="not in measurement condition"):
+        flomni.tomo_scan()
 
     assert flomni.progress["projection"] == 0
     assert flomni.progress["total_projections"] == 1
@@ -765,3 +769,24 @@ def test_flomni_gui_progress_survives_zero_total(monkeypatch):
 
     assert ring_values == [0.0, 50.0]
     assert "Angles from file" in labels[0]
+
+
+@pytest.mark.parametrize("zero_deg_reference", [False, True])
+def test_type1_new_scan_takes_two_zero_deg_projections_at_the_start(monkeypatch, zero_deg_reference):
+    """The fixed 0-deg shot + sub-tomogram 1's first projection (0 deg); the damage-check reference
+    before sub-tomogram 1 would have been a third one in a row (removed 2026-10-24)."""
+    flomni = make_flomni_for_golden_resume(monkeypatch, tomo_type=1)
+    flomni.tomo_angle_range = 180
+    flomni.tomo_angle_stepsize = 45.0
+    flomni.tomo_type1_always_forward = False
+    flomni.zero_deg_reference_at_each_subtomo = zero_deg_reference
+    calls = []
+    flomni._tomo_scan_at_angle = lambda angle, subtomo, **kw: calls.append((float(angle), subtomo))
+
+    flomni.tomo_scan()
+
+    assert calls[:2] == [(0.0, 1), (0.0, 1)]
+    assert calls[2][0] != 0.0
+    # sub-tomogram 3 (forward, starts near 0) still gets its reference shot when enabled
+    sub3 = [c for c in calls if c[1] == 3]
+    assert (sub3[0][0] == 0.0) == zero_deg_reference

From 5937d930407967ecd9551639e6dacac3c2a36b99 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Mon, 26 Oct 2026 09:08:33 +0100
Subject: [PATCH 083/102] mod config files

---
 csaxs_bec/device_configs/ptycho_flomni.yaml   | 68 +++++++++----------
 .../simulated_bl_endstation_flomni.yaml       |  4 +-
 2 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/csaxs_bec/device_configs/ptycho_flomni.yaml b/csaxs_bec/device_configs/ptycho_flomni.yaml
index 677355a1..15ccd18e 100644
--- a/csaxs_bec/device_configs/ptycho_flomni.yaml
+++ b/csaxs_bec/device_configs/ptycho_flomni.yaml
@@ -728,37 +728,37 @@ calculated_signal:
 #   deviceTags:
 #     - ptycho_flomni
 
-omny_panda_continuous:
-  readoutPriority: async
-  deviceClass: csaxs_bec.devices.panda_box.panda_box_omny.PandaBoxOMNY
-  deviceConfig:
-    host: omny-panda.psi.ch
-    raw_stream_mode: true
-    # Only actually Arm() PandA for scans that consume its data -- generic BEC staging
-    # (stage_all_devices/pre_scan_all_devices) otherwise arms this device for every scan type
-    # (grid_scan, line_scan, alignment moves, ...), not just the ptycho scan that reads it. See
-    # docs/developer/panda_box_free_running_setup.md and
-    # AI_docs/PANDA_POSITION_VALIDATION.md sec 7 (stale frame_counter exposure).
-    arm_scan_allowlist:
-      - flomni_fermat_scan
-    signal_alias:
-      FMC_IN.VAL1.Value: cap_voltage_fzp_y
-      FMC_IN.VAL2.Value: cap_voltage_fzp_x
-      INENC1.VAL.Value: interf_st_fzp_y
-      INENC2.VAL.Value: interf_st_fzp_x
-      INENC3.VAL.Value: interf_st_rotz
-      INENC4.VAL.Value: interf_st_rotx
-      PCAP.GATE_DURATION.Value: pcap_gate_duration_value
-      # TTLIN1 (detector trigger) feeds both blocks below - confirmed 2026-09-15 against the
-      # omny-panda hardware, see docs/developer/panda_box_free_running_setup.md. PCAP.BITS0
-      # is a shared 32-bit word; PandaBoxOMNY masks it to bit 0 (TTLIN1.VAL) before
-      # publishing gate_detector_active. COUNTER1 counts TTLIN1's falling edge, i.e. one
-      # increment per completed exposure; it also doubles as the on_complete signal. Confirmed
-      # working end-to-end 2026-09-15; now under speed testing beyond the initial 100 Hz.
-      PCAP.BITS0.Value: gate_detector_active
-      COUNTER1.OUT.Value: frame_counter
-  enabled: true
-  readOnly: false
-  softwareTrigger: false
-  deviceTags:
-    - ptycho_flomni
+# omny_panda_continuous:
+#   readoutPriority: async
+#   deviceClass: csaxs_bec.devices.panda_box.panda_box_omny.PandaBoxOMNY
+#   deviceConfig:
+#     host: omny-panda.psi.ch
+#     raw_stream_mode: true
+#     # Only actually Arm() PandA for scans that consume its data -- generic BEC staging
+#     # (stage_all_devices/pre_scan_all_devices) otherwise arms this device for every scan type
+#     # (grid_scan, line_scan, alignment moves, ...), not just the ptycho scan that reads it. See
+#     # docs/developer/panda_box_free_running_setup.md and
+#     # AI_docs/PANDA_POSITION_VALIDATION.md sec 7 (stale frame_counter exposure).
+#     arm_scan_allowlist:
+#       - flomni_fermat_scan
+#     signal_alias:
+#       FMC_IN.VAL1.Value: cap_voltage_fzp_y
+#       FMC_IN.VAL2.Value: cap_voltage_fzp_x
+#       INENC1.VAL.Value: interf_st_fzp_y
+#       INENC2.VAL.Value: interf_st_fzp_x
+#       INENC3.VAL.Value: interf_st_rotz
+#       INENC4.VAL.Value: interf_st_rotx
+#       PCAP.GATE_DURATION.Value: pcap_gate_duration_value
+#       # TTLIN1 (detector trigger) feeds both blocks below - confirmed 2026-09-15 against the
+#       # omny-panda hardware, see docs/developer/panda_box_free_running_setup.md. PCAP.BITS0
+#       # is a shared 32-bit word; PandaBoxOMNY masks it to bit 0 (TTLIN1.VAL) before
+#       # publishing gate_detector_active. COUNTER1 counts TTLIN1's falling edge, i.e. one
+#       # increment per completed exposure; it also doubles as the on_complete signal. Confirmed
+#       # working end-to-end 2026-09-15; now under speed testing beyond the initial 100 Hz.
+#       PCAP.BITS0.Value: gate_detector_active
+#       COUNTER1.OUT.Value: frame_counter
+#   enabled: true
+#   readOnly: false
+#   softwareTrigger: false
+#   deviceTags:
+#     - ptycho_flomni
diff --git a/csaxs_bec/device_configs/simulated_omny/simulated_bl_endstation_flomni.yaml b/csaxs_bec/device_configs/simulated_omny/simulated_bl_endstation_flomni.yaml
index 6632fd0e..2019acf7 100644
--- a/csaxs_bec/device_configs/simulated_omny/simulated_bl_endstation_flomni.yaml
+++ b/csaxs_bec/device_configs/simulated_omny/simulated_bl_endstation_flomni.yaml
@@ -24,5 +24,5 @@ fsh:
 flomni:
  - !include ../ptycho_flomni.yaml
 
-machine:
- - !include ../machine.yml
+# machine:
+#  - !include ../machine.yml

From 692ee478369b743c561e90af2f6eaa0ba92c75ee Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Mon, 26 Oct 2026 09:27:16 +0100
Subject: [PATCH 084/102] token added to config file

---
 csaxs_bec/device_configs/ptycho_flomni.yaml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/csaxs_bec/device_configs/ptycho_flomni.yaml b/csaxs_bec/device_configs/ptycho_flomni.yaml
index 15ccd18e..450b4222 100644
--- a/csaxs_bec/device_configs/ptycho_flomni.yaml
+++ b/csaxs_bec/device_configs/ptycho_flomni.yaml
@@ -628,7 +628,7 @@ flomni_loop_settings:
   deviceClass: csaxs_bec.devices.omny.flomni_loop_settings.FlomniLoopSettings
   deviceConfig:
     host: mpc2844.psi.ch
-    token: ""
+    token: "3CcGHMdz16G7zuC6iPHEoZPWvKDY1HkCZnTlP1msZbg"
     token_file: ~/.flomni_webhmi_token
     timeout: 2.0
   enabled: true

From 81d9e9eec04951bfddcde4d666a69abcd8b418e2 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 10:43:30 +0100
Subject: [PATCH 085/102] docs(flomni): PDFs of the realtime_system guide and
 the FZP how-tos (for the web HMI tab Docs)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QnSJvqxh9oDbshx8qXgeiX
---
 ...t_only-howto_calibrate_the_fzp_scanner.pdf | Bin 31150 -> 88918 bytes
 ...only-howto_limit_the_fzp_scanner_range.pdf | Bin 20066 -> 57503 bytes
 .../local_contact_only-realtime_system.pdf    | Bin 0 -> 57342 bytes
 3 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf
index 81ce9c8a5479ba327965c1f1f11cb88a10381c23..b23a54db08bcd0a9636031d5bb23ea2c0b8428a5 100644
GIT binary patch
literal 88918
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%0A4A+0
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
PbFwf%laUF_ia`G#oS6$x

literal 31150
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
P$-@FiK_Q_a3HQGMWG+-C

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.pdf
index 66e18ac1f531e6555db57952dcbde5a96f8c3661..2c8a51c7e5a7a8d5b867c7922f15993f67922efc 100644
GIT binary patch
literal 57503
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
H#zgpEmCtty

literal 20066
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%0DNW
zwno|I!Ply!u7-z=z{HakoUR(LDv;teY8-`FEOtydFBYF|!2BlP9N=qWXM$<PIA-aw
zx!rRlQTou?AB;eyZS}l8jHS{h_(q{sgCY+?SC8a%2x2XrAHSmp*hsxQVn$dR<4jlU
zXt9Ef-)(m#&zI5RFYpV=o~91U*dIjI2g;AZa^$6q&QtVVr`8VFgK<QYP*~m_M8nu+
zu|17<#J<6LvVd?QgfH|q1{1YR<V=RsA+i>4B7KV&yTf<Pj)jXIX@xw|E)7765idG{
zas;8~b;*0rt48aN$`<~?z_*S#pbLWG@pCOSIS+nj;6O%}GJkkBh725*&mkVtP?%B{
zXgd^VIB*KNocFpw%@nvyU;o0T2dlvjumN=2-+q?{X~t_L46Yx$Awiw&83DJ<zk(!}
zHO=fS(~$4Zq$7qaHPi3Qw_-%@iTwfPS6Bd*_(r;B!bYMe8v3l+(DL)Kp`JaUCNrW_
zZqW%C8Xu}VGIpO;VfuwswLg7RADVJ5>P!Y37{nqV#wOdzr^f@pT9CGI$gIeTL}VSL
z$u7+YH+Md-*E`aC0%1I3JhU7kM$}L)jp^eqT{WRXD*1%+QGeIBB$mwE?iSJv^NG46
zmwF6KF7=7P1N|E^qo4#yY}kbI0pFr2R61ZoE8@@t)34BIJ!YC-fx1AO;pun_)nXeS
zQCE~zJuq6ob}c|J*4|9+u-|!~C)f`(8~3EC3SjpDA7QQ(U5MMk*8|Txq_+((>>t>2
zu`y`Dt!Z9apEPz%Wm4RUo*3EZeA-05)fvEaEyz1=5MI#NDNzo#)ZQ@zqHqCfUOEJF
znONDHah}w#_)vM0CmOKsR)iQqB>kl|0?qkcCr&L-2=16(L0^Ck1G?0|do&@~0*7~R
zUCAT$DZdb(5y5+E{3l2^4<L{X;OY`qkKde$F2b$`V!{mVB^a_l9PX&myNqr!-F<mE
z)Io@Z@qZ&_-(&pp`-=AVGa<7B7;=ZS4u19mxblI?0d|y6$QWrLf?T@>JHi`pfF}|r
zMIpiweISyEF92vplWlWV1Ui=ODGn=zz4C&dINCo!_mza#otAq5cGlye=^?x!+6d>k
z!RkPu?aO*`_XM6en|B4@3W(X0xrGlT7S|7P3y(`XK&g+rz<VE+v-jtla8>PhWLRdz
zOv9ewm|&$EKB@)1Ap0HA8Ld?fkR*93+wC;vX3e)9*%k8kl{q58L{u$aDb^9smi|Ie
zCUGU@9hO)MFtieE+>d4x_}q=X8HNM=;R-hN!v2Qg1y1*ke&pYaaS@CNZrHNe-y+gG
zLK-mUNSx_#!<qU`(*f$Tk9y1f0mU7<J#f7{eG>!He{#Q52||%7S{>-(8fuAecSoPu
z9qYq@IP(^fs;{c#*t1?~c;)-tn)4d@8c$rAMQu3TK)J$-9JvQI=oKy%{uvG&Zj+RG
z$IvsgkhX_wKhYtit!I(?YRXs%hjyfKhf~(a8sG3jzSm#VGw(TpW(-qCnv{!q2}q^m
zYgsNOE=T?Yb59Zbf#iTMeq7R+FcOCv&|Sa~sx`|omuC-kR?Qw#ca3=hzdlXUfThl*
zf%!#1Ri~qmK)=UC7Q4Kk8KC`Hj+B=yWp$`a>bg{x@faC86u&k8Q=KpM*%w~fpzi}z
zrkC^<ZO?bLoX8~~A(7ql#~dQBA1?6GHBeK7Ki5<xG2v*5EGw?nKur(F72o|R&Ih=!
z1nA8EqAQGdD!Cx*u5@Y~z9~*CIOr(B4-n7n&@bq1|4ZIh6F?U91MvX{Fa{)Sd@F!Q
zm)f9%-3$O3)Ldp)=CNKcS6ugqji9j`s-r^(PaTxrW9hxi31U+Y?r|JLc>g;u6yrJY
z)QX`Wx+D8Ngd{*l;gTS=#X#f`mHWQgzkHV_4^TaU(_)VHz*D>TNyV_u`5ICO3n8~t
zUV^F&!u5unfmzE`;N%E}lKO^|0S3B-nSG-gdifbbxQbhXj?$jf=0|@QrluCtk#Gx)
z>p9Z^Ui}6$J^k?j>AW+3tI8slzG`UyV~ziJT@G=UYK+i>^$#+tIwY0d$U<L^gkPK}
zbRYKS9(v2Q&2<uLwV1@yK+7H2n^8FYHU3O)KnKbs6Z=JU847;S6QJmF04M?SuI(61
zFfDTsrkDXFfIOD~G;YLi*k>S9?-1@NR^X6}F!y%snl8lY;Exe}{8};AKyNx>OF-}~
z@SljC6504My%^7McNnd~6GAz;GO4U+kTU!tD@qqoOgKwD26aEPHQ{8TdYmj0uKVZn
zM}RlFK}wP7cwV*cOz&j8LUz4<0_(P`u!6f3mI|mA{HJTJD`U?{M4Olwm68NP6cbaD
zkx_r592_4W4b&H?rN!9_laWCIc2A$%-P4rxTQ{grWR9B7oHt@LiI?f3`^!lil$HsE
ziu~HMByt=jZf(R$hx<8CTY3@-ExX9nBBPnREEQ7B$3=YNb|}PEq$p#SOL`PYp_r6G
z$P^s-k{2916HyXr74*>-ESrJALw+nW`U-2m1>hzZ2puTAoC$^>%@H`{I?wE&%<9Z^
zaI|yz%gU?NJDG(Q+-ms@uOdKm16{olo5P|u6Mt$bZyiz|bLZ#&m8^h4CVX#^EhfnZ
z+h_PoYF$+nERLMz_+;4rTUs8vonTW>>IUfIcuW}O`98%fecuLK2dp}w<@9Q^yA^GS
zvE#slN?>&=cN6oJWQYgT&?LR9wZKN}N8q_9qBY#x(HOJ_*Tk9dvZkN2cBgw0!Zzpc
zM}G@0f=&Sq%njgb;@#rtMX8&UCV(>IHu>;`^)>bV7Zz8dlL@`oD*5Y_xs!hE`@j|w
zCMqVA#|}7vC=VyBsCMZK=k_A4(fyH4vdZikj34_=*|O^oVAsx=>ReZCINCp6dZ}C4
z*V!G+^_wxJP9wK$^^8#@-OHt>MmNo>-8OnA^nVS_gtma7F)R4SH3siwQJ6AS099qH
z0Rs3I!1gQMQUVY-?5Dp)FK)=H!`FoFhtr|{Q2zD@0Olv{#?@rx(kg&)=*C+Uy)^__
z+;esJ;l_y=Y-k`4FFgY+rW?X&)lAQDkfKe)R3Cth?eT|*@@vi7VqwB9)<GusU49TZ
z1w-D`GSE;k0-U^YBqYaOf-MaAeQ|D6CsRnR^+^q!;t~ju;NttkFP5u18s<YXvww}v
z#1xC;OX|K-(c}I__I`!DihutsnrVqe22D}CX&y4jE#S8!jdhic5huu*X|yX^>(5yG
zvqV1{S<}VgRl1Kv26>&?3VC4VF=kcMa0l#^!abHMvSPC%pY~E#w{UG@(qmeQZedST
zDz2G@+Wn+}v4G$bok=DcfMkJmQc1N=b&k?1$kf%dMJfC|GpFIR)6UUqbbLSPsx43`
zQNzc4VO;_8&?gd?n%jYlrQf|36TJd}Hjo&<xdN}z+O_&zB6H^2psA?)u#wc;`I^eE
z(Uz8y$8q=@@O_zaAKnB^Sqnq(K7aH<LWtmB$SkMf^Pu+?Am9Y>zB}@z0_TDE(LkKz
zM~2)0g0zsX0q8*oX5h_q;qtd2_6b7J@~r^(!s&4bw&Ts*&U}U7Z@}&{KqMhZ1IhRH
zLF$9xU=pu^m-*62EYGa<g2ycbFZAanVk+wLT=Fn|qO&g&U>EM}1Ky)^McP}&8^A4*
zJk;V*t~kEKd-#CKjb|hILpvHbcc|aYCJ|x*qGg5p*Wv(d!$TE7j2u$6g8ETOVjtoW
zniOQrD!c%o3w0Uc7;+mRg*%LWmai}JJ(^3^IEP8kb(VII)6LOMvkfEDVecJfY#!xM
ze>ZBIdCg{D$7Tv2KUZg22Y9rb)HN@9U|36*e)Uc%`&NLL$<8|$m7|`!_=+mlGWFwC
z$pfYxqX)MzQ>Z_43U{;}x~o_+xwM%p>MWXGNiLFA!^7+;c_}d=qabGpIjAy4G^jaB
z>po>AAfHhESn<*oiy)4Ub+N;74Gkw=t~lXx#LDt7TDhnCqP>H1p9UG?&38xS@oh8(
ze8N|W<e2x)zXloOQB(C@uM17e(=BW)#8R|z*b|Tmgr{e#xh}{@r~%E@ZOkZDrBnm7
z*-w5j#pSaG-Ca%7II)$n)yeyidk}W6OKi&a2(N5;Qb(K5J3y_S_=3bcOKNP<s50Q0
zyBz{;uf@%Vw_!gcDi5mY8x+drCKI>=7#kUg45v33H+xW!7@V19>ap~Oe0~$=QxSS~
zwTKBa6=+Z3AtZ5Y<50n_n&;)Fbi*(r`S!y?xES@}yk<6!G$&lm`uJ%#n$zwzr0Fi?
zd}l(AtmGO6XfRXHd-<#`i!-H&=8s>XYBgG>tcna3(2nsK-<(Z5QOa@$`dx=f83!$y
zREF<hqPx(vA$C=0G=k7z6q+V100n(klTaMXNwc??)e+Eq&!V08;O>djO}e9(lonSh
z$`p^Sm-MSsxn{QFk)o4-RM7tj1`<-aInZFN7Q``yb~jcmu{I=xEPpyq7RN6XL#oFg
zNQ4EeE<;Y}t>+IKL6<02C%q|kEbcS1nv5~nKfEQZYFXWs<M9&A?$hz_Y!PlrLNkZf
z5TY2Y;D8VC^ety%ZZ#a6TGd0bn2sB62|7og<B=FhG8lPlpcZ~mn^fD)kum>r3k62R
zcE<eeKoPE)hWL_{Y=3A3U{eC@UH+qVG&0bCz`B`l^^}aJK9OO2gY!HuuKDN{LrQvt
zc{~2tW(N!Dtl_m1zkk`PI;OQgShL=l@%15VKqh8OR*hmyi_7emBemdlXHzLbnTkUZ
zdru&2|J|9|qy5*2iLM>);0_XR_;zhKkk87Nm7IrrLbo_c!;dm%oKeOhhM|6Q$@bBC
z(HK@S4CxwHJ6el{z$LQWA^)FH{yNGfN?J*S2J5gaWQ=K_K=P&w?%69(u^E0c?4#>D
zmZ?@O`>Ub-8xn?yXtZCzk}?cnfU{YZdvDVAC4gb&<}%p>#t{w>dvE2`0(V-e?}rax
zd_jFc3(|lQlltMpg5rfngZXN4#mn{f^?=ac&FkB&IYX+VAG-6Yu2tzKK3p7&W=$=c
zC>06Rsf7oVBmwHcjgH91djd}u2f$k|)rJ7+D4{xvFF@Mh+Y#OFTgM)&di5Iab|HrJ
z7&^b9^Vu@!SoqNhz<ATTE<l6ze&%oQgm|*no@oO;9Nu5`rU25i@MZN+J;ZAeBPpYq
zyn6x~-WePWe{CMPhz_KP{nCX?g|DyFf?s&VnUET?qR*v(k<4>Y+)jI%DyK*-rnmyx
zE0>;|fLFqj#8R9yzegAx>sX1}@J8K}?kmJDJCl(L0?ksT8XP?G&YsH=lhLeO#p;8Z
zf9Ce~(NO5Qgku`D+XI;7iBCw4ERix{nC=uhroNT<zSuQ8P|bm0Yvg$ajnF%?pV=<V
zohrBmW0vzSm59UaWco$@)_wv!8}Lz5eXVKEeKJaB_dxPZqK3bZ$Zw8GYRCp;jdc@t
zLY!JkHv!n<cLOQ5Utz399UfTK`NBgS)u4V}eWa+`l(7+<Z}=sB!p@O78}a=HG<+Pa
zR<--S*<vx18TAWx&yQnu+51QBF^CE%7Wp@k?yA@bKrk#i|7zkyz9vl#|GpAHx1AZ@
z9hujUqeW>*z%n4vZJ0>V_$O&gngT=dRr}aEGNCpC@f@QfV%}N?zLY0IVr}}n=ra)>
zwkCtsYhejQRFmIZ+nsjXxb4=RN_47NhD3uBPget#ygN1=@E__JG^p4pTlH5v3NF@G
z2bys4=l-i;9^q89spxpLoTajJscqQ5oLJ@6pLD@*yihot&m1|gxoCNLx%(vi5%Tmw
zo&z*V5YKbxK>3A|sq6<P&=j=U(}TMnQAIIkm{&S=1E#=wZ#s}E8T&8X%<ab<LNtV1
zXeZ6aK#g}(kFt{)NuHN26<~}^jt}(s?VB`d-T3X%mN0P`V-3J8L(^fwrY`2wsq@IJ
z7=#H1SK~yP)=|f%W&!+oljPMT6UBpHn21uE$CTiPi6Z*-nqFKZ*iVX-Qb1&LDQoe2
zI*@w&N=Xp_T7NvWY_hMeddI9E-L_C0H{=`u1sxd&^4ER|ui!Esg7%mum+U$?5LjCb
zOd>s7)5#w1V2mbX--?n*Q8O4Ig_i7RE8r~6M>u5D;vqU%57c8W<2l&t#HeXlTuEIe
zu$@>i7#Ld9f166Dt1&)Yj@o2i`#-Rhi#Y<#WrE2T)_XCy6gWyC)@dp0_}Z&b80KrG
z9fwzSAeyRh^*ni-Ur&Hfx$q5stH^b!gKqc*C;sX$?A?}mVk^=_j`&oa+wP&m4{q(c
zE|~hxRZVxz8gg>Itzn?`g5psmRq5ti?LUgz2H_s2L<)IZ1-h@AH+RbRYU++uiBI#2
zk&S|XdaAYZ70{kxjkrmglUT2B9?)LyDt?!(P|fN5^%Po5{-Ju&T6^~v`Ez%$uBi3A
z>D<bKVJT!0sa0(Q>XN`Z&MnR;PKj9_jW~M5G<wro5jl+_C~t4Z*2>waa+WDm!Q#%X
zm(sm2+fv4RBoSLdXSg%<R+xL9C=x=4aD%3jrbWe7eucc$VWDTGcl+D{p@|^4PDTq4
zEloDLPITl!h%kC0bnW^c73C-U!ayEekkp$mw~kJQ&8*BkEr?JN>NbUtL;uJ`TG(hu
zZ^!gU^lQs&qMDg=ilH%}MTnNv0dlQKm+OHOc_x4`oFr$_;O}v&EORMeScZal^n{7@
z(i_Z)J|mXH>5;mX#$OghC{w==kM?R=5+fX_<W|=6A`bSD8}cvCj2Bj;IXF1hcOf#~
z{Up&-#`s!O7!tu6m8d9a6VgymriJWje*B<6E4(4zAgtkXJHMlsk-pZD7_ZqqX-qx~
z_DCjnznM3vsWS6$l-lcrB)7fR{F-U}2%*iXH3mznD5N^bQrWU!XCEfM4;Ecs@^$n=
z*7bqy*#a*tP8r~6s&I5sRaR43U0PcPUxKa}bV{ozIB$4tqsk-~>?Cj+vcQ?xAdh!%
znio0MI*ul2UJvn<X3jg57gAK_@iceHCf{*k^YkwHb+l|6sw2ffK!U`Q27*N2dT;-c
z3*Z}-h{x>$kK?}x9B%RMrYjo^ImaJe>WEfo2SYJZONLnA<XkYSJD1@|qKpn{65P-?
zOIOjTZi$kQ+`qaO$w{>$;KpVdez==U9Gikds;CBvAoml@1<oH{>52DL!5{CmL=c^#
zh*)t=cH|{^oT$ZT>vu<T>Gj#V@m73kK68fcZim*T=TL2AlL1o5Jg-?*DvQm+1~Kb5
zrx9Av*qI8AkFKNBdTJ)3Z(<A}XEFe%_>9clAvTod+=&6!@q8$bj~U&`J@Ron6cA`3
zp0fPjI4BT#0f_$YC4Ix{u!y~EVnn<t71q-shyY?2NDw0d#4U&j6X$HHL|^MJ#MrL=
z&;cELXOD&h0|P&VNQ*9r8wfo5{_2IB$WblSG+RTD-hh)GW{U#W_-&DivmC^%Q;;Op
zWmckzf4oDwd06dDMG(OZ%!qUOlP-eO2JNK?fO9}%_Sc!>J8#1T#JiB=H&KZwh@$PR
zq!7o+J}+Fot;@>0#Z5nX5W{ZX{U#)`{@iPth_1et7puOS>O3d86v!KUjwA+{)gD^s
zo@~Awh7=Odj4Q@sXE#Xki;FKGfEU@}QG;7}tTr74OK<k|<nuCF_#^0VAdjl%B_4IT
zniR|U&eioji`(^6Z-QKKue8e8cP39>8jtbVWlUafZXw)XzUWHRUgjx5zfIQ0C!E^{
zFC0J#I*9w)A;L<f5Tk^pKnq$yAMCYNJ*b#(6KQx+OTq=IPtpPWwr2*x<%V+my3@^4
zmm15n=kiCiP|Z$<PY+@}OedBy9bnSMNRucXx7q+)H1xIvnRLqO&LfLZB4k7mQBzw(
zX32PnbJ<rmrsOLYk4X@-hNT?M6TmDsd;`2Ig5bH`vOdzu&%VpCZ7GVFM$w22rU3dL
z9Q0kWYZ+yO;BEEk_5ijDwZVOO?@E`Ps{^`v{D7H;be_6la4uc${RR#bQ4};4yzzm&
z9}O<BoGDFRIk`!R;nTJE!wxBjRjPgLzZ)~1GmnyN*tn0le`7g$p1g59yF`plwo*HX
z^bdCFz1qy9Q{IOjX@4Rem<`USlRo&!eF;@{B~>a_D!82b^{!pxXCR;18@0BnDiq<4
z{nQA@7SKAg{4sy*peL~scU=yG8EQtmY<2qEd3`^+vwE|`z2cPpN^BgrGG;x;*3yBi
zzk*a__}7|NjNP+3>n|K<u8|7Ns;DR7VbSHH59E1d>r5eRCs^hrwed><%>pUHR^bTs
zl7(_E@t9xcV~xgZO5z+bYE6rVx^ZLZ#>_{x$@IZxsmMKujp!44<Cc0qxA&`cvRMLU
z{~STAyK|p`Z2R@o+^ls8j-eV``H2HtUA0}qJ;B5s?@$+T-N0_Kk6>SA)bxJgmnNJ}
zRfI4G0y!5+Hj9^pf{@MK39p(--l2*IUXZuFc~M!frbWqe(cFBz-1OoapHEHQ8-8Es
zsEvD1rLJg6U~y)ra*niCr>+WpY8CSeL>#xM1F*5LU!>&_KmvgIFbmKHI1?0zs<B)W
zf;mVnUvJ-3>;ABk4awF(kxliR-r@kR_L?_JMYiWD_}oLuz;Q;eh9wBR^7+vKstj(Q
zR9HZcSH=qhtGtH>{LGjUFD3rX@2q&u%8bWS-Qki&1IR$GqHN*m>Qt8X_|=RLzP;o&
zpKFq|Gs{Qe=T1PkWr9P7I;ND@Wz8Z4BL47-gAq>Rzz@9$@&c9sL&Fx|Cc%CZ+NZXA
z2fsmE&#kokblL8cq9>ZM>Ge}?tkFb#Ko|zyEa12)MF}h7`f`|yukV2Xvh}i3-Ymry
zpuu8@d!6};aHus~^=rUgjPBHa;79L<$N62MNrPZ%@eic)bzB?oqvQeb7gzmJ-KmGA
z^19|g%8ez+{hF#Y$Z|O0cHd$v-g(#)1@iW`7kL>8JC9q2;mhcxE2Zov0UWGiY<#B0
zxON~P2u`i%5<OhDZu_r2MZeEO$>v2R;gk_8dUAEGQ|B~fmca2SAy9mhngI}J$cE?`
zMWv+F{>L_E%dPZ@_*&KJS^zdVgUC{jvHtlF=+A*`>-wOgK2b7)Me4}v(CQfOKW8|V
z1Yd_locDX&U`-do5_-0KE7!QoYhud(92CScdNo$1Rgi#zEdyno1V)$Vz$^v{o#&U=
zMjWRQmo;mCg;X+}8$VD~Fe@iqC`K7q%n_@}NsCH^?eqLqw|Bc;<3?~j7fso`AZ7i2
zHl4F2Zo<A;e>^LqV`@(2y0clPu)U38V$qRUf%Dj|l?~ZklcUX4&8GYG#-O6pwL7T<
z+IX4)z$DfAJ^R{k{C;VDQ@{1}o<gp<1k9y4`e0j<2rDi_uH^2&#j8ekaPOb3ApVF&
zc})hK))zum8xP_n3=5VUH0_YN3g7HoNo2d_X%q5Xo5Jj7(Mi2!wk5RnxMj6vpxyL*
zy{m#c7JM)@Z)O3z(g+YlD=!Epfli@Cqn_#4C`L|r%xKt8`mp)-#kVi>!zX{f-?C_)
zRaKSbOI*d+RZTxB(|<u=9}w5Z_nD@rmum!iX`A<M`3m5;C|DQ%W^9LH8uCzO%Le$H
zsGH2^_5*{B($q0fNk4|hHp3)A-po#p*k8bTO8R23WAkdyEBOLQ-Au5RjWyif0Xmj;
zy)r2YQ9#jv&Xk$kfk|+@pKy>*RyUx_l#hsm1364s3o(L4pB@QU)IaxR*cHDgIF(l_
zM|kp7sAIiGx!JVX48>g8bjbo4qs#V0={QBM9?4gqy7VR&RGyyi5qU<nbneb)2l+A}
zGF&!)F6ivQcY}@jK5p(lTrWH(aDpYg$LKT|uy^{w>w6*pI61)Hdg0v;9dx=l#Rk3G
z{D~x8N~xCFtN(XS`t4BDfst=2pG5BxtL0=x3imICYOyj_G-q)<62RC!J6;TX>;UR{
z=J`wPXrVRfO@fg6l-FQS1N{XMfAStSDK(;;GQ8TuY_(o0My>uT0v9@xPI)kY<9Pl8
zISS9WL_}iD+FwQjyOM$Q4N%>)yi~pms#fuV@(Bk4JsuL0h`&>)QusZgFra%4_MTD+
z-+lq^qpZj@0p;{j9c=={Bqqag2KocBy@~BC16QLn)<!Xr@e1*D`p5znx3gR0ZevXY
zq@2+hihp%vp;1z-0YKnEl<At3lH-89p>mx*fYOa14I!82=QqGMN9fK|{hWsxqFU>n
zjaQyY9cYCgW%Rn1H;VL}VGaApo_exBB3|S%3^&zwwoU~LF~czhe)JQeMFjdBuN81Y
zU#fe3C5NBEGfL`wzSu`jxAgEmeutaKoC9ER2A)|WDu(tnHF6DRdO}}B@-w+h4W+;;
zHB3=WX|1_+T(x%CwrXGQ6lz+13Vd(<$SOyTTDRiZX#cRmkU?E*s#PP!WQ0$<wo5p_
zS3b5H^B8I&zHaJ+hw7$MGy(M(b%^K4qz&%pqfa%uRm+-XKui*%SEyV*NPOJepF{Q(
zL778|h?FLrb6O@)brGU`e4|?L&pc6>1q1#8BFDgHE=4efYB7jnm;RF4BDFz@gS436
z-q+g2t2p-*G&Y>*ku;oG8BaUC<&b?~YpJ-cf;^?WEM5iA%M9!z^ELY6JhG^qRh+yC
zs0KK+7_kIg%05*B*o9i=dz(lklP3@1dFL1-lvM(D766Q#Cw)>LP|ea4#We!2RXOU_
z2r4Muu1ZleYpAs0=C|8a*dh6pzw*vbF2D{~n#C}g%veR+;qc8k%!B1FBB8PzdFdbQ
zU>?PYi*v8~Ob`xUqx9uH0No%$+wR_*owm&Nu+w)qozcR9QG=E5q&A_R!0{fJ<|RVb
zJ?KN{K%KNtlf|f}-ERfB!U}xRFk6<DkAjRMi#jdJ9_!ZsrS`HvvG2FP=dx?VsD%C`
zDH1?O!AaqeKZBDU&pyo*lY^-}c+Q9Wsitn()TBnbS_7q%<~CF%+vYZP6-@k__(FTq
zYVXQn^W1yxi|7FsaGdFu1>Q1P5!0=Pu?RkwV?tlC=v*&pi-&D6c1pF(dL63=6X+d?
zXlJS}4AFdf1FN@K6t5oe<IdCaJL?z_`UZ;_$@ZAcyns{8&+Sf7{7#|w8brfptN=Ve
z=T0<NZpHvSkY^>qP((Qt%4ZB$LATb=`KMqJac(z5&1@6Bv-+fT{)Y2(wn_{)<Nl<b
z^VCJ=<BK0Fl1bgwqzYO<O5g6G@A@hF*5l=83~sAo<fK_NY&#UAO-ESow)l(`-MU84
z{7%U0*T*a3szbfrJQ*=O;Y$JX>zzAm=~F<dyYwFCt8~opA<SD-v~F^-)_R1=lVKR$
zwrepFh)@RZsT0djptvg-(?FUw9y9|NY1Iq=B3oMRb)@ktaj73J#f)4$x}mXB2u->k
zY;Hi_C4h$^AHf}QLE;V@aYL^-gq|+^aV_lCxH}%Jqu1@A8YDma;|`X&@SVVTctL?F
z_(X?X&#Zk9OB%LwO^Ucf9wHlvf(BfCydT?_wVto`rmqslBe>h1yJEQ8uD4=VYNly&
zSKb%=&ZBADpH}XGUy$7L+;#6wa;&^BYJ7rPFa295!6lFM*q@@ARL)&zq{Bz(7~r0U
zyQH<7zk<F8?jXO@j(N0nz`oY?b~;zLe#r0Qp0+a4Eiw|<&M@-WCYV$m^IZpgp&}O-
zMQ?6>PI!;=UGsIzf2OZeL+q^4zYCUx|D62w3F2~S9Eb||d^xBiK9wsQM#;K<!@sV*
zuD4E)37x%oVM5D0E0<dYbj<F?uZ{4OAqj{(Eo0o=UmRFP!@>F67gt$-8=ejc21_E5
zc^Ys4t4FdhUy{E}-(mW5^!9K*rCZB{*`B6)CnbYN9IL+=*v8<}@GBq+Gp6O1Fs55h
z!E$fXxZ0HA3Ck0Z66xFNKK(db3mgrEgAb7dl&%4!lRSv{6HO>(Px*5)DC2SS4ZBXo
zKtx}iG!^dwoQ<ZGd{iK)r8cE@nh<#cxTpbDA|7);_ZJ~$Xy2vWEcp5_5N_J#qJ`2X
zz8)bl4X|K^UN2SQNe^OyF0Fdn`fdZ0OV86et(U6CUdsiuGu2Z6DsaWq%6!U_E~NUa
zEt_G{B3;_^n%K#-p^H>-fOI5YdKo5wVnY~X!xg|=4d_yRwH#d8J0roy5>yQ$-0`RV
zt{_Ftu2;^e9G|BtBg%+Nnv6B~@62uL{t8oKgA+{YxOfb~5t{HA$|J4|Sq>@`(*4Zs
z7XKyL@@{%NBo8EAV-kuX@3Pw2-y_1@NZar}wAm0jKV?kFYQkwoveI}OTw8a8O-*js
zOjT|PXWPS@1zAzApD@GH?E}ym0%pjN&81@Td@5&%ZKVNq%^qy1kU^~^1u+RJoQUQ6
zjvlCTd_k*{=Pj28m?Omm7H6!|`*Q=^B<=^QXM$&rWH|?}V6ow_;j^IX@VkgS-tY{Q
z28o);0qJz5oa&!IjLOIZ)^wxs8N;A!UExdjOX4tp+Zt9x^n}k|suXCG9hO3y{#Znv
zAJY`!PNkR6%+Jx0T@96(uYj0QR1%Kg;*!58<ZMl}N0e9BC#PwPb)sYK7WSJ>+f`?B
zO0>-UFgvK193F%Joz2z$7?5OBt?``FU8(U*!hRDwLGLVumh9k$V#-b9c^Z1r=Fm>J
z)rwRgc+X{nz2-WdC%_Ah<cER+K&`k_QM3WRX#(1(&(X!-s@Mv+Ex@u*DvI@taG5a1
zQ|?UWT&}I+Rru>jxpmRFWTIK>w{O%+ahoMe38iWD(Y(0U)PjFz=7+y-V!$Kl;q#7o
zCIv0MzoxjrTu@0db745a8nI%!j;gx4B3fn7LSBz>Lp{L8&rl^h^(Nt+m{z)xuwmj&
zSt6()4`{f6rgl`HWky3+j6}r((24*_IY%uRs+?@n$?nk`T5WllIUgD_fQe>Gu}_e<
zCR{e;UR1c`!u`!1HXsez49VEc^#WP)ejHHT9_u7lq4)))O{``Z2zaBr2WdXs+E;93
za9+aVH@PtpSmCjV<pf1d-_d=ag_2JJ*NxPulu1?QM|)Wt;4s`Ws;-ZvB8Bt2V;$4x
zWb%y9w(E<7-KcYow=a6$?g^uDhae-b?Prx*W`@@v4?lDR1oVQ1vQVpH>jOLyX>a#m
z(msBCJ$H<m@2Fe-&gCmxZlplw>+B!jwrB?LoUkZF-M;ToF`KbK^lacm4FW;dA{?gx
z@rZz3cimq3c^tJ^3zkT|)MTRjlWhdiHhUV-ZAGAHDZ({<g;r)X7*lyC?xFKtGm+qC
zL`U}(S2mUBi;eziWBQX8EECEReeC|ZCu0?0TB}rxB27=nvU?G3f`41wjnno~d2E)N
z=DpL{VJ65oj*u$#&q31laeAz29X9u|s_)5CABO=KSe)x=$BxhZZ2Ltf1l>w!v~%s9
zJSifLa)zV~ibw%T0V$<o^8~|kR%UZ5M6WdOkP?oN$pNEO$%iS~$r~Cu>RXC2MWHQW
zr2?0Hak*TYn&h(U6<N;4GUJn(vvl27><+|fG4EdgVb!fVtme%6+L1mrB4`6M26ZYD
zgBct!a8NQsvJp_R+EH8>u#a9_^c6T$BYG9d@Qk~N2<W>2BdH%%nNF2B%dCq_%Mwk!
z8=gfx@hKUH_Y`#$?V9C+Qe&2Jb`cn`1wh9}Y?jLyk^b}epyJS2T5x-8sJE{{6A;uQ
zZ3IO2)nJFvP0WsF0p?FjSi#d5ue+-n3M~ohV*qi(@{Q6+zF<WUfX^b`pU|29z`>w+
zyS*Tv>qSpf5${h(-9JLN@sYj<CGjRf11n3Re`C}`X|atNgVpknT4ddvCK7P?YPr+h
zj&SS1p$zOifTrkk)Pl>Tb1j&~vAhE7<Cn(g;1Ppl{y9y9QXAcuRXeZ+N=*mk0(&B5
z4`pep!<twohOrX12=`XpPi~QQj4nPxMVSp8Nu<=}+faxuZpWkN<*@kChOR%jmzR<R
zoAQ~GA&h#grM4^>W~m^dXD#j2srd<7CHkmqEUCG%vaq1)cAD6gm3TMuITtvj=5;;(
z+I~j*p082}b({p=bNA|dm;g9Vc_Uu-0elE<Ua!-tBZZ^lLfO73SyC<`WL#b?tFx=e
z;+Cx#e-6y$3a;1T=LYCcC(+{|IjQNJMB)K3p($0LMrqor3YO;7n1G00S0`q{bk@k{
zAP#0nHW4%`<Ub<2miR+ZDCwto2PUovP$h3Acbt-+WPQ(_e8JC+Vb=)-yMfU?Q-NM%
z1QE_8q580(>gIQ1IVg5L4zbHoK*tWWes3g9+N+hA@NVJ|OPm`1D*u>+upca<ptT~G
z5~BoXecUmYn}C=*Q`^5iEEN&(&k6u_U@duio{*n3eYwfub#H}K9qYnyWUM<IstSts
z7|@xyODtPYlR@`WT(rre4p@wb!hZ*s`b>s);exv|%{zO2T6yunCK_GFpT)cMQj|c^
z35I08{3z?&)5T^f31AO}KjX&Bq4+9)<1OhBXI_>xj#InPeAK+;?DxE<I!}^r(lV6H
z2ZN!a=!C#n<v!zxS13@BCJyLiilzhas)R#O?ldeqsP`2DZ6hZ>X+Vgi2uT`FDoKPg
zqW#Jr2Bj+XDM6?#*2_^R-Lw>zx>>lSptUN64O|<3>iOE7A4%ry3}`^Nn%W$t?ZLYf
zis`j^8V8}4`8C1z{}giO(NOMx9H%laW4Rf1EtP4R?96Vb5<)YRZEQuFMJD@BxRwaX
zQcR>GBHJ`*RM&R7BpSxjj3(+PvX+!VcE9KLJNI{gw|jo)_dU;F@8|tI-*Z0S^ZfIi
z^LnWWaZ`$d___qfRr6}Q=`=EC<w6KHnd_2lkB(oRgDHLVaCp`7wx~F(jT$=0KTod9
z^JYDZ>DngG*nP{5rqI=)vnnhYDV7{QwPmH$y2KMy4pg*vIet}+X`yd0&wXg`)$!ZB
z1#0whAC<+<mE>0tn&zk8rW?(F{z4MUKiwx#T}<+b$X4g=rr}JH`?Dv~pF%7f-ib@V
zZQLkM@yy<4eZp7IapT!%6&aWUa?I)FoOx^hkeHI88`A~s$}33JMtfw)m0gW$mR{;u
ziBHeY9&nbDkg*JDU1y==uX?SNS~WbDS>N3eWpn>(YWTs*V{y-`kq2&aoo2N-N6lOP
z=IfSAS9Y&DDY*x)00IN6yTM_R4UIoHSP_@Ea+*z&g|yWq+&I)}aOie!knjwm>1d1W
zOk&rszP%EXEvJ)oF;6?~&Ch5FC3nB&e%2C_<oL#fPD{>d;uo40R)!v{jNv-jnED!F
zA~mCNt0loA-7tJ>C$%Ht2JTGY^33g&_h2zti85`0tX>{?BlqIVcVXDqiyV)UM%P#Y
z-h<xyTff#TU-;-A+?CKf<N9nhcJy<LDmA8eJ6A;N(zdv>DpQO6u<Mg8VlYdEd^Y8=
zh*1q(#L0SaDy^!@-yB|w8hW2GA*;4Ms@4+~IF#lOOI59_+XKg6EKzovUW{ZN=Be_3
zo8y>a_qWL^K&&)5_{8k}#`otqg6<%+#hZ0iZIe3xxZKMja%WOY?yY6Ec030!PnyA3
zA4@=Vi}Y}{1`KR*+bFKa)ZeTW8hp3-WJs2a4pdt#V)RSLM1Dl&;CacM&*S+^qp(_+
z`dD9RI3!9uDmE|R{hgGDuZewyrk@5iQ)J}PyQ`T^Dj(j+?ZxjS$sEB+E-Oz<xiTK7
zJ830KUz@}lsvEj)D(&)fmX=xrekYEd@44UB{P2#-3YD+-Vfvc;W#?dGiK$Jo{O;<Z
zy-Nzc)tJ_c)=Rm;*BN$d6U6Sy({2HF;}xk6IfS8lpCJSFFi@vch=xL{tQF4zHo`zx
zd|cgMw&Qh<w_9FUnI~(c=Dm7lrP)I#Y3!4My=j@31(9E(uj$wxPA#*=1SIoE@8hjO
zx9EwGV>vbrD*b!uQX{u*hksK6F)2-{Hs-9NPxCAse#w4-(LY;^ACr3$h3{;)h|bN9
zepC>4*7o{Bthn+;c<UWi?OL_xmz{U`@fCm%Y<t-N>QF3OBw3@aaH=dsB=d!Xoe|ej
zB(V34v%^jmFx2(7GqIs8N$&c=LX*hO`D&$A12rF*%iNVNW)^D2h$eK<{VHRRlP{sq
z#w_4KNNg%k%o^(qsT7K-65dre0J0Go=V<XQPkAMj#nq016yYNvMLBxYf-xM$dI7fo
z;nn$Ug&kL?&EvVoIWgYF?vPUkx*=>SzV{UNNIg%Lw`-_uoc;;TPQHi5qICKa)2$!9
zBBr_i0!UEoT4#q9N(mR&uIdoWW<jqoYy(qit*CPXen5)OrzZ=Y9h14a(uWp7zYe!L
zQiu{MIYdeXj_5d*Wc?tLM(m>ouRY$jIwaU8QpZ*_pPU54f+{AMg_Y$EN0E;4Z`DQj
zW+OR~)vaSonaV7KIwtMy%R7B)4-mimHojc882eCPtY2b>3yU`q9WG$fKho$9<q5eD
zy*^SQo{#vljmAS)lx}oyK2MWyfF*6s_g`t`go+MdDWH4n=~ZuLBr^|cPwr|7YIs>G
z<n@I@&^jY4Bx)kuEzHt<#Z@toT_fv+(_St^IhnP$e=%~o&0&Z^85T;hxEOAzx#Q^P
z4{v|YoL6)^AM-Ixi@xi=x0jSbS<-y^-Q!OOI4R5<!xFdH(DmY=v7lN=07L|YN{|VA
z+i;L73kI!@$LrD-ZLbm3$D4i$-lv@q;Z33zo*Ze9)NFWhv~~|)vctj|IwRmkHkt25
zm!!Sd@10_08QR^Ot<I74M2pGG7ya1XE_EIEqq<G$;B<w=^2Xu1(rYMHpOKT>E@%bn
zmo-<U1X7Pi%Y{zZjad#p?SSN-n6WKfr^{H+<TJKBgcZ@{3F4}uU?nR{uGIkvWR_D^
zmF><)wG%?MDn8|Tgsi)mo=fiWes`Kh-%NwamNCL;i!;`>Yd<XQTVUc-Dg5jL?b6x9
z-Lt*>p13J!v)f)yq#3i!Ky4Yd&m%V478%wl?x2qP0D;>{iXC>Fc!E`CQrLEhW8pXL
zpNRO?7+#?4U=%{8Kqkd!Wsb0!?YroA2i3d01*eB!_hF|N(s&0%;BOFHx5%QNhdeuV
z;7R@SNh?tAT!NTQxGVp&F-G%*Y4WGM%TJSS^&EajNtcR#ta(x4a-(aP|IU|FtV?yy
zJv&IP=N`4*Yy&B6i4pUAXo&<aV!+l*{1~szftF{*Fqf}jEsjQ9<5;N)dg>;8s2z=p
zy{5#fEQ!x=2yv9V6qLqSXSQ{?;>bz4E6^Thtj}Dvmq49gp0`RDm8&^<L}+V0s{X~^
zM^Cocw?A#gcwSsH>tSg$e6VSdQ{cDX3GHulAG-Hbq1PxlYx#D{{lhj*Ajg4lNiDH4
z!w3TELDArYl(e{bThQd^Y}m~S)kE)w@e`u4_aGZ*1{BI=(s<^Y5vma&`4-P&GmUN*
zKBu?LUIW6_Cy!v91URC)r?`Gvu2b?^_>cr>86tG9U21zjso3%ee!2N*Z13;>2CiNM
zgS4M$@{Ig2mNu7UH0N@Y9#|V?ZHb*(J@G=C=W44MnAD<d!gX#2Z?1efA?<DtPS1!o
z;=Hz}v5TfH-c+w<ifrF#IhzTIIVDWZPK7N)6bzy?vt__){xx4O@~!iVqc5CD^j@7c
zeLvHTQl)cWJ2qXye~6>b&+yO!(A50AuyM$$-*H`sdMGE!aQ&T<_XdjX&eU&Bnz;U}
zS<fZyQ|}7E?|$B&Y9k+&V70|e+SEA?QIOiQL~Pp(Wyo*BibOV*&uOeb>kY5Q5aQ>=
zU5?gx-I&YBf^8VW>LPgkB&VvFcLSA^ochRxDhjD1<7Vup66%?p`#)iH#DD9a01Xp4
zgaqipRD3*01Uo2^5*Xy==L<z*wGhzLD#t>+yva}`=9rG|X;r9Ah(};>BtQ+Be^Wn&
z2de^{FJKM}2A(($NS4G^j_V`gNGu!y*F_*u2$Zf19IgypKo93f{-Xl@-<7{O^zc9m
z6=1UwNOAao78HxYpfFG>^v?_ffXUzPLVf?tP#7e@y#KNO%HVJSUj9DA>H;dNzxPmR
zJwRjiU53T}V-L8FE-=6Edw<OI?-?4d2XNWnWhnIb??dQe-~e|2XD>L=13;bwzj@p2
zydo*U3;^+#pC5o&e`BDvEq$qe&~GPb3&7aN0V3WIgT$ab&=?XKK{@9^CLt+gj1GxR
n#*)q<bx0Tt*;xGlSN`n{2nq(y_uKFhdRVNkI1FY+Fc<$9@MASd

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..2d1f3c692428df5d75c4503f442b2f83249c1c16
GIT binary patch
literal 57342
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

literal 0
HcmV?d00001


From 68ea8235e6028afd889c5f615288d7a49b3b9bb1 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 10:59:15 +0100
Subject: [PATCH 086/102] feat(flomni): rt_positions prints the average of the
 per-point standard deviations (sample vs FZP during the exposures) to the BEC
 CLI at the end of each scan; no ZeroDivisionError when no point was read

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QnSJvqxh9oDbshx8qXgeiX
---
 csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py | 25 ++++++++++++++++----
 tests/tests_devices/test_rt_flomni.py        | 17 +++++++++++++
 2 files changed, 38 insertions(+), 4 deletions(-)

diff --git a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
index 3ef464b1..eca5bff9 100644
--- a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
@@ -877,11 +877,28 @@ class RtFlomniFlyer(Device):
         status.set_finished()
         self.progress.put(value=read_counter, max_value=number_of_positions_planned, done=True)
 
-        logger.info(
-            "Flomni statistics: Average of all standard deviations: x"
-            f" {self.average_stdeviations_x_st_fzp/read_counter*1000:.1f}, y"
-            f" {self.average_stdeviations_y_st_fzp/read_counter*1000:.1f}"
+        self._report_statistics(read_counter)
+
+    def _report_statistics(self, read_counter: int):
+        """At the end of a scan: mean of the per-point standard deviations (sample vs FZP during each exposure,
+        RT_sampler) to the device-server log and to the BEC command line (Mirko 2026-10-26)."""
+        if read_counter == 0:
+            logger.info("Flomni statistics: no scan points read, no average of the standard deviations")
+            return
+        msg = (
+            "flOMNI scan statistics: average of the standard deviations during the exposures"
+            f" ({read_counter} points, sample vs FZP): x"
+            f" {self.average_stdeviations_x_st_fzp/read_counter*1000:.1f} nm, y"
+            f" {self.average_stdeviations_y_st_fzp/read_counter*1000:.1f} nm"
         )
+        logger.info(msg)
+        try:
+            self.controller.device_manager.connector.send_client_info(
+                msg, scope="flomni_scan_statistics", show_asap=True
+            )
+        except Exception as exc:  # pylint: disable=broad-except
+            # the statistics are information only: never fail the readout for them
+            logger.warning(f"Flomni statistics not sent to the client: {exc}")
 
     def _get_signals_from_table(self, return_table) -> dict:
         self.average_stdeviations_x_st_fzp += float(return_table[4])
diff --git a/tests/tests_devices/test_rt_flomni.py b/tests/tests_devices/test_rt_flomni.py
index 811d6571..9d860184 100644
--- a/tests/tests_devices/test_rt_flomni.py
+++ b/tests/tests_devices/test_rt_flomni.py
@@ -4,6 +4,7 @@ import pytest
 from ophyd_devices.tests.utils import SocketMock
 
 from csaxs_bec.devices.omny.rt import RtFlomniController, RtFlomniMotor
+from csaxs_bec.devices.omny.rt.rt_flomni_ophyd import RtFlomniFlyer
 from csaxs_bec.devices.omny.rt.rt_ophyd import RtError
 
 
@@ -98,3 +99,19 @@ def test_feedback_enable_without_reset_raises(rt_flomni):
                 rt_flomni.feedback_enable_without_reset()
                 laser_tracker_on.assert_called_once()
                 assert mock.call(b"l3\n") in rt_flomni.sock.put.mock_calls
+
+
+def test_flyer_reports_average_stdev_to_the_client(rt_flomni):
+    flyer = RtFlomniFlyer(name="rt_positions", socket_cls=SocketMock, device_manager=rt_flomni.device_manager)
+    flyer.controller = rt_flomni
+    for row in (["0", "0", "1", "1", "0.002", "2", "2", "0.001", "0", "0"],
+                ["1", "0", "1", "1", "0.004", "2", "2", "0.003", "0", "0"]):
+        flyer._get_signals_from_table(row)
+    flyer._report_statistics(2)
+    send = rt_flomni.device_manager.connector.send_client_info
+    msg = send.call_args.args[0]
+    assert "x 3.0 nm, y 2.0 nm" in msg and "2 points" in msg
+    assert send.call_args.kwargs["show_asap"] is True
+    send.reset_mock()
+    flyer._report_statistics(0)                    # no points: nothing sent, no ZeroDivisionError
+    send.assert_not_called()

From 9edeb661f917fe6343369f9ff01184f1940c2667 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 11:01:34 +0100
Subject: [PATCH 087/102] feat(lamni): rt_positions prints the average of the
 per-point standard deviations and the average angle to the BEC CLI at the end
 of each scan (as flOMNI); the log line printed the sums

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QnSJvqxh9oDbshx8qXgeiX
---
 csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py   | 25 +++++++++++++++++--
 .../tests_devices/test_rt_lamni_statistics.py | 23 +++++++++++++++++
 2 files changed, 46 insertions(+), 2 deletions(-)
 create mode 100644 tests/tests_devices/test_rt_lamni_statistics.py

diff --git a/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py
index 22ea1cf4..5ac3a718 100644
--- a/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py
@@ -855,9 +855,30 @@ class RtLamniFlyer(Device):
         status.set_finished()
         self.progress.put(value=read_counter, max_value=number_of_positions_planned, done=True)
 
-        logger.info(
-            f"LamNI statistics: Average of all standard deviations: x {self.average_stdeviations_x_st_fzp}, y {self.average_stdeviations_y_st_fzp}, angle {self.average_lamni_angle}."
+        self._report_statistics(read_counter)
+
+    def _report_statistics(self, read_counter: int):
+        """At the end of a scan: mean of the per-point standard deviations (sample vs FZP during each exposure,
+        RT_sampler) and the mean angle to the device-server log and to the BEC command line (Mirko 2026-10-26,
+        as flOMNI). Before, the log line printed the sums, not the averages."""
+        if read_counter == 0:
+            logger.info("LamNI statistics: no scan points read, no average of the standard deviations")
+            return
+        msg = (
+            "LamNI scan statistics: average of the standard deviations during the exposures"
+            f" ({read_counter} points, sample vs FZP): x"
+            f" {self.average_stdeviations_x_st_fzp/read_counter*1000:.1f} nm, y"
+            f" {self.average_stdeviations_y_st_fzp/read_counter*1000:.1f} nm;"
+            f" average angle {self.average_lamni_angle/read_counter:.4f}"
         )
+        logger.info(msg)
+        try:
+            self.controller.device_manager.connector.send_client_info(
+                msg, scope="lamni_scan_statistics", show_asap=True
+            )
+        except Exception as exc:  # pylint: disable=broad-except
+            # the statistics are information only: never fail the readout for them
+            logger.warning(f"LamNI statistics not sent to the client: {exc}")
 
     def _get_signals_from_table(self, return_table) -> dict:
         self.average_stdeviations_x_st_fzp += float(return_table[5])
diff --git a/tests/tests_devices/test_rt_lamni_statistics.py b/tests/tests_devices/test_rt_lamni_statistics.py
new file mode 100644
index 00000000..8c21f750
--- /dev/null
+++ b/tests/tests_devices/test_rt_lamni_statistics.py
@@ -0,0 +1,23 @@
+from unittest import mock
+
+from ophyd_devices.tests.utils import SocketMock
+
+from csaxs_bec.devices.omny.rt.rt_lamni_ophyd import RtLamniController, RtLamniFlyer
+
+
+def test_lamni_flyer_reports_average_stdev_to_the_client():
+    RtLamniController._reset_controller()
+    flyer = RtLamniFlyer(name="rt_positions", socket_cls=SocketMock, device_manager=mock.MagicMock())
+    flyer.controller = mock.MagicMock()
+    for i, (sx, sy) in enumerate(((0.002, 0.001), (0.004, 0.003))):
+        row = ["0"] * 21
+        row[0], row[5], row[8], row[19] = str(i), str(sx), str(sy), "0.5"
+        flyer._get_signals_from_table(row)
+    flyer._report_statistics(2)
+    send = flyer.controller.device_manager.connector.send_client_info
+    msg = send.call_args.args[0]
+    assert "x 3.0 nm, y 2.0 nm" in msg and "2 points" in msg and "average angle 0.5000" in msg
+    send.reset_mock()
+    flyer._report_statistics(0)                    # no points: nothing sent, no ZeroDivisionError
+    send.assert_not_called()
+    RtLamniController._reset_controller()

From 43e92f1e44f5ead3b9d5ea191cc9bdc6b5a3fe27 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 11:18:10 +0100
Subject: [PATCH 088/102] feat(flomni, lamni): end-of-scan statistics with the
 time split: scan time (kickoff -> end in the RT loop), exposure (points x
 requested exp_time x frames, passed with the kickoff), overhead per point

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QnSJvqxh9oDbshx8qXgeiX
---
 csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py  | 20 ++++++++++++++++++
 csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py   | 21 ++++++++++++++++++-
 csaxs_bec/devices/omny/rt/rt_ophyd.py         | 20 ++++++++++++++++++
 csaxs_bec/scans/flomni_fermat_scan.py         |  6 +++++-
 csaxs_bec/scans/lamni_fermat_scan.py          |  6 +++++-
 tests/tests_devices/test_rt_flomni.py         | 12 +++++++++++
 .../tests_devices/test_rt_lamni_statistics.py |  3 +++
 7 files changed, 85 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
index eca5bff9..b2616c80 100644
--- a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
@@ -13,6 +13,7 @@ from ophyd_devices.utils.socket import SocketIO, raise_if_disconnected
 from prettytable import PrettyTable
 
 from csaxs_bec.devices.omny.rt.rt_ophyd import (
+    format_scan_timing,
     RtCommunicationError,
     RtError,
     RtReadbackSignal,
@@ -816,6 +817,11 @@ class RtFlomniFlyer(Device):
         )
         self.average_stdeviations_x_st_fzp = 0
         self.average_stdeviations_y_st_fzp = 0
+        # end-of-scan statistics: kickoff parameters from the scan, start / end of the scan
+        self._exp_time = None
+        self._frames_per_trigger = 1
+        self._t_kickoff = None
+        self._t_scan_end = None
         self.readout_thread = None
         self.scan_done_event = threading.Event()
         self.scan_done_event.set()
@@ -856,6 +862,8 @@ class RtFlomniFlyer(Device):
                     signals = self._get_signals_from_table(return_table)
                     self.data.set(signals)
 
+        self._t_scan_end = time.monotonic()  # scan finished in the RT loop (statistics)
+
         if self.shutdown_event.wait(0.05):
             logger.info("Shutdown event set, stopping readout.")
             # if we are here, the shutdown_event is set. We can exit the readout loop.
@@ -890,6 +898,8 @@ class RtFlomniFlyer(Device):
             f" ({read_counter} points, sample vs FZP): x"
             f" {self.average_stdeviations_x_st_fzp/read_counter*1000:.1f} nm, y"
             f" {self.average_stdeviations_y_st_fzp/read_counter*1000:.1f} nm"
+            + format_scan_timing(read_counter, self._t_kickoff, self._t_scan_end, self._exp_time,
+                                 self._frames_per_trigger)
         )
         logger.info(msg)
         try:
@@ -932,12 +942,22 @@ class RtFlomniFlyer(Device):
         )
         self.readout_thread.start()
 
+    def configure(self, d: dict) -> tuple:
+        """The device server calls this with the kickoff parameters of the scan before kickoff():
+        exp_time / frames_per_trigger for the end-of-scan statistics (not passed: no exposure part)."""
+        d = dict(d or {})
+        self._exp_time = d.pop("exp_time", None)
+        self._frames_per_trigger = d.pop("frames_per_trigger", 1) or 1
+        return super().configure(d) if d else ({}, {})
+
     def kickoff(self) -> DeviceStatus:
         self.shutdown_event.clear()
         self.scan_done_event.clear()
         while not self.controller._min_scan_buffer_reached and not self.shutdown_event.wait(0.001):
             ...
         self.controller.start_scan()
+        self._t_kickoff = time.monotonic()
+        self._t_scan_end = None
         self.shutdown_event.wait(0.1)
         status = DeviceStatus(self)
         status.set_finished()
diff --git a/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py
index 5ac3a718..19aa1660 100644
--- a/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_lamni_ophyd.py
@@ -13,7 +13,7 @@ from ophyd_devices.utils.controller import Controller, retry_once, threadlocked
 from ophyd_devices.utils.socket import SocketIO, SocketSignal, raise_if_disconnected
 from prettytable import PrettyTable
 
-from csaxs_bec.devices.omny.rt.rt_ophyd import RtCommunicationError, RtError
+from csaxs_bec.devices.omny.rt.rt_ophyd import RtCommunicationError, RtError, format_scan_timing
 
 logger = bec_logger.logger
 
@@ -752,6 +752,11 @@ class RtLamniFlyer(Device):
         self.average_stdeviations_x_st_fzp = 0
         self.average_stdeviations_y_st_fzp = 0
         self.average_lamni_angle = 0
+        # end-of-scan statistics: kickoff parameters from the scan, start / end of the scan
+        self._exp_time = None
+        self._frames_per_trigger = 1
+        self._t_kickoff = None
+        self._t_scan_end = None
         self.readout_thread = None
         self.scan_done_event = threading.Event()
         self.scan_done_event.set()
@@ -767,12 +772,22 @@ class RtLamniFlyer(Device):
         )
         self.readout_thread.start()
 
+    def configure(self, d: dict) -> tuple:
+        """The device server calls this with the kickoff parameters of the scan before kickoff():
+        exp_time / frames_per_trigger for the end-of-scan statistics (not passed: no exposure part)."""
+        d = dict(d or {})
+        self._exp_time = d.pop("exp_time", None)
+        self._frames_per_trigger = d.pop("frames_per_trigger", 1) or 1
+        return super().configure(d) if d else ({}, {})
+
     def kickoff(self) -> DeviceStatus:
         self.shutdown_event.clear()
         self.scan_done_event.clear()
         while not self.controller._min_scan_buffer_reached and not self.shutdown_event.wait(0.001):
             ...
         self.controller.start_scan()
+        self._t_kickoff = time.monotonic()
+        self._t_scan_end = None
         self.shutdown_event.wait(0.1)
         status = DeviceStatus(self)
         status.set_finished()
@@ -834,6 +849,8 @@ class RtLamniFlyer(Device):
                     signals = self._get_signals_from_table(return_table)
                     self.data.set(signals)
 
+        self._t_scan_end = time.monotonic()  # scan finished in the RT loop (statistics)
+
         if self.shutdown_event.wait(0.05):
             logger.info("Shutdown event set, stopping readout.")
             # if we are here, the shutdown_event is set. We can exit the readout loop.
@@ -870,6 +887,8 @@ class RtLamniFlyer(Device):
             f" {self.average_stdeviations_x_st_fzp/read_counter*1000:.1f} nm, y"
             f" {self.average_stdeviations_y_st_fzp/read_counter*1000:.1f} nm;"
             f" average angle {self.average_lamni_angle/read_counter:.4f}"
+            + format_scan_timing(read_counter, self._t_kickoff, self._t_scan_end, self._exp_time,
+                                 self._frames_per_trigger)
         )
         logger.info(msg)
         try:
diff --git a/csaxs_bec/devices/omny/rt/rt_ophyd.py b/csaxs_bec/devices/omny/rt/rt_ophyd.py
index f456729c..839e7a50 100644
--- a/csaxs_bec/devices/omny/rt/rt_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_ophyd.py
@@ -14,6 +14,26 @@ from ophyd_devices.utils.socket import SocketSignal
 logger = bec_logger.logger
 
 
+def format_scan_timing(n_points: int, t_start, t_end, exp_time=None, frames_per_trigger=1) -> str:
+    """Time split of a flyer scan for the end-of-scan statistics (Mirko 2026-10-26, BEC side only): scan time from
+    the kickoff to the end of the scan in the RT loop (wall clock of the device server), exposure = points x
+    requested exp_time x frames_per_trigger (not measured: the detector may expose longer), overhead = the rest
+    (positioning, trigger, detector readout). '' when the times are missing."""
+    if not n_points or t_start is None or t_end is None or t_end <= t_start:
+        return ""
+    total = t_end - t_start
+    txt = f"; scan time {total:.1f} s ({total / n_points * 1000:.0f} ms/point)"
+    if exp_time:
+        expo = n_points * float(exp_time) * int(frames_per_trigger or 1)
+        over = total - expo
+        txt += (
+            f": exposure {expo:.1f} s ({expo / total * 100:.0f} %, requested {float(exp_time) * 1000:g} ms"
+            f" x {int(frames_per_trigger or 1)}), overhead {over:.1f} s ({over / n_points * 1000:.0f} ms/point:"
+            " positioning, trigger, detector)"
+        )
+    return txt
+
+
 class RtCommunicationError(ControllerCommunicationError):
     pass
 
diff --git a/csaxs_bec/scans/flomni_fermat_scan.py b/csaxs_bec/scans/flomni_fermat_scan.py
index f07cbca8..fc1b820c 100644
--- a/csaxs_bec/scans/flomni_fermat_scan.py
+++ b/csaxs_bec/scans/flomni_fermat_scan.py
@@ -238,7 +238,11 @@ class FlomniFermatScan(ScanBase):
         """
 
         # send off the flyer
-        self.actions.kickoff(device=self.dev.rt_positions)
+        self.actions.kickoff(
+            device=self.dev.rt_positions,
+            # for the end-of-scan statistics of the flyer (exposure vs overhead)
+            parameters={"exp_time": self.exp_time, "frames_per_trigger": self.frames_per_trigger},
+        )
 
         # start the readout loop of the flyer
         status = self.actions.complete(device=self.dev.rt_positions, wait=False)
diff --git a/csaxs_bec/scans/lamni_fermat_scan.py b/csaxs_bec/scans/lamni_fermat_scan.py
index 743d8f39..817347eb 100644
--- a/csaxs_bec/scans/lamni_fermat_scan.py
+++ b/csaxs_bec/scans/lamni_fermat_scan.py
@@ -218,7 +218,11 @@ class LamniFermatScan(ScanBase):
         This is where the main scan logic should be implemented.
         """
 
-        self.actions.kickoff(device="rt_positions")
+        self.actions.kickoff(
+            device="rt_positions",
+            # for the end-of-scan statistics of the flyer (exposure vs overhead)
+            parameters={"exp_time": self.exp_time, "frames_per_trigger": self.frames_per_trigger},
+        )
 
         status = self.actions.complete(device="rt_positions", wait=False)
 
diff --git a/tests/tests_devices/test_rt_flomni.py b/tests/tests_devices/test_rt_flomni.py
index 9d860184..b3ebe5e5 100644
--- a/tests/tests_devices/test_rt_flomni.py
+++ b/tests/tests_devices/test_rt_flomni.py
@@ -107,11 +107,23 @@ def test_flyer_reports_average_stdev_to_the_client(rt_flomni):
     for row in (["0", "0", "1", "1", "0.002", "2", "2", "0.001", "0", "0"],
                 ["1", "0", "1", "1", "0.004", "2", "2", "0.003", "0", "0"]):
         flyer._get_signals_from_table(row)
+    flyer.configure({"exp_time": 0.1, "frames_per_trigger": 2})        # kickoff parameters of the scan
+    flyer._t_kickoff, flyer._t_scan_end = 100.0, 101.0
     flyer._report_statistics(2)
     send = rt_flomni.device_manager.connector.send_client_info
     msg = send.call_args.args[0]
     assert "x 3.0 nm, y 2.0 nm" in msg and "2 points" in msg
+    assert "scan time 1.0 s (500 ms/point)" in msg and "exposure 0.4 s (40 %" in msg and "overhead 0.6 s (300 ms/point" in msg
     assert send.call_args.kwargs["show_asap"] is True
     send.reset_mock()
     flyer._report_statistics(0)                    # no points: nothing sent, no ZeroDivisionError
     send.assert_not_called()
+
+
+def test_format_scan_timing():
+    from csaxs_bec.devices.omny.rt.rt_ophyd import format_scan_timing
+
+    assert format_scan_timing(0, 0, 1) == "" and format_scan_timing(5, None, 1) == ""
+    assert format_scan_timing(10, 0, 2.0) == "; scan time 2.0 s (200 ms/point)"     # no exp_time: no split
+    txt = format_scan_timing(10, 0, 2.0, 0.1, 1)
+    assert "exposure 1.0 s (50 %" in txt and "overhead 1.0 s (100 ms/point" in txt
diff --git a/tests/tests_devices/test_rt_lamni_statistics.py b/tests/tests_devices/test_rt_lamni_statistics.py
index 8c21f750..3db16603 100644
--- a/tests/tests_devices/test_rt_lamni_statistics.py
+++ b/tests/tests_devices/test_rt_lamni_statistics.py
@@ -13,10 +13,13 @@ def test_lamni_flyer_reports_average_stdev_to_the_client():
         row = ["0"] * 21
         row[0], row[5], row[8], row[19] = str(i), str(sx), str(sy), "0.5"
         flyer._get_signals_from_table(row)
+    flyer.configure({"exp_time": 0.05})                                  # frames_per_trigger default 1
+    flyer._t_kickoff, flyer._t_scan_end = 10.0, 10.5
     flyer._report_statistics(2)
     send = flyer.controller.device_manager.connector.send_client_info
     msg = send.call_args.args[0]
     assert "x 3.0 nm, y 2.0 nm" in msg and "2 points" in msg and "average angle 0.5000" in msg
+    assert "scan time 0.5 s (250 ms/point)" in msg and "exposure 0.1 s (20 %" in msg
     send.reset_mock()
     flyer._report_statistics(0)                    # no points: nothing sent, no ZeroDivisionError
     send.assert_not_called()

From 76723df5e30b3fba5c0af1cc4f861375304caa50 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 11:59:03 +0100
Subject: [PATCH 089/102] docs(flomni): scan-mode profiles (high_res,
 high_res_1v5, normal, low_res) instead of fast_scan

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QnSJvqxh9oDbshx8qXgeiX
---
 ...ct_only-howto_calibrate_the_fzp_scanner.md |   2 +-
 ...t_only-howto_calibrate_the_fzp_scanner.pdf | Bin 88918 -> 89158 bytes
 .../local_contact_only-realtime_system.md     |   2 +-
 .../local_contact_only-realtime_system.pdf    | Bin 57342 -> 57759 bytes
 4 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
index e0214cbd..aafb81e9 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
@@ -145,7 +145,7 @@ not have to be set by hand:
 | 1, FZP disabled (alignment, affine matrix) | `fzp_off` | `flomni.realtime_system.apply_profile("fzp_off")` |
 | 2, FZP-only calibration scan (clear `MatrixCorr` first: not part of the settings) | `fzp_calibration` | `apply_profile("fzp_calibration")` |
 | 3, back to operation | `production` | `apply_profile("production")` |
-| afterwards, faster scans (calibrated over ±7 V) | `fast_scan` | `apply_profile("fast_scan")` |
+| afterwards, fast scans with the FZP at ±9 V (scan modes, flOMNI `FeedbackLoop/scan_modes.md`) | `high_res`, `normal`, `low_res` | `apply_profile("high_res")` |
 
 Single values: `flomni.realtime_system.set(fzp_range_V_x=7, fzp_range_V_y=7)`,
 `set(move_beyond_um_x=0.3)`, `set(exposure_during_motion=1)`; refused with the reason if a rule objects
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf
index b23a54db08bcd0a9636031d5bb23ea2c0b8428a5..29bdcb4c6e1fb62e8c8c29df8b314df9723f94ef 100644
GIT binary patch
delta 31432
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
F{|hAlFKGY(

delta 31160
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

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
index 0fbce70c..bb5551ec 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
@@ -34,7 +34,7 @@ live and saved value, the loop parameters it sets, its rules).
   feedforward must be off while the FZP loop is off); `set(..., adjust=True)` changes the dependent settings the
   rule names (never the ones given)
 - `flomni.realtime_system.check(name=value)` — dry run
-- `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "fast_scan")`
+- `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "high_res" | "high_res_1v5" | "normal" | "low_res")` (scan modes 2026-10-26: flOMNI `FeedbackLoop/scan_modes.md`)
 - `flomni.realtime_system.unsaved()` — what differs from the loop's parameter files
 - `flomni.realtime_system.save_as_default()` — writes the live values into the loop's parameter files: the next
   loop start uses them. Only for a change that should stay (a backup of each file is kept on the loop machine).
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf
index 2d1f3c692428df5d75c4503f442b2f83249c1c16..d170eb4499d65db812ce848093938626fe4a5ec5 100644
GIT binary patch
delta 19001
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
azR(CHfI$<>C$t4n5C{|`E311&5A=U5lZ(#)

delta 18603
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
EUsmjS)c^nh


From 2c168e6154f6bd5da7bef13eb6a2a5bcb1962b77 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 12:12:02 +0100
Subject: [PATCH 090/102] feat(flomni): flomni_loop_settings stores
 target_shaper_scale and jump_max_um_x/_y as own signals (scan-mode profiles)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QnSJvqxh9oDbshx8qXgeiX
---
 csaxs_bec/devices/omny/flomni_loop_settings.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/csaxs_bec/devices/omny/flomni_loop_settings.py b/csaxs_bec/devices/omny/flomni_loop_settings.py
index 0a59324c..552d6667 100644
--- a/csaxs_bec/devices/omny/flomni_loop_settings.py
+++ b/csaxs_bec/devices/omny/flomni_loop_settings.py
@@ -42,6 +42,7 @@ SETTINGS = (
     "tracking_target_y", "tracking_target_z", "psd_threshold_low", "interferometer_threshold",
     "interferometer_threshold_rot",
     "sample_hold_fzp_V", "sample_hold_err_um", "sample_hold_zero",
+    "target_shaper_scale", "jump_max_um_x", "jump_max_um_y",      # group motion, scan-mode profiles (2026-10-26)
 )
 
 RETRY_AFTER_FAILURE_S = 60.0    # web HMI not reachable: no new attempt for this long (a tomogram does not wait each time)

From 7c8b2a50add75d98e10d7b25da1fcaf0e4fd80d5 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 13:46:00 +0100
Subject: [PATCH 091/102] tests(omny): update three OMNY tests to the code
 merged from main

- tomo_queue_execute() resumes with tomo_scan_resume(from_queue=True)
- tomo_id is a _GlobalVarParam: give the bare OMNY object a fake client
- _irrelevant_params_for_type(): pass the omny profile; without it the
  setup-neutral fallback treats type 4 as an angle file (flomni/lamni)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../test_omny_tomo_params_widget_math.py             | 12 +++++++++---
 .../tests_bec_ipython_client/test_omny_tomo_queue.py |  2 +-
 .../tests_bec_ipython_client/test_omny_tomo_scan.py  |  1 +
 3 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
index e6cd8a25..ef696f7b 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
@@ -196,11 +196,17 @@ def test_irrelevant_params_for_type_keeps_zero_deg_reference_for_omny_types_4_an
     """_irrelevant_params_for_type() used to hardcode `tomo_type != 1`, which
     would hide zero_deg_reference_at_each_subtomo from an OMNY type-4/5 job's
     tooltip even though it's a real, applicable setting for those types too
-    (only flomni/lamni are limited to type 1) -- fixed to `not in (1, 4, 5)`."""
+    (only flomni/lamni are limited to type 1) -- the sub-tomogram types now
+    come from the omny profile's "tomo_types"."""
+    profile = SETUP_PROFILES["omny"]
     for tomo_type in (1, 4, 5):
-        assert "zero_deg_reference_at_each_subtomo" not in _irrelevant_params_for_type(tomo_type)
+        assert "zero_deg_reference_at_each_subtomo" not in _irrelevant_params_for_type(
+            tomo_type, profile
+        )
     for tomo_type in (2, 3):
-        assert "zero_deg_reference_at_each_subtomo" in _irrelevant_params_for_type(tomo_type)
+        assert "zero_deg_reference_at_each_subtomo" in _irrelevant_params_for_type(
+            tomo_type, profile
+        )
 
 
 # --- _validate()'s tomo_type check: regression guard for the critical fix --
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
index 11284244..94dce0dd 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_queue.py
@@ -139,7 +139,7 @@ def test_tomo_queue_execute_resumes_incomplete_job():
 
     omny.tomo_queue_execute()
 
-    assert calls == [("resume", (), {})]
+    assert calls == [("resume", (), {"from_queue": True})]
     job = omny._tomo_queue_proxy.as_list()[0]
     assert job["status"] == "done"
 
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
index 15213c57..380c0e9a 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_scan.py
@@ -525,6 +525,7 @@ def test_write_to_scilog_tolerates_send_exception(monkeypatch):
 def test_write_tomo_scan_number_creates_missing_directory(monkeypatch, tmp_path):
     monkeypatch.setenv("HOME", str(tmp_path))
     omny = object.__new__(OMNY)
+    omny.client = FakeGlobalVarClient()
     omny.tomo_id = 1
     fake_dev = types.SimpleNamespace(
         osamroy=types.SimpleNamespace(read=lambda: {"osamroy": {"value": 12.5}}),

From 37c3bff89f4b081eaf3f408a42f6e688ac214523 Mon Sep 17 00:00:00 2001
From: wakonig_k <klaus.wakonig@psi.ch>
Date: Mon, 26 Oct 2026 13:52:02 +0100
Subject: [PATCH 092/102] build: pin dectris compression for now

---
 pyproject.toml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/pyproject.toml b/pyproject.toml
index 4110f2b6..72cc9652 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -25,7 +25,7 @@ dependencies = [
     "bec_widgets",
     "zmq",
     "opencv-python",
-    "dectris-compression",       # for JFJ preview stream decompression
+    "dectris-compression~=0.3.1",       # for JFJ preview stream decompression
     "cbor2~=5.9.0",
 ]
 

From 96c02b3367adc4efebed678583b931a69711a72f Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 14:01:12 +0100
Subject: [PATCH 093/102] fix(tomo_params): pin seed=0 in the OMNY fermat
 position estimate, as flomni/lamni

get_omny_fermat_spiral_pos() draws a random sub-step offset per call, so the
estimate (and its test against a second call) was not reproducible.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../bec_widgets/widgets/tomo_params/tomo_params.py  | 13 ++++++++++++-
 .../test_omny_tomo_params_widget_math.py            |  4 +++-
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
index 05796e04..f6f377c3 100644
--- a/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
+++ b/csaxs_bec/bec_widgets/widgets/tomo_params/tomo_params.py
@@ -2767,6 +2767,11 @@ def _compute_fermat_positions_omny(params: dict[str, Any]) -> tuple[int, int]:
     estimate can never drift out of sync. cenx/ceny/zshift left at their
     defaults -- they only shift the final position, never affect the count.
 
+    The real scan also draws a fresh random sub-step offset on every call
+    (see get_omny_fermat_spiral_pos()'s `seed` argument), which can shift
+    the actual scan-time count by a point or two near the threshold. A
+    fixed seed is used here only so this estimate is itself reproducible.
+
     Returns:
         (estimated_count, minimum_required)
     """
@@ -2778,7 +2783,13 @@ def _compute_fermat_positions_omny(params: dict[str, Any]) -> tuple[int, int]:
     if step <= 0:
         return 0, OmnyFermatScan.MIN_POSITIONS
     positions = OmnyFermatScan.get_omny_fermat_spiral_pos(
-        -abs(fovx / 2), abs(fovx / 2), -abs(fovy / 2), abs(fovy / 2), step=step, spiral_type=0
+        -abs(fovx / 2),
+        abs(fovx / 2),
+        -abs(fovy / 2),
+        abs(fovy / 2),
+        step=step,
+        spiral_type=0,
+        seed=0,
     )
     return len(positions), OmnyFermatScan.MIN_POSITIONS
 
diff --git a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
index ef696f7b..1f084cee 100644
--- a/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
+++ b/tests/tests_bec_ipython_client/test_omny_tomo_params_widget_math.py
@@ -138,8 +138,10 @@ def test_compute_fermat_positions_omny_matches_scan_class_below_threshold():
     count, min_positions = _compute_fermat_positions_omny(params)
     assert min_positions == OmnyFermatScan.MIN_POSITIONS
     assert count < min_positions
+    # _compute_fermat_positions_omny() pins seed=0 for its own reproducibility --
+    # match it here rather than drawing an independent random offset.
     expected = OmnyFermatScan.get_omny_fermat_spiral_pos(
-        -1.0, 1.0, -1.0, 1.0, step=2.0, spiral_type=0
+        -1.0, 1.0, -1.0, 1.0, step=2.0, spiral_type=0, seed=0
     )
     assert count == len(expected)
 

From c1cc2cbc8e5dbe308cc7099eebfc10c435d75692 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Mon, 26 Oct 2026 14:51:51 +0100
Subject: [PATCH 094/102] refactor(flomni): harmonize real-time commands under
 the rt_ prefix

flomni.rt_<TAB> now lists the whole real-time system:
- feedback_* -> rt_feedback_*
- laser_tracker_on/off/show_all -> rt_laser_tracker_*,
  laser_parameters_tweak_tracking -> rt_laser_tracker_tweak
- show_signal_strength_interferometer -> rt_signal_strength (old name kept as alias)
- realtime_system -> rt_settings; laser_parameters_* setters moved there as
  rt_settings.tracking_show / tracking_set_target_y/z /
  tracking_set_interferometer_threshold / tracking_set_psd_threshold_low
- rt_on / rt_off unchanged

Docs, callers (x_ray_eye_align, e2e bootstrap) and tests updated. TODO note
for porting the scheme to LamNI and OMNY in OMNY_shared/AI_docs.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../TODO_rt_namespace_harmonization.md        | 37 ++++++++++
 ...ct_only-howto_calibrate_the_fzp_scanner.md |  8 +--
 ..._only-howto_limit_the_fzp_scanner_range.md |  2 +-
 .../local_contact_only-realtime_system.md     | 36 +++++-----
 .../plugins/flomni/flomni.py                  | 69 ++++++++-----------
 .../plugins/flomni/flomni_realtime_system.py  | 41 ++++++++---
 .../plugins/flomni/x_ray_eye_align.py         | 20 +++---
 csaxs_bec/device_configs/ptycho_flomni.yaml   |  2 +-
 .../devices/omny/flomni_loop_settings.py      |  6 +-
 csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py  |  2 +-
 csaxs_bec/devices/omny/webhmi_client.py       |  2 +-
 docs/user/ptychography/flomni.md              | 20 +++---
 omny_e2e_tests/_bootstrap.py                  |  2 +-
 .../test_flomni_realtime_system.py            |  2 +-
 .../test_flomni_review_fixes.py               |  2 +-
 .../test_flomni_loop_settings.py              |  2 +-
 16 files changed, 153 insertions(+), 100 deletions(-)
 create mode 100644 csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md
new file mode 100644
index 00000000..07968972
--- /dev/null
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md
@@ -0,0 +1,37 @@
+# TODO: port the flOMNI `rt_*` naming to LamNI and OMNY
+
+**Status: done on flOMNI (2026-10-26)**, not yet on LamNI and OMNY. Goal: `<endstation>.rt_<TAB>` lists the whole
+real-time system, and the names match across all three endstations.
+
+## flOMNI scheme (reference)
+
+| Function | flOMNI name | former name |
+| --- | --- | --- |
+| BEC device enable rtx/rty/rtz | `rt_on()` / `rt_off()` | unchanged |
+| feedback | `rt_feedback_enable_with_reset()`, `rt_feedback_enable_without_reset()`, `rt_feedback_disable()`, `rt_feedback_status()` | `feedback_*` |
+| laser tracker | `rt_laser_tracker_on()`, `rt_laser_tracker_off()`, `rt_laser_tracker_show_all()`, `rt_laser_tracker_tweak()` | `laser_tracker_*`, `laser_parameters_tweak_tracking` |
+| signal strength | `rt_signal_strength()`, alias `show_signal_strength_interferometer()` | `show_signal_strength_interferometer` |
+| loop settings (staff) | `rt_settings` incl. `tracking_show/set_target_y/set_target_z/set_interferometer_threshold/set_psd_threshold_low` | `realtime_system`, `laser_parameters_*` |
+
+## LamNI (`plugins/LamNI/lamni.py`)
+
+- `rt_on` / `rt_off` already exist (line ~774).
+- `feedback_enable_with_reset`, `feedback_enable_without_reset`, `feedback_disable`, `feedback_status`
+  -> `rt_feedback_*`; also `feedback_disable_and_reset_angle` -> `rt_feedback_disable_and_reset_angle`.
+- `show_signal_strength` -> `rt_signal_strength` (keep the old name as an alias).
+- LamNI has no laser tracker and no `rt_settings` (no web HMI loop settings).
+- Callers: `plugins/LamNI/x_ray_eye_align.py` and `plugins/omny/x_ray_eye_align.py` (the LamNI one calls
+  `rtx.controller` directly), LamNI tomo/optics mixins, `docs/user/ptychography/lamni.md`, tests with
+  `feedback_*` mocks (`test_lamni_optics_skip_if_in_position.py`).
+
+## OMNY (`plugins/omny/omny.py`, `plugins/omny/omny_rt.py`)
+
+- `rt_on` / `rt_off` already exist (`omny.py` ~2166).
+- `omny_rt.py`: `feedback_*` -> `rt_feedback_*`, `laser_tracker_on/off/show_all` -> `rt_laser_tracker_*`,
+  `laser_tracker_check_and_wait_for_signalstrength` -> `rt_laser_tracker_check_and_wait_for_signalstrength`,
+  `show_signal_strength_interferometer` -> `rt_signal_strength` + alias.
+- Callers: OMNY tomo/alignment code, `docs/user/ptychography/omny.md`, `test_omny_tomo_scan.py`
+  (`omny.laser_tracker_on` mock), `test_omny_optics_skip_if_in_position.py`.
+
+Do not rename the controller methods (`dev.rtx.controller.feedback_*`, `laser_tracker_*`): only the
+client-level user commands change.
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
index aafb81e9..76dd0a35 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
@@ -103,7 +103,7 @@ correction (−4 before 2026-10-19, now 0: replaced by the feedforward).
   about ±2 V only). For the field of view above (2.8 × 1.8 µm) widen them, e.g. to ±10 V (FZP ≈ 0.13 µm/V in x,
   ≈ 0.05 µm/V in y). The feedforward stays off (`enable` 0,0) during this scan.
 - The detector trigger (`OnTargetTrigger`) checks the relative error sample vs FZP (parameters
-  `ontarget_tolerance_um` / `ontarget_hold_ms`, BEC `flomni.realtime_system.trigger_*`, default 10 nm / 3 ms; until
+  `ontarget_tolerance_um` / `ontarget_hold_ms`, BEC `flomni.rt_settings.trigger_*`, default 10 nm / 3 ms; until
   2026-10-23 ConstEmitter lines) and waits `MinDelay_ms` (15 ms).
 
 **Step 3, default operating values (replace the values in the text above):**
@@ -136,18 +136,18 @@ exposure grows with the step (1 µm: ≈ 6 nm max instead of 2.5 nm), so the set
 
 ## With the loop settings (since 2026-10-23)
 
-The steps above are profiles of the loop settings (web HMI tab *Loop settings*, BEC `flomni.realtime_system`;
+The steps above are profiles of the loop settings (web HMI tab *Loop settings*, BEC `flomni.rt_settings`;
 flOMNI `FeedbackLoop/loopsettings/`). The rules keep the modules consistent, so the individual parameters above do
 not have to be set by hand:
 
 | Step | Profile | BEC |
 |---|---|---|
-| 1, FZP disabled (alignment, affine matrix) | `fzp_off` | `flomni.realtime_system.apply_profile("fzp_off")` |
+| 1, FZP disabled (alignment, affine matrix) | `fzp_off` | `flomni.rt_settings.apply_profile("fzp_off")` |
 | 2, FZP-only calibration scan (clear `MatrixCorr` first: not part of the settings) | `fzp_calibration` | `apply_profile("fzp_calibration")` |
 | 3, back to operation | `production` | `apply_profile("production")` |
 | afterwards, fast scans with the FZP at ±9 V (scan modes, flOMNI `FeedbackLoop/scan_modes.md`) | `high_res`, `normal`, `low_res` | `apply_profile("high_res")` |
 
-Single values: `flomni.realtime_system.set(fzp_range_V_x=7, fzp_range_V_y=7)`,
+Single values: `flomni.rt_settings.set(fzp_range_V_x=7, fzp_range_V_y=7)`,
 `set(move_beyond_um_x=0.3)`, `set(exposure_during_motion=1)`; refused with the reason if a rule objects
 (`adjust=True` changes the dependent settings too). FZP settings only between scans. Live only until
 `save_as_default()`.
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
index 488462ee..2ff5e696 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
@@ -40,7 +40,7 @@ Changing the FZP range now involves, in addition to the text above:
 - After a change: web HMI tab **Loop check** level 1 (expected settings) and, with the beamline ready, the scan test
   (level 4: positioning time, stability during the exposure per step size).
 
-**With the loop settings (since 2026-10-23):** `flomni.realtime_system.set(fzp_range_V_x=..., fzp_range_V_y=...)`
+**With the loop settings (since 2026-10-23):** `flomni.rt_settings.set(fzp_range_V_x=..., fzp_range_V_y=...)`
 (web HMI tab *Loop settings*) sets `PID_*_fzp` `Ub` / `Lb` and the `Feedforward` limits together; a move-beyond that
 no longer fits is refused, or clamped with `adjust=True` (rule `move_beyond_*_fits`). `FreqGen` limits stay
 manual (measurements only).
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
index bb5551ec..cb36401d 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
@@ -1,6 +1,6 @@
 # flOMNI real-time loop settings (beamline scientists / local contact only)
 
-**Not for users.** `flomni.realtime_system` changes how the FZP scanner, the detector trigger and the laser tracker
+**Not for users.** `flomni.rt_settings` changes how the FZP scanner, the detector trigger and the laser tracker
 work, and `save_as_default()` makes a change the default of every following loop start. A wrong combination can spoil
 the data of a beamtime. The user guide only says that these settings exist, are set by the local contact and are
 stored with every scan; the details are here.
@@ -23,22 +23,22 @@ Background and reference (flOMNI control repository, `OMNY/flOMNI` on gitea):
 | Laser tracker and thresholds | `tracking_target_y` / `_z`, `psd_threshold_low`, `interferometer_threshold`, `interferometer_threshold_rot` |
 | FZP calibration (expert, only between scans) | `sample_hold_fzp_V`, `sample_hold_err_um`, `sample_hold_zero` |
 
-`flomni.realtime_system.help("all")` explains every setting, `help("<setting>")` one setting (what it does, range,
+`flomni.rt_settings.help("all")` explains every setting, `help("<setting>")` one setting (what it does, range,
 live and saved value, the loop parameters it sets, its rules).
 
 ## Commands
 
-- `flomni.realtime_system.show()` — all settings with live and saved value, violated rules, scan state
+- `flomni.rt_settings.show()` — all settings with live and saved value, violated rules, scan state
   (`show(expert=True)` also the FZP calibration group)
-- `flomni.realtime_system.set(name=value, ...)` — change; refused with the reason if a rule objects (e.g. the
+- `flomni.rt_settings.set(name=value, ...)` — change; refused with the reason if a rule objects (e.g. the
   feedforward must be off while the FZP loop is off); `set(..., adjust=True)` changes the dependent settings the
   rule names (never the ones given)
-- `flomni.realtime_system.check(name=value)` — dry run
-- `flomni.realtime_system.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "high_res" | "high_res_1v5" | "normal" | "low_res")` (scan modes 2026-10-26: flOMNI `FeedbackLoop/scan_modes.md`)
-- `flomni.realtime_system.unsaved()` — what differs from the loop's parameter files
-- `flomni.realtime_system.save_as_default()` — writes the live values into the loop's parameter files: the next
+- `flomni.rt_settings.check(name=value)` — dry run
+- `flomni.rt_settings.profiles()`, `apply_profile("production" | "fzp_off" | "fzp_calibration" | "high_res" | "high_res_1v5" | "normal" | "low_res")` (scan modes 2026-10-26: flOMNI `FeedbackLoop/scan_modes.md`)
+- `flomni.rt_settings.unsaved()` — what differs from the loop's parameter files
+- `flomni.rt_settings.save_as_default()` — writes the live values into the loop's parameter files: the next
   loop start uses them. Only for a change that should stay (a backup of each file is kept on the loop machine).
-- `flomni.realtime_system.help()`, `help("all")`, `help("<setting>")`
+- `flomni.rt_settings.help()`, `help("all")`, `help("<setting>")`
 
 Changes are live only until the next start of the control loop, unless saved. FZP settings can only be changed
 between scans (refused while a scan runs); trigger and tracker settings any time.
@@ -48,11 +48,11 @@ between scans (refused while a scan runs); trigger and tracker settings any time
 In step scans the detector is triggered when the relative position sample vs FZP (interferometer minus FZP cap
 sensor) stays within the tolerance in x and in y (each averaged over 0.5 ms) for the hold time.
 
-- `flomni.realtime_system.trigger_show()` — tolerance, hold time, minimum delay, trigger after a move
-- `flomni.realtime_system.trigger_set_tolerance_nm(10)` — about 30 for a fast low-resolution scan, 10 standard,
+- `flomni.rt_settings.trigger_show()` — tolerance, hold time, minimum delay, trigger after a move
+- `flomni.rt_settings.trigger_set_tolerance_nm(10)` — about 30 for a fast low-resolution scan, 10 standard,
   2 for the highest resolution (a few ms more per point); 0 = the former criterion (on-target flags of the FZP loops)
-- `flomni.realtime_system.trigger_set_hold_ms(3)` — hold time in ms
-- `flomni.realtime_system.trigger_set_after_move(True)` — also one trigger after every position change of the
+- `flomni.rt_settings.trigger_set_hold_ms(3)` — hold time in ms
+- `flomni.rt_settings.trigger_set_after_move(True)` — also one trigger after every position change of the
   sample stage (e.g. `umv(dev.rtx, ...)`, `dev.rtx.controller.move_xyz(x, y, z)`) once on target; `False` (default):
   scan points only
 
@@ -60,10 +60,10 @@ The former `flomni.interferometer_trigger_*` were removed 2026-10-23.
 
 ### Laser tracker
 
-`flomni.laser_parameters_show_all()`, `laser_parameters_set_targety(v)` / `_targetz(v)`,
-`laser_parameters_set_intensity_threshold_laser(v)`, `laser_parameters_set_psd_intensity_threshold_tracking_low(v)`
-and the arrow-key tweak `laser_parameters_tweak_tracking()` use the same settings (`tracking_target_y` / `_z`,
-`interferometer_threshold`, `psd_threshold_low`).
+`flomni.rt_settings.tracking_show()`, `tracking_set_target_y(v)` / `tracking_set_target_z(v)`,
+`tracking_set_interferometer_threshold(v)`, `tracking_set_psd_threshold_low(v)` and the arrow-key tweak
+`flomni.rt_laser_tracker_tweak()` use the same settings (`tracking_target_y` / `_z`, `interferometer_threshold`,
+`psd_threshold_low`). The former `flomni.laser_parameters_*` were moved here 2026-10-26.
 
 ## Stored with every scan
 
@@ -74,7 +74,7 @@ as default or inconsistent, violated error rules, the definition with its sha1,
 
 ## Connection
 
-`flomni.realtime_system` sends its requests through the device `flomni_loop_settings` (device server). The device
+`flomni.rt_settings` sends its requests through the device `flomni_loop_settings` (device server). The device
 talks to the web HMI on the loop machine (`http://mpc2844:8080`, REST `/api/settings`; port 80 as fallback) with the
 API token in its device config (`ptycho_flomni.yaml`, `token:`; the line of `~/loop-data/webhmi/api_token` on
 mpc2844). Without that device (e.g. a simulated config) the client talks to the web HMI directly with
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index de017755..689309da 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -495,38 +495,24 @@ class FlomniSampleTransferMixin:
             self.move_fheater_down()
         self.xrayeye_update_frame()
 
-    def laser_tracker_show_all(self):
+    def rt_laser_tracker_show_all(self):
         dev.rtx.controller.laser_tracker_show_all()
 
-    def laser_tracker_on(self):
+    def rt_laser_tracker_on(self):
         dev.rtx.controller.laser_tracker_on()
         time.sleep(0.2)
         dev.rtx.controller.laser_tracker_check_signalstrength()
 
-    def laser_tracker_off(self):
+    def rt_laser_tracker_off(self):
         dev.rtx.controller.laser_tracker_off()
 
-    # laser tracker targets and thresholds: settings of the real-time loop (flomni.realtime_system, group
-    # "tracking"; until 2026-10-23 ConstEmitter lines set through the CommunicationServer e-commands)
-    def laser_parameters_show_all(self):
-        self.realtime_system.show(group="tracking")
+    # laser tracker targets and thresholds: settings of the real-time loop, flomni.rt_settings.tracking_*
+    # (the former flomni.laser_parameters_* moved there 2026-10-26)
 
-    def laser_parameters_set_targety(self, val: float):
-        self.realtime_system.set(tracking_target_y=val)
-
-    def laser_parameters_set_targetz(self, val: float):
-        self.realtime_system.set(tracking_target_z=val)
-
-    def laser_parameters_set_intensity_threshold_laser(self, val: float):
-        self.realtime_system.set(interferometer_threshold=val)
-
-    def laser_parameters_set_psd_intensity_threshold_tracking_low(self, val: float):
-        self.realtime_system.set(psd_threshold_low=val)
-
-    def laser_parameters_tweak_tracking(self):
+    def rt_laser_tracker_tweak(self):
         """Interactive tweak of the two laser tracking target positions.
 
-        Arrow keys nudge the tracking targets (realtime_system tracking_target_y / _z) by a fixed step of
+        Arrow keys nudge the tracking targets (rt_settings tracking_target_y / _z) by a fixed step of
         0.02 (absolute set of current +/- step):
             left / right : target y  -/+
             up   / down  : target z  +/-
@@ -547,11 +533,11 @@ class FlomniSampleTransferMixin:
         import tty
 
         controller = dev.rtx.controller
-        rts = self.realtime_system
+        rts = self.rt_settings
 
         if not controller.laser_tracker_check_enabled():
             print(
-                "The laser tracker is disabled. Enable it with laser_tracker_on() "
+                "The laser tracker is disabled. Enable it with rt_laser_tracker_on() "
                 "before tweaking the tracking targets - otherwise nothing moves on "
                 "the hardware side."
             )
@@ -563,7 +549,7 @@ class FlomniSampleTransferMixin:
             return rts.tracking_targets()
 
         def signal_fzpx():
-            # second channel (index 1) of show_signal_strength_interferometer,
+            # second channel (index 1) of rt_signal_strength,
             # i.e. the fzp x channel / tracker signal
             return controller.read_ssi_interferometer(1)
 
@@ -630,14 +616,14 @@ class FlomniSampleTransferMixin:
     def umvr_fsamy_tracked(self, shift: float, step: float = 0.01, _internal: bool = False):
         """
         Relative move of fsamy by `shift` mm, broken into steps of at most
-        `step` mm (default 0.01 mm = 10 um), calling laser_tracker_on()
+        `step` mm (default 0.01 mm = 10 um), calling rt_laser_tracker_on()
         after every step so the tracker stays locked during the move
         (fsamy travels a lot during sample change and the tracker can't
         keep up in one big jump). fsamy itself moves in mm, so shift/step
         are taken directly in mm -- no unit conversion needed.
 
         Uses dev.rtx.controller.laser_tracker_on() directly rather than
-        self.laser_tracker_on() (which adds a 0.2s sleep plus a
+        self.rt_laser_tracker_on() (which adds a 0.2s sleep plus a
         signal-strength check) since this runs once per small step and that
         overhead would add up across what can be 100+ steps for a typical
         sample-change-sized move; the goal here is just to keep the tracker
@@ -663,7 +649,7 @@ class FlomniSampleTransferMixin:
             )
             if not self.OMNYTools.yesno("Disable feedback and continue?", "y"):
                 return
-            self.feedback_disable()
+            self.rt_feedback_disable()
 
         direction = 1 if shift >= 0 else -1
         remaining = abs(shift)
@@ -691,28 +677,31 @@ class FlomniSampleTransferMixin:
         shift_mm = target - current
         self.umvr_fsamy_tracked(shift_mm, step, _internal=_internal)
 
-    def show_signal_strength_interferometer(self):
+    def rt_signal_strength(self):
         dev.rtx.controller.show_signal_strength_interferometer()
 
-    def feedback_disable(self):
+    # the familiar name, kept as an alias
+    show_signal_strength_interferometer = rt_signal_strength
+
+    def rt_feedback_disable(self):
         self.device_manager.devices.rtx.controller.feedback_disable()
 
-    def feedback_enable_with_reset(self):
+    def rt_feedback_enable_with_reset(self):
         self.device_manager.devices.rtx.controller.feedback_enable_with_reset()
-        self.feedback_status()
+        self.rt_feedback_status()
 
-    def feedback_enable_without_reset(self):
+    def rt_feedback_enable_without_reset(self):
         self.device_manager.devices.rtx.controller.feedback_enable_without_reset()
-        self.feedback_status()
+        self.rt_feedback_status()
 
-    def feedback_status(self):
+    def rt_feedback_status(self):
         feedback_status = self.device_manager.devices.rtx.controller.feedback_is_running()
         if feedback_status == True:
             print("The rt feedback is \x1b[92mrunning\x1b[0m.")
         else:
             print("The rt feedback is \x1b[91mNOT\x1b[0m running.")
 
-    # detector trigger: flomni.realtime_system.trigger_* (the former flomni.interferometer_trigger_* removed
+    # detector trigger: flomni.rt_settings.trigger_* (the former flomni.interferometer_trigger_* removed
     # 2026-10-23, Mirko: "interferometer" was confusing next to flomni.laser_*)
 
     def lights_off(self):
@@ -735,7 +724,7 @@ class FlomniSampleTransferMixin:
         self.feye_in()
         self.foptics_out()
 
-        self.feedback_disable()
+        self.rt_feedback_disable()
 
         self.ensure_fheater_up()
 
@@ -751,7 +740,7 @@ class FlomniSampleTransferMixin:
 
         self.umv_fsamy_tracked(fsamy_in, _internal=True)
         time.sleep(0.05)
-        self.laser_tracker_off()
+        self.rt_laser_tracker_off()
         time.sleep(0.05)
 
 
@@ -1762,8 +1751,8 @@ class Flomni(
 
         self.OMNYTools = OMNYTools(self.client)
         # expert functions of the real-time loop (settings with rules, via the web HMI on the loop machine;
-        # flomni_realtime_system.py): flomni.realtime_system.show() / .set(...) / .help()
-        self.realtime_system = FlomniRealtimeSystem(device_manager=self.device_manager)
+        # flomni_realtime_system.py): flomni.rt_settings.show() / .set(...) / .help()
+        self.rt_settings = FlomniRealtimeSystem(device_manager=self.device_manager)
         self.reconstructor = PtychoReconstructor(self.ptycho_reconstruct_foldername)
         self.tomo_id_manager = TomoIDManager()
         self.align = XrayEyeAlign(self.client, self)
@@ -1868,7 +1857,7 @@ class Flomni(
                 fsamx_in = self._get_user_param_safe("fsamx", "in")  # name: dev[...] lookup (a device raised)
                 if np.isclose(fsamx_in, dev.fsamx.readback.get(), rtol=0, atol=0.5):
                     print("Stopping alignment. Returning to fsamx in position.")
-                    self.feedback_disable()
+                    self.rt_feedback_disable()
                     umv(dev.fsamx, fsamx_in)
                 raise exc
 
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index 0c08651f..b539dbd9 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -1,4 +1,4 @@
-"""flomni.realtime_system: the operating settings of the flOMNI real-time loop.
+"""flomni.rt_settings: the operating settings of the flOMNI real-time loop.
 
 BEAMLINE SCIENTISTS / LOCAL CONTACT ONLY - not for users. These settings change how the FZP scanner, the detector
 trigger and the laser tracker work; a wrong combination can spoil a beamtime's data. The rules refuse combinations
@@ -9,12 +9,12 @@ The settings, the parameters they map onto and the rules between them live in th
 webhmi/loopsettings.py). This client only talks to its REST API (/api/settings); it holds no logic of its own, so the
 web page (tab "Loop settings") and BEC always behave the same way.
 
-    flomni.realtime_system.show()                          all settings, rules, scan state
-    flomni.realtime_system.set(trigger_tolerance_nm=5)     change (refused if a rule objects)
-    flomni.realtime_system.set(fzp_enable=0, adjust=True)  ... and adjust the dependent settings
-    flomni.realtime_system.check(fzp_range_V_x=1.0)        dry run
-    flomni.realtime_system.apply_profile("fzp_off")        a named set of settings
-    flomni.realtime_system.save_as_default()               write the live values into the .xmp files
+    flomni.rt_settings.show()                          all settings, rules, scan state
+    flomni.rt_settings.set(trigger_tolerance_nm=5)     change (refused if a rule objects)
+    flomni.rt_settings.set(fzp_enable=0, adjust=True)  ... and adjust the dependent settings
+    flomni.rt_settings.check(fzp_range_V_x=1.0)        dry run
+    flomni.rt_settings.apply_profile("fzp_off")        a named set of settings
+    flomni.rt_settings.save_as_default()               write the live values into the .xmp files
 
 Changes are live only: the next start of the control loop uses the .xmp files again (save_as_default keeps them).
 
@@ -27,7 +27,7 @@ from csaxs_bec.devices.omny.webhmi_client import WebHmiClient
 from csaxs_bec.devices.omny.webhmi_client import WebHmiError as RealtimeSystemError  # name kept for BEC users
 
 
-STAFF_ONLY = ("flomni.realtime_system: beamline scientists / local contact only - not for users "
+STAFF_ONLY = ("flomni.rt_settings: beamline scientists / local contact only - not for users "
               "(plugins/flomni/docs/local_contact_only-realtime_system.md).")
 
 
@@ -225,6 +225,27 @@ class FlomniRealtimeSystem(WebHmiClient):
         v = self.get()
         return v["tracking_target_y"], v["tracking_target_z"]
 
+    # the former flomni.laser_parameters_* (moved here 2026-10-26)
+    def tracking_show(self):
+        """Laser tracker: targets on the PSD and intensity thresholds."""
+        self.show(group="tracking")
+
+    def tracking_set_target_y(self, val: float):
+        """Laser tracker target y on the PSD (arrow-key tweak: flomni.rt_laser_tracker_tweak())."""
+        return self.set(tracking_target_y=val)
+
+    def tracking_set_target_z(self, val: float):
+        """Laser tracker target z on the PSD (arrow-key tweak: flomni.rt_laser_tracker_tweak())."""
+        return self.set(tracking_target_z=val)
+
+    def tracking_set_interferometer_threshold(self, val: float):
+        """Intensity threshold of the interferometer signal."""
+        return self.set(interferometer_threshold=val)
+
+    def tracking_set_psd_threshold_low(self, val: float):
+        """Lower PSD intensity threshold of the tracking."""
+        return self.set(psd_threshold_low=val)
+
     def help(self, name: str = None):
         """help(): the functions; help("all"): every setting with its explanation; help(name): one setting (what it
         does, unit, range, the loop parameters it sets, live and saved value), from the definition on the loop
@@ -232,7 +253,9 @@ class FlomniRealtimeSystem(WebHmiClient):
         if name is None:
             print(__doc__.split("\n\nConnection:")[0])
             print("\nShortcuts: trigger_show(), trigger_set_tolerance_nm(v), trigger_set_hold_ms(v),"
-                  " trigger_set_after_move(True/False), tracking_targets(); profiles(), unsaved(), get(name)")
+                  " trigger_set_after_move(True/False), tracking_targets(), tracking_show(), tracking_set_target_y(v),"
+                  " tracking_set_target_z(v), tracking_set_interferometer_threshold(v), tracking_set_psd_threshold_low(v);"
+                  " profiles(), unsaved(), get(name)")
             print('Explanations: help("all") or help("<setting>"), e.g. help("move_beyond_um_x")')
             return
         snap = self.read()
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/x_ray_eye_align.py b/csaxs_bec/bec_ipython_client/plugins/flomni/x_ray_eye_align.py
index d8263501..a3a94091 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/x_ray_eye_align.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/x_ray_eye_align.py
@@ -270,9 +270,9 @@ class XrayEyeAlign:
 
             self.flomni.feye_in()
 
-        self.flomni.laser_tracker_on()
+        self.flomni.rt_laser_tracker_on()
 
-        self.flomni.feedback_enable_with_reset()
+        self.flomni.rt_feedback_enable_with_reset()
 
         # disable movement buttons
         self.movement_buttons_enabled(False, False)
@@ -281,12 +281,12 @@ class XrayEyeAlign:
         self.gui.sample_name = sample_name
 
         # this makes sure we are in a defined state
-        self.flomni.feedback_disable()
+        self.flomni.rt_feedback_disable()
 
         if not self.test_wo_movements:
             self.flomni.fosa_out()
             self.flomni.ffzp_in()
-            self.flomni.feedback_disable()
+            self.flomni.rt_feedback_disable()
             fsamx_in = self.flomni._get_user_param_safe("fsamx", "in")
             umv(dev.fsamx, fsamx_in - 0.25)
 
@@ -362,7 +362,7 @@ class XrayEyeAlign:
                     self.movement_buttons_enabled(False, False)
                     self.gui.enable_submit_button(False)
 
-                    self.flomni.feedback_disable()
+                    self.flomni.rt_feedback_disable()
                     if not self.test_wo_movements:
                         fsamx_in = self.flomni._get_user_param_safe("fsamx", "in")
                         umv(dev.fsamx, fsamx_in)
@@ -371,7 +371,7 @@ class XrayEyeAlign:
 
                         time.sleep(0.5)
 
-                    self.flomni.feedback_enable_with_reset()
+                    self.flomni.rt_feedback_enable_with_reset()
 
                     self.update_frame(keep_shutter_open)
 
@@ -410,11 +410,11 @@ class XrayEyeAlign:
                         f"delta_fsamy={delta_y_mm:.5f} mm"
                     )
 
-                    self.flomni.feedback_disable()
+                    self.flomni.rt_feedback_disable()
                     if not self.test_wo_movements and delta_y_mm != 0:
                         self.flomni.umvr_fsamy_tracked(delta_y_mm, _internal=True)
                         time.sleep(2)
-                    self.flomni.feedback_enable_with_reset()
+                    self.flomni.rt_feedback_enable_with_reset()
 
                     self._height_centered = True
                     # From here through step 5, the sample's vertical position is
@@ -471,12 +471,12 @@ class XrayEyeAlign:
                 # allow movements, store movements to calculate center
                 _xrayeyalignmvy = dev.omny_xray_gui.mvy.get()
                 if _xrayeyalignmvy != 0:
-                    self.flomni.feedback_disable()
+                    self.flomni.rt_feedback_disable()
                     if not self.test_wo_movements:
                         self.flomni.umvr_fsamy_tracked(_xrayeyalignmvy / 1000, _internal=True)
                     time.sleep(2)
                     dev.omny_xray_gui.mvy.set(0)
-                    self.flomni.feedback_enable_with_reset()
+                    self.flomni.rt_feedback_enable_with_reset()
                     self.update_frame(keep_shutter_open)
             time.sleep(0.1)
 
diff --git a/csaxs_bec/device_configs/ptycho_flomni.yaml b/csaxs_bec/device_configs/ptycho_flomni.yaml
index 450b4222..31bc56d7 100644
--- a/csaxs_bec/device_configs/ptycho_flomni.yaml
+++ b/csaxs_bec/device_configs/ptycho_flomni.yaml
@@ -620,7 +620,7 @@ flomni_temphum:
 # ############################################################
 # The loop settings (FZP, trigger, tracker; flOMNI FeedbackLoop/loopsettings) stored with every scan: read from the
 # web HMI on the loop machine at the start of each scan (baseline). Web HMI down: available = 0, the scan continues.
-# The user commands flomni.realtime_system go through this device (RPC), so the token is needed only here.
+# The user commands flomni.rt_settings go through this device (RPC), so the token is needed only here.
 # token: the web HMI API token (~/loop-data/webhmi/api_token on mpc2844; behind the beamline firewall, Mirko
 # 2026-10-23). When empty, token_file (on the machine of the device server) is used.
 flomni_loop_settings:
diff --git a/csaxs_bec/devices/omny/flomni_loop_settings.py b/csaxs_bec/devices/omny/flomni_loop_settings.py
index 552d6667..d92338f1 100644
--- a/csaxs_bec/devices/omny/flomni_loop_settings.py
+++ b/csaxs_bec/devices/omny/flomni_loop_settings.py
@@ -20,7 +20,7 @@ deviceConfig: token (the API token itself), else token_file (path to a file with
 ~/.flomni_webhmi_token), optional url / host / timeout (default 2 s for the scan snapshot). Connection details:
 devices/omny/webhmi_client.py.
 
-flomni.realtime_system (the user commands) calls api_get / api_post of this device by RPC, so the token is needed
+flomni.rt_settings (the user commands) calls api_get / api_post of this device by RPC, so the token is needed
 only here.
 """
 
@@ -67,7 +67,7 @@ class FlomniLoopSettings(Device):
         super().__init__(prefix, name=name, **kwargs)
         self._client = WebHmiClient(url=url, token=token, token_file=token_file, host=host,
                                     device_manager=device_manager, timeout=timeout, client_name="BEC baseline")
-        # requests of flomni.realtime_system (RPC from the client, below): longer timeout, no back-off
+        # requests of flomni.rt_settings (RPC from the client, below): longer timeout, no back-off
         self._api = WebHmiClient(url=url, token=token, token_file=token_file, host=host,
                                  device_manager=device_manager, timeout=max(timeout, 10.0), client_name="BEC")
         self._failed_at = None
@@ -127,7 +127,7 @@ class FlomniLoopSettings(Device):
         self.update()
         return super().read()
 
-    # ── RPC for flomni.realtime_system: the user commands go through this device, so the API token is needed only
+    # ── RPC for flomni.rt_settings: the user commands go through this device, so the API token is needed only
     # in its device config (device server), not on the client. Not called set / put: the device server treats
     # those names as ophyd writes (refused on a readOnly device).
 
diff --git a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
index b2616c80..a59612f2 100644
--- a/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
+++ b/csaxs_bec/devices/omny/rt/rt_flomni_ophyd.py
@@ -396,7 +396,7 @@ class RtFlomniController(Controller):
 
     # emitter_* (ConstEmitter get / set through the CommunicationServer e-commands) removed 2026-10-23: the
     # ConstEmitter is no longer in the loop; its values are loop settings, set through the web HMI
-    # (flomni.realtime_system, csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py).
+    # (flomni.rt_settings, csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py).
 
     def move_xyz(self, x: float, y: float, z: float) -> None:
         """Move rtx, rty and rtz with one command (CommunicationServer p<x>,<y>,<z>).
diff --git a/csaxs_bec/devices/omny/webhmi_client.py b/csaxs_bec/devices/omny/webhmi_client.py
index 92554527..8a22fa16 100644
--- a/csaxs_bec/devices/omny/webhmi_client.py
+++ b/csaxs_bec/devices/omny/webhmi_client.py
@@ -1,6 +1,6 @@
 """Client of the web HMI on an OMNY-family loop machine (RT-system webhmi): REST requests with the API token.
 
-Shared by the BEC client plugin (flomni.realtime_system, bec_ipython_client/plugins/flomni/flomni_realtime_system.py)
+Shared by the BEC client plugin (flomni.rt_settings, bec_ipython_client/plugins/flomni/flomni_realtime_system.py)
 and the baseline device FlomniLoopSettings (devices/omny/flomni_loop_settings.py), so both talk to the web HMI the
 same way. Standard library only (runs in the IPython client and in the device server).
 
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 9b7f1270..66d0aac8 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -187,8 +187,10 @@ Following functions exist to move the optics in and out, with self-explaining na
 
 ### Interferometer
 
+All commands of the real-time system start with `rt_`: `flomni.rt_<TAB>` lists them.
+
 The position feedback in flOMNI is controlled in closed loop to an interferometric position measurement. To show the signal of the interferometers:
-`flomni.show_signal_strength_interferometer()`  
+`flomni.rt_signal_strength()` (or the former name `flomni.show_signal_strength_interferometer()`)  
 Typical values with proper alignment, sample stage at the measurement position and laser tracker running are in the range of
 
 |    Axis   |       Value        |
@@ -203,20 +205,21 @@ Typical values with proper alignment, sample stage at the measurement position a
 
 The horizontal interferometer is built according to the [tracking interferometer](https://www.dora.lib4ri.ch/psi/islandora/object/psi:7524). The tracker can be controlled by following commands. During commissioning of the setup it is worthy to check the status, but during general operation these commands should not be required.
 
-- `flomni.laser_tracker_show_all()`
-- `flomni.laser_tracker_on()`
-- `flomni.laser_tracker_off()`
+- `flomni.rt_laser_tracker_show_all()`
+- `flomni.rt_laser_tracker_on()`
+- `flomni.rt_laser_tracker_off()`
+- `flomni.rt_laser_tracker_tweak()` (arrow keys move the tracking targets)
 
 
 #### Interferometer feedback commands
 
 The closed loop control of the Piezo stages can be controlled by  
 
-- `flomni.feedback_feedback_enable_with_reset()`.  
+- `flomni.rt_feedback_enable_with_reset()`.  
 _There is also an enable without reset, which is used during tomography scans, when using coarse stages to increase the scan range. It should not be required to use manually._  
 
-- `flomni.feedback_disable()`
-- `flomni.feedback_status()`
+- `flomni.rt_feedback_disable()`
+- `flomni.rt_feedback_status()`
 
 #### Detector trigger: position stability
 
@@ -773,7 +776,8 @@ removed later.
 ### Real-time loop settings
 
 The operating settings of the real-time control loop (FZP scanner, detector trigger, laser tracker) are set by the
-local contact; please do not change them. Every scan stores the settings it ran with (baseline device
+local contact (`flomni.rt_settings`, including the laser tracker targets and thresholds
+`flomni.rt_settings.tracking_*`); please do not change them. Every scan stores the settings it ran with (baseline device
 `flomni_loop_settings`).
 
 Details for beamline scientists: `csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md`.
diff --git a/omny_e2e_tests/_bootstrap.py b/omny_e2e_tests/_bootstrap.py
index 133d9b4e..08517bf1 100644
--- a/omny_e2e_tests/_bootstrap.py
+++ b/omny_e2e_tests/_bootstrap.py
@@ -103,7 +103,7 @@ def build_flomni(services_config_path):
         if abs(fsamx.readback.get() - fsamx_in) > 0.3:
             fsamx.read_only = False
             flomni_module.umv(fsamx, fsamx_in)
-        flomni.feedback_enable_with_reset()
+        flomni.rt_feedback_enable_with_reset()
 
     return bec, flomni
 
diff --git a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
index ec664b87..d44bbf96 100644
--- a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
+++ b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
@@ -1,4 +1,4 @@
-"""Tests for flomni.realtime_system (flomni_realtime_system.py): the client of the web HMI loop-settings API on the
+"""Tests for flomni.rt_settings (flomni_realtime_system.py): the client of the web HMI loop-settings API on the
 flOMNI loop machine. A small local HTTP server stands in for the web HMI (RT-system webhmi, /api/settings*); it checks
 the token header and answers like the real server. No BEC service, no loop."""
 
diff --git a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
index 8e745039..bd521c27 100644
--- a/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
+++ b/tests/tests_bec_ipython_client/test_flomni_review_fixes.py
@@ -163,7 +163,7 @@ def test_xray_eye_ctrl_c_returns_fsamx_in(monkeypatch):
     moved = []
     monkeypatch.setattr(flomni_module, "umv", lambda *a: moved.append(a), raising=False)
     flomni.OMNYTools = types.SimpleNamespace(yesno=lambda *a, **k: True)
-    flomni.feedback_disable = lambda: None
+    flomni.rt_feedback_disable = lambda: None
 
     class _Align:
         def __init__(self, *a):
diff --git a/tests/tests_devices/test_flomni_loop_settings.py b/tests/tests_devices/test_flomni_loop_settings.py
index 08066006..a5350e06 100644
--- a/tests/tests_devices/test_flomni_loop_settings.py
+++ b/tests/tests_devices/test_flomni_loop_settings.py
@@ -98,7 +98,7 @@ def test_token_file_and_snapshot(url, tmp_path):
 
 
 def test_api_methods_for_realtime_system(url):
-    """api_get / api_post: the RPC used by flomni.realtime_system (token only in the device config)."""
+    """api_get / api_post: the RPC used by flomni.rt_settings (token only in the device config)."""
     dev = FlomniLoopSettings(name="ls", url=url, token=TOKEN)
     assert dev.api_get("/api/settings")["instrument"] == "flOMNI"
     with pytest.raises(Exception, match="not allowed"):

From ac633d56347f56bd12d2ac54d4b90a4cf1d53ed4 Mon Sep 17 00:00:00 2001
From: x01dc <x01dc@psi.ch>
Date: Mon, 26 Oct 2026 15:15:14 +0100
Subject: [PATCH 095/102] feat(flomni): keep feedback_* as aliases of
 rt_feedback_*

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md  | 6 +++---
 csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py       | 6 ++++++
 docs/user/ptychography/flomni.md                            | 3 +++
 3 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md
index 07968972..bc7398e1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md
+++ b/csaxs_bec/bec_ipython_client/plugins/OMNY_shared/AI_docs/TODO_rt_namespace_harmonization.md
@@ -8,7 +8,7 @@ real-time system, and the names match across all three endstations.
 | Function | flOMNI name | former name |
 | --- | --- | --- |
 | BEC device enable rtx/rty/rtz | `rt_on()` / `rt_off()` | unchanged |
-| feedback | `rt_feedback_enable_with_reset()`, `rt_feedback_enable_without_reset()`, `rt_feedback_disable()`, `rt_feedback_status()` | `feedback_*` |
+| feedback | `rt_feedback_enable_with_reset()`, `rt_feedback_enable_without_reset()`, `rt_feedback_disable()`, `rt_feedback_status()` | `feedback_*` (kept as aliases) |
 | laser tracker | `rt_laser_tracker_on()`, `rt_laser_tracker_off()`, `rt_laser_tracker_show_all()`, `rt_laser_tracker_tweak()` | `laser_tracker_*`, `laser_parameters_tweak_tracking` |
 | signal strength | `rt_signal_strength()`, alias `show_signal_strength_interferometer()` | `show_signal_strength_interferometer` |
 | loop settings (staff) | `rt_settings` incl. `tracking_show/set_target_y/set_target_z/set_interferometer_threshold/set_psd_threshold_low` | `realtime_system`, `laser_parameters_*` |
@@ -17,7 +17,7 @@ real-time system, and the names match across all three endstations.
 
 - `rt_on` / `rt_off` already exist (line ~774).
 - `feedback_enable_with_reset`, `feedback_enable_without_reset`, `feedback_disable`, `feedback_status`
-  -> `rt_feedback_*`; also `feedback_disable_and_reset_angle` -> `rt_feedback_disable_and_reset_angle`.
+  -> `rt_feedback_*` (keep the old names as aliases, as on flOMNI); also `feedback_disable_and_reset_angle` -> `rt_feedback_disable_and_reset_angle`.
 - `show_signal_strength` -> `rt_signal_strength` (keep the old name as an alias).
 - LamNI has no laser tracker and no `rt_settings` (no web HMI loop settings).
 - Callers: `plugins/LamNI/x_ray_eye_align.py` and `plugins/omny/x_ray_eye_align.py` (the LamNI one calls
@@ -27,7 +27,7 @@ real-time system, and the names match across all three endstations.
 ## OMNY (`plugins/omny/omny.py`, `plugins/omny/omny_rt.py`)
 
 - `rt_on` / `rt_off` already exist (`omny.py` ~2166).
-- `omny_rt.py`: `feedback_*` -> `rt_feedback_*`, `laser_tracker_on/off/show_all` -> `rt_laser_tracker_*`,
+- `omny_rt.py`: `feedback_*` -> `rt_feedback_*` (old names as aliases), `laser_tracker_on/off/show_all` -> `rt_laser_tracker_*`,
   `laser_tracker_check_and_wait_for_signalstrength` -> `rt_laser_tracker_check_and_wait_for_signalstrength`,
   `show_signal_strength_interferometer` -> `rt_signal_strength` + alias.
 - Callers: OMNY tomo/alignment code, `docs/user/ptychography/omny.md`, `test_omny_tomo_scan.py`
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 689309da..59df523e 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -701,6 +701,12 @@ class FlomniSampleTransferMixin:
         else:
             print("The rt feedback is \x1b[91mNOT\x1b[0m running.")
 
+    # the familiar names, kept as aliases
+    feedback_disable = rt_feedback_disable
+    feedback_enable_with_reset = rt_feedback_enable_with_reset
+    feedback_enable_without_reset = rt_feedback_enable_without_reset
+    feedback_status = rt_feedback_status
+
     # detector trigger: flomni.rt_settings.trigger_* (the former flomni.interferometer_trigger_* removed
     # 2026-10-23, Mirko: "interferometer" was confusing next to flomni.laser_*)
 
diff --git a/docs/user/ptychography/flomni.md b/docs/user/ptychography/flomni.md
index 66d0aac8..ad39c6fd 100644
--- a/docs/user/ptychography/flomni.md
+++ b/docs/user/ptychography/flomni.md
@@ -221,6 +221,9 @@ _There is also an enable without reset, which is used during tomography scans, w
 - `flomni.rt_feedback_disable()`
 - `flomni.rt_feedback_status()`
 
+The former names `flomni.feedback_enable_with_reset()`, `feedback_enable_without_reset()`, `feedback_disable()`
+and `feedback_status()` still work.
+
 #### Detector trigger: position stability
 
 In step scans the detector is triggered when the sample is stable at the scan point: the relative position

From 8e8a5a790f3e2140d2ddb4aadd4432edd2bd1c7b Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 16:48:45 +0100
Subject: [PATCH 096/102] flomni_loop_settings: fzp_ff_priority as own signal
 (new loop setting, flOMNI scan_modes.md 2026-10-26)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017KicuVBRC7jB1TLG5hLZwx
---
 csaxs_bec/devices/omny/flomni_loop_settings.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/csaxs_bec/devices/omny/flomni_loop_settings.py b/csaxs_bec/devices/omny/flomni_loop_settings.py
index d92338f1..dbb32383 100644
--- a/csaxs_bec/devices/omny/flomni_loop_settings.py
+++ b/csaxs_bec/devices/omny/flomni_loop_settings.py
@@ -43,6 +43,7 @@ SETTINGS = (
     "interferometer_threshold_rot",
     "sample_hold_fzp_V", "sample_hold_err_um", "sample_hold_zero",
     "target_shaper_scale", "jump_max_um_x", "jump_max_um_y",      # group motion, scan-mode profiles (2026-10-26)
+    "fzp_ff_priority",                                            # FZP feedforward priority (2026-10-26)
 )
 
 RETRY_AFTER_FAILURE_S = 60.0    # web HMI not reachable: no new attempt for this long (a tomogram does not wait each time)

From 1c569a3808f9d09391e94439e9d3ad26090df6fa Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 17:43:54 +0100
Subject: [PATCH 097/102] docs(flomni): fzp_ff_priority in the realtime-system
 and FZP how-tos (ff_limit unused with the priority), motion settings group;
 PDFs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017KicuVBRC7jB1TLG5hLZwx
---
 ...ct_only-howto_calibrate_the_fzp_scanner.md |   2 +-
 ...t_only-howto_calibrate_the_fzp_scanner.pdf | Bin 89158 -> 89318 bytes
 ..._only-howto_limit_the_fzp_scanner_range.md |   4 +++-
 ...only-howto_limit_the_fzp_scanner_range.pdf | Bin 57503 -> 57946 bytes
 .../local_contact_only-realtime_system.md     |   3 ++-
 .../local_contact_only-realtime_system.pdf    | Bin 57759 -> 58205 bytes
 6 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
index 76dd0a35..908c998d 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.md
@@ -113,7 +113,7 @@ correction (−4 before 2026-10-19, now 0: replaced by the feedforward).
 | `PID_x`, `PID_y` | `FAST_FZP_PID_LOOP` | `0,0,0,0,0.1,0,0` (no move-beyond: −0.5 µm is larger than the ±1.5 V FZP stroke, x ≈ ±0.19 µm, y ≈ ±0.08 µm) |
 | `PID_x_fzp` | `FAST_FZP_PID_LOOP`, `Ub` / `Lb` | `1,0.0001,0.1,0,0,0,0`, ±1.5 V |
 | `PID_y_fzp` | `FAST_FZP_PID_LOOP`, `Ub` / `Lb` | `1,0.0005,0.02,0,0,0,0`, ±1.5 V |
-| `Feedforward` | `enable`; `ff_limit`, `out_min` / `out_max` | 1,1; ±1.5 V (as the FZP `Ub` / `Lb`) |
+| `Feedforward` | `enable`; `ff_limit`, `out_min` / `out_max`; `pid_priority` | 1,1; ±1.5 V (as the FZP `Ub` / `Lb`; `ff_limit` unused with `pid_priority` 1); 1,1 (since 2026-10-26, with `PID_*_fzp` `antiwindup` 1) |
 | `OnTargetTrigger` | `WaitForSlew`, `MinDelay_ms` | 1, 15 |
 | `TargetSelect_x`, `TargetSelect_y` | `use_final` | 0 |
 | `AbbeCorrection` | `enable` | 0 (until the signs are known) |
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_calibrate_the_fzp_scanner.pdf
index 29bdcb4c6e1fb62e8c8c29df8b314df9723f94ef..b69bb94ac47c106f8d5e4251c60b8ae446118882 100644
GIT binary patch
delta 31517
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

delta 31394
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
a|1Lt#Pt>WYI^bgPp9tV7D8v-R;r~BTVI{Hv

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
index 2ff5e696..a3c8829f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.md
@@ -26,7 +26,9 @@ so ±1.5 V ≈ ±0.19 µm (x) / ±0.08 µm (y). In the sample stage PIDs (`PID_x
 Changing the FZP range now involves, in addition to the text above:
 
 - **`Feedforward`** (static FZP feedforward): `ff_limit`, `out_min` / `out_max` to the same values as the FZP `Ub` /
-  `Lb` (they limit drive + feedforward).
+  `Lb` (they limit drive + feedforward). Since 2026-10-26 (`fzp_ff_priority` 1, `pid_priority` 1,1) `ff_limit` is not
+  used: the feedforward has the range first, the FZP PID limits follow `Ub` / `Lb` − feedforward (flOMNI
+  `FeedbackLoop/scan_modes.md`); `out_min` / `out_max` still limit the sum.
 - **`FreqGen`** `out_min` / `out_max` (channels 0 / 1) limit the FZP drive only while an excitation is running
   (measurements).
 - **`OnTargetTrigger`** `WaitForSlew` and **`TargetSelect_x` / `_y`** `use_final`: keep the defaults (1 / 0) with a
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-howto_limit_the_fzp_scanner_range.pdf
index 2c8a51c7e5a7a8d5b867c7922f15993f67922efc..77b6089e78ee00529d6ca966c5eb0f0e2971b080 100644
GIT binary patch
delta 18566
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
DYl>M&

delta 18090
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
Br3?T7

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
index cb36401d..165239ba 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
@@ -18,7 +18,8 @@ Background and reference (flOMNI control repository, `OMNY/flOMNI` on gitea):
 
 | Group | Settings |
 |---|---|
-| FZP scanner (only between scans) | `fzp_enable` (both axes or none), `fzp_range_V_x` / `_y`, `feedforward_enable`, `move_beyond_um_x` / `_y`, `exposure_during_motion`, `abbe_enable`, `abbe_limit_um` |
+| FZP scanner (only between scans) | `fzp_enable` (both axes or none), `fzp_range_V_x` / `_y`, `feedforward_enable`, `fzp_ff_priority` (feedforward first, 1 in production and all scan profiles since 2026-10-26), `move_beyond_um_x` / `_y`, `exposure_during_motion`, `abbe_enable`, `abbe_limit_um` |
+| Sample stage moves (only between scans) | `target_shaper_scale`, `jump_max_um_x` / `_y` |
 | Detector trigger | `trigger_tolerance_nm`, `trigger_hold_ms`, `trigger_min_delay_ms`, `trigger_on_move` |
 | Laser tracker and thresholds | `tracking_target_y` / `_z`, `psd_threshold_low`, `interferometer_threshold`, `interferometer_threshold_rot` |
 | FZP calibration (expert, only between scans) | `sample_hold_fzp_V`, `sample_hold_err_um`, `sample_hold_zero` |
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf
index d170eb4499d65db812ce848093938626fe4a5ec5..cf5b5236e68afe75ecf0ef10e0ce05fb361d928a 100644
GIT binary patch
delta 16240
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

delta 15776
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


From 5e3b4b50d5f4db4ecaef1f2df925b670c5f330c7 Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Mon, 26 Oct 2026 21:48:53 +0100
Subject: [PATCH 098/102] feat(flomni): trigger source of the flOMNI loop at
 every Fermat scan start (soft trigger)

flomni_fermat_scan sets the loop setting trigger_soft before arming ddg1: at the beamline (a real, not simulated,
ddg1 or one of the exposure box motors ebtrx/ebtry/ebtrz/ebsupport configured; a failing check counts as beamline)
the hardware trigger, else the soft trigger with soft_exposure_ms = exp_time x frames_per_trigger. At the beamline
the scan is aborted if the hardware trigger cannot be confirmed; away only a warning. flomni_loop_settings: signals
trigger_soft, soft_exposure_ms, soft_latency_ms. rt_settings.trigger_set_soft(); trigger_show() shows both groups.
Docs + PDF. Needs the flOMNI loop / web HMI with the soft trigger (flOMNI feat/soft-trigger) first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017KicuVBRC7jB1TLG5hLZwx
---
 .../local_contact_only-realtime_system.md     |  20 +++++
 .../local_contact_only-realtime_system.pdf    | Bin 58205 -> 68928 bytes
 .../plugins/flomni/flomni_realtime_system.py  |  25 ++++--
 .../devices/omny/flomni_loop_settings.py      |   1 +
 csaxs_bec/scans/flomni_fermat_scan.py         |  69 +++++++++++++++++
 .../test_flomni_realtime_system.py            |   9 +++
 tests/tests_scans/test_flomni_fermat_scan.py  |  73 ++++++++++++++++++
 7 files changed, 191 insertions(+), 6 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
index 165239ba..eb9d1348 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
@@ -21,6 +21,7 @@ Background and reference (flOMNI control repository, `OMNY/flOMNI` on gitea):
 | FZP scanner (only between scans) | `fzp_enable` (both axes or none), `fzp_range_V_x` / `_y`, `feedforward_enable`, `fzp_ff_priority` (feedforward first, 1 in production and all scan profiles since 2026-10-26), `move_beyond_um_x` / `_y`, `exposure_during_motion`, `abbe_enable`, `abbe_limit_um` |
 | Sample stage moves (only between scans) | `target_shaper_scale`, `jump_max_um_x` / `_y` |
 | Detector trigger | `trigger_tolerance_nm`, `trigger_hold_ms`, `trigger_min_delay_ms`, `trigger_on_move` |
+| Trigger source (only between scans) | `trigger_soft` (never saved, set by the Fermat scan), `soft_exposure_ms`, `soft_latency_ms` |
 | Laser tracker and thresholds | `tracking_target_y` / `_z`, `psd_threshold_low`, `interferometer_threshold`, `interferometer_threshold_rot` |
 | FZP calibration (expert, only between scans) | `sample_hold_fzp_V`, `sample_hold_err_um`, `sample_hold_zero` |
 
@@ -59,6 +60,25 @@ sensor) stays within the tolerance in x and in y (each averaged over 0.5 ms) for
 
 The former `flomni.interferometer_trigger_*` were removed 2026-10-23.
 
+### Soft trigger (working without detector)
+
+With the soft trigger no trigger leaves the loop (the detector trigger output stays 0) and the loop emulates the
+detector: every trigger starts an exposure of `soft_exposure_ms` after `soft_latency_ms` (1 ms). Scans then run
+without detector or trigger PLC. The loop always starts with the hardware trigger; `trigger_soft` is never saved as
+default and is in no profile (flOMNI `FeedbackLoop/soft_trigger.md`).
+
+**`flomni_fermat_scan` sets the trigger source at every scan start** (2026-10-26):
+
+- **At the beamline → hardware.** At the beamline means: `ddg1` is configured with a real (not simulated) device
+  class, or one of the exposure box motors `ebtrx`, `ebtry`, `ebtrz`, `ebsupport` is in the session. If this cannot
+  be confirmed (web HMI not reachable, refused) the scan is aborted: with the soft trigger the detector would not
+  be triggered while flOMNI exposes internally. A failing check also counts as beamline.
+- **Otherwise (simulated `ddg1`, no beamline devices) → soft** with `soft_exposure_ms` = `exp_time` ×
+  `frames_per_trigger` × 1000. If that fails the scan continues with a warning (alarm).
+
+By hand: `flomni.rt_settings.trigger_set_soft(True, exposure_ms=100)`, `trigger_set_soft(False)`;
+`trigger_show()` shows both groups.
+
 ### Laser tracker
 
 `flomni.rt_settings.tracking_show()`, `tracking_set_target_y(v)` / `tracking_set_target_z(v)`,
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf
index cf5b5236e68afe75ecf0ef10e0ce05fb361d928a..fb4ee1d079799fbd89e6d0f3d9eb167cd334d639 100644
GIT binary patch
delta 49894
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
CXxAM8

delta 39752
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
a#{+?8u+RWFFTiDBFc~TV0d)fns{aG9bVm>X

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
index b539dbd9..598d262f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni_realtime_system.py
@@ -85,16 +85,18 @@ class FlomniRealtimeSystem(WebHmiClient):
             raise RealtimeSystemError(f"unknown setting '{name}'; known: {', '.join(values)}")
         return values[name]
 
-    def show(self, group: str = None, expert: bool = False):
-        """Print the settings (live value, .xmp value, markers), the violated rules and the scan state."""
+    def show(self, group=None, expert: bool = False):
+        """Print the settings (live value, .xmp value, markers), the violated rules and the scan state; group: one
+        group name or several (tuple)."""
         snap = self.read()
+        wanted = (group,) if isinstance(group, str) else tuple(group or ())
         groups = {g["name"]: g for g in snap["groups"]}
         sc = snap.get("scan") or {}
         print(STAFF_ONLY)
         print(f"Loop settings {snap.get('instrument', '')} ({self.route}) - "
               + (f"scan running (mode {_fmt(sc.get('mode'))})" if sc.get("active") else "no scan"))
         for gname, g in groups.items():
-            if group and gname != group:
+            if wanted and gname not in wanted:
                 continue
             if g.get("expert") and not expert and not group:
                 continue
@@ -203,8 +205,9 @@ class FlomniRealtimeSystem(WebHmiClient):
 
     # the former flomni.interferometer_trigger_* (removed 2026-10-23)
     def trigger_show(self):
-        """Detector trigger (step scans): tolerance, hold time, minimum delay, trigger after every move."""
-        self.show(group="trigger")
+        """Detector trigger (step scans): tolerance, hold time, minimum delay, trigger after every move; trigger source
+        (hardware / soft)."""
+        self.show(group=("trigger", "trigger_source"))
 
     def trigger_set_tolerance_nm(self, tolerance_nm: float):
         """|relative position sample vs FZP| x and y within this (nm) for the hold time. 30 coarse, 10 standard, 2 finest;
@@ -220,6 +223,16 @@ class FlomniRealtimeSystem(WebHmiClient):
         False: triggers at step-scan points only."""
         return self.set(trigger_on_move=1 if enable else 0)
 
+    def trigger_set_soft(self, enable: bool, exposure_ms: float = None):
+        """Soft trigger (working without detector / trigger PLC): True = no hardware trigger leaves the loop, every
+        trigger starts an emulated exposure of exposure_ms (default: unchanged); False = hardware trigger. Never saved
+        as default (the loop starts with the hardware trigger); the flOMNI Fermat scan sets it at every scan start
+        (hardware at the beamline, soft otherwise). Only between scans."""
+        changes = {"trigger_soft": 1 if enable else 0}
+        if enable and exposure_ms is not None:
+            changes["soft_exposure_ms"] = exposure_ms
+        return self.set(**changes)
+
     def tracking_targets(self):
         """-> (target y, target z) of the laser tracker on the PSD."""
         v = self.get()
@@ -253,7 +266,7 @@ class FlomniRealtimeSystem(WebHmiClient):
         if name is None:
             print(__doc__.split("\n\nConnection:")[0])
             print("\nShortcuts: trigger_show(), trigger_set_tolerance_nm(v), trigger_set_hold_ms(v),"
-                  " trigger_set_after_move(True/False), tracking_targets(), tracking_show(), tracking_set_target_y(v),"
+                  " trigger_set_after_move(True/False), trigger_set_soft(True/False, exposure_ms), tracking_targets(), tracking_show(), tracking_set_target_y(v),"
                   " tracking_set_target_z(v), tracking_set_interferometer_threshold(v), tracking_set_psd_threshold_low(v);"
                   " profiles(), unsaved(), get(name)")
             print('Explanations: help("all") or help("<setting>"), e.g. help("move_beyond_um_x")')
diff --git a/csaxs_bec/devices/omny/flomni_loop_settings.py b/csaxs_bec/devices/omny/flomni_loop_settings.py
index dbb32383..23bf5faf 100644
--- a/csaxs_bec/devices/omny/flomni_loop_settings.py
+++ b/csaxs_bec/devices/omny/flomni_loop_settings.py
@@ -44,6 +44,7 @@ SETTINGS = (
     "sample_hold_fzp_V", "sample_hold_err_um", "sample_hold_zero",
     "target_shaper_scale", "jump_max_um_x", "jump_max_um_y",      # group motion, scan-mode profiles (2026-10-26)
     "fzp_ff_priority",                                            # FZP feedforward priority (2026-10-26)
+    "trigger_soft", "soft_exposure_ms", "soft_latency_ms",        # soft trigger (2026-10-26)
 )
 
 RETRY_AFTER_FAILURE_S = 60.0    # web HMI not reachable: no new attempt for this long (a tomogram does not wait each time)
diff --git a/csaxs_bec/scans/flomni_fermat_scan.py b/csaxs_bec/scans/flomni_fermat_scan.py
index fc1b820c..6cfac1bc 100644
--- a/csaxs_bec/scans/flomni_fermat_scan.py
+++ b/csaxs_bec/scans/flomni_fermat_scan.py
@@ -69,6 +69,10 @@ class FlomniFermatScan(ScanBase):
     MAX_CORRIDOR_SIZE = 3  # Corridor size is capped at this value (in um) for stability
     MIN_FERMAT_ASYMMETRY = 0.1  # Practical working range for fermat_asymmetry (soft-clamped)
     MAX_FERMAT_ASYMMETRY = 10.0
+    # Devices that exist only in the beamline configuration (bl_endstation.yaml: exposure box motors); with one of
+    # them, or a ddg1 that is not simulated, the session is at the beamline -> hardware trigger (flOMNI soft trigger,
+    # FeedbackLoop/soft_trigger.md, 2026-10-26)
+    BEAMLINE_DEVICES = ("ebtrx", "ebtry", "ebtrz", "ebsupport")
 
     def __init__(
         # fmt: off
@@ -345,6 +349,9 @@ class FlomniFermatScan(ScanBase):
         """
         dev = self.dev
 
+        # Trigger source of the flOMNI loop: hardware at the beamline, soft otherwise
+        self.set_trigger_source()
+
         # Prepare DDG1
         dev.ddg1.set_trigger(TRIGGERSOURCE.EXT_RISING_EDGE.value)
 
@@ -377,6 +384,68 @@ class FlomniFermatScan(ScanBase):
                 "Signal strength of the laser tracker is too low for scanning. Realignment required!"
             )
 
+    def at_beamline(self) -> tuple[bool, str]:
+        """
+        Is this session at the beamline? True when ddg1 is configured with a real (not simulated) device class or
+        one of BEAMLINE_DEVICES is configured; False only when both say no. A failing check counts as beamline,
+        so the hardware trigger is the fallback.
+
+        Returns:
+            (at_beamline, reason)
+        """
+        try:
+            devices = self.device_manager.devices
+            reasons = []
+            if "ddg1" in devices:
+                cls = str((getattr(devices["ddg1"], "_config", None) or {}).get("deviceClass", ""))
+                if ".sim." not in cls and "Simulated" not in cls:
+                    reasons.append(f"ddg1 is {cls or 'not simulated'}")
+            found = [name for name in self.BEAMLINE_DEVICES if name in devices]
+            if found:
+                reasons.append("beamline devices " + ", ".join(found))
+            if reasons:
+                return True, "; ".join(reasons)
+            return False, "no beamline devices, ddg1 simulated or absent"
+        except Exception as exc:  # pylint: disable=broad-except
+            return True, f"beamline check failed ({exc}), treated as beamline"
+
+    def set_trigger_source(self):
+        """
+        Set the trigger source of the flOMNI loop (loop setting trigger_soft, web HMI via flomni_loop_settings):
+        at the beamline the hardware trigger (the loop's default); otherwise the soft trigger with the exposure
+        exp_time x frames_per_trigger, so a scan runs without detector or trigger PLC. At the beamline the scan is
+        aborted if the hardware trigger cannot be confirmed (with the soft trigger the detector would not be
+        triggered while flOMNI exposes internally).
+        """
+        at_bl, reason = self.at_beamline()
+        if at_bl:
+            changes = {"trigger_soft": 0}
+        else:
+            changes = {"trigger_soft": 1,
+                       "soft_exposure_ms": float(self.exp_time) * float(self.frames_per_trigger) * 1000.0}
+        try:
+            res = self.dev.flomni_loop_settings.api_post(
+                "/api/settings/apply", {"changes": changes, "profile": None, "adjust": False}
+            )
+            errors = [] if res and res.get("ok") else list((res or {}).get("errors") or ["no answer"])
+        except Exception as exc:  # pylint: disable=broad-except
+            errors = [str(exc)]
+        source = "hardware" if at_bl else "soft"
+        if errors:
+            text = f"flOMNI trigger source {source} ({reason}) not set: {'; '.join(errors)}"
+            if at_bl:
+                raise ScanAbortion(text + ". At the beamline the hardware trigger must be confirmed.")
+            logger.warning(text)
+            self.device_manager.connector.raise_alarm(
+                severity=Alarms.WARNING,
+                info=messages.ErrorInfo(
+                    error_message=text, compact_error_message=text, exception_type="TriggerSource",
+                    device="flomni_loop_settings",
+                ),
+            )
+            return
+        logger.info(f"flOMNI trigger source: {source} ({reason}), {changes}")
+
     def flomni_rotation(self, angle: float):
         """
         Rotate flomni to the requested angle.
diff --git a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
index d44bbf96..04921234 100644
--- a/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
+++ b/tests/tests_bec_ipython_client/test_flomni_realtime_system.py
@@ -212,3 +212,12 @@ def test_help(server, capsys):
     assert "BEAMLINE SCIENTISTS" in capsys.readouterr().out
     with pytest.raises(RealtimeSystemError, match="unknown setting"):
         rts.help("nosuch")
+
+
+def test_trigger_set_soft(server):
+    url, tok, _ = server
+    rts = FlomniRealtimeSystem(url=url, token_file=tok)
+    rts.trigger_set_soft(True, exposure_ms=200)
+    assert _Handler.requests[-1][1]["changes"] == {"trigger_soft": 1, "soft_exposure_ms": 200}
+    rts.trigger_set_soft(False, exposure_ms=200)
+    assert _Handler.requests[-1][1]["changes"] == {"trigger_soft": 0}
diff --git a/tests/tests_scans/test_flomni_fermat_scan.py b/tests/tests_scans/test_flomni_fermat_scan.py
index 2e2e4c0e..98a66823 100644
--- a/tests/tests_scans/test_flomni_fermat_scan.py
+++ b/tests/tests_scans/test_flomni_fermat_scan.py
@@ -1,6 +1,8 @@
 from unittest import mock
 
 import numpy as np
+import pytest
+from bec_server.scan_server.scans import ScanAbortion
 
 from csaxs_bec.scans.flomni_fermat_scan import FlomniFermatScan
 
@@ -152,3 +154,74 @@ def test_randomize_offset_false_gives_unshifted_deterministic_lattice():
     phi = 2 * np.pi * ((1 + np.sqrt(5)) / 2.0)
     r = 0.57
     np.testing.assert_allclose(a[0, :2], [r * np.sin(phi), r * np.cos(phi)])
+
+
+# ── trigger source of the flOMNI loop (soft trigger, 2026-10-26) ──────────────
+
+def _trigger_stub(devices, apply_result=None, apply_exc=None, exp_time=0.1, frames_per_trigger=2):
+    """A stand-in for a FlomniFermatScan instance with a device list {name: deviceClass} and the loop-settings
+    device answering /api/settings/apply."""
+    scan = mock.MagicMock()
+    scan.BEAMLINE_DEVICES = FlomniFermatScan.BEAMLINE_DEVICES
+    scan.device_manager.devices = {
+        name: mock.MagicMock(_config={"deviceClass": cls}) for name, cls in devices.items()
+    }
+    scan.exp_time = exp_time
+    scan.frames_per_trigger = frames_per_trigger
+    if apply_exc is not None:
+        scan.dev.flomni_loop_settings.api_post.side_effect = apply_exc
+    else:
+        scan.dev.flomni_loop_settings.api_post.return_value = (
+            apply_result if apply_result is not None else {"ok": True, "errors": []}
+        )
+    scan.at_beamline = lambda: FlomniFermatScan.at_beamline(scan)
+    return scan
+
+
+SIM_DDG1 = "csaxs_bec.devices.sim.simulated_beamline_devices.SimulatedDDG1"
+REAL_DDG1 = "csaxs_bec.devices.epics.delay_generator_csaxs.DDG1"
+MOTOR = "ophyd_devices.devices.psi_motor.EpicsUserMotorVME"
+
+
+def test_at_beamline_detection():
+    assert FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": SIM_DDG1}))[0] is False
+    assert FlomniFermatScan.at_beamline(_trigger_stub({}))[0] is False
+    assert FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": REAL_DDG1}))[0] is True
+    # a beamline-only device counts even with a simulated ddg1
+    at_bl, reason = FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": SIM_DDG1, "ebtrx": MOTOR}))
+    assert at_bl is True and "ebtrx" in reason
+    # a failing check counts as beamline (hardware trigger is the fallback)
+    scan = _trigger_stub({})
+    scan.device_manager.devices = None
+    assert FlomniFermatScan.at_beamline(scan)[0] is True
+
+
+def test_trigger_source_soft_away_from_beamline():
+    scan = _trigger_stub({"ddg1": SIM_DDG1}, exp_time=0.1, frames_per_trigger=2)
+    FlomniFermatScan.set_trigger_source(scan)
+    path, body = scan.dev.flomni_loop_settings.api_post.call_args[0]
+    assert path == "/api/settings/apply"
+    assert body["changes"]["trigger_soft"] == 1
+    assert abs(body["changes"]["soft_exposure_ms"] - 200.0) < 1e-9
+
+
+def test_trigger_source_hardware_at_beamline():
+    scan = _trigger_stub({"ddg1": REAL_DDG1, "ebtry": MOTOR})
+    FlomniFermatScan.set_trigger_source(scan)
+    body = scan.dev.flomni_loop_settings.api_post.call_args[0][1]
+    assert body["changes"] == {"trigger_soft": 0}
+
+
+def test_trigger_source_not_confirmed_at_beamline_aborts():
+    scan = _trigger_stub({"ddg1": REAL_DDG1}, apply_exc=RuntimeError("web HMI not reachable"))
+    with pytest.raises(ScanAbortion, match="hardware trigger must be confirmed"):
+        FlomniFermatScan.set_trigger_source(scan)
+    scan = _trigger_stub({"ddg1": REAL_DDG1}, apply_result={"ok": False, "errors": ["a scan is running"]})
+    with pytest.raises(ScanAbortion, match="a scan is running"):
+        FlomniFermatScan.set_trigger_source(scan)
+
+
+def test_trigger_source_failure_away_only_warns():
+    scan = _trigger_stub({"ddg1": SIM_DDG1}, apply_exc=RuntimeError("web HMI not reachable"))
+    FlomniFermatScan.set_trigger_source(scan)
+    scan.device_manager.connector.raise_alarm.assert_called_once()

From 6e0ffa3b7484a935bcb7052ba747da09b602328c Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 27 Oct 2026 08:52:18 +0100
Subject: [PATCH 099/102] fix(flomni): beamline detection for the trigger
 source by ddg1 only (exposure box motors removed)

Mirko 2026-10-27: a real (not simulated) ddg1 is sufficient. Simulated or no ddg1 -> soft trigger;
a failing check still counts as beamline (hardware trigger). Docs + PDF.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_017KicuVBRC7jB1TLG5hLZwx
---
 .../local_contact_only-realtime_system.md     |   9 ++++----
 .../local_contact_only-realtime_system.pdf    | Bin 68928 -> 68826 bytes
 csaxs_bec/scans/flomni_fermat_scan.py         |  20 +++++-------------
 tests/tests_scans/test_flomni_fermat_scan.py  |   6 ++----
 4 files changed, 11 insertions(+), 24 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
index eb9d1348..e3417883 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.md
@@ -70,11 +70,10 @@ default and is in no profile (flOMNI `FeedbackLoop/soft_trigger.md`).
 **`flomni_fermat_scan` sets the trigger source at every scan start** (2026-10-26):
 
 - **At the beamline → hardware.** At the beamline means: `ddg1` is configured with a real (not simulated) device
-  class, or one of the exposure box motors `ebtrx`, `ebtry`, `ebtrz`, `ebsupport` is in the session. If this cannot
-  be confirmed (web HMI not reachable, refused) the scan is aborted: with the soft trigger the detector would not
-  be triggered while flOMNI exposes internally. A failing check also counts as beamline.
-- **Otherwise (simulated `ddg1`, no beamline devices) → soft** with `soft_exposure_ms` = `exp_time` ×
-  `frames_per_trigger` × 1000. If that fails the scan continues with a warning (alarm).
+  class (only `ddg1` decides, 2026-10-27). If this cannot be confirmed (web HMI not reachable, refused) the scan is
+  aborted: with the soft trigger the detector would not be triggered while flOMNI exposes internally. A failing check
+  also counts as beamline.
+- **Otherwise (simulated or no `ddg1`) → soft** with `soft_exposure_ms` = `exp_time` × `frames_per_trigger` × 1000. If that fails the scan continues with a warning (alarm).
 
 By hand: `flomni.rt_settings.trigger_set_soft(True, exposure_ms=100)`, `trigger_set_soft(False)`;
 `trigger_show()` shows both groups.
diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf b/csaxs_bec/bec_ipython_client/plugins/flomni/docs/local_contact_only-realtime_system.pdf
index fb4ee1d079799fbd89e6d0f3d9eb167cd334d639..f8f45098627fba1d97bccffc7001850d8bac5a7c 100644
GIT binary patch
delta 31102
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

delta 31221
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

diff --git a/csaxs_bec/scans/flomni_fermat_scan.py b/csaxs_bec/scans/flomni_fermat_scan.py
index 6cfac1bc..8d056a2a 100644
--- a/csaxs_bec/scans/flomni_fermat_scan.py
+++ b/csaxs_bec/scans/flomni_fermat_scan.py
@@ -69,10 +69,6 @@ class FlomniFermatScan(ScanBase):
     MAX_CORRIDOR_SIZE = 3  # Corridor size is capped at this value (in um) for stability
     MIN_FERMAT_ASYMMETRY = 0.1  # Practical working range for fermat_asymmetry (soft-clamped)
     MAX_FERMAT_ASYMMETRY = 10.0
-    # Devices that exist only in the beamline configuration (bl_endstation.yaml: exposure box motors); with one of
-    # them, or a ddg1 that is not simulated, the session is at the beamline -> hardware trigger (flOMNI soft trigger,
-    # FeedbackLoop/soft_trigger.md, 2026-10-26)
-    BEAMLINE_DEVICES = ("ebtrx", "ebtry", "ebtrz", "ebsupport")
 
     def __init__(
         # fmt: off
@@ -386,26 +382,20 @@ class FlomniFermatScan(ScanBase):
 
     def at_beamline(self) -> tuple[bool, str]:
         """
-        Is this session at the beamline? True when ddg1 is configured with a real (not simulated) device class or
-        one of BEAMLINE_DEVICES is configured; False only when both say no. A failing check counts as beamline,
-        so the hardware trigger is the fallback.
+        Is this session at the beamline? True when ddg1 is configured with a real (not simulated) device class
+        (flOMNI soft trigger, FeedbackLoop/soft_trigger.md; ddg1 only, Mirko 2026-10-27). A failing check counts as
+        beamline, so the hardware trigger is the fallback.
 
         Returns:
             (at_beamline, reason)
         """
         try:
             devices = self.device_manager.devices
-            reasons = []
             if "ddg1" in devices:
                 cls = str((getattr(devices["ddg1"], "_config", None) or {}).get("deviceClass", ""))
                 if ".sim." not in cls and "Simulated" not in cls:
-                    reasons.append(f"ddg1 is {cls or 'not simulated'}")
-            found = [name for name in self.BEAMLINE_DEVICES if name in devices]
-            if found:
-                reasons.append("beamline devices " + ", ".join(found))
-            if reasons:
-                return True, "; ".join(reasons)
-            return False, "no beamline devices, ddg1 simulated or absent"
+                    return True, f"ddg1 is {cls or 'not simulated'}"
+            return False, "ddg1 simulated or absent"
         except Exception as exc:  # pylint: disable=broad-except
             return True, f"beamline check failed ({exc}), treated as beamline"
 
diff --git a/tests/tests_scans/test_flomni_fermat_scan.py b/tests/tests_scans/test_flomni_fermat_scan.py
index 98a66823..c68101a8 100644
--- a/tests/tests_scans/test_flomni_fermat_scan.py
+++ b/tests/tests_scans/test_flomni_fermat_scan.py
@@ -162,7 +162,6 @@ def _trigger_stub(devices, apply_result=None, apply_exc=None, exp_time=0.1, fram
     """A stand-in for a FlomniFermatScan instance with a device list {name: deviceClass} and the loop-settings
     device answering /api/settings/apply."""
     scan = mock.MagicMock()
-    scan.BEAMLINE_DEVICES = FlomniFermatScan.BEAMLINE_DEVICES
     scan.device_manager.devices = {
         name: mock.MagicMock(_config={"deviceClass": cls}) for name, cls in devices.items()
     }
@@ -187,9 +186,8 @@ def test_at_beamline_detection():
     assert FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": SIM_DDG1}))[0] is False
     assert FlomniFermatScan.at_beamline(_trigger_stub({}))[0] is False
     assert FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": REAL_DDG1}))[0] is True
-    # a beamline-only device counts even with a simulated ddg1
-    at_bl, reason = FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": SIM_DDG1, "ebtrx": MOTOR}))
-    assert at_bl is True and "ebtrx" in reason
+    # only ddg1 decides: other devices (e.g. exposure box motors) do not count
+    assert FlomniFermatScan.at_beamline(_trigger_stub({"ddg1": SIM_DDG1, "ebtrx": MOTOR}))[0] is False
     # a failing check counts as beamline (hardware trigger is the fallback)
     scan = _trigger_stub({})
     scan.device_manager.devices = None

From bd2448b74671abe417c35a119cbffcf8bc9e195f Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 27 Oct 2026 20:32:05 +0100
Subject: [PATCH 100/102] fix(omny): remove
 OMNYTemperatures._set_TEMP_default_setpoints - defaults only in the
 controllers

The default setpoints are stored in the OMNY temperature controllers (EEPROM). The
second copy here could overwrite them; the OMNY service tempcontrol.py (mpc3217)
seeds the :SET PVs from the controllers and writes only real changes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01M8zoDvfTY6VYunNtWse9VZ
---
 csaxs_bec/devices/omny/omny_temperatures.py | 64 ++-------------------
 csaxs_bec/devices/sim/sim_omny.py           |  7 ++-
 2 files changed, 8 insertions(+), 63 deletions(-)

diff --git a/csaxs_bec/devices/omny/omny_temperatures.py b/csaxs_bec/devices/omny/omny_temperatures.py
index 0d4ecc74..34bd6817 100644
--- a/csaxs_bec/devices/omny/omny_temperatures.py
+++ b/csaxs_bec/devices/omny/omny_temperatures.py
@@ -18,7 +18,6 @@ class OMNYTemperatures(Device):
         "set_setpoint",
         "show_all",
         "help",
-        "_set_TEMP_default_setpoints",
         "temperature_controller_TEMP_running",
         "temperature_controller_CRYO_running",
     ]
@@ -96,65 +95,10 @@ class OMNYTemperatures(Device):
             raise OMNYTemperaturesError("invalid type")
 
 
-    def _set_TEMP_default_setpoints(self):
-        self.set_setpoint("TEMP",8,-199.9)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",9,23)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",10,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",16,-199.9)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",17,23)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",18,26)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",19,26)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",20,26)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",21,23)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",22,-199.9)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",23,-199.9)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",24,-199.9)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",25,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",27,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",28,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",29,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",30,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",31,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",35,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",36,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",37,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",38,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",39,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",41,30)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",42,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",44,25)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",45,-199.9)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",46,73.2)
-        time.sleep(0.1)
-        self.set_setpoint("TEMP",47,73.2)
-        time.sleep(0.1)
+    # The default setpoints are stored only in the temperature controllers (EEPROM); the
+    # former _set_TEMP_default_setpoints() kept a second copy here (removed 2026-10-27,
+    # decision Mirko). The OMNY service tempcontrol.py seeds the :SET PVs from the
+    # controllers and writes a setpoint only when a :SET value is changed (heated channels).
 
     def temperature_controller_TEMP_running(self):
         time_diff = np.fabs(float(self.temperature_update_time.get()) - time.time())
diff --git a/csaxs_bec/devices/sim/sim_omny.py b/csaxs_bec/devices/sim/sim_omny.py
index 458d3f17..4f392eca 100644
--- a/csaxs_bec/devices/sim/sim_omny.py
+++ b/csaxs_bec/devices/sim/sim_omny.py
@@ -318,9 +318,10 @@ class SimOMNYDewar(OMNYDewar):
 
 # OMNY temperature-controller channels ("TEMP" bank, channels 1-48), sourced from the
 # real OMNY_tempcontroller/tempcontrol.py channel config (name, EGU, ChanHeat, ALARMLIM)
-# cross-referenced against OMNYTemperatures._set_TEMP_default_setpoints()'s existing
-# per-channel setpoints (already in this repo, confirmed to cover exactly the same 29
-# channels -- the setpoint value below is copied from that method, not re-derived).
+# cross-referenced against the per-channel setpoints of the former
+# OMNYTemperatures._set_TEMP_default_setpoints() (removed 2026-10-27: the defaults live
+# only in the controllers; values checked against the controllers on mpc3217 the same
+# day -- 73.2 K here vs. -199.9 degC = 73.25 K there).
 # Sentinel setpoints ("no active control": -199.9 degC / 73.2 K, matching
 # tempcontrol.py's configure_device()'s unused-channel convention) mark monitor-only
 # channels (ChanHeat=0); those get a plausible physical reading instead of the sentinel.

From 495609dbd060674d243e576b3bf76885e5e6618f Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 27 Oct 2026 20:54:16 +0100
Subject: [PATCH 101/102] fix(omny): sample-storage widget shows the shuttle
 places as on the real shuttle (3 rows x 2: 1 2 / 3 4 / 5 6), also in the PDF
 report

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01M8zoDvfTY6VYunNtWse9VZ
---
 .../widgets/sample_storage/sample_storage.py        | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index 99f86b7a..d3a5b55c 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -130,6 +130,8 @@ EMPTY_LABEL = "— empty —"  # what an empty cell shows in the GUI
 # OMNY-specific layout
 OMNY_SHUTTLE_LETTERS = ("A", "B", "C")
 OMNY_SHUTTLE_SLOTS = tuple(range(1, 7))
+# places as on the real shuttle: 3 rows x 2 columns, 1 2 / 3 4 / 5 6 (Mirko 2026-10-27; was 2 x 3)
+OMNY_SHUTTLE_COLS = 2
 OMNY_FIXED_POSITIONS = (10, 11, 12, 13, 14, 32, 33, 34, 100, 101)
 OMNY_PARKING_SLOTS = tuple(range(1, 7))
 # OMNYSampleStorage.unset_shuttle_slot()'s own empty sentinel -- unlike sample
@@ -446,7 +448,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
       - Header: Stage and Gripper, right-click correctable
       - Grid: the 10 fixed O positions, right-click correctable
       - Three shuttle sections (A/B/C): installed/active status line
-        (right-click to assign/clear a parking slot) + a 6-slot grid,
+        (right-click to assign/clear a parking slot) + a 6-slot grid as on the
+        real shuttle (3 rows x 2 columns: 1 2 / 3 4 / 5 6),
         right-click correctable
       - Caveat line: records only, not hardware
 
@@ -999,7 +1002,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             slot_grid = QGridLayout()
             slot_grid.setSpacing(4)
             for idx, n in enumerate(OMNY_SHUTTLE_SLOTS):
-                r, c = divmod(idx, 3)
+                r, c = divmod(idx, OMNY_SHUTTLE_COLS)
                 key = ("shuttle", letter, n)
                 cell = _SlotCell(key, self, COLOR_SLOT_BORDER, caption=f"{letter}-{n}")
                 self._cells[key] = cell
@@ -1403,7 +1406,7 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             usable_w = pdf.w - 2 * margin
             cell_h = 28
 
-            # shuttles A/B/C: status line + 3-wide slot grid, side by side
+            # shuttles A/B/C: status line + slot grid as on the shuttle (3 rows x 2), side by side
             shuttle_y0 = pdf.get_y()
             shuttle_w = usable_w / 3
             for si, letter in enumerate(OMNY_SHUTTLE_LETTERS):
@@ -1419,9 +1422,9 @@ class OMNY_SampleStorage(BECWidget, QWidget):
                 pdf.set_font("Helvetica", "B", 9)
                 pdf.cell(shuttle_w, 5, status_text, align="L")
 
-                slot_w = shuttle_w / 3
+                slot_w = shuttle_w / OMNY_SHUTTLE_COLS
                 for idx, n in enumerate(OMNY_SHUTTLE_SLOTS):
-                    r, c = divmod(idx, 3)
+                    r, c = divmod(idx, OMNY_SHUTTLE_COLS)
                     x = x0 + c * slot_w
                     y = shuttle_y0 + 6 + r * cell_h
                     key = ("shuttle", letter, n)

From 0dd14f6226f5b392d4f2d4b7226ec59f0943305e Mon Sep 17 00:00:00 2001
From: Mirko Holler <holler@xomny-ws-01.psi.ch>
Date: Tue, 27 Oct 2026 21:02:58 +0100
Subject: [PATCH 102/102] feat(omny, flomni): MEAS_ACCOUNT per sample record;
 OMNY status 'screened'

- set_sample_measured(..., account=...) stores the e-account of the status change in
  <slot>:MEAS_ACCOUNT; OWNER is no longer filled with the account (owner is free
  text now). Callers in omny.py/flomni.py pass bec.active_account. The account moves
  with the sample (transfer_sample) and is reset on load/clear.
- OMNY: status 'screened' when a sample leaves the sample stage (stage -> gripper)
  with status 'none', i.e. no tomoscan was started on it (Mirko 2026-10-27).
- widget: shows 'screened'; the P-touch label prints MEAS_ACCOUNT (owner as fallback
  for older records); CLI views show the account.
- IOCs: OMNY ioc_omny.py / flOMNI ioc_flomni.py got the MEAS_ACCOUNT field (and
  'screened' appended to the OMNY status enum), deployed on mpc3217 / mpc2844.
- tests/e2e harness updated (owner_if_empty replaced by account).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01M8zoDvfTY6VYunNtWse9VZ
---
 .../plugins/flomni/flomni.py                  |  4 +-
 .../bec_ipython_client/plugins/omny/omny.py   |  4 +-
 .../omny/omny_sample_transfer_mixin.py        | 15 ++++-
 .../widgets/sample_storage/sample_storage.py  | 24 ++++++--
 .../devices/omny/flomni_sample_storage.py     | 54 ++++++++++++------
 csaxs_bec/devices/omny/omny_sample_storage.py | 56 ++++++++++++-------
 omny_e2e_tests/sim_flomni_harness.py          | 11 ++--
 .../tests_devices/test_omny_sample_storage.py | 40 +++++++++----
 .../test_sim_omny_sample_storage_defaults.py  |  2 +-
 9 files changed, 147 insertions(+), 63 deletions(-)

diff --git a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
index 59df523e..4083f98f 100644
--- a/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
+++ b/csaxs_bec/bec_ipython_client/plugins/flomni/flomni.py
@@ -2788,7 +2788,7 @@ class Flomni(
                 0,
                 "started",
                 datetime.date.today().strftime("%Y-%m"),
-                owner_if_empty=bec.active_account or "",
+                account=bec.active_account or "",
             )
             self.write_pdf_report()
             # estimated_remaining_time/estimated_finish_time/accumulated_idle_time/
@@ -2988,7 +2988,7 @@ class Flomni(
             0,
             "completed",
             datetime.date.today().strftime("%Y-%m"),
-            owner_if_empty=bec.active_account or "",
+            account=bec.active_account or "",
         )
         timing_lines = self._build_timing_lines()
         for line in timing_lines[3:]:
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
index 16b67727..219d42b1 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny.py
@@ -1371,7 +1371,7 @@ class OMNY(
                 0,
                 "started",
                 datetime.date.today().strftime("%Y-%m"),
-                owner_if_empty=bec.active_account or "",
+                account=bec.active_account or "",
             )
             self.progress["tomo_start_time"] = datetime.datetime.now().isoformat()
             # reset stale estimates from any previous scan, otherwise the GUI
@@ -1565,7 +1565,7 @@ class OMNY(
             0,
             "completed",
             datetime.date.today().strftime("%Y-%m"),
-            owner_if_empty=bec.active_account or "",
+            account=bec.active_account or "",
         )
 
         idle_s = self.progress.get("accumulated_idle_time", 0.0)
diff --git a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
index 369397e6..bc11eca3 100644
--- a/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
+++ b/csaxs_bec/bec_ipython_client/plugins/omny/omny_sample_transfer_mixin.py
@@ -1,3 +1,4 @@
+import datetime
 import os
 import time
 import builtins
@@ -1234,9 +1235,9 @@ class OMNYSampleTransferMixin:
         return dev.omny_samples.get_sample_name_and_owner(container, slot_nr)
 
     def otransfer_set_sample_measured(
-        self, container: str, slot_nr: int, status: str, meas_date: str, owner_if_empty: str = ""
+        self, container: str, slot_nr: int, status: str, meas_date: str, account: str = ""
     ):
-        return dev.omny_samples.set_sample_measured(container, slot_nr, status, meas_date, owner_if_empty)
+        return dev.omny_samples.set_sample_measured(container, slot_nr, status, meas_date, account)
 
     def otransfer_get_sample_status(self, container: str, slot_nr: int) -> str:
         return dev.omny_samples.get_sample_status(container, slot_nr)
@@ -1439,6 +1440,16 @@ class OMNYSampleTransferMixin:
             if dev.omny_samples.is_sample_in_samplestage():
                 if _picked_it:
                     dev.omny_samples.transfer_sample("STAGE", "GRIPPER")
+                    # leaving the sample stage without a tomoscan having been started on it:
+                    # "screened" (Mirko 2026-10-27); a started/completed status is kept
+                    if dev.omny_samples.get_sample_status("GRIPPER") == "none":
+                        dev.omny_samples.set_sample_measured(
+                            "GRIPPER",
+                            0,
+                            "screened",
+                            datetime.date.today().strftime("%Y-%m"),
+                            account=bec.active_account or "",
+                        )
                     # FZP was picked
                     # if (_osampleposition == 10 || _osampleposition == 11 || _osampleposition == 100)
                     #  _otransfer_modify_sample("omny",110,2,samplename)
diff --git a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
index d3a5b55c..ad5a8a14 100644
--- a/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
+++ b/csaxs_bec/bec_widgets/widgets/sample_storage/sample_storage.py
@@ -331,7 +331,7 @@ class _SlotCell(QFrame):
     ) -> None:
         """Update the cell's displayed state (called by the poll/refresh).
 
-        `measured_status` is "started"/"completed" (FLOMNI-SAMPLE:<slot>:STATUS)
+        `measured_status` is "started"/"completed" (OMNY also "screened") (FLOMNI-SAMPLE:<slot>:STATUS)
         (OMNY: OMNY-SAMPLE:<slot>:STATUS) or None if this slot's current
         occupant has no measured record, which the measured label below
         renders as blank.
@@ -356,6 +356,10 @@ class _SlotCell(QFrame):
                 # wording that implies live progress.
                 self._lbl_measured.setText("◐ started")
                 self._lbl_measured.setStyleSheet("font-size: 10px; color: #ef6c00;")
+            elif measured_status == "screened":
+                # OMNY only (2026-10-27): was on the sample stage, no tomoscan started
+                self._lbl_measured.setText("○ screened")
+                self._lbl_measured.setStyleSheet("font-size: 10px; color: #1565c0;")
             else:
                 self._lbl_measured.setText("")
         else:
@@ -613,7 +617,12 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             owner = _val(f"omny_samples_sample_owners_{slot}", "") or ""
             raw = _val(f"omny_samples_sample_status_{slot}")
             status = str(raw) if raw is not None else ""
-            return (used, str(name), str(owner), status if used and status in ("started", "completed") else None)
+            return (
+                used,
+                str(name),
+                str(owner),
+                status if used and status in ("started", "completed", "screened") else None,
+            )
 
         state: dict[tuple, tuple[bool, str, str, Optional[str]]] = {}
         state[("stage",)] = _record("STAGE")
@@ -693,7 +702,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if reply != QMessageBox.StandardButton.Yes:
             return
         fields = {
-            PTOUCH_FIELD_ACCOUNT: record["owner"],
+            # account of the measurement (MEAS_ACCOUNT, 2026-10-27); older records: the owner
+            PTOUCH_FIELD_ACCOUNT: record.get("meas_account") or record["owner"],
             PTOUCH_FIELD_DATE: record["meas_date"],
             PTOUCH_FIELD_SAMPLENAME: prev_name,
         }
@@ -738,7 +748,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
 
         Status, owner and measurement date live on the slot record itself
         (OMNY-SAMPLE:<slot>:..., as FlOMNI), read fresh from the device right
-        before the clear; the owner is printed as account, as on FlOMNI.
+        before the clear; the account of the measurement (MEAS_ACCOUNT) is printed, the owner
+        only for records without one.
         """
         assert key[0] == "shuttle"
         _, letter, n = key
@@ -763,7 +774,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
         if reply != QMessageBox.StandardButton.Yes:
             return
         fields = {
-            PTOUCH_FIELD_ACCOUNT: record["owner"],
+            # account of the measurement (MEAS_ACCOUNT, 2026-10-27); older records: the owner
+            PTOUCH_FIELD_ACCOUNT: record.get("meas_account") or record["owner"],
             PTOUCH_FIELD_DATE: record["meas_date"],
             PTOUCH_FIELD_SAMPLENAME: prev_name,
         }
@@ -1463,6 +1475,8 @@ class OMNY_SampleStorage(BECWidget, QWidget):
             marker = "measured"
         elif measured_status == "started":
             marker = "started"
+        elif measured_status == "screened":
+            marker = "screened"
         pdf.set_xy(x + 1, y + h - 6)
         pdf.set_font("Helvetica", "", 7)
         pdf.cell(w - 2, 4, marker, align="C")
diff --git a/csaxs_bec/devices/omny/flomni_sample_storage.py b/csaxs_bec/devices/omny/flomni_sample_storage.py
index 2ccce0c8..493ddc61 100644
--- a/csaxs_bec/devices/omny/flomni_sample_storage.py
+++ b/csaxs_bec/devices/omny/flomni_sample_storage.py
@@ -4,9 +4,11 @@ One record per slot, all fields autosaved by the IOC::
 
     FLOMNI-SAMPLE:<slot>:USED       0 = free, 1 = sample present
     FLOMNI-SAMPLE:<slot>:NAME       sample name (long string, up to 256 chars)
-    FLOMNI-SAMPLE:<slot>:OWNER      e-account of the owner
+    FLOMNI-SAMPLE:<slot>:OWNER      owner of the sample (free text, not necessarily an e-account)
     FLOMNI-SAMPLE:<slot>:STATUS     none / started / completed (measurement status)
     FLOMNI-SAMPLE:<slot>:MEAS_DATE  date of the measurement
+    FLOMNI-SAMPLE:<slot>:MEAS_ACCOUNT  e-account active when the measurement status was last set
+                                    (2026-10-27; before, it went into OWNER if that was empty)
 
     <slot> = STAGE (slot 0, the flOMNI sample stage), T01 ... T20 (tray slots 1-20),
              GRIPPER (slot 100)
@@ -72,6 +74,7 @@ class FlomniSampleStorage(Device):
         "get_sample_name_and_owner",
         "get_sample_status",
         "get_sample_meas_date",
+        "get_sample_meas_account",
         "get_sample_record",
         "set_sample_measured",
         "transfer_sample",
@@ -86,6 +89,7 @@ class FlomniSampleStorage(Device):
     sample_owners = Dcpt(_slot_signals("OWNER", string=True))
     sample_status = Dcpt(_slot_signals("STATUS", string=True))
     sample_meas_date = Dcpt(_slot_signals("MEAS_DATE", string=True))
+    sample_meas_account = Dcpt(_slot_signals("MEAS_ACCOUNT", string=True))
 
     # gripper (slot 100)
     sample_in_gripper = Cpt(EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:USED", auto_monitor=True)
@@ -101,6 +105,9 @@ class FlomniSampleStorage(Device):
     sample_in_gripper_meas_date = Cpt(
         EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:MEAS_DATE", string=True, auto_monitor=True
     )
+    sample_in_gripper_meas_account = Cpt(
+        EpicsSignal, read_pv=f"{PV_PREFIX}GRIPPER:MEAS_ACCOUNT", string=True, auto_monitor=True
+    )
 
     def __init__(self, prefix="", *, name, **kwargs):
         super().__init__(prefix, name=name, **kwargs)
@@ -130,6 +137,7 @@ class FlomniSampleStorage(Device):
                 "owner": self.sample_in_gripper_owner,
                 "status": self.sample_in_gripper_status,
                 "meas_date": self.sample_in_gripper_meas_date,
+                "meas_account": self.sample_in_gripper_meas_account,
             }[field]
         group = {
             "used": self.sample_placed,
@@ -137,6 +145,7 @@ class FlomniSampleStorage(Device):
             "owner": self.sample_owners,
             "status": self.sample_status,
             "meas_date": self.sample_meas_date,
+            "meas_account": self.sample_meas_account,
         }[field]
         return getattr(group, f"sample{slot_nr}")
 
@@ -145,7 +154,7 @@ class FlomniSampleStorage(Device):
         return "" if val is None else str(val)
 
     # ── write ────────────────────────────────────────────────────────────────
-    def _write(self, slot_nr: int, used: int, name: str, owner: str, status: str, meas_date: str):
+    def _write(self, slot_nr: int, used: int, name: str, owner: str, status: str, meas_date: str, meas_account: str = ""):
         if status not in STATUS_VALUES:
             raise FlomniSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
         name = name if name else EMPTY_NAME
@@ -154,13 +163,20 @@ class FlomniSampleStorage(Device):
         self._sig("owner", slot_nr).set(owner or "").wait(timeout=5)
         self._sig("status", slot_nr).set(status).wait(timeout=5)
         self._sig("meas_date", slot_nr).set(meas_date or "").wait(timeout=5)
+        self._sig("meas_account", slot_nr).set(meas_account or "").wait(timeout=5)
         self._sig("used", slot_nr).set(int(used)).wait(timeout=5)
 
     def set_sample_slot(
-        self, slot_nr: int, name: str, owner: str = "", status: str = STATUS_NONE, meas_date: str = ""
+        self,
+        slot_nr: int,
+        name: str,
+        owner: str = "",
+        status: str = STATUS_NONE,
+        meas_date: str = "",
+        meas_account: str = "",
     ):
         """Place a sample record in slot `slot_nr` (0-20, or 100 = gripper)."""
-        self._write(slot_nr, 1, name, owner, status, meas_date)
+        self._write(slot_nr, 1, name, owner, status, meas_date, meas_account)
 
     def unset_sample_slot(self, slot_nr: int):
         """Clear slot `slot_nr` (0-20, or 100 = gripper)."""
@@ -172,25 +188,26 @@ class FlomniSampleStorage(Device):
     def unset_sample_in_gripper(self):
         self.unset_sample_slot(GRIPPER_SLOT)
 
-    def set_sample_measured(self, slot_nr: int, status: str, meas_date: str, owner_if_empty: str = ""):
-        """Record the measurement status/date of the sample in `slot_nr`.
-
-        If the sample has no owner yet, `owner_if_empty` (e.g. the active
-        e-account) is stored as owner -- the label printed when a measured
-        sample is cleared uses the owner as account.
+    def set_sample_measured(self, slot_nr: int, status: str, meas_date: str, account: str = ""):
+        """Record the measurement status/date of the sample in `slot_nr` and the
+        e-account it happened in (`account`, e.g. bec.active_account) in MEAS_ACCOUNT.
+        The owner is not touched (2026-10-27: owner and measurement account are
+        separate fields; before, the account was stored as owner when it was empty).
         """
         if status not in STATUS_VALUES:
             raise FlomniSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
-        if owner_if_empty and not self.get_sample_owner(slot_nr):
-            self._sig("owner", slot_nr).set(owner_if_empty).wait(timeout=5)
         self._sig("status", slot_nr).set(status).wait(timeout=5)
         self._sig("meas_date", slot_nr).set(meas_date or "").wait(timeout=5)
+        if account:
+            self._sig("meas_account", slot_nr).set(account).wait(timeout=5)
 
     def transfer_sample(self, from_slot: int, to_slot: int):
-        """Move the complete record (name, owner, status, date) from one slot to
-        another (0-20, 100 = gripper) and clear the source slot."""
+        """Move the complete record (name, owner, status, date, account) from one slot
+        to another (0-20, 100 = gripper) and clear the source slot."""
         rec = self.get_sample_record(from_slot)
-        self.set_sample_slot(to_slot, rec["name"], rec["owner"], rec["status"], rec["meas_date"])
+        self.set_sample_slot(
+            to_slot, rec["name"], rec["owner"], rec["status"], rec["meas_date"], rec["meas_account"]
+        )
         self.unset_sample_slot(from_slot)
 
     # ── read ─────────────────────────────────────────────────────────────────
@@ -217,6 +234,9 @@ class FlomniSampleStorage(Device):
     def get_sample_meas_date(self, slot_nr) -> str:
         return self._str(self._sig("meas_date", slot_nr).get())
 
+    def get_sample_meas_account(self, slot_nr) -> str:
+        return self._str(self._sig("meas_account", slot_nr).get())
+
     def get_sample_record(self, slot_nr) -> dict:
         return {
             "used": self.is_sample_slot_used(slot_nr),
@@ -224,6 +244,7 @@ class FlomniSampleStorage(Device):
             "owner": self.get_sample_owner(slot_nr),
             "status": self.get_sample_status(slot_nr),
             "meas_date": self.get_sample_meas_date(slot_nr),
+            "meas_account": self.get_sample_meas_account(slot_nr),
         }
 
     def show_all(self):
@@ -235,7 +256,8 @@ class FlomniSampleStorage(Device):
             text = f"  (owner: {owner})" if owner else ""
             if status != STATUS_NONE:
                 date = self.get_sample_meas_date(slot_nr)
-                text += f"  [measured: {status}{', ' + date if date else ''}]"
+                account = self.get_sample_meas_account(slot_nr)
+                text += f"  [measured: {status}{', ' + date if date else ''}{', ' + account if account else ''}]"
             return text
 
         t = PrettyTable()
diff --git a/csaxs_bec/devices/omny/omny_sample_storage.py b/csaxs_bec/devices/omny/omny_sample_storage.py
index 8cf31d0a..e5e284e0 100644
--- a/csaxs_bec/devices/omny/omny_sample_storage.py
+++ b/csaxs_bec/devices/omny/omny_sample_storage.py
@@ -5,9 +5,12 @@ One record per slot, all fields autosaved by the IOC (same layout as flOMNI's
 
     OMNY-SAMPLE:<slot>:USED       0 = free, 1 = sample present
     OMNY-SAMPLE:<slot>:NAME       sample name (long string, up to 256 chars)
-    OMNY-SAMPLE:<slot>:OWNER      e-account of the owner
-    OMNY-SAMPLE:<slot>:STATUS     none / started / completed (measurement status)
-    OMNY-SAMPLE:<slot>:MEAS_DATE  date of the measurement
+    OMNY-SAMPLE:<slot>:OWNER      owner of the sample (free text, not necessarily an e-account)
+    OMNY-SAMPLE:<slot>:STATUS     none / screened / started / completed (measurement status;
+                                  screened = was on the sample stage, no tomoscan started)
+    OMNY-SAMPLE:<slot>:MEAS_DATE  date of the measurement (of the last status change)
+    OMNY-SAMPLE:<slot>:MEAS_ACCOUNT  e-account active when the status was last raised
+                                  (2026-10-27; before, the account went into OWNER if it was empty)
 
     <slot> (container, slot_nr of this device in brackets):
       A1..A6, B1..B6, C1..C6   shuttles      ("A".."C", 1-6)
@@ -47,8 +50,9 @@ NO_SHUTTLE = "none"
 STATUS_NONE = "none"
 STATUS_STARTED = "started"
 STATUS_COMPLETED = "completed"
-STATUS_VALUES = (STATUS_NONE, STATUS_STARTED, STATUS_COMPLETED)
-FIELDS = ("used", "name", "owner", "status", "meas_date")
+STATUS_SCREENED = "screened"   # was on the sample stage, no tomoscan started (2026-10-27)
+STATUS_VALUES = (STATUS_NONE, STATUS_STARTED, STATUS_COMPLETED, STATUS_SCREENED)
+FIELDS = ("used", "name", "owner", "status", "meas_date", "meas_account")
 
 # every sample slot of the IOC that this device handles, by PV slot name
 SAMPLE_SLOTS = (
@@ -118,6 +122,7 @@ class OMNYSampleStorage(Device):
         "get_sample_name_and_owner",
         "get_sample_status",
         "get_sample_meas_date",
+        "get_sample_meas_account",
         "get_sample_record",
         "set_sample_measured",
         "transfer_sample",
@@ -139,6 +144,7 @@ class OMNYSampleStorage(Device):
     sample_owners = Dcpt(_sample_signals("owner"))
     sample_status = Dcpt(_sample_signals("status"))
     sample_meas_date = Dcpt(_sample_signals("meas_date"))
+    sample_meas_account = Dcpt(_sample_signals("meas_account"))
 
     # parking slots 1-6: which shuttle (letter in NAME) is docked
     parking_placed = Dcpt(_parking_signals("used"))
@@ -161,6 +167,7 @@ class OMNYSampleStorage(Device):
             "owner": self.sample_owners,
             "status": self.sample_status,
             "meas_date": self.sample_meas_date,
+            "meas_account": self.sample_meas_account,
         }[field]
         return getattr(group, slot)
 
@@ -176,7 +183,7 @@ class OMNYSampleStorage(Device):
         return "" if val is None else str(val)
 
     # ── write ────────────────────────────────────────────────────────────────
-    def _write(self, slot: str, used: int, name: str, owner: str, status: str, meas_date: str):
+    def _write(self, slot: str, used: int, name: str, owner: str, status: str, meas_date: str, meas_account: str = ""):
         if status not in STATUS_VALUES:
             raise OMNYSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
         name = name if name else EMPTY_NAME
@@ -185,6 +192,7 @@ class OMNYSampleStorage(Device):
         self._sig("owner", slot).set(owner or "").wait(timeout=5)
         self._sig("status", slot).set(status).wait(timeout=5)
         self._sig("meas_date", slot).set(meas_date or "").wait(timeout=5)
+        self._sig("meas_account", slot).set(meas_account or "").wait(timeout=5)
         self._sig("used", slot).set(int(used)).wait(timeout=5)
 
     def set_sample_slot(
@@ -195,9 +203,10 @@ class OMNYSampleStorage(Device):
         owner: str = "",
         status: str = STATUS_NONE,
         meas_date: str = "",
+        meas_account: str = "",
     ):
         """Place a sample record in (container, slot_nr): A/B/C 1-6, O 10-14/32-34/100/101."""
-        self._write(slot_name(container, slot_nr), 1, name, owner, status, meas_date)
+        self._write(slot_name(container, slot_nr), 1, name, owner, status, meas_date, meas_account)
 
     def unset_sample_slot(self, container: str, slot_nr: int):
         """Clear (container, slot_nr)."""
@@ -217,30 +226,29 @@ class OMNYSampleStorage(Device):
     def unset_sample_in_samplestage(self):
         self.unset_sample_slot(STAGE, 0)
 
-    def set_sample_measured(self, container: str, slot_nr: int, status: str, meas_date: str, owner_if_empty: str = ""):
+    def set_sample_measured(self, container: str, slot_nr: int, status: str, meas_date: str, account: str = ""):
         """Record the measurement status/date of the sample in (container, slot_nr)
-        (container "STAGE" for the sample stage).
-
-        If the sample has no owner yet, `owner_if_empty` (e.g. the active
-        e-account) is stored as owner -- the label printed when a measured
-        sample is cleared uses the owner as account.
+        (container "STAGE" for the sample stage) and the e-account it happened in
+        (`account`, e.g. bec.active_account) in MEAS_ACCOUNT. The owner is not
+        touched (2026-10-27: owner and measurement account are separate fields;
+        before, the account was stored as owner when the owner was empty).
         """
         if status not in STATUS_VALUES:
             raise OMNYSampleStorageError(f"Invalid status {status!r}, expected one of {STATUS_VALUES}.")
         slot = slot_name(container, slot_nr)
-        if owner_if_empty and not self._str(self._sig("owner", slot).get()):
-            self._sig("owner", slot).set(owner_if_empty).wait(timeout=5)
         self._sig("status", slot).set(status).wait(timeout=5)
         self._sig("meas_date", slot).set(meas_date or "").wait(timeout=5)
+        if account:
+            self._sig("meas_account", slot).set(account).wait(timeout=5)
 
     def transfer_sample(self, from_slot, to_slot):
-        """Move the complete record (name, owner, status, date) from one slot to
+        """Move the complete record (name, owner, status, date, account) from one slot to
         another and clear the source. Slots as (container, slot_nr) tuples or slot
         names: e.g. transfer_sample(("A", 3), "GRIPPER"), transfer_sample("GRIPPER", "STAGE")."""
         src = slot_name(*from_slot) if isinstance(from_slot, tuple) else slot_name(from_slot)
         dst = slot_name(*to_slot) if isinstance(to_slot, tuple) else slot_name(to_slot)
         rec = self.get_sample_record(src)
-        self._write(dst, 1, rec["name"], rec["owner"], rec["status"], rec["meas_date"])
+        self._write(dst, 1, rec["name"], rec["owner"], rec["status"], rec["meas_date"], rec["meas_account"])
         self._write(src, 0, EMPTY_NAME, "", STATUS_NONE, "")
 
     def set_shuttle_slot(self, container: str, slot_nr: int):
@@ -281,6 +289,9 @@ class OMNYSampleStorage(Device):
     def get_sample_meas_date(self, container: str, slot_nr: int = 0) -> str:
         return self._str(self._sig("meas_date", slot_name(container, slot_nr)).get())
 
+    def get_sample_meas_account(self, container: str, slot_nr: int = 0) -> str:
+        return self._str(self._sig("meas_account", slot_name(container, slot_nr)).get())
+
     def get_sample_record(self, container: str, slot_nr: int = 0) -> dict:
         return {
             "used": self.is_sample_slot_used(container, slot_nr),
@@ -288,6 +299,7 @@ class OMNYSampleStorage(Device):
             "owner": self.get_sample_owner(container, slot_nr),
             "status": self.get_sample_status(container, slot_nr),
             "meas_date": self.get_sample_meas_date(container, slot_nr),
+            "meas_account": self.get_sample_meas_account(container, slot_nr),
         }
 
     def get_sample_name_in_gripper(self) -> str:
@@ -332,11 +344,15 @@ class OMNYSampleStorage(Device):
         owner = self.get_sample_owner(container, slot_nr)
         status = self.get_sample_status(container, slot_nr)
         date = self.get_sample_meas_date(container, slot_nr)
+        account = self.get_sample_meas_account(container, slot_nr)
         suffix = f" ({owner})" if owner else ""
-        if status == STATUS_STARTED:
-            suffix += "  ◐ started" + (f" {date}" if date else "")
+        when = (f" {date}" if date else "") + (f" [{account}]" if account else "")
+        if status == STATUS_SCREENED:
+            suffix += "  ○ screened" + when
+        elif status == STATUS_STARTED:
+            suffix += "  ◐ started" + when
         elif status == STATUS_COMPLETED:
-            suffix += "  ✓ completed" + (f" {date}" if date else "")
+            suffix += "  ✓ completed" + when
         return name + suffix
 
     def show_all(self):
diff --git a/omny_e2e_tests/sim_flomni_harness.py b/omny_e2e_tests/sim_flomni_harness.py
index 709d5149..0918b62c 100644
--- a/omny_e2e_tests/sim_flomni_harness.py
+++ b/omny_e2e_tests/sim_flomni_harness.py
@@ -461,10 +461,13 @@ def main():  # noqa: C901
         "gripper -> slot move carries the status",
     )
     samples.unset_sample_slot(5)
-    # set_sample_measured fills an empty owner (label printing uses the owner as account)
-    samples.set_sample_slot(6, "no_owner_sample")
-    samples.set_sample_measured(6, "started", "2026-10", owner_if_empty="e99999")
-    check(samples.get_sample_owner(6) == "e99999", "owner_if_empty fills an empty owner")
+    # set_sample_measured stores the measurement account separately, the owner is kept
+    samples.set_sample_slot(6, "owned_sample", "Group XY")
+    samples.set_sample_measured(6, "started", "2026-10", account="e99999")
+    check(
+        samples.get_sample_owner(6) == "Group XY" and samples.get_sample_meas_account(6) == "e99999",
+        "set_sample_measured stores the account in MEAS_ACCOUNT, owner untouched",
+    )
     samples.unset_sample_slot(6)
 
     frame_a = ids_cam.cam.get_image_data()
diff --git a/tests/tests_devices/test_omny_sample_storage.py b/tests/tests_devices/test_omny_sample_storage.py
index 1b3ec4c9..817da5a1 100644
--- a/tests/tests_devices/test_omny_sample_storage.py
+++ b/tests/tests_devices/test_omny_sample_storage.py
@@ -1,4 +1,4 @@
-"""OMNYSampleStorage on the OMNY soft IOC records (OMNY-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE)."""
+"""OMNYSampleStorage on the OMNY soft IOC records (OMNY-SAMPLE:<slot>:USED/NAME/OWNER/STATUS/MEAS_DATE/MEAS_ACCOUNT)."""
 
 import pytest
 
@@ -40,6 +40,7 @@ def test_pv_names_match_the_ioc():
     assert OMNYSampleStorage.sample_names.defn["P100"][1] == "OMNY-SAMPLE:P100:NAME"
     assert OMNYSampleStorage.sample_status.defn["STAGE"][1] == "OMNY-SAMPLE:STAGE:STATUS"
     assert OMNYSampleStorage.sample_meas_date.defn["GRIPPER"][1] == "OMNY-SAMPLE:GRIPPER:MEAS_DATE"
+    assert OMNYSampleStorage.sample_meas_account.defn["A3"][1] == "OMNY-SAMPLE:A3:MEAS_ACCOUNT"
     assert OMNYSampleStorage.parking_names.defn["parking3"][1] == "OMNY-SAMPLE:PARK3:NAME"
     assert len(SAMPLE_SLOTS) == 18 + 10 + 2
 
@@ -47,7 +48,8 @@ def test_pv_names_match_the_ioc():
 def test_set_and_unset_slot(storage):
     storage.set_sample_slot("O", 32, "pin1", "e12345")
     assert storage.get_sample_record("O", 32) == {
-        "used": True, "name": "pin1", "owner": "e12345", "status": "none", "meas_date": ""}
+        "used": True, "name": "pin1", "owner": "e12345", "status": "none", "meas_date": "",
+        "meas_account": ""}
     storage.unset_sample_slot("O", 32)
     rec = storage.get_sample_record("O", 32)
     assert rec["used"] is False and rec["name"] == "-" and rec["owner"] == ""
@@ -55,23 +57,39 @@ def test_set_and_unset_slot(storage):
 
 def test_status_travels_with_the_sample(storage):
     storage.set_sample_slot("B", 2, "pin2", "e11111")
-    storage.set_sample_measured("B", 2, "completed", "2026-10")
+    storage.set_sample_measured("B", 2, "completed", "2026-10", account="e20001")
     storage.transfer_sample(("B", 2), "GRIPPER")
     storage.transfer_sample("GRIPPER", "STAGE")
     assert not storage.is_sample_slot_used("B", 2)
     assert not storage.is_sample_in_gripper()
     assert storage.get_sample_record("STAGE") == {
-        "used": True, "name": "pin2", "owner": "e11111", "status": "completed", "meas_date": "2026-10"}
+        "used": True, "name": "pin2", "owner": "e11111", "status": "completed", "meas_date": "2026-10",
+        "meas_account": "e20001"}
 
 
-def test_set_sample_measured_owner_if_empty(storage):
-    storage.set_sample_in_samplestage("pin3")
-    storage.set_sample_measured("STAGE", 0, "started", "2026-10", owner_if_empty="e22222")
-    assert storage.get_sample_owner_in_samplestage() == "e22222"
+def test_set_sample_measured_stores_the_account_not_the_owner(storage):
+    # owner (free text) and measurement account are separate fields (2026-10-27)
+    storage.set_sample_in_samplestage("pin3", "Group XY")
+    storage.set_sample_measured("STAGE", 0, "started", "2026-10", account="e22222")
+    assert storage.get_sample_owner_in_samplestage() == "Group XY"
     assert storage.get_sample_status_in_samplestage() == "started"
-    # an existing owner is kept
-    storage.set_sample_measured("STAGE", 0, "completed", "2026-10", owner_if_empty="e33333")
-    assert storage.get_sample_owner_in_samplestage() == "e22222"
+    assert storage.get_sample_meas_account("STAGE") == "e22222"
+    # the account of the latest status change is stored
+    storage.set_sample_measured("STAGE", 0, "completed", "2026-10", account="e33333")
+    assert storage.get_sample_meas_account("STAGE") == "e33333"
+    # no account given: the stored one is kept
+    storage.set_sample_measured("STAGE", 0, "completed", "2026-11")
+    assert storage.get_sample_meas_account("STAGE") == "e33333"
+    # loading a new sample resets status, date and account
+    storage.set_sample_in_samplestage("pin3b", "Group XY")
+    assert storage.get_sample_record("STAGE")["meas_account"] == ""
+
+
+def test_screened_status(storage):
+    storage.set_sample_slot("C", 4, "pin5", "someone")
+    storage.set_sample_measured("C", 4, "screened", "2026-10", account="e44444")
+    assert storage.get_sample_status("C", 4) == "screened"
+    assert storage.get_sample_meas_account("C", 4) == "e44444"
 
 
 def test_invalid_status_raises(storage):
diff --git a/tests/tests_devices/test_sim_omny_sample_storage_defaults.py b/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
index 66c0f910..48514498 100644
--- a/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
+++ b/tests/tests_devices/test_sim_omny_sample_storage_defaults.py
@@ -33,6 +33,6 @@ def test_default_samples_still_seeded_in_shuttle_a(storage):
 
 def test_untouched_slots_read_empty(storage):
     rec = storage.get_sample_record("O", 100)
-    assert rec == {"used": False, "name": "-", "owner": "", "status": "none", "meas_date": ""}
+    assert rec == {"used": False, "name": "-", "owner": "", "status": "none", "meas_date": "", "meas_account": ""}
     assert storage.get_sample_name_in_samplestage() == "sim_stage_sample"
     assert not storage.is_sample_in_gripper()