pylabrobot.opentrons.flex.flex_head.FlexHead1.aspirate

async FlexHead1.aspirate(target: Well | Container, volume: float, flow_rate: float | None = None, offset: Coordinate | None = None, liquid_height: float | None = None) → None

Aspirate from a well or single-cavity container using PLR coordinates and in-place aspiration.

A Well is addressed through its plate parent by well name; a bare Container (trough/reservoir) at its own sole well. Requires a mounted tip. Follows stage -> validate -> wire -> commit/rollback: the tracker (remove_liquid) is staged BEFORE the wire command, so an infeasible aspirate raises before any hardware motion. The head primes at traversal height before descending to the PLR cavity floor plus clearance.

Parameters:

• target (Well | Container)

• volume (float)

• flow_rate (float | None)

• offset (Coordinate | None)

• liquid_height (float | None)

Return type:

None