pymodaq 4.4.0__py3-none-any.whl → 4.4.2__py3-none-any.whl

pymodaq/control_modules/move_utility_classes.py

@@ -1,3 +1,5 @@
+import numbers
+
 from time import perf_counter
 from typing import Union, List, Dict, TYPE_CHECKING, Optional
 from numbers import Number
@@ -61,9 +63,15 @@ class DataActuatorType(BaseEnum):
     DataActuator = 1
 
 
-def comon_parameters(epsilon=config('actuator', 'epsilon_default')):
+def comon_parameters(epsilon=config('actuator', 'epsilon_default'),
+                     epsilons=None):
+    if epsilons is not None:
+        epsilon=epsilons
     if isinstance(epsilon, list):
         epsilon=epsilon[0]
+    elif isinstance(epsilon, dict):
+        epsilon=epsilon[list[epsilon.keys()][0]]
+
     return [{'title': 'Units:', 'name': 'units', 'type': 'str', 'value': '', 'readonly': True},
             {'title': 'Epsilon:', 'name': 'epsilon', 'type': 'float',
              'value': epsilon,
@@ -106,32 +114,45 @@ class MoveCommand:
         self.value = value
 
 
-def comon_parameters_fun(is_multiaxes = False,
-                         axes_names: Union[List[str], Dict[str, int]] = [],
+def comon_parameters_fun(is_multiaxes=False, axes_names=None,
                          axis_names: Union[List, Dict] = [],
                          master=True,
-                         epsilon=config('actuator', 'epsilon_default')):
+                         epsilon: float = config('actuator', 'epsilon_default')):
+
     """Function returning the common and mandatory parameters that should be on the actuator plugin level
 
     Parameters
     ----------
-    is_multiaxes: bool
+    is_multiaxes: bool  # deprecated not need anymore
         If True, display the particular settings to define which axis the controller is driving
-    axis_names: list of str
+    axes_names: deprecated, use axis_names
+    axis_names: list of str or dictionnary of string as key and integer as value
         The string identifier of every axis the controller can drive
     master: bool
         If True consider this plugin has to init the controller, otherwise use an already initialized instance
+    epsilon: float
+        deprecated (< 5.0.0) no more used here
+
     """
-    if axis_names == [] and len(axes_names) != 0:
+    if axes_names is not None and len(axis_names) == 0:
+        if len(axes_names) == 0:
+            axes_names = ['']
         axis_names = axes_names
 
+    is_multiaxes = len(axis_names) > 1
+    if isinstance(axis_names, list):
+        axis_name = axis_names[0]
+    elif isinstance(axis_names, dict):
+        axis_name = axis_names[list(axis_names.keys())[0]]
     params = [
-                 {'title': 'MultiAxes:', 'name': 'multiaxes', 'type': 'group', 'visible': is_multiaxes, 'children': [
-                     {'title': 'is Multiaxes:', 'name': 'ismultiaxes', 'type': 'bool', 'value': is_multiaxes,
-                      'default': False},
+                 {'title': 'MultiAxes:', 'name': 'multiaxes', 'type': 'group',
+                  'visible': is_multiaxes, 'children': [
+                     {'title': 'is Multiaxes:', 'name': 'ismultiaxes', 'type': 'bool',
+                      'value': is_multiaxes,  'default': False},
                      {'title': 'Status:', 'name': 'multi_status', 'type': 'list',
                       'value': 'Master' if master else 'Slave', 'limits': ['Master', 'Slave']},
-                     {'title': 'Axis:', 'name': 'axis', 'type': 'list', 'limits': axis_names},
+                     {'title': 'Axis:', 'name': 'axis', 'type': 'list', 'limits': axis_names,
+                      'value': axis_name},
                  ]},
              ] + comon_parameters(epsilon)
     return params
@@ -231,10 +252,16 @@ class DAQ_Move_base(QObject):
 
     move_done_signal = Signal(DataActuator)
     is_multiaxes = False
-    stage_names = []
+    stage_names = []  # deprecated
+
+    _axis_names: Union[list, Dict[str, int]] = None
+    _controller_units: Union[str, List[str], Dict[str, int]] = ''
+    _epsilons: Union[float, List[float], Dict[str, float]] = None
+    _epsilon = 1.0  # deprecated
+
+
     params = []
-    _controller_units: Union[str, List[str]] = ''
-    _epsilon = 1.0
+
     data_actuator_type = DataActuatorType.float
     data_shape = (1, )  # expected shape of the underlying actuator's value (in general a float so shape = (1, ))
 
@@ -264,11 +291,11 @@ class DAQ_Move_base(QObject):
         else:
             self._title = "myactuator"
 
-        self._axis_units: List[str] = []
+        self._axis_units: Union[Dict[str, str], List[str]] = None
         self.axis_units = self._controller_units
-        self._epsilons: List[float] = []  # self._epsilon if isinstance(self._epsilon, list) else\
-        #    [self._epsilon for _ in range(len(self.axis_name))]
-        self.epsilons = self._epsilon
+        if self._epsilons is None:
+            self._epsilons = self._epsilon
+        self.epsilons = self._epsilons
         self.axis_name = self.axis_name  # to trigger some actions on units and epsilons
 
         self._current_value = DataActuator(self._title,
@@ -293,16 +320,16 @@ class DAQ_Move_base(QObject):
 
         New in 4.4.0
         """
-        return self.axis_units[self.axis_value]
+        return self.axis_units[self.axis_index_key]
 
     @axis_unit.setter
     def axis_unit(self, unit: str):
-        self.axis_units[self.axis_value] = unit
+        self.axis_units[self.axis_index_key] = unit
         self.settings.child('units').setValue(unit)
         self.emit_status(ThreadCommand('units', unit))
 
     @property
-    def axis_units(self) -> List[str]:
+    def axis_units(self) -> Union[List[str], Dict[str, str]]:
         """ Get/Set the units for each axis of the controller
 
         New in 4.4.0
@@ -310,10 +337,23 @@ class DAQ_Move_base(QObject):
         return self._axis_units
 
     @axis_units.setter
-    def axis_units(self, units: Union[str, List[str]]):
+    def axis_units(self, units: Union[str, List[str], Dict[str, str]]):
         if isinstance(units, str):
-            units = [units for _ in range(len(self.axis_names))]
-        self._axis_units = units
+            if isinstance(self.axis_names, list):
+                units_tmp = [units for _ in range(len(self.axis_names))]
+            else:
+                units_tmp = {}
+                for key in self.axis_names:
+                    units_tmp[key] = units
+        else:
+            if not isinstance(units, type(self.axis_names)):
+                raise TypeError('units should be defined just like axis_names: a str, list of string or'
+                                'dict of string')
+            if len(units) != len(self.axis_names):
+                raise ValueError('Units should be defined either as a single str or a list/dict with'
+                                 'a str defined for each axis')
+            units_tmp = units
+        self._axis_units = units_tmp
 
     @property
     def epsilon(self) -> float:
@@ -321,14 +361,14 @@ class DAQ_Move_base(QObject):
 
         New in 4.4.0
         """
-        return self.epsilons[self.axis_value]
+        return self.epsilons[self.axis_index_key]
 
     @epsilon.setter
     def epsilon(self, eps: float):
-        self.epsilons[self.axis_value] = eps
+        self.epsilons[self.axis_index_key] = eps
 
     @property
-    def epsilons(self) -> List[float]:
+    def epsilons(self) -> Union[List[float], Dict[str, float]]:
         """ Get/Set the epsilon for each axis of the controller
 
         New in 4.4.0
@@ -336,10 +376,24 @@ class DAQ_Move_base(QObject):
         return self._epsilons
 
     @epsilons.setter
-    def epsilons(self, epsilons: Union[float, List[float]]):
-        if not isinstance(epsilons, Iterable) and isinstance(epsilons, float):
-            epsilons = [epsilons for _ in range(len(self.axis_names))]
-        self._epsilons = epsilons
+    def epsilons(self, epsilons: Union[float, List[float], Dict[str, float]]):
+        if isinstance(epsilons, numbers.Number):
+            if isinstance(self.axis_names, list):
+                epsilons_tmp = [epsilons for _ in range(len(self.axis_names))]
+            else:
+                epsilons_tmp = {}
+                for key in self.axis_names:
+                    epsilons_tmp[key] = epsilons
+        else:
+            if not isinstance(epsilons, type(self.axis_names)):
+                raise TypeError('units should be defined just like axis_names: a float, list of '
+                                'float or dict of float')
+            if len(epsilons) != len(self.axis_names):
+                raise ValueError('epsilons should be defined either as a single float or a '
+                                 'list/dict with'
+                                 'a float defined for each axis')
+            epsilons_tmp = epsilons
+        self._epsilons = epsilons_tmp
 
     @property
     def controller_units(self):
@@ -357,7 +411,7 @@ class DAQ_Move_base(QObject):
     def controller_units(self, units: str = ''):
         deprecation_msg('The property controller_units is deprecated please use the'
                         'axis_unit property.')
-        self._axis_units[self.axis_value] = units
+        self._axis_units[self.axis_index_key] = units
 
     @property
     def axis_name(self) -> Union[str]:
@@ -398,12 +452,29 @@ class DAQ_Move_base(QObject):
 
     @property
     def axis_value(self) -> int:
-        """Get the current value selected from the current axis"""
+        """Get the current value selected from the current axis
+
+        In case axis_names is a list, return the element of the list: self.axis_name
+        In case axis_names is a dict, return the value of the dict self.axis_names[self.axis_name]
+        """
         if isinstance(self.axis_names, list):
-            return self.axis_names.index(self.axis_name)
+            return self.axis_name
         else:
             return self.axis_names[self.axis_name]
 
+    @property
+    def axis_index_key(self) -> Union[int, str]:
+        """ Get the current index or key correspondingto the current axis
+
+        In case axis_names is a list, return the index wihtin the list
+        In case axis_names is a dict, return the key of the dict self.axis_name
+
+        """
+        if isinstance(self.axis_names, list):
+            return self.axis_names.index(self.axis_name)
+        else:
+            return self.axis_name
+
     def ini_attributes(self):
         """ To be subclassed, in order to init specific attributes needed by the real implementation"""
         self.controller = None
@@ -442,14 +513,14 @@ class DAQ_Move_base(QObject):
 
     @property
     def current_value(self):
-        if self.data_actuator_type.name == 'float':
+        if self.data_actuator_type == self.data_actuator_type.float:
             return self._current_value.value()
         else:
             return self._current_value
 
     @current_value.setter
     def current_value(self, value: Union[float, DataActuator]):
-        if not isinstance(value, DataActuator):
+        if isinstance(value, numbers.Number):
             self._current_value = DataActuator(self._title, data=value,
                                                units=self.axis_unit)
         else:
@@ -461,14 +532,14 @@ class DAQ_Move_base(QObject):
 
     @property
     def target_value(self):
-        if self.data_actuator_type.name == 'float':
+        if self.data_actuator_type.name == self.data_actuator_type.float:
             return self._target_value.value()
         else:
             return self._target_value
 
     @target_value.setter
-    def target_value(self, value: Union[float, DataActuator]):
-        if not isinstance(value, DataActuator):
+    def target_value(self, value: Union[numbers.Number, DataActuator]):
+        if isinstance(value, numbers.Number):
             self._target_value = DataActuator(self._title, data=value,
                                               units=self.axis_unit)
         else:

pymodaq/resources/VERSION

@@ -1,2 +1,2 @@
-version = '4.4.0'
+version = '4.4.2'
 

{pymodaq-4.4.0.dist-info → pymodaq-4.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pymodaq
-Version: 4.4.0
+Version: 4.4.2
 Summary: Modular Data Acquisition with Python
 Project-URL: Homepage, http://pymodaq.cnrs.fr
 Project-URL: Source, https://github.com/PyMoDAQ/PyMoDAQ

{pymodaq-4.4.0.dist-info → pymodaq-4.4.2.dist-info}/RECORD

@@ -8,7 +8,7 @@ pymodaq/control_modules/daq_move_ui.py,sha256=IbqNAErwXGjKUbYEptvZUz3J8MapNBFIbQ
 pymodaq/control_modules/daq_viewer.py,sha256=5CYmdWHGE7sQApeMfdWNV3zbPyoxxYtzFlQ1PaEw4fI,57883
 pymodaq/control_modules/daq_viewer_ui.py,sha256=FWP3jdIOR9vTgYqNaaodteGZ3dwgQ1GdWKrOpOAuSrs,15693
 pymodaq/control_modules/mocks.py,sha256=hh_xSWp9g1UV3NAQVD9Ft9tNWfTsSvKU0OU0trgzP2w,1956
-pymodaq/control_modules/move_utility_classes.py,sha256=LUO7kGb-1iQOP_6Wvp46xnx5Z9wNxUhRzOfz9cfXH-s,39664
+pymodaq/control_modules/move_utility_classes.py,sha256=WwZku-xFsyqun25IG9570_OU5x1frA9rIrxVu6XJKIk,42599
 pymodaq/control_modules/utils.py,sha256=5YdSwq_lFJm7IalYWe_Hn1U4LUoUmo1gedvV9UguU0Y,20016
 pymodaq/control_modules/viewer_utility_classes.py,sha256=OHxwue1t3z2AXyeqNjnwPT2pMc8yXhnqyiWc9IdCI2c,26841
 pymodaq/examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -58,7 +58,7 @@ pymodaq/post_treatment/daq_measurement/daq_measurement_GUI.py,sha256=1u7hWDaiwsZ
 pymodaq/post_treatment/daq_measurement/daq_measurement_GUI.ui,sha256=PyzbCWPMkh5oIYYteZczXyWMeHKW9EJmM1QlzXhnyTk,7037
 pymodaq/post_treatment/daq_measurement/daq_measurement_main.py,sha256=CAKwcWMOD86aXB8mbdxOK7e8nZRos5d59FzDtqK1QoY,17093
 pymodaq/post_treatment/daq_measurement/process_from_QtDesigner_DAQ_Measurement_GUI.bat,sha256=e1tu2A67MS9fk3jhriF6saQgRxWIucIvNW92iWXFP6E,164
-pymodaq/resources/VERSION,sha256=x4JbXmXiNnoebdA-11hkfcpy5BKE5mBMlysMVDo9SRw,19
+pymodaq/resources/VERSION,sha256=u7UAa-_KS1Q9ODCq7-42m4PKdNLnm3M_qQLvikeM9Hc,19
 pymodaq/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 pymodaq/resources/config_template.toml,sha256=d3pofgIK5FxaRMELAI1qEsRcMD3GlYd87zZjDj9G9m0,3210
 pymodaq/resources/preset_default.xml,sha256=Dt8iWLwPPOPtcG00JCVP-mh-G7KC6B0YN8hd8RQdnNI,27256
@@ -438,8 +438,8 @@ pymodaq/utils/tcp_ip/__init__.py,sha256=1e_EK0AgvdoLAD_CSGGEaITZdy6OWCO7ih9IAIp7
 pymodaq/utils/tcp_ip/mysocket.py,sha256=StAWj8dzHeMnbLj68Sel81uWFy-YkKVNRnVf7gXrESI,3452
 pymodaq/utils/tcp_ip/serializer.py,sha256=htVQCE4saRBMeIcseEyxTt5G58A341m6OGkaJUA34Wk,27766
 pymodaq/utils/tcp_ip/tcp_server_client.py,sha256=xIMTNgVW_rKK0yTi4FDNFLf85-Akb27Jz2LdrvOrP68,30660
-pymodaq-4.4.0.dist-info/METADATA,sha256=PGjrsAiJMph8il3hZKb9aJDvUShYG5CUrEYgTPsY8is,7623
-pymodaq-4.4.0.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
-pymodaq-4.4.0.dist-info/entry_points.txt,sha256=RAzdYNjvUT28I2eiCKki_g2NzXq0woWxhev6lwzwRv8,348
-pymodaq-4.4.0.dist-info/licenses/LICENSE,sha256=VKOejxexXAe3XwfhAhcFGqeXQ12irxVHdeAojZwFEI8,1108
-pymodaq-4.4.0.dist-info/RECORD,,
+pymodaq-4.4.2.dist-info/METADATA,sha256=wc6QZZgW3pBAs85kQQ88JdPtJ8omKojHa1RDSgtuR3s,7623
+pymodaq-4.4.2.dist-info/WHEEL,sha256=1yFddiXMmvYK7QYTqtRNtX66WJ0Mz8PYEiEUoOUUxRY,87
+pymodaq-4.4.2.dist-info/entry_points.txt,sha256=RAzdYNjvUT28I2eiCKki_g2NzXq0woWxhev6lwzwRv8,348
+pymodaq-4.4.2.dist-info/licenses/LICENSE,sha256=VKOejxexXAe3XwfhAhcFGqeXQ12irxVHdeAojZwFEI8,1108
+pymodaq-4.4.2.dist-info/RECORD,,