aspirate_ml

Description

Aspirates a given volume into the syringe. This method requires the volume of the syringe installed in the pump to be set correctly in the project file, generally done through the NorthIDE. Does not move valves. Only calculates and effects the required plunger motion to achieve the target aspiration volume.

Signature

aspirate_ml(self, pump_num: int, ml: float, wait: bool = True) -> CmdToken

Parameters

pump_num: int

The address of the aspirating pump, [0, 14].


ml: float

The volume to aspirate in units of mL.


wait: bool, optional

If True, this command blocks until the move is complete.

Returns

CmdToken

A CmdToken object that can be used to follow up on the status of the aspiration or wait for it ot finish if wait = False.


RuntimeError

If the requested volume exceeds the available volume of the syringe.

Example