Add alignment gui 1d v1

Description

This MR adds a first draft for the alignment GUI. It is a preliminary version of the GUI which is not yet fully functional and can produce popup errors. Those are mostly link to its usage with its components which we will tackle in refactoring of the individual components. For the moment, I suggest to merge it and tackle the refactoring in separate MRs. A list of toDos will be added below.

Related Issues

relates to #350, #349 (closed), #348 (closed), #322 (closed), #323 (closed), #329 (closed)

Type of Change

• added plot_indicator_items (BECArrowItem and BECTickItem). They can be used to visualise the position of for instance a motor. The TickItem is attached to the layout and plotted below the Axis of the WaveformWidget, while the ArrowItem is attached to the plot_item allowing to follow the 1D curve or in future point to a specific pixel in the 2D plot. They consider log scale (note: the arrowItem is a bit off when moved to negative x values. There is a manual fix with the ViewBox.)
• added a button to the LMFitDialog that emits a signal with the parameter value of the fit. This can be hooked up to move the motor to the center position of the fit
• improves the linear region selector to consider logarithmic axis

Screenshots / GIFs (if applicable)

Plot Indicators:

Screen_Recording_2024-09-11_at_20.09.01

The full app is best tested with this branch. The recording was too large. Be aware, there are 3 prompt errors upon starting due to the filters in the comboboxes, and one more error if you change the motor. This is to be tackled via separate MRs.

Additional Comments

ToDo list for future improvements of the GUI:

• refactoring of filters for BECDeviceBox. Changing the filter after stating the GUI is generating errors because the currentTextChanged signal is already hooked up to adding a plot to the BECWaveformWidget. This creates issues since we cycle through devices that cannot be plotted, i.e. have no hinted signals/ no signals of type kind.normal/hinted at all. relates to these two issues #323 (closed) #322 (closed) #329 (closed)
• Related to the above, the logic for accepting device plot (scan_segment) and dap plots may be improved. Even with properly set filters, I would currently face the issue that I could change the x axis while a DAP process is still added with a different axis. This creates a popup error and removes the DAP. An easier logic to add/remove curves is desired and discussed in more detail, related issue is created (#349 (closed))
• Refactor of positioner_box to facilitate a more flexible arrangement of its components (#348 (closed) )
• Review LMFitDialog. A button has been added to the ListWidget for each parameter that can be hooked up to an action. This logic should be reviewed and optimised. Maybe we can generalise this even. (#350)

Definition of Done

• Documentation is up-to-date.

bec_widgets/utils/plot_indicator_items.py

@@ -13,16 +13,28 @@ class BECIndicatorItem(QObject):
         super().__init__(parent=parent)
         self.accent_colors = get_accent_colors()
         self.plot_item = plot_item
+        self._item_on_plot = False
         self._pos = None
         self.is_log_x = False
         self.is_log_y = False
 
+    @property
+    def item_on_plot(self) -> bool:
+        """Returns if the item is on the plot"""
+        return self._item_on_plot
+
+    @item_on_plot.setter
+    def item_on_plot(self, value: bool) -> None:
+        self._item_on_plot = value
+
     def add_to_plot(self) -> None:
         """Add the item to the plot"""
+        self.item_on_plot = True
         raise NotImplementedError("Method add_to_plot not implemented")
 
     def remove_from_plot(self) -> None:
         """Remove the item from the plot"""
+        self.item_on_plot = False
         raise NotImplementedError("Method remove_from_plot not implemented")
 
     def set_position(self, pos: tuple[float, float] | float) -> None:
@@ -35,11 +47,6 @@ class BECIndicatorItem(QObject):
         self.is_log_y = self.plot_item.ctrl.logYCheck.isChecked()
         self.set_position(self._pos)
 
-    def cleanup(self) -> None:
-        """Cleanup the item"""
-        self.remove_from_plot()
-        self.deleteLater()
-
 
 class BECTickItem(BECIndicatorItem):
     """Class to create a tick item which can be added to a pyqtgraph plot.
@@ -51,7 +58,7 @@ class BECTickItem(BECIndicatorItem):
 
     def __init__(self, plot_item: pg.PlotItem = None, parent=None):
         super().__init__(plot_item=plot_item, parent=parent)
-        self.tick_item = pg.TickSliderItem(allowAdd=False, allowRemove=False)
+        self.tick_item = pg.TickSliderItem(parent=parent, allowAdd=False, allowRemove=False)
         self.tick = None
         # Set _pos to float
         self._pos = 0
@@ -106,11 +113,24 @@ class BECTickItem(BECIndicatorItem):
             self.plot_item.vb.sigXRangeChanged.connect(self.update_range)
             self.plot_item.ctrl.logXCheck.checkStateChanged.connect(self.check_log)
             self.plot_item.ctrl.logYCheck.checkStateChanged.connect(self.check_log)
+            self.item_on_plot = True
 
     def remove_from_plot(self):
         """Remove the tick item from the view box or plot item."""
-        if self.plot_item.layout is not None:
-            self.plot_item.layout.removeItem(self.tick_item)
+        if self.plot_item is not None and self.item_on_plot is True:
+            self.plot_item.vb.sigXRangeChanged.disconnect(self.update_range)
+            self.plot_item.ctrl.logXCheck.checkStateChanged.disconnect(self.check_log)
+            self.plot_item.ctrl.logYCheck.checkStateChanged.disconnect(self.check_log)
+            if self.plot_item.layout is not None:
+                self.plot_item.layout.removeItem(self.tick_item)
+        self.item_on_plot = False
+
+    def cleanup(self) -> None:
+        """Cleanup the item"""
+        self.remove_from_plot()
+        if self.tick_item is not None:
+            self.tick_item.clear()
+            self.tick_item = None
 
 
 class BECArrowItem(BECIndicatorItem):
@@ -133,7 +153,7 @@ class BECArrowItem(BECIndicatorItem):
 
     def __init__(self, plot_item: pg.PlotItem = None, parent=None):
         super().__init__(plot_item=plot_item, parent=parent)
-        self.arrow_item = pg.ArrowItem()
+        self.arrow_item = pg.ArrowItem(parent=parent)
         self._pos = (0, 0)
 
     @Slot(dict)
@@ -183,14 +203,26 @@ class BECArrowItem(BECIndicatorItem):
             self.plot_item.addItem(self.arrow_item)
             self.plot_item.ctrl.logXCheck.checkStateChanged.connect(self.check_log)
             self.plot_item.ctrl.logYCheck.checkStateChanged.connect(self.check_log)
+            self.item_on_plot = True
 
     def remove_from_plot(self):
         """Remove the arrow item from the view box or plot item."""
-        if self.plot_item is not None:
+        if self.plot_item is not None and self.item_on_plot is True:
+            self.plot_item.ctrl.logXCheck.checkStateChanged.disconnect(self.check_log)
+            self.plot_item.ctrl.logYCheck.checkStateChanged.disconnect(self.check_log)
             self.plot_item.removeItem(self.arrow_item)
+        self.item_on_plot = False
 
     def check_log(self):
         """Checks if the x or y axis is in log scale and updates the internal state accordingly."""
         self.is_log_x = self.plot_item.ctrl.logXCheck.isChecked()
         self.is_log_y = self.plot_item.ctrl.logYCheck.isChecked()
         self.set_position(self._pos)
+
+    def cleanup(self) -> None:
+        """Cleanup the item"""
+        self.remove_from_plot()
+        if self.arrow_item is not None:
+            self.arrow_item.scene().removeItem(self.arrow_item)
+            self.arrow_item.clear()
+            self.arrow_item = None