pylabrobot.opentrons.flex.flex_head.FlexHead96.aspirate

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

Aspirate a whole plate or one single-cavity container using PLR coordinates and in-place aspiration.

A Plate (which must have exactly 96 positions) is anchored at its “A1” well and covered one-to-one, staging remove_liquid per well whose channel holds a tip. A bare Container (trough/reservoir) is positioned with the nozzle grid centered in the PLR cavity and its single tracker staged with the total. Either way a mounted tip is required and every check runs before any wire command. The head primes at traversal height, descends using PLR coordinates, aspirates in place, and retracts vertically.

Parameters:

• target (Plate | Container)

• volume (float)

• flow_rate (float | None)

• offset (Coordinate | None)

• liquid_height (float | None)

Return type:

None