opentrons 8.0.0a7__py2.py3-none-any.whl → 8.0.0a9__py2.py3-none-any.whl

opentrons/protocol_engine/commands/liquid_probe.py

@@ -2,7 +2,11 @@
 
 from __future__ import annotations
 from typing import TYPE_CHECKING, Optional, Type, Union
-from opentrons.protocol_engine.errors.exceptions import MustHomeError, TipNotEmptyError
+from opentrons.protocol_engine.errors.exceptions import (
+    MustHomeError,
+    PipetteNotReadyToAspirateError,
+    TipNotEmptyError,
+)
 from opentrons.types import MountType
 from opentrons_shared_data.errors.exceptions import (
     PipetteLiquidNotFoundError,
@@ -32,6 +36,7 @@ from ..errors.error_occurrence import ErrorOccurrence
 if TYPE_CHECKING:
     from ..execution import MovementHandler, PipettingHandler
     from ..resources import ModelUtils
+    from ..state import StateView
 
 
 LiquidProbeCommandType = Literal["liquidProbe"]
@@ -92,11 +97,13 @@ class LiquidProbeImplementation(
 
     def __init__(
         self,
+        state_view: StateView,
         movement: MovementHandler,
         pipetting: PipettingHandler,
         model_utils: ModelUtils,
         **kwargs: object,
     ) -> None:
+        self._state_view = state_view
         self._movement = movement
         self._pipetting = pipetting
         self._model_utils = model_utils
@@ -112,6 +119,8 @@ class LiquidProbeImplementation(
                 the pipette.
             TipNotEmptyError: as an undefined error, if the tip starts with liquid
                 in it.
+            PipetteNotReadyToAspirateError: as an undefined error, if the plunger is not
+                in a safe position to do the liquid probe.
             MustHomeError: as an undefined error, if the plunger is not in a valid
                 position.
         """
@@ -119,13 +128,21 @@ class LiquidProbeImplementation(
         labware_id = params.labwareId
         well_name = params.wellName
 
-        # _validate_tip_attached in pipetting.py is a private method so we're using
-        # get_is_ready_to_aspirate as an indirect way to throw a TipNotAttachedError if appropriate
-        self._pipetting.get_is_ready_to_aspirate(pipette_id=pipette_id)
-
-        if self._pipetting.get_is_empty(pipette_id=pipette_id) is False:
+        # May raise TipNotAttachedError.
+        aspirated_volume = self._state_view.pipettes.get_aspirated_volume(pipette_id)
+
+        if aspirated_volume is None:
+            # Theoretically, we could avoid raising an error by automatically preparing
+            # to aspirate above the well like AspirateImplementation does. However, the
+            # only way for this to happen is if someone tries to do a liquid probe with
+            # a tip that's previously held liquid, which they should avoid anyway.
+            raise PipetteNotReadyToAspirateError(
+                "The pipette cannot probe liquid because of a previous blow out."
+                " The plunger must be reset while the tip is somewhere away from liquid."
+            )
+        elif aspirated_volume != 0:
             raise TipNotEmptyError(
-                message="This operation requires a tip with no liquid in it."
+                message="The pipette cannot probe for liquid when the tip has liquid in it."
             )
 
         if await self._movement.check_for_valid_position(mount=MountType.LEFT) is False:
@@ -182,11 +199,13 @@ class TryLiquidProbeImplementation(
 
     def __init__(
         self,
+        state_view: StateView,
         movement: MovementHandler,
         pipetting: PipettingHandler,
         model_utils: ModelUtils,
         **kwargs: object,
     ) -> None:
+        self._state_view = state_view
         self._movement = movement
         self._pipetting = pipetting
         self._model_utils = model_utils
@@ -203,6 +222,7 @@ class TryLiquidProbeImplementation(
         # Otherwise, we return the result or propagate the exception unchanged.
 
         original_impl = LiquidProbeImplementation(
+            state_view=self._state_view,
             movement=self._movement,
             pipetting=self._pipetting,
             model_utils=self._model_utils,

opentrons/protocol_engine/execution/pipetting.py

@@ -29,9 +29,6 @@ _VOLUME_ROUNDING_ERROR_TOLERANCE = 1e-9
 class PipettingHandler(TypingProtocol):
     """Liquid handling commands."""
 
-    def get_is_empty(self, pipette_id: str) -> bool:
-        """Get whether a pipette has an aspirated volume equal to 0."""
-
     def get_is_ready_to_aspirate(self, pipette_id: str) -> bool:
         """Get whether a pipette is ready to aspirate."""
 
@@ -81,10 +78,6 @@ class HardwarePipettingHandler(PipettingHandler):
         self._state_view = state_view
         self._hardware_api = hardware_api
 
-    def get_is_empty(self, pipette_id: str) -> bool:
-        """Get whether a pipette has an aspirated volume equal to 0."""
-        return self._state_view.pipettes.get_aspirated_volume(pipette_id) == 0
-
     def get_is_ready_to_aspirate(self, pipette_id: str) -> bool:
         """Get whether a pipette is ready to aspirate."""
         hw_pipette = self._state_view.pipettes.get_hardware_pipette(
@@ -236,10 +229,6 @@ class VirtualPipettingHandler(PipettingHandler):
         """Initialize a PipettingHandler instance."""
         self._state_view = state_view
 
-    def get_is_empty(self, pipette_id: str) -> bool:
-        """Get whether a pipette has an aspirated volume equal to 0."""
-        return self._state_view.pipettes.get_aspirated_volume(pipette_id) == 0
-
     def get_is_ready_to_aspirate(self, pipette_id: str) -> bool:
         """Get whether a pipette is ready to aspirate."""
         return self._state_view.pipettes.get_aspirated_volume(pipette_id) is not None

opentrons/protocol_engine/execution/tip_handler.py

@@ -302,12 +302,29 @@ class HardwareTipHandler(TipHandler):
         This function will raise an exception if the specified tip presence status
         isn't matched.
         """
+        nozzle_configuration = (
+            self._state_view.pipettes.state.nozzle_configuration_by_id[pipette_id]
+        )
+
+        # Configuration metrics by which tip presence checking is ignored
+        unsupported_pipette_types = [8, 96]
+        unsupported_layout_types = [
+            NozzleConfigurationType.SINGLE,
+            NozzleConfigurationType.COLUMN,
+        ]
+        # NOTE: (09-20-2024) Current on multi-channel pipettes, utilizing less than 4 nozzles risks false positives on the tip presence sensor
+        supported_partial_nozzle_minimum = 4
+
         if (
-            self._state_view.pipettes.get_nozzle_layout_type(pipette_id)
-            == NozzleConfigurationType.SINGLE
-            and self._state_view.pipettes.get_channels(pipette_id) == 96
+            nozzle_configuration is not None
+            and self._state_view.pipettes.get_channels(pipette_id)
+            in unsupported_pipette_types
+            and nozzle_configuration.configuration in unsupported_layout_types
+            and len(nozzle_configuration.map_store) < supported_partial_nozzle_minimum
         ):
-            # Tip presence sensing is not supported for single tip pick up on the 96ch Flex Pipette
+            # Tip presence sensing is not supported for single tip pick up on the 96ch Flex Pipette, nor with single and some partial layous of the 8ch Flex Pipette.
+            # This is due in part to a press distance tolerance which creates a risk case for false positives. In the case of single tip, the mechanical tolerance
+            # for presses with 100% success is below the minimum average achieved press distance for a given multi channel pipette in that configuration.
             return
         try:
             ot3api = ensure_ot3_hardware(hardware_api=self._hardware_api)

opentrons/protocol_engine/state/pipettes.py

@@ -611,7 +611,7 @@ class PipetteView(HasState[PipetteState]):
 
         Returns:
             The volume the pipette has aspirated.
-            None, after blow-out and the plunger is in an unsafe position or drop-tip and there is no tip attached.
+            None, after blow-out and the plunger is in an unsafe position.
 
         Raises:
             PipetteNotLoadedError: pipette ID does not exist.

{opentrons-8.0.0a7.dist-info → opentrons-8.0.0a9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: opentrons
-Version: 8.0.0a7
+Version: 8.0.0a9
 Summary: The Opentrons API is a simple framework designed to make writing automated biology lab protocols easy.
 Author: Opentrons
 Author-email: engineering@opentrons.com
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Topic :: Scientific/Engineering
 Requires-Python: >=3.10
 License-File: ../LICENSE
-Requires-Dist: opentrons-shared-data ==8.0.0a7
+Requires-Dist: opentrons-shared-data ==8.0.0a9
 Requires-Dist: aionotify ==0.3.1
 Requires-Dist: anyio <4.0.0,>=3.6.1
 Requires-Dist: jsonschema <4.18.0,>=3.0.1
@@ -33,9 +33,9 @@ Requires-Dist: click <9,>=8.0.0
 Requires-Dist: packaging >=21.0
 Requires-Dist: importlib-metadata >=1.0 ; python_version < "3.8"
 Provides-Extra: flex-hardware
-Requires-Dist: opentrons-hardware[flex] ==8.0.0a7 ; extra == 'flex-hardware'
+Requires-Dist: opentrons-hardware[flex] ==8.0.0a9 ; extra == 'flex-hardware'
 Provides-Extra: ot2-hardware
-Requires-Dist: opentrons-hardware ==8.0.0a7 ; extra == 'ot2-hardware'
+Requires-Dist: opentrons-hardware ==8.0.0a9 ; extra == 'ot2-hardware'
 
 .. _Full API Documentation: http://docs.opentrons.com
 

{opentrons-8.0.0a7.dist-info → opentrons-8.0.0a9.dist-info}/RECORD

@@ -296,7 +296,7 @@ opentrons/protocol_engine/commands/generate_command_schema.py,sha256=w5RsTJV4HtF
 opentrons/protocol_engine/commands/get_tip_presence.py,sha256=Jh1tDMGe8HWL0a1uq1E-RuSuAFZuME0F6RFrB2yRuUo,2539
 opentrons/protocol_engine/commands/hash_command_params.py,sha256=obWy4TbVH97SyhNqrSD6iP1wgZ20JoaH1rilZCjXxIs,1530
 opentrons/protocol_engine/commands/home.py,sha256=3FtygvsJUUQryFQpAXTOfrjJ_rNkOJJa25VzpRSrPfA,2766
-opentrons/protocol_engine/commands/liquid_probe.py,sha256=I95WqfD9U9B6hm1m39fshq6Ad7uipMYXuTISLJhVM9M,9318
+opentrons/protocol_engine/commands/liquid_probe.py,sha256=mVrRFvNI28wXauiRMVXAW493wvb5rq66gdfYMwdEpms,10197
 opentrons/protocol_engine/commands/load_labware.py,sha256=yHCdamAKoIMOAZKH1ROx2W8-xwlhvjOWusVo9tarj9E,6623
 opentrons/protocol_engine/commands/load_liquid.py,sha256=fPaETCUB1LRL6wga-uKJARzN3uDB7JjX9k8hV5a5wpY,2371
 opentrons/protocol_engine/commands/load_module.py,sha256=tfNgKRUHyawoxfyM6amQScqN2JAerXCtf46M_lml1rY,7544
@@ -371,14 +371,14 @@ opentrons/protocol_engine/execution/hardware_stopper.py,sha256=kjvinwg6uPc3lDNlL
 opentrons/protocol_engine/execution/heater_shaker_movement_flagger.py,sha256=FMqiJjE2L6Ru3x3zTCntT9ts7o_Q4wExrcQb03xZd9I,9287
 opentrons/protocol_engine/execution/labware_movement.py,sha256=x-oZWh4p9QO6AhFxYo-68Ubv7wqnfIFteWsjkdutLg4,9832
 opentrons/protocol_engine/execution/movement.py,sha256=MaLBVcca3C90kRvedRToNZvOe92tYQ-x5oFynN1K0Po,10902
-opentrons/protocol_engine/execution/pipetting.py,sha256=9iAPL-cc_gcST-cGQ-fC2FV54Qm4DnGRtS5Du9ERKgA,14769
+opentrons/protocol_engine/execution/pipetting.py,sha256=gtWiIUlxlRfEkiT6ztAwiu3_hUzudY-ZQWu3iOZUzos,14233
 opentrons/protocol_engine/execution/queue_worker.py,sha256=3bVTnwOur8mgwLKVATAzKCYWxwrYajHRmykr9PbhTZc,2706
 opentrons/protocol_engine/execution/rail_lights.py,sha256=eiJT6oI_kFk7rFuFkZzISZiLNnpf7Kkh86Kyk9wQ_Jo,590
 opentrons/protocol_engine/execution/run_control.py,sha256=vWLSRdkds2CrtsJ0IU9hX-oTsNPrXJ5RZ9cq7ekO80c,1138
 opentrons/protocol_engine/execution/status_bar.py,sha256=tR7CHS_y1ARQxcSKDO4YFU2cqVQhePzalmzsyH8b23A,970
 opentrons/protocol_engine/execution/thermocycler_movement_flagger.py,sha256=if_jbmszy2MFMJCEMwt_fP_h0T1OBnHrQyI4jtUygvY,6784
 opentrons/protocol_engine/execution/thermocycler_plate_lifter.py,sha256=SPzuiyNNB05YPb_czPr8KmnvBwmXTszvngW1CX3HVd4,3309
-opentrons/protocol_engine/execution/tip_handler.py,sha256=AWVJXR9R91KvQWeRhVGXyoPzCDhLmGtyyRwqBAqjv8E,15405
+opentrons/protocol_engine/execution/tip_handler.py,sha256=SoZ4bEMWWDwFcwkL3tbZYxVTntVaTISJjrfu3DzNHdE,16484
 opentrons/protocol_engine/notes/__init__.py,sha256=JRh7fKZ4XLUSQOZeI853MYkAZpKvp34RY8yDAHzcEbk,197
 opentrons/protocol_engine/notes/notes.py,sha256=RlLpfElzIa_p51ECCug7Fueq2VHRUeBTtnk-2zQerp0,1419
 opentrons/protocol_engine/resources/__init__.py,sha256=-tuKcd2Fn3YKWDX-tDqgZYv5MOSekGqHaHSoE1XDY3M,745
@@ -403,7 +403,7 @@ opentrons/protocol_engine/state/liquids.py,sha256=W7cf-mmVaZ3aNyiormFEy79aSvU__Q
 opentrons/protocol_engine/state/modules.py,sha256=bylqsYZyVjrnx6BUhDjJb-TofnqPNk0EUYV8j12UINE,50673
 opentrons/protocol_engine/state/motion.py,sha256=nh0UGOVvmpYynOchGJkVLTyIyiJ9CszRTUvp4Czr_GI,13955
 opentrons/protocol_engine/state/move_types.py,sha256=zSQj_qYHBi7_-wrpaZBKmX_O-wNZCpLZkCzagOwI-zY,2132
-opentrons/protocol_engine/state/pipettes.py,sha256=PK57-a2A5wkRwRW0OaEAPVeioN38aCOo9iZrByxT-I4,37350
+opentrons/protocol_engine/state/pipettes.py,sha256=F026AaXUPe5VcNQ__C91y_qHhvbPWI7d17tKgYacaVc,37309
 opentrons/protocol_engine/state/state.py,sha256=jx044yBfXFV1YO5aqXhJmy7iFx-tXEQ5rIl3lMcrY04,13562
 opentrons/protocol_engine/state/state_summary.py,sha256=8VCxEOBeUflx8IBYUYtgNdwcwgdVZv3R8rSfzsbai7U,923
 opentrons/protocol_engine/state/tips.py,sha256=gU2GsmaWPDyIIjWHj3KXv6NqxphfOd4eeNxF40hm5ok,22621
@@ -500,9 +500,9 @@ opentrons/util/helpers.py,sha256=3hr801bWGbxEcOFAS7f-iOhmnUhoK5qahbB8SIvaCfY,165
 opentrons/util/linal.py,sha256=IlKAP9HkNBBgULeSf4YVwSKHdx9jnCjSr7nvDvlRALg,5753
 opentrons/util/logging_config.py,sha256=g3TdzDKa1pL_N3eKhRYCdqPaZYe_hpLV-e8llObTcT4,5657
 opentrons/util/performance_helpers.py,sha256=ew7H8XD20iS6-2TJAzbQeyzStZkkE6PzHt_Adx3wbZQ,5172
-opentrons-8.0.0a7.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-opentrons-8.0.0a7.dist-info/METADATA,sha256=t9_kvk6apuDByc7BPI8F4cM_TSe62ivSF71v5mpv0yQ,4990
-opentrons-8.0.0a7.dist-info/WHEEL,sha256=_4XEmVmaBFWtekSGrbfOGNjC2I5lUr0lZSRblBllIFA,109
-opentrons-8.0.0a7.dist-info/entry_points.txt,sha256=fTa6eGCYkvOtv0ov-KVE8LLGetgb35LQLF9x85OWPVw,106
-opentrons-8.0.0a7.dist-info/top_level.txt,sha256=wk6whpbMZdBQpcK0Fg0YVfUGrAgVOFON7oQAhOMGMW8,10
-opentrons-8.0.0a7.dist-info/RECORD,,
+opentrons-8.0.0a9.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+opentrons-8.0.0a9.dist-info/METADATA,sha256=X9jHd468ULxCHBHVUUg4xfI2oTPaIEHoi2Ka7xoGdg4,4990
+opentrons-8.0.0a9.dist-info/WHEEL,sha256=_4XEmVmaBFWtekSGrbfOGNjC2I5lUr0lZSRblBllIFA,109
+opentrons-8.0.0a9.dist-info/entry_points.txt,sha256=fTa6eGCYkvOtv0ov-KVE8LLGetgb35LQLF9x85OWPVw,106
+opentrons-8.0.0a9.dist-info/top_level.txt,sha256=wk6whpbMZdBQpcK0Fg0YVfUGrAgVOFON7oQAhOMGMW8,10
+opentrons-8.0.0a9.dist-info/RECORD,,