1.5.1: win and ubuntu build, minor bugfixes, code restructuring

Co-authored-by: Cursor <[email protected]>

Author: PiMaV

.dockerignore

@@ -20,5 +20,4 @@ tests/
 scripts/
 TODO.md
 profile_load.prof
-pyinstaller_command.md
 resources/public/

.github/workflows/build.yml

@@ -76,6 +76,12 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install system dependencies
+        shell: bash
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgl1-mesa-glx libxcb-cursor0
+
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
@@ -162,10 +168,10 @@ jobs:
           git tag "$tag" "${{ github.sha }}"
           git push origin "$tag"
 
-      - name: Publish Release (tag created automatically on this commit)
+      - name: Publish Release
         uses: softprops/action-gh-release@v2
         with:
-          tag_name: ${{ needs.windows.outputs.tag }}
+          tag_name: ${{ github.event_name == 'workflow_dispatch' && needs.windows.outputs.tag || github.ref_name }}
           name: BLITZ ${{ needs.windows.outputs.version }}
           target_commitish: ${{ github.sha }}
           files: |

.gitignore

@@ -8,7 +8,8 @@ __pycache__/
 
 # BLITZ related stuff:
 _cache.ini
-# QSettings atomic-write temp files (leftover if app was killed during save)
+# QSettings and user config (created at CWD when app runs)
+settings.blitz
 settings.blitz.*
 boot_bench_results.json
 boot_bench_results/

TODO.md

@@ -2,15 +2,7 @@
 
 ## Known Issues (Bugs)
 
-*   **Timeline / Aggregation:**
-    *   Transition between Aggregate and Frame mode is not intuitive. Consider separate timelines?
-    *   "Running Mean" has issues.
-    *   Aggregate function is deactivated when starting a grayscale web stream (32 frames). Ops tab allows opening Aggregate, but Range is not initially FULL.
-    *   Switching from Aggregate to Frame mode causes an error in some cases.
-*   **Live View:**
-    *   Background Subtraction in Live Stream causes error messages.
-    *   RAM usage warning needed in Buffer Dialog.
-    *   Display FPS is currently fixed at 10 FPS; should be configurable.
+- ...
 
 ## High Priority Features
 
@@ -20,17 +12,16 @@
 
 ## Medium Priority
 
-*   **Dual-Build Setup:** Ability to build Standard and Full EXE.
-*   **CSV Converter:** Dialog with Preview, Column Selection -> .npy export.
-*   **Tests:** Expand tests for `ReduceDict` edge cases.
+*   **Dual-Build Setup:** Ability to build Standard and Full EXE (= Exotic Data flavours).
+*   **Proper Exporter:** Dialog with Options to export as *.npy or image for Raw / Pipeline / PCA data
 *   **RoSEE:** Check Isolines and normalization (Autozoom should activate).
 *   **Mouse Wheel Zoom:** Allow zooming only on one axis (in extraction plots?).
 *   **Docker:** Verify Docker deployment.
+*   **Ubuntu:** Verify Ubuntu deployment.
 
-## Low Priority / Long Term
+## Low Priority / Long Term / Discussion
 
-*   **Video Optimization:** Strategy for handling compressed video data vs. full float32 matrices (mmap, Chunked, Range-Load). See `docs/OPTIMIZATION.md`.
-*   **Project Files:** Restore Load/Save project file functionality (currently removed). See `docs/MISSING_FEATURES.md`.
+*   **Project Files:** Restore Load/Save project file functionality in a different way than before?. See `docs/MISSING_FEATURES.md`.
 
 ## Notes on "Missing" Features
 

benchmarks/bench_numba_full.py

@@ -200,7 +200,9 @@ def _print_results(times_numba, times_numpy):
 
 def main() -> None:
     # Use larger dimensions for more realistic benchmark
-    run_benchmark(T=200, H=512, W=512, C=1)
+    run_benchmark(T=200, H=512, W=512, C=1) # 200MB
+    # run_benchmark(T=300, H=800, W=600, C=1) # 580MB
+    # run_benchmark(T=500, H=1200, W=900, C=1) # 2.2GB
 
 
 if __name__ == "__main__":

blitz/layout/dialogs.py

@@ -1310,20 +1310,21 @@ def _start(self, HandlerClass) -> None:
         self._set_stream_controls_enabled(False)
 
     def _stop(self) -> None:
-        if self._handler is None:
+        handler = self._handler
+        self._handler = None  # clear immediately to avoid re-entrancy (e.g. closeEvent)
+        if handler is None:
             return
-        self._handler.stop()
-        if not self._handler.wait_stopped(4000):
+        handler.stop()
+        if not handler.wait_stopped(4000):
             from ..tools import log
             log("[CAM] Timeout beim Stoppen", color="orange")
         try:
             if self._on_frame:
-                self._handler.frame_ready.disconnect(self._on_frame)
-            self._handler.buffer_status.disconnect(self._on_buffer_status)
-            self._handler.buffer_time_span_sec.disconnect(self._on_buffer_time_span)
+                handler.frame_ready.disconnect(self._on_frame)
+            handler.buffer_status.disconnect(self._on_buffer_status)
+            handler.buffer_time_span_sec.disconnect(self._on_buffer_time_span)
         except (TypeError, RuntimeError):
             pass
-        self._handler = None
         self._buffer_actual_sec = None
         self._update_fps_label()
         if self._on_stop:

blitz/layout/main.py

@@ -1290,8 +1290,22 @@ def _update_bench_timer(self) -> None:
             self._bench_timer.stop()
             self.ui.label_bench_live.setText("")
 
+    def _sync_pca_target_comp_to_data(self) -> None:
+        """Update Target Comp max and default from current data (e.g. when PCA tab is shown)."""
+        data = getattr(self.ui.image_viewer, "data", None)
+        n_frames = max(1, data.n_images) if data else 1
+        target_max = min(n_frames, 500)
+        target = self.ui.spinbox_pcacomp_target
+        target.setMaximum(target_max)
+        current = target.value()
+        if current < 1 or current > target_max or (current == 1 and target_max > 1):
+            default_target = min(n_frames // 2, 50, target_max)
+            default_target = max(1, default_target)
+            target.setValue(default_target)
+        self._pca_update_target_spinner_state()
+
     def _on_option_tab_changed(self, index: int) -> None:
-        """Toggle LIVE indicator and timer when Bench tab visible."""
+        """Toggle LIVE indicator and timer when Bench tab visible. Sync PCA Target Comp when PCA tab shown."""
         bench_idx = getattr(
             self.ui, "bench_tab_index",
             self.ui.option_tabwidget.count() - 1,
@@ -1302,6 +1316,9 @@ def _on_option_tab_changed(self, index: int) -> None:
         else:
             self.ui.label_bench_live.setText("")
         self._update_bench_timer()
+        pca_idx = getattr(self.ui, "pca_tab_index", -1)
+        if index == pca_idx:
+            self._sync_pca_target_comp_to_data()
 
     def _bench_tick(self) -> None:
         """Sample CPU/RAM/Disk, feed shared BenchData, refresh Bench tab + compact (if shown)."""

blitz/layout/ui.py

@@ -961,6 +961,7 @@ def _set_timeline_splitter_sizes():
 
         pca_layout.addStretch()
         self.create_option_tab(pca_layout, "PCA")
+        self.pca_tab_index = self.option_tabwidget.count() - 1
 
         # --- Bench ---
         bench_layout = QVBoxLayout()

blitz/layout/viewer.py

@@ -274,7 +274,8 @@ def setImage(self, *args, keep_timestep: bool = False, skip_roi_init: bool = Fal
         self.image_changed.emit()
 
     def updateImage(self, autoHistogramRange: bool = False) -> None:
-        super().updateImage(autoHistogramRange)
+        """Override: when Auto fit is off, never recalc LUT on frame change (timeline click/drag)."""
+        super().updateImage(autoHistogramRange=self._auto_fit)
 
     def toggle_auto_colormap(self) -> None:
         self._auto_colormap = not self._auto_colormap
@@ -454,8 +455,9 @@ def unravel(self) -> None:
             autoRange=False,
             autoLevels=self._auto_fit,
         )
-        self.setLevels(min=mn, max=mx)
-        self.ui.histogram.setHistogramRange(mn, mx)
+        if self._auto_fit:
+            self.setLevels(min=mn, max=mx)
+            self.ui.histogram.setHistogramRange(mn, mx)
         self.image_size_changed.emit()
 
     def reduce(