robotools.fluenttools

class robotools.fluenttools.worklist.FluentWorklist(filepath: str | Path | None = None, max_volume: int | float = 950, auto_split: bool = True, diti_mode: bool = False)

Bases: BaseWorklist

Context manager for the creation of Tecan Fluent worklists.

Attributes:

filepath

Path to which the worklist will write, if specified.

Methods

append(object, /)	Append object to the end of the list.
aspirate(labware, wells, volumes, *[, ...])	Performs aspiration from the provided labware.
aspirate_well(rack_label, position, volume, *)	Command for aspirating with a single tip.
clear(/)	Remove all items from list.
comment(comment)	Adds a comment.
commit()	Inserts a 'break' that forces the execution of aspirate/dispense operations at this point.
copy(/)	Return a shallow copy of the list.
count(value, /)	Return number of occurrences of value.
decontaminate()	Decontamination wash consists of a decontamination wash followed by a normal wash.
dispense(labware, wells, volumes, *[, ...])	Performs dispensing into the provided labware.
dispense_well(rack_label, position, volume, *)	Command for dispensing with a single tip.
distribute(source, source_column, ...[, ...])	Transfers from a Trough into many destination wells using multi-pipetting.
extend(iterable, /)	Extend list by appending elements from the iterable.
flush()	Discards the contents of the tips WITHOUT WASHING or DROPPING of tips.
index(value[, start, stop])	Return first index of value.
insert(index, object, /)	Insert object before index.
pop([index])	Remove and return item at index (default last).
reagent_distribution(src_rack_label, ...[, ...])	Transfers from a Trough into many destination wells using multi-pipetting.
remove(value, /)	Remove first occurrence of value.
reverse(/)	Reverse IN PLACE.
save(filepath)	Writes the worklist to the filepath.
set_diti(diti_index)	Switches the DiTi types within the worklist.
sort(*[, key, reverse])	Sort the list in ascending order and return None.
transfer(source, source_wells, destination, ...)	Transfer operation between two labwares.
wash([scheme])	Washes fixed tips or replaces DiTis.

transfer(source: Labware, source_wells: str | Sequence[str] | ndarray, destination: Labware, destination_wells: str | Sequence[str] | ndarray, volumes: float | Sequence[float] | ndarray, *, label: str | None = None, wash_scheme: Literal[1, 2, 3, 4, 'flush', 'reuse'] = 1, partition_by: str = 'auto', on_underflow: Literal['debug', 'warn', 'raise'] = 'raise', **kwargs) → None

Transfer operation between two labwares.

Parameters:

source

Source labware

source_wells

List of source well ids

destination

Destination labware

destination_wells

List of destination well ids

volumes

Volume(s) to transfer

label

Label of the operation to log into labware history

wash_scheme

• One of {1, 2, 3, 4} to select a wash scheme for fixed tips,

or drop tips when using DiTis. - "flush" blows out tips, but does not drop DiTis, and only does a short wash with fixed tips. - "reuse" continues pipetting without flushing, dropping or washing. Passing None is deprecated, results in "flush" behavior and emits a warning.

partition_bystr

one of ‘auto’ (default), ‘source’ or ‘destination’

‘auto’: partitioning by source unless the source is a Trough ‘source’: partitioning by source columns ‘destination’: partitioning by destination columns

on_underflow

What to do about volume underflows (going below vmin) in non-empty wells.

Options:

• "debug" mentions the underflowing wells in a log message at DEBUG level.

• "warn" emits an VolumeUnderflowWarning. This can be captured in unit tests.

• "raise" raises a VolumeUnderflowError about underflowing wells.

kwargs

Additional keyword arguments to pass to aspirate and dispense. Most prominent example: liquid_class. Take a look at Worklist.aspirate_well for the full list of options.

Generic utility functions.

robotools.fluenttools.utils.get_well_position(labware: Labware, well: str) → int

Calculate the EVO-style well position from the alphanumeric ID.