Adds an EXPERIMENTAL, operator-only alternative to the extended-sample rotation-center click: instead of judging the center from a single instant of live rotation, accumulate a max-projection composite while lsamrot rotates continuously through a (tunable, default 360 deg) sweep. Off-axis features smear into circular arcs; the common center of curvature is the rotation axis, an easier target to click than one live frame. No automatic circle fitting -- purely a visual aid feeding the same _collect_click mechanism the production feature already uses. Rotation is issued non-blocking via scans.mv() (new local wrapper, sibling of this file's existing blocking umv()) and frames are grabbed via get_last_image() in a single-threaded loop polling ScanReport.status -- the same thing ScanReport.wait() does internally -- so no background thread or device-server change is needed to grab frames while the motor is actively moving. The composite is pushed to the GUI through the camera's existing PreviewSignal (dev.cam_xeye.image), duty-cycling live_mode_enabled off/on around each push so the background 5 Hz live thread can't immediately overwrite it. New entry point: lamni.xrayeye_rotation_center_calibration_smear_experimental(). Purely additive -- does not modify find_rotation_center()/_live_sweep() or the two production entry points. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Getting Started with Testing using pytest
BEC is using the pytest framework. It can be installed via
pip install pytest
in your python environment.
We note that pytest is part of the optional-dependencies [dev] of the plugin package.
Introduction
Tests in this package should be stored in the tests directory.
We suggest to sort tests of different submodules, i.e. scans or devices in the respective folder structure, and to folow a naming convention of <test_module_name.py>.
It is mandatory for test files to begin with test_ for pytest to discover them.
To run all tests, navigate to the directory of the plugin from the command line, and run the command
pytest -v --random-order ./tests
Note, the python environment needs to be active.
The additional arg -v allows pytest to run in verbose mode which provides more detailed information about the tests being run.
The argument --random-order instructs pytest to run the tests in random order, which is the default in the CI pipelines.
Test examples
Writing tests can be quite specific for the given function. We recommend writing tests as isolated as possible, i.e. try to test single functions instead of full classes. A very useful class to enable isolated testing is MagicMock. In addition, we also recommend to take a look at the How-to guides from pytest.