pylabrobot.liquid_handling.liquid_handler.LiquidHandler.use_tips#

LiquidHandler.use_tips(tip_spots: List[TipSpot], channels: List[int] | None = None, discard: bool = True)#

Temporarily pick up tips from the specified tip spots on the specified channels.

This is a convenience method that picks up tips from tip_spots on channels when entering the context, and discards them when exiting the context. When passing discard=False, the tips will be returned instead of discarded.

Examples

Use tips from A1 to H1 on channels 0 to 7, then discard:

>>> with lh.use_tips(tip_rack["A1":"H1"], channels=list(range(8))):
...   await lh.aspirate(plate["A1":"H1"], vols=[50]*8)
...   await lh.dispense(plate["A1":"H1"], vols=[50]*8)

This is equivalent to:

>>> await lh.pick_up_tips(tip_rack["A1":"H1"], use_channels=list(range(8)))
>>> await lh.aspirate(plate["A1":"H1"], vols=[50]*8, use_channels=list(range(8)))
>>> await lh.dispense(plate["A1":"H1"], vols=[50]*8, use_channels=list(range(8)))
>>> await lh.discard_tips(use_channels=list(range(8)))

Use tips from A1 to H1 on channels 0 to 7, but return them instead of discarding:

>>> with lh.use_tips(tip_rack["A1":"H1"], channels=list(range(8)), discard=False):
...   await lh.aspirate(plate["A1":"H1"], vols=[50]*8)
...   await lh.dispense(plate["A1":"H1"], vols=[50]*8)

This is equivalent to:

>>> await lh.pick_up_tips(tip_rack["A1":"H1"], use_channels=list(range(8)))
>>> await lh.aspirate(plate["A1":"H1"], vols=[50]*8, use_channels=list(range(8)))
>>> await lh.dispense(plate["A1":"H1"], vols=[50]*8, use_channels=list(range(8)))
>>> await lh.return_tips(use_channels=list(range(8)))
Parameters: