tomwer 1.3.26__py3-none-any.whl → 1.4.0__py3-none-any.whl

tomwer/gui/control/datavalidator.py

@@ -1,31 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["H. Payno"]
-__license__ = "MIT"
-__date__ = "23/07/2020"
+from __future__ import annotations
 
 
 import logging
@@ -38,7 +12,7 @@ from silx.gui import qt
 from tomwer.core.process.control.scanvalidator import ScanValidator as BaseDataValidator
 from tomwer.core.scan.scanbase import TomwerScanBase, _TomwerBaseDock
 from tomwer.core.scan.scanfactory import ScanFactory
-from tomwer.gui.qfolderdialog import QDataDialog
+from tomwer.gui.dialog.QDataDialog import QDataDialog
 from tomwer.gui.utils.waiterthread import QWaiterThread
 from tomwer.gui.visualization.dataviewer import DataViewer
 
@@ -293,15 +267,7 @@ class _ScanSelectorWidget(qt.QWidget):
 
 
 class _DataControlWidget(qt.QGroupBox):
-    """Set of buttons to control the curremt scan"""
-
-    """
-        Class containing all the validation buttons
-        and sending signals when they are pushed
-
-        :param QObject parent: the parent of the QTabWidget
-        :param :class:`.FtserieReconstruction`: the scan to display
-        """
+    """Set of buttons to control the current scan"""
 
     sigValidateScan = qt.Signal(str)
     sigCancelScan = qt.Signal(str)

tomwer/gui/control/datawatcher/__init__.py

@@ -1,31 +1,3 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["C. Nemoz", "H. Payno"]
-__license__ = "MIT"
-__date__ = "18/02/2018"
-
 
 from .datawatcher import DataWatcherWidget  # noqa F401

tomwer/gui/control/datawatcher/configuration.py

@@ -1,32 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["C. Nemoz", "H. Payno"]
-__license__ = "MIT"
-__date__ = "18/02/2018"
-
+from __future__ import annotations
 
 import functools
 

tomwer/gui/control/datawatcher/datawatcher.py

@@ -1,36 +1,7 @@
-# coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["C. Nemoz", "H. Payno"]
-__license__ = "MIT"
-__date__ = "18/02/2018"
-
+from __future__ import annotations
 
 import logging
 import os
-from typing import Optional
 
 from silx.gui import icons as silxicons
 from silx.gui import qt
@@ -255,7 +226,7 @@ class DataWatcherWidget(_DataWatcher, qt.QMainWindow):
     def _filterChanged(self, *args, **kwargs):
         self.sigFilterFileNamePatternChanged.emit(self._filterQLE.text())
 
-    def getFilterLinuxFileNamePattern(self) -> Optional[str]:
+    def getFilterLinuxFileNamePattern(self) -> str | None:
         value = self._filterQLE.text().rstrip(" ").lstrip(" ")
         if value == "":
             return None
@@ -335,7 +306,7 @@ class DataWatcherWidget(_DataWatcher, qt.QMainWindow):
         """
         Stop the thread of observation
 
-        :param bool sucess: if True this mean that we are stopping the
+        :param sucess: if True this mean that we are stopping the
                             observation because we found an acquisition
                             finished. In this case we don't want to update the
                             status and the log message.

tomwer/gui/control/datawatcher/datawatcherobserver.py

@@ -1,32 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["H. Payno"]
-__license__ = "MIT"
-__date__ = "10/01/2019"
-
+from __future__ import annotations
 
 import logging
 import os
@@ -57,6 +30,7 @@ class _QDataWatcherObserver(_DataWatcherObserver_MixIn, qt.QThread):
     """
 
     sigScanReady = qt.Signal(object)
+    """emit when scan ready"""
 
     def __init__(
         self,

tomwer/gui/control/history.py

@@ -1,31 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["C. Nemoz", "H. Payno"]
-__license__ = "MIT"
-__date__ = "18/02/2018"
+from __future__ import annotations
 
 
 from operator import itemgetter
@@ -58,13 +32,9 @@ class ScanHistory(qt.QWidget):
 
         self.layout().addWidget(self.scanHistory)
         header = self.scanHistory.horizontalHeader()
-        if qt.qVersion() < "5.0":
-            setResizeMode = header.setResizeMode
-        else:
-            setResizeMode = header.setSectionResizeMode
-        setResizeMode(0, qt.QHeaderView.Fixed)
-        setResizeMode(1, qt.QHeaderView.Fixed)
-        setResizeMode(2, qt.QHeaderView.Stretch)
+        header.setSectionResizeMode(0, qt.QHeaderView.Fixed)
+        header.setSectionResizeMode(1, qt.QHeaderView.Fixed)
+        header.setSectionResizeMode(2, qt.QHeaderView.Stretch)
         header.setStretchLastSection(True)
 
     def update(self, scans):
@@ -83,7 +53,7 @@ class _FoundScanModel(qt.QAbstractTableModel):
     :param mlist: list of tuple (scan, time stamp)
     """
 
-    def __init__(self, parent, header, mlist, *args):
+    def __init__(self, parent, header, mlist: list[tuple], *args):
         qt.QAbstractTableModel.__init__(self, parent, *args)
         self.header = header
         self.myList = mlist

tomwer/gui/control/nxtomomill.py

@@ -1,32 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["C. Nemoz", "H. Payno"]
-__license__ = "MIT"
-__date__ = "01/07/2022"
-
+from __future__ import annotations
 
 from silx.gui import qt
 
@@ -125,8 +98,8 @@ class NXTomomillInput:
     callback provided to nxtomomill if an entry is missing.
     The goal is to ask the user the missing informations
 
-    :param str entry: name of the entry missing
-    :param str desc: description of the entry
+    :param entry: name of the entry missing
+    :param desc: description of the entry
     :return: user input or None
     """
 

tomwer/gui/control/observations.py

@@ -1,31 +1,5 @@
 # coding: utf-8
-# /*##########################################################################
-#
-# Copyright (c) 2016-2017 European Synchrotron Radiation Facility
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to deal
-# in the Software without restriction, including without limitation the rights
-# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-# copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-# THE SOFTWARE.
-#
-# ###########################################################################*/
-
-__authors__ = ["C. Nemoz", "H. Payno"]
-__license__ = "MIT"
-__date__ = "31/05/2018"
+from __future__ import annotations
 
 
 import os
@@ -37,12 +11,26 @@ from silx.gui import qt
 from tomwer.core.scan.blissscan import BlissScan
 from tomwer.core.scan.nxtomoscan import NXtomoScan
 from tomwer.core.scan.scanbase import TomwerScanBase
+from datetime import datetime
 
 
 class ScanObservation(qt.QWidget):
-    """Widget used for the scans observation"""
+    """
+    Widget displayed the on-going observations (done by the data-listener)
 
-    HEADER = ("acquisition", "status", "N projections", "type")
+    For each scan on-going we can display the following information:
+    * time (when the scan has been discovered)
+    * type: HDF5 or EDF
+    * N projections: number of projections already acquired (a)
+    * status of the scan (starting, on-going...)
+    * acquisition: id of the scan (entry and data path in case of HDF5 scan)
+
+    (a) the GUI was set up to display this information. Nevertheless this information is not provided by the rpc-call so this was never used.
+
+    Context: when the 'data listener' gets triggered by bliss-tomo then we want to notify the user that a new scan is on-going.
+    """
+
+    HEADER = ("Time", "Type", "N Projections", "Status", "Acquisition")
 
     def __init__(self, parent):
         qt.QWidget.__init__(self, parent)
@@ -61,17 +49,18 @@ class ScanObservation(qt.QWidget):
 
         self.layout().addWidget(self.observationTable)
         header = self.observationTable.horizontalHeader()
-        if qt.qVersion() < "5.0":
-            setResizeMode = header.setResizeMode
-        else:
-            setResizeMode = header.setSectionResizeMode
-        setResizeMode(0, qt.QHeaderView.Fixed)
-        setResizeMode(1, qt.QHeaderView.Stretch)
-        setResizeMode(2, qt.QHeaderView.Stretch)
-
-        header.setSectionResizeMode(0, qt.QHeaderView.Interactive)
+        header.setSectionResizeMode(0, qt.QHeaderView.Fixed)
+        header.setSectionResizeMode(1, qt.QHeaderView.Fixed)
+        header.setSectionResizeMode(2, qt.QHeaderView.Fixed)
+        header.setSectionResizeMode(3, qt.QHeaderView.Fixed)
+        header.setSectionResizeMode(4, qt.QHeaderView.Stretch)
         header.setStretchLastSection(True)
 
+        self.observationTable.setColumnWidth(0, 70)
+        self.observationTable.setColumnWidth(1, 40)
+        self.observationTable.setColumnWidth(2, 90)
+        self.observationTable.setColumnWidth(3, 70)
+
     @property
     def onGoingObservations(self):
         if self._onGoingObservations:
@@ -99,8 +88,8 @@ class ScanObservation(qt.QWidget):
     def update(self, scan, status):
         """
 
-        :param str scan: the updated scan
-        :param str status: the status of the updated scan
+        :param scan: the updated scan
+        :param status: the status of the updated scan
         """
         self.observationTable.model().update(scan, status)
 
@@ -127,15 +116,18 @@ class _ObservedScanModel(qt.QAbstractTableModel):
         qt.QAbstractTableModel.__init__(self, parent, *args)
         self.header = header
         self.observations = OrderedDict()
+        self._time_stamps = OrderedDict()
+        # note: the time stamp is the time of the discovery and not of the start scan (as we don't have this information)
 
     def add(self, scan, status):
         self.observations[scan] = status
+        self._time_stamps[scan] = datetime.now()
         if qt.qVersion() > "4.6":
             self.endResetModel()
 
     def remove(self, scan):
-        if scan in self.observations:
-            del self.observations[scan]
+        self.observations.pop(scan, None)
+        self._time_stamps.pop(scan, None)
         if qt.qVersion() > "4.6":
             self.endResetModel()
 
@@ -146,6 +138,7 @@ class _ObservedScanModel(qt.QAbstractTableModel):
 
     def clear(self):
         self.observations = OrderedDict()
+        self._time_stamps = OrderedDict()
         if qt.qVersion() > "4.6":
             self.endResetModel()
 
@@ -168,11 +161,14 @@ class _ObservedScanModel(qt.QAbstractTableModel):
         if order == qt.Qt.DescendingOrder:
             ordering = reversed(ordering)
         _observations = OrderedDict()
+        _time_stamps = OrderedDict()
         for str_key in ordering:
             key = to_order[str_key]
             _observations[key] = self.observations[key]
+            _time_stamps[key] = self._time_stamps[key]
 
         self.observations = _observations
+        self._time_stamps = _time_stamps
         self.layoutChanged.emit()
 
     def data(self, index, role):
@@ -183,15 +179,24 @@ class _ObservedScanModel(qt.QAbstractTableModel):
             return None
 
         obs = list(self.observations.keys())[index.row()]
+        time_stamp = self._time_stamps.get(obs, None)
+        # time stamp
         if index.column() == 0:
-            if role == qt.Qt.ToolTipRole:
-                return obs
-            elif isinstance(obs, (TomwerScanBase, BlissScan)):
-                return str(obs)
+            if time_stamp:
+                return time_stamp.strftime("%H:%M:%S")
             else:
-                return os.path.basename(obs)
+                return "Unknown timestamp"
+        # acquisition type
         elif index.column() == 1:
-            return self.observations[obs]
+            if isinstance(obs, TomwerScanBase):
+                return obs.type
+            elif isinstance(obs, BlissScan):
+                return "hdf5"
+            elif NXtomoScan.directory_contains_scan(directory=obs):
+                return "hdf5"
+            else:
+                return "edf"
+        # N projections
         elif index.column() == 2:
             if isinstance(obs, TomwerScanBase):
                 return obs.tomo_n or 0
@@ -202,14 +207,15 @@ class _ObservedScanModel(qt.QAbstractTableModel):
             else:
                 return None
         elif index.column() == 3:
-            if isinstance(obs, TomwerScanBase):
-                return obs.type
-            elif isinstance(obs, BlissScan):
-                return "hdf5"
-            elif NXtomoScan.directory_contains_scan(directory=obs):
-                return "hdf5"
+            return self.observations[obs]
+        # observation id
+        elif index.column() == 4:
+            if role == qt.Qt.ToolTipRole:
+                return obs
+            elif isinstance(obs, (TomwerScanBase, BlissScan)):
+                return str(obs)
             else:
-                return "edf"
+                return os.path.basename(obs)
         else:
             return None
 

tomwer/gui/control/reducedarkflatselector.py

@@ -1,4 +1,5 @@
-from typing import Optional
+from __future__ import annotations
+
 from copy import copy
 import os
 import numpy
@@ -21,16 +22,16 @@ _logger = logging.getLogger(__name__)
 
 class ReduceDarkFlatSelectorTableWidget(qt.QWidget):
     """
-    Table widget used to refgister and select a list of reduces frames
+    Table widget used to register and select a list of reduces frames
     """
 
     sigActiveChanged = qt.Signal(object)
     """Signal emit when the active frame changed (the one to be displayed)"""
 
     sigUpdated = qt.Signal()
-    """Signal emmit when the table is updated"""
+    """Signal emit when the table is updated"""
 
-    def __init__(self, parent: Optional[qt.QWidget] = None) -> None:
+    def __init__(self, parent: qt.QWidget | None = None) -> None:
         super().__init__(parent)
         self._iDict = 0
         self._dicts = {}
@@ -60,8 +61,9 @@ class ReduceDarkFlatSelectorTableWidget(qt.QWidget):
     def addReduceFrames(self, reduced_frames: dict, selected: tuple = ()):
         """
         Add the reduced frames in the interface.
-        :param dict reduced_frames: frame index as key and numpy.ndarray as value
-        :param tuple selected: if the frame index is in selected tuple then this item will be automatically selected
+
+        :param reduced_frames: frame index as key and numpy.ndarray as value
+        :param selected: if the frame index is in selected tuple then this item will be automatically selected
         """
         reduced_frames = copy(reduced_frames)
         dict_key = (
@@ -115,15 +117,14 @@ class ReduceDarkFlatSelectorTableWidget(qt.QWidget):
 
     def getConfiguration(self) -> tuple:
         """
-        return configuration as a tuple of 'reduced frames'. Each reduced_frames are provided as:
-        {
-            "reduce_frames_name": str: name of the reduced frame
-            "reduce_frames": tuple of dict for each reduce frame.
-                             this dict contains:
-                                * index: index of this frame in the acquisition
-                                * data: the reduce frame as a 2D array
-                                * selected: is the frame selected by the user
-        }
+        return configuration as a tuple of 'reduced frames'. Each reduced_frames are provided with the following:
+        * 'reduce_frames_name': str: name of the reduced frame
+        * 'reduce_frames': tuple of dict for each reduce frame. This second dict contains:
+
+            * index: index of this frame in the acquisition
+            * data: the reduce frame as a 2D array
+            * selected: is the frame selected by the user
+
         """
         config = []
         for i_child in range(self._tree.topLevelItemCount()):
@@ -148,7 +149,7 @@ class ReduceDarkFlatSelectorTableWidget(qt.QWidget):
             )
         return tuple(config)
 
-    def setConfiguration(self, config: Optional[tuple]):
+    def setConfiguration(self, config: tuple | None):
         if config is None:
             return
         self.clear()
@@ -349,7 +350,7 @@ class ReduceDarkFlatSelectorWidget(qt.QSplitter):
     sigUpdated = qt.Signal()
     """Signal emmit when the table is updated"""
 
-    def __init__(self, parent: Optional[qt.QWidget] = None) -> None:
+    def __init__(self, parent: qt.QWidget | None = None) -> None:
         super().__init__(parent)
         self._first_display = True
         self._plot = Plot2D(self)
@@ -364,7 +365,7 @@ class ReduceDarkFlatSelectorWidget(qt.QSplitter):
     def _tableUpdated(self, *args, **kwargs):
         self.sigUpdated.emit()
 
-    def _updatePlot(self, obj: Optional[numpy.ndarray]):
+    def _updatePlot(self, obj: numpy.ndarray | None):
         if obj is None:
             self._plot.clear()
         else:
@@ -404,8 +405,11 @@ class ReduceDarkFlatSelectorDialog(qt.QDialog):
     """
 
     sigClearSelection = qt.Signal()
+    """emit when user ask for the selection to be cleared"""
     sigSelectActiveAsDarks = qt.Signal(dict)
+    """emit when user select the darks to be activated"""
     sigSelectActiveAsFlats = qt.Signal(dict)
+    """emit when user select the flats to be activated"""
 
     sigUpdated = qt.Signal()
     """Signal emmit when the table is updated"""
@@ -505,7 +509,7 @@ def filter_selected_reduced_frames(configuration: tuple):
     remove all the frames not 'selected' from the configuration.
     If a reduce frame set becomes empty it will also be removed
 
-    :param dict configuration: configuration of the reduced frames
+    :param configuration: configuration of the reduced frames
     """
     return _filter_reduced_frames(configuration=configuration, filter_selected=True)
 
@@ -515,7 +519,7 @@ def filter_unselected_reduced_frames(configuration: tuple):
     remove all the frames 'selected' from the configuration.
     If a reduce frame set becomes empty it will also be removed
 
-    :param dict configuration: configuration of the reduced frames
+    :param configuration: configuration of the reduced frames
     """
     return _filter_reduced_frames(configuration=configuration, filter_selected=False)