puda-drivers 0.0.10__py3-none-any.whl → 0.0.11__py3-none-any.whl

puda_drivers/labware/polyelectric_8_wellplate_30000ul.json

@@ -30,7 +30,7 @@
     "dimensions": {
         "xDimension": 128,
         "yDimension": 85.5,
-        "zDimension": 74
+        "zDimension": 54
     },
     "wells": {
         "A1": {

puda_drivers/labware/trash_bin.json

@@ -11,7 +11,7 @@
   "dimensions": {
     "xDimension": 127.76,
     "yDimension": 85.48,
-    "zDimension": 20
+    "zDimension": 0
   },
   "wells": {
     "A1": {

puda_drivers/machines/first.py

@@ -185,14 +185,30 @@ class First:
         self.qubot.home(axis="Z")
         self._logger.debug("Z axis homed after tip attachment")
         
-    def drop_tip(self, slot: str, well: str):
-        """Drop a tip into a slot."""
+    def drop_tip(self, slot: str, well: str, height_from_bottom: float = 0.0):
+        """
+        Drop a tip into a slot.
+        
+        Args:
+            slot: Slot name (e.g., 'A1', 'B2')
+            well: Well name within the slot (e.g., 'A1' for a well in a tiprack)
+            height_from_bottom: Height from the bottom of the well in mm. Defaults to 0.0.
+                               Positive values move up from the bottom. Negative values
+                               may cause a ValueError if the resulting position is outside
+                               the Z axis limits.
+        
+        Raises:
+            ValueError: If no tip is attached, or if the resulting position is outside
+                       the Z axis limits.
+        """
         if not self.pipette.is_tip_attached():
             self._logger.error("Cannot drop tip: no tip attached")
             raise ValueError("Tip not attached")
         
         self._logger.info("Dropping tip into slot '%s', well '%s'", slot, well)
         pos = self.get_absolute_z_position(slot, well)
+        # add height from bottom
+        pos += Position(z=height_from_bottom)
         # move up by the tip length
         pos += Position(z=self.TIP_LENGTH)
         self._logger.debug("Moving to position %s (adjusted for tip length) for tip drop", pos)
@@ -204,31 +220,67 @@ class First:
         self.pipette.set_tip_attached(attached=False)
         self._logger.info("Tip dropped successfully")
         
-    def aspirate_from(self, slot:str, well:str, amount:int):
-        """Aspirate a volume of liquid from a slot."""
+    def aspirate_from(self, slot:str, well:str, amount:int, height_from_bottom: float = 0.0):
+        """
+        Aspirate a volume of liquid from a slot.
+        
+        Args:
+            slot: Slot name (e.g., 'A1', 'B2')
+            well: Well name within the slot (e.g., 'A1')
+            amount: Volume to aspirate in µL
+            height_from_bottom: Height from the bottom of the well in mm. Defaults to 0.0.
+                               Positive values move up from the bottom. Negative values
+                               may cause a ValueError if the resulting position is outside
+                               the Z axis limits.
+        
+        Raises:
+            ValueError: If no tip is attached, or if the resulting position is outside
+                       the Z axis limits.
+        """
         if not self.pipette.is_tip_attached():
             self._logger.error("Cannot aspirate: no tip attached")
             raise ValueError("Tip not attached")
         
         self._logger.info("Aspirating %d µL from slot '%s', well '%s'", amount, slot, well)
         pos = self.get_absolute_z_position(slot, well)
+        # add height from bottom
+        pos += Position(z=height_from_bottom)
         self._logger.debug("Moving Z axis to position %s", pos)
         self.qubot.move_absolute(position=pos)
+
         self._logger.debug("Aspirating %d µL", amount)
         self.pipette.aspirate(amount=amount)
         time.sleep(5)
         self._logger.info("Aspiration completed: %d µL from slot '%s', well '%s'", amount, slot, well)
         
-    def dispense_to(self, slot:str, well:str, amount:int):
-        """Dispense a volume of liquid to a slot."""
+    def dispense_to(self, slot:str, well:str, amount:int, height_from_bottom: float = 0.0):
+        """
+        Dispense a volume of liquid to a slot.
+        
+        Args:
+            slot: Slot name (e.g., 'A1', 'B2')
+            well: Well name within the slot (e.g., 'A1')
+            amount: Volume to dispense in µL
+            height_from_bottom: Height from the bottom of the well in mm. Defaults to 0.0.
+                               Positive values move up from the bottom. Negative values
+                               may cause a ValueError if the resulting position is outside
+                               the Z axis limits.
+        
+        Raises:
+            ValueError: If no tip is attached, or if the resulting position is outside
+                       the Z axis limits.
+        """
         if not self.pipette.is_tip_attached():
             self._logger.error("Cannot dispense: no tip attached")
             raise ValueError("Tip not attached")
         
         self._logger.info("Dispensing %d µL to slot '%s', well '%s'", amount, slot, well)
         pos = self.get_absolute_z_position(slot, well)
+        # add height from bottom
+        pos += Position(z=height_from_bottom)
         self._logger.debug("Moving Z axis to position %s", pos)
         self.qubot.move_absolute(position=pos)
+
         self._logger.debug("Dispensing %d µL", amount)
         self.pipette.dispense(amount=amount)
         time.sleep(5)
@@ -275,8 +327,7 @@ class First:
             # the deck is rotated 90 degrees clockwise for this machine
             pos += well_pos.swap_xy()
             # get z
-            z = Position(z=self.deck[slot].get_height() - self.CEILING_HEIGHT)
-            pos += z
+            pos += Position(z=self.deck[slot].get_height() - self.CEILING_HEIGHT)
             self._logger.debug("Absolute Z position for slot '%s', well '%s': %s", slot, well, pos)
         else:
             self._logger.debug("Absolute Z position for slot '%s': %s", slot, pos)

{puda_drivers-0.0.10.dist-info → puda_drivers-0.0.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: puda-drivers
-Version: 0.0.10
+Version: 0.0.11
 Summary: Hardware drivers for the PUDA platform.
 Project-URL: Homepage, https://github.com/zhao-bears/puda-drivers
 Project-URL: Issues, https://github.com/zhao-bears/puda-drivers/issues
@@ -123,8 +123,8 @@ machine.camera.start_video_recording()
 
 # Perform liquid handling operations
 machine.attach_tip(slot="A3", well="G8")
-machine.aspirate_from(slot="C2", well="A1", amount=100)
-machine.dispense_to(slot="C2", well="B4", amount=100)
+machine.aspirate_from(slot="C2", well="A1", amount=100, height_from_bottom=10.0)
+machine.dispense_to(slot="C2", well="B4", amount=100, height_from_bottom=30.0)
 machine.drop_tip(slot="C1", well="A1")
 
 # Stop video recording

{puda_drivers-0.0.10.dist-info → puda_drivers-0.0.11.dist-info}/RECORD

@@ -9,10 +9,10 @@ puda_drivers/cv/camera.py,sha256=Tzxt1h3W5Z8XFanud_z-PhhJ2UYsC4OEhcak9TVu8jM,164
 puda_drivers/labware/__init__.py,sha256=RlRxrJn2zyzyxv4c1KGt8Gmxv2cRO8V4zZVnnyL-I00,288
 puda_drivers/labware/labware.py,sha256=hZhOzSyb1GP_bm1LvQsREx4YSqLCWBTKNWDgDqfFavI,5317
 puda_drivers/labware/opentrons_96_tiprack_300ul.json,sha256=jmNaworu688GEgFdxMxNRSaEp4ZOg9IumFk8bVHSzYY,19796
-puda_drivers/labware/polyelectric_8_wellplate_30000ul.json,sha256=NwXMgHBYnIIFasmrthTDTTV7n1M5DYQBDWh-KYsq1gI,3104
-puda_drivers/labware/trash_bin.json,sha256=X4TDNDzGbCtJSWlYgGYHUzdnVKj62SggGDNf7z5S0OE,581
+puda_drivers/labware/polyelectric_8_wellplate_30000ul.json,sha256=esu2tej0ORs7Pfd4HwoQVUpU5mPvp2AYzE3zsCC2FDk,3104
+puda_drivers/labware/trash_bin.json,sha256=Hk4MXO48P28jG7F87DUd9Ja4c_P7kAy3karPQ965i9Y,580
 puda_drivers/machines/__init__.py,sha256=zmIk_r2T8nbPA68h3Cko8N6oL7ncoBpmvhNcAqzHmc4,45
-puda_drivers/machines/first.py,sha256=9Im7jiw2duOBbBQEOxVkqFApPDRlGfI87OoyJ-M4SJE,12122
+puda_drivers/machines/first.py,sha256=F1D-Te25cUJamE-FG_BEcY2PgN0_6S81ImdhNDeupCk,14415
 puda_drivers/move/__init__.py,sha256=NKIKckcqgyviPM0EGFcmIoaqkJM4qekR4babfdddRzM,96
 puda_drivers/move/deck.py,sha256=yq2B4WMqj0hQvHt8HoJskP10u1DUyKwUnjP2c9gJ174,1397
 puda_drivers/move/gcode.py,sha256=Aw7la4RkPw737hW5sKl6WiPCmmTnsjLvG4mOb-RwVSc,22592
@@ -23,7 +23,7 @@ puda_drivers/transfer/liquid/sartorius/__init__.py,sha256=QGpKz5YUwa8xCdSMXeZ0iR
 puda_drivers/transfer/liquid/sartorius/api.py,sha256=jxwIJmY2k1K2ts6NC2ZgFTe4MOiH8TGnJeqYOqNa3rE,28250
 puda_drivers/transfer/liquid/sartorius/constants.py,sha256=mcsjLrVBH-RSodH-pszstwcEL9wwbV0vOgHbGNxZz9w,2770
 puda_drivers/transfer/liquid/sartorius/sartorius.py,sha256=bW838jYOAfLlbUqtsKRipZ-RLjrNTcZ7riYV6I4w8G8,13728
-puda_drivers-0.0.10.dist-info/METADATA,sha256=oEbn6NvV9bXfJZusYV49ri1V1aPFR3n2qjKTp3vJ5R0,6991
-puda_drivers-0.0.10.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-puda_drivers-0.0.10.dist-info/licenses/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
-puda_drivers-0.0.10.dist-info/RECORD,,
+puda_drivers-0.0.11.dist-info/METADATA,sha256=b6LZSNkAD3RG4cjghtm2DcNwFEbK1nIgDJazlUfhYRQ,7041
+puda_drivers-0.0.11.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+puda_drivers-0.0.11.dist-info/licenses/LICENSE,sha256=7EI8xVBu6h_7_JlVw-yPhhOZlpY9hP8wal7kHtqKT_E,1074
+puda_drivers-0.0.11.dist-info/RECORD,,