zaber-motion 7.12.0__tar.gz → 7.14.0__tar.gz

{zaber_motion-7.12.0/zaber_motion.egg-info → zaber_motion-7.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zaber_motion
-Version: 7.12.0
+Version: 7.14.0
 Summary: An official library for communicating with Zaber devices.
 Author-email: "Zaber Technologies Inc." <contact@zaber.com>
 License: The MIT License (MIT)

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "zaber_motion"
-version = "7.12.0"
+version = "7.14.0"
 description = "An official library for communicating with Zaber devices."
 authors = [{ name = "Zaber Technologies Inc.", email = "contact@zaber.com" }]
 license = { file = "LICENSE.txt" }

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/setup.py

@@ -19,13 +19,13 @@ def get_version():
 
 def download_bindings(version):
     url = f"https://api.zaber.io/downloads/software-downloads?product=zml_cpp_src&version={version}"
-    filename = f"ZaberMotionCppSource-{version}.zip"
-    bindings_prefix = "ZaberMotionCppSource/build/zaber-motion-lib"
+    archive_file = f"ZaberMotionCppSource-{version}.zip"
+    bindings_prefix = "ZaberMotionCppSource/build/zaber-motion-core"
 
-    with urllib.request.urlopen(url) as response, open(filename, 'wb') as out_file:
+    with urllib.request.urlopen(url) as response, open(archive_file, 'wb') as out_file:
         shutil.copyfileobj(response, out_file)
 
-    with zipfile.ZipFile(filename, 'r') as archive:
+    with zipfile.ZipFile(archive_file, 'r') as archive:
         files = archive.namelist()
         bindings = [f for f in files if f.startswith(bindings_prefix)]
         archive.extractall(".", bindings)
@@ -33,7 +33,7 @@ def download_bindings(version):
     shutil.rmtree(BINDINGS_DIR, ignore_errors=True)
     shutil.move("ZaberMotionCppSource/build", BINDINGS_DIR)
     shutil.rmtree("ZaberMotionCppSource", ignore_errors=True)
-    os.remove(filename)
+    os.remove(archive_file)
 
 
 def setup():

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/ascii/axis.py

@@ -104,6 +104,13 @@ class Axis:
         """
         return self.identity.axis_type
 
+    @property
+    def resolution(self) -> int:
+        """
+        The number of microsteps per full step for motion axes. Always equal to 0 for non-motion axes.
+        """
+        return self.identity.resolution
+
     @property
     def label(self) -> str:
         """

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/dto/ascii/axis_identity.py

@@ -43,6 +43,11 @@ class AxisIdentity:
     The peripheral has hardware modifications.
     """
 
+    resolution: int
+    """
+    The number of microsteps per full step for motion axes. Always equal to 0 for non-motion axes.
+    """
+
     @staticmethod
     def zero_values() -> 'AxisIdentity':
         return AxisIdentity(
@@ -52,6 +57,7 @@ class AxisIdentity:
             is_peripheral=False,
             axis_type=next(first for first in AxisType),
             is_modified=False,
+            resolution=0,
         )
 
     @staticmethod
@@ -73,6 +79,7 @@ class AxisIdentity:
             'isPeripheral': bool(self.is_peripheral),
             'axisType': self.axis_type.value,
             'isModified': bool(self.is_modified),
+            'resolution': int(self.resolution),
         }
 
     @staticmethod
@@ -84,6 +91,7 @@ class AxisIdentity:
             is_peripheral=data.get('isPeripheral'),  # type: ignore
             axis_type=AxisType(data.get('axisType')),  # type: ignore
             is_modified=data.get('isModified'),  # type: ignore
+            resolution=data.get('resolution'),  # type: ignore
         )
 
     def validate(self) -> None:
@@ -115,3 +123,12 @@ class AxisIdentity:
 
         if not isinstance(self.axis_type, AxisType):
             raise ValueError(f'Property "AxisType" of "AxisIdentity" is not an instance of "AxisType".')
+
+        if self.resolution is None:
+            raise ValueError(f'Property "Resolution" of "AxisIdentity" is None.')
+
+        if not isinstance(self.resolution, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "Resolution" of "AxisIdentity" is not a number.')
+
+        if int(self.resolution) != self.resolution:
+            raise ValueError(f'Property "Resolution" of "AxisIdentity" is not integer value.')

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/dto/ascii/optional_measurement_sequence.py

@@ -16,7 +16,7 @@ class OptionalMeasurementSequence:
 
     values: List[Optional[float]]
     """
-    Sequence of values.
+    Sequence of optional values.
     """
 
     unit: Optional[UnitsAndLiterals] = None

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/dto/ascii/simple_tuning.py

@@ -42,7 +42,7 @@ class SimpleTuning:
 
     motor_inertia: Optional[float] = None
     """
-    The mass of the carriage in kg.
+    The inertia of the motor in kg⋅m².
     """
 
     @staticmethod

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/dto/requests/__init__.py

@@ -210,6 +210,7 @@ from .string_array_response import StringArrayResponse as StringArrayResponse
 from .string_response import StringResponse as StringResponse
 from .test_event import TestEvent as TestEvent
 from .test_request import TestRequest as TestRequest
+from .test_request_complex import TestRequestComplex as TestRequestComplex
 from .test_response import TestResponse as TestResponse
 from .test_response_long import TestResponseLong as TestResponseLong
 from .toggle_device_db_store_request import ToggleDeviceDbStoreRequest as ToggleDeviceDbStoreRequest
@@ -250,5 +251,6 @@ from .unknown_binary_response_event_wrapper import UnknownBinaryResponseEventWra
 from .unknown_response_event_wrapper import UnknownResponseEventWrapper as UnknownResponseEventWrapper
 from .wait_to_clear_warnings_request import WaitToClearWarningsRequest as WaitToClearWarningsRequest
 from .wait_to_respond_request import WaitToRespondRequest as WaitToRespondRequest
+from .wdi_generic_float_request import WdiGenericFloatRequest as WdiGenericFloatRequest
 from .wdi_generic_request import WdiGenericRequest as WdiGenericRequest
 from .wdi_get_status_response import WdiGetStatusResponse as WdiGetStatusResponse

zaber_motion-7.14.0/zaber_motion/dto/requests/test_request_complex.py

@@ -0,0 +1,57 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass, field
+from typing import Any, Dict, List
+import decimal
+from collections.abc import Iterable
+import zaber_bson
+
+
+@dataclass
+class TestRequestComplex:
+
+    int_array: List[int] = field(default_factory=list)
+
+    @staticmethod
+    def zero_values() -> 'TestRequestComplex':
+        return TestRequestComplex(
+            int_array=[],
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'TestRequestComplex':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return TestRequestComplex.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'intArray': [int(item) for item in self.int_array] if self.int_array is not None else [],
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'TestRequestComplex':
+        return TestRequestComplex(
+            int_array=data.get('intArray'),  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.int_array is not None:
+            if not isinstance(self.int_array, Iterable):
+                raise ValueError('Property "IntArray" of "TestRequestComplex" is not iterable.')
+
+            for i, int_array_item in enumerate(self.int_array):
+                if int_array_item is None:
+                    raise ValueError(f'Item {i} in property "IntArray" of "TestRequestComplex" is None.')
+
+                if not isinstance(int_array_item, (int, float, decimal.Decimal)):
+                    raise ValueError(f'Item {i} in property "IntArray" of "TestRequestComplex" is not a number.')
+
+                if int(int_array_item) != int_array_item:
+                    raise ValueError(f'Item {i} in property "IntArray" of "TestRequestComplex" is not integer value.')

zaber_motion-7.14.0/zaber_motion/dto/requests/wdi_generic_float_request.py

@@ -0,0 +1,119 @@
+# This file is generated. Do not modify by hand.
+# pylint: disable=line-too-long, unused-argument, f-string-without-interpolation, too-many-branches, too-many-statements, unnecessary-pass
+from dataclasses import dataclass, field
+from typing import Any, Dict, List
+import decimal
+from collections.abc import Iterable
+import zaber_bson
+
+
+@dataclass
+class WdiGenericFloatRequest:
+
+    interface_id: int = 0
+
+    register_id: int = 0
+
+    count: int = 0
+
+    offset: int = 0
+
+    register_bank: str = ""
+
+    data: List[float] = field(default_factory=list)
+
+    @staticmethod
+    def zero_values() -> 'WdiGenericFloatRequest':
+        return WdiGenericFloatRequest(
+            interface_id=0,
+            register_id=0,
+            count=0,
+            offset=0,
+            register_bank="",
+            data=[],
+        )
+
+    @staticmethod
+    def from_binary(data_bytes: bytes) -> 'WdiGenericFloatRequest':
+        """" Deserialize a binary representation of this class. """
+        data = zaber_bson.loads(data_bytes)  # type: Dict[str, Any]
+        return WdiGenericFloatRequest.from_dict(data)
+
+    def to_binary(self) -> bytes:
+        """" Serialize this class to a binary representation. """
+        self.validate()
+        return zaber_bson.dumps(self.to_dict())  # type: ignore
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            'interfaceId': int(self.interface_id),
+            'registerId': int(self.register_id),
+            'count': int(self.count),
+            'offset': int(self.offset),
+            'registerBank': str(self.register_bank or ''),
+            'data': [float(item) for item in self.data] if self.data is not None else [],
+        }
+
+    @staticmethod
+    def from_dict(data: Dict[str, Any]) -> 'WdiGenericFloatRequest':
+        return WdiGenericFloatRequest(
+            interface_id=data.get('interfaceId'),  # type: ignore
+            register_id=data.get('registerId'),  # type: ignore
+            count=data.get('count'),  # type: ignore
+            offset=data.get('offset'),  # type: ignore
+            register_bank=data.get('registerBank'),  # type: ignore
+            data=data.get('data'),  # type: ignore
+        )
+
+    def validate(self) -> None:
+        """" Validates the properties of the instance. """
+        if self.interface_id is None:
+            raise ValueError(f'Property "InterfaceId" of "WdiGenericFloatRequest" is None.')
+
+        if not isinstance(self.interface_id, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "InterfaceId" of "WdiGenericFloatRequest" is not a number.')
+
+        if int(self.interface_id) != self.interface_id:
+            raise ValueError(f'Property "InterfaceId" of "WdiGenericFloatRequest" is not integer value.')
+
+        if self.register_id is None:
+            raise ValueError(f'Property "RegisterId" of "WdiGenericFloatRequest" is None.')
+
+        if not isinstance(self.register_id, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "RegisterId" of "WdiGenericFloatRequest" is not a number.')
+
+        if int(self.register_id) != self.register_id:
+            raise ValueError(f'Property "RegisterId" of "WdiGenericFloatRequest" is not integer value.')
+
+        if self.count is None:
+            raise ValueError(f'Property "Count" of "WdiGenericFloatRequest" is None.')
+
+        if not isinstance(self.count, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "Count" of "WdiGenericFloatRequest" is not a number.')
+
+        if int(self.count) != self.count:
+            raise ValueError(f'Property "Count" of "WdiGenericFloatRequest" is not integer value.')
+
+        if self.offset is None:
+            raise ValueError(f'Property "Offset" of "WdiGenericFloatRequest" is None.')
+
+        if not isinstance(self.offset, (int, float, decimal.Decimal)):
+            raise ValueError(f'Property "Offset" of "WdiGenericFloatRequest" is not a number.')
+
+        if int(self.offset) != self.offset:
+            raise ValueError(f'Property "Offset" of "WdiGenericFloatRequest" is not integer value.')
+
+        if self.register_bank is not None:
+            if not isinstance(self.register_bank, str):
+                raise ValueError(f'Property "RegisterBank" of "WdiGenericFloatRequest" is not a string.')
+
+        if self.data is not None:
+            if not isinstance(self.data, Iterable):
+                raise ValueError('Property "Data" of "WdiGenericFloatRequest" is not iterable.')
+
+            for i, data_item in enumerate(self.data):
+                if data_item is None:
+                    raise ValueError(f'Item {i} in property "Data" of "WdiGenericFloatRequest" is None.')
+
+                if not isinstance(data_item, (int, float, decimal.Decimal)):
+                    raise ValueError(f'Item {i} in property "Data" of "WdiGenericFloatRequest" is not a number.')

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/library.py

@@ -171,7 +171,7 @@ class Library:
         """
         request = dto.CheckVersionRequest(
             host="py",
-            version="7.12.0",
+            version="7.14.0",
         )
         call_sync("library/check_version", request)
 

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion/microscopy/wdi_autofocus_provider.py

@@ -9,6 +9,7 @@ from ..exceptions.motion_lib_exception import MotionLibException
 
 from ..dto import requests as dto
 from ..dto.microscopy.wdi_autofocus_provider_status import WdiAutofocusProviderStatus
+from ..dto.firmware_version import FirmwareVersion
 
 
 class WdiAutofocusProvider:
@@ -28,6 +29,13 @@ class WdiAutofocusProvider:
         """
         return self._provider_id
 
+    @property
+    def firmware_version(self) -> FirmwareVersion:
+        """
+        The firmware version of the connected autofocus.
+        """
+        return self.__retrieve_firmware_version()
+
     def __init__(self, provider_id: int):
         self._provider_id: int = provider_id
 
@@ -116,6 +124,24 @@ class WdiAutofocusProvider:
         )
         call_sync("wdi/free", request)
 
+    def __retrieve_firmware_version(
+            self
+    ) -> FirmwareVersion:
+        """
+        Returns FW version.
+
+        Returns:
+            Firmware version.
+        """
+        request = dto.InterfaceEmptyRequest(
+            interface_id=self.provider_id,
+        )
+        response = call_sync(
+            "wdi/get_firmware_version",
+            request,
+            FirmwareVersion.from_binary)
+        return response
+
     def generic_read(
             self,
             register_id: int,
@@ -242,6 +268,120 @@ class WdiAutofocusProvider:
         )
         await call_async("wdi/write", request)
 
+    def generic_read_float(
+            self,
+            register_id: int,
+            count: int = 1,
+            offset: int = 0,
+            register_bank: str = "U"
+    ) -> List[float]:
+        """
+        Generic read operation.
+
+        Args:
+            register_id: Register address to read from.
+            count: Number of values to read (defaults to 1).
+            offset: Offset within the register (defaults to 0).
+            register_bank: Register bank letter (defaults to U for user bank).
+
+        Returns:
+            Array of floats read from the device.
+        """
+        request = dto.WdiGenericFloatRequest(
+            interface_id=self.provider_id,
+            register_id=register_id,
+            count=count,
+            offset=offset,
+            register_bank=register_bank,
+        )
+        response = call(
+            "wdi/read_float",
+            request,
+            dto.DoubleArrayResponse.from_binary)
+        return response.values
+
+    async def generic_read_float_async(
+            self,
+            register_id: int,
+            count: int = 1,
+            offset: int = 0,
+            register_bank: str = "U"
+    ) -> List[float]:
+        """
+        Generic read operation.
+
+        Args:
+            register_id: Register address to read from.
+            count: Number of values to read (defaults to 1).
+            offset: Offset within the register (defaults to 0).
+            register_bank: Register bank letter (defaults to U for user bank).
+
+        Returns:
+            Array of floats read from the device.
+        """
+        request = dto.WdiGenericFloatRequest(
+            interface_id=self.provider_id,
+            register_id=register_id,
+            count=count,
+            offset=offset,
+            register_bank=register_bank,
+        )
+        response = await call_async(
+            "wdi/read_float",
+            request,
+            dto.DoubleArrayResponse.from_binary)
+        return response.values
+
+    def generic_write_float(
+            self,
+            register_id: int,
+            data: List[float] = [],
+            offset: int = 0,
+            register_bank: str = "U"
+    ) -> None:
+        """
+        Generic write operation.
+
+        Args:
+            register_id: Register address to write to.
+            data: Array of values to write to the register. Empty array is allowed.
+            offset: Offset within the register (defaults to 0).
+            register_bank: Register bank letter (defaults to U for user bank).
+        """
+        request = dto.WdiGenericFloatRequest(
+            interface_id=self.provider_id,
+            register_id=register_id,
+            data=data,
+            offset=offset,
+            register_bank=register_bank,
+        )
+        call("wdi/write_float", request)
+
+    async def generic_write_float_async(
+            self,
+            register_id: int,
+            data: List[float] = [],
+            offset: int = 0,
+            register_bank: str = "U"
+    ) -> None:
+        """
+        Generic write operation.
+
+        Args:
+            register_id: Register address to write to.
+            data: Array of values to write to the register. Empty array is allowed.
+            offset: Offset within the register (defaults to 0).
+            register_bank: Register bank letter (defaults to U for user bank).
+        """
+        request = dto.WdiGenericFloatRequest(
+            interface_id=self.provider_id,
+            register_id=register_id,
+            data=data,
+            offset=offset,
+            register_bank=register_bank,
+        )
+        await call_async("wdi/write_float", request)
+
     def enable_laser(
             self
     ) -> None:

zaber_motion-7.14.0/zaber_motion/version.py

@@ -0,0 +1 @@
+__version__ = "7.14.0"

{zaber_motion-7.12.0 → zaber_motion-7.14.0/zaber_motion.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zaber_motion
-Version: 7.12.0
+Version: 7.14.0
 Summary: An official library for communicating with Zaber devices.
 Author-email: "Zaber Technologies Inc." <contact@zaber.com>
 License: The MIT License (MIT)

{zaber_motion-7.12.0 → zaber_motion-7.14.0}/zaber_motion.egg-info/SOURCES.txt

@@ -376,6 +376,7 @@ zaber_motion/dto/requests/string_array_response.py
 zaber_motion/dto/requests/string_response.py
 zaber_motion/dto/requests/test_event.py
 zaber_motion/dto/requests/test_request.py
+zaber_motion/dto/requests/test_request_complex.py
 zaber_motion/dto/requests/test_response.py
 zaber_motion/dto/requests/test_response_long.py
 zaber_motion/dto/requests/toggle_device_db_store_request.py
@@ -416,6 +417,7 @@ zaber_motion/dto/requests/unknown_binary_response_event_wrapper.py
 zaber_motion/dto/requests/unknown_response_event_wrapper.py
 zaber_motion/dto/requests/wait_to_clear_warnings_request.py
 zaber_motion/dto/requests/wait_to_respond_request.py
+zaber_motion/dto/requests/wdi_generic_float_request.py
 zaber_motion/dto/requests/wdi_generic_request.py
 zaber_motion/dto/requests/wdi_get_status_response.py
 zaber_motion/exceptions/__init__.py

zaber_motion-7.12.0/zaber_motion/version.py

@@ -1 +0,0 @@
-__version__ = "7.12.0"