Build lh.probe_tip_presence_via_pickup()

[BioCam]

Hi everyone,

In this PR I am proposing the addition of the "atomic command" for tip_probing:

  async def probe_tip_presence_via_pickup(
    self,
    tip_spots: List[TipSpot],
    use_channels: Optional[List[int]] = None
) -> List[int]:
    """
    Probe tip presence by attempting pickup on each TipSpot.

    Args:
        tip_spots: TipSpots to probe.
        use_channels: Channels to use (must match tip_spots length).

    Returns:
        List[int]: 1 if tip is present, 0 otherwise.
    """

This is step 1 of a multi-feature generation process:

Build lh.probe_tip_presence_via_pickup()
Build measured_tip_inventory = lh.probe_tip_inventory(probing_mode=lh.probe_tip_presence_via_pickup)
Build lh.update_tip_inventory(measured_tip_inventory)
Build lh.consolidate_tip_inventory()

For further details please see the user & developer forum thread:
https://discuss.pylabrobot.org/t/liquid-handler-auto-detection-of-real-tip-presence/212/3

[rickwierenga]

wouldn't you want to return a bool?

[BioCam]

I found it doesn't matter: The important point is that the returns of this method (a list of True/False or 1/0) will be used in simple array/matrix additions/subtractions.
For that purpose True/False or 1/0 are equivalent.

I am happy to change it to True / False :)

[rickwierenga]

maybe if any(successful) so it's more readable

[rickwierenga]

how do you know it's this cluster?

[rickwierenga]

is list conversion necessary?

[rickwierenga]

very nice and clever feature addition!

atomic command

i wouldn't call this an atomic command since it uses the atomic command pick_up_tips. (it requires no changes to the backend! - any backend in PLR that raises the appropriate error will get this functionality for free)