pylabrobot.liquid_handling.liquid_handler.LiquidHandler.dispense#
- async LiquidHandler.dispense(resources: Container | Sequence[Container], vols: List[float] | float, use_channels: List[int] | None = None, flow_rates: float | List[float | None] | None = None, end_delay: float = 0, offsets: Coordinate | None | Sequence[Coordinate | None] = None, liquid_height: float | None | List[float | None] = None, blow_out_air_volume: float | None | List[float | None] = None, **backend_kwargs)#
Dispense liquid to the specified channels.
Examples
Dispense a constant amount of liquid to the first column:
>>> lh.dispense(plate["A1:H1"], 50)
Dispense an linearly increasing amount of liquid to the first column:
>>> lh.dispense(plate["A1:H1"], range(0, 500, 50))
Dispense arbitrary amounts of liquid to the first column:
>>> lh.dispense(plate["A1:H1"], [0, 40, 10, 50, 100, 200, 300, 400])
Dispense liquid to wells in different plates:
>>> lh.dispense((plate["A1"], 50), (plate2["A1"], 50), (plate3["A1"], 50))
Dispensing with a 10mm z-offset:
>>> lh.dispense(plate["A1"], vols=50, offsets=[Coordinate(0, 0, 10)])
Dispense a blue bucket (big container), with the first 4 channels (which will be spaced equally apart):
>>> lh.dispense(blue_bucket, vols=50, use_channels=[0, 1, 2, 3])
- Parameters:
wells – A list of resources to dispense liquid to. Can be a list of resources, or a single resource, in which case all channels will dispense to that resource.
vols (List[float] | float) – A list of volumes to dispense, one for each channel, or a single volume to dispense to all channels. If
vols
is a single number, then all channels will dispense that volume. In units of ul.use_channels (List[int] | None) – List of channels to use. Index from front to back. If
None
, the firstlen(channels)
channels will be used.flow_rates (float | List[float | None] | None) – the flow rates, in ul/s. If
None
, the backend default will be used.end_delay (float) – The delay after the last dispense in seconds, optional. This is useful for when the tips used in the dispense are dripping.
offsets (Coordinate | None | Sequence[Coordinate | None]) – List of offsets for each channel, a translation that will be applied to the dispense location. If
None
, no offset will be applied.liquid_height (float | None | List[float | None]) – The height of the liquid in the well wrt the bottom, in mm.
blow_out_air_volume (float | None | List[float | None]) – The volume of air to dispense after the liquid, in ul. If
None
, the backend default will be used.backend_kwargs – Additional keyword arguments for the backend, optional.
- Raises:
RuntimeError – If the setup has not been run. See
setup()
.ValueError – If the dispense info is invalid, in other words, when all channels are
None
.ValueError – If all channels are
None
.