pylabrobot.liquid_handling.liquid_handler.LiquidHandler.move_plate#

async LiquidHandler.move_plate(plate: Plate, to: ResourceStack | ResourceHolder | Resource | Coordinate, intermediate_locations: List[Coordinate] | None = None, resource_offset: Coordinate | None = None, pickup_offset: Coordinate = Coordinate(x=0, y=0, z=0), destination_offset: Coordinate = Coordinate(x=0, y=0, z=0), drop_direction: GripDirection = GripDirection.FRONT, pickup_direction: GripDirection = GripDirection.FRONT, get_direction: GripDirection | None = None, put_direction: GripDirection | None = None, pickup_distance_from_top: float = 9.87, **backend_kwargs)#

Move a plate to a new location.

A convenience method for move_resource().

Examples

Move a plate to into a carrier spot:

>>> await lh.move_plate(plate, plt_car[1])

Move a plate to an absolute location:

>>> await lh.move_plate(plate_01, Coordinate(100, 100, 100))

Move a lid to another carrier spot, grabbing it from the left side:

>>> await lh.move_plate(plate, plt_car[1], pickup_direction=GripDirection.LEFT)
>>> await lh.move_plate(plate, plt_car[0], drop_direction=GripDirection.LEFT)

Move a resource while visiting a few intermediate locations along the way:

>>> await lh.move_plate(plate, plt_car[1], intermediate_locations=[
...   Coordinate(100, 100, 100),
...   Coordinate(200, 200, 200),
... ])
Parameters:

  • plate (Plate) – The plate to move. Can be either a Plate object or a ResourceHolder object.

  • to (ResourceStack | ResourceHolder | Resource | Coordinate) – The location to move the plate to, either a plate, ResourceHolder or a Coordinate.

  • pickup_offset (Coordinate) – The offset from the resource’s origin, optional (rarely necessary).

  • destination_offset (Coordinate) – The offset from the location’s origin, optional (rarely necessary).

  • intermediate_locations (List[Coordinate] | None)

  • resource_offset (Coordinate | None)

  • drop_direction (GripDirection)

  • pickup_direction (GripDirection)

  • get_direction (GripDirection | None)

  • put_direction (GripDirection | None)

  • pickup_distance_from_top (float)