pylabrobot.formulatrix.mantis.driver.features.arm.Arm.move_to_xy_position#

async Arm.move_to_xy_position(*, x: float, y: float, minimum_traverse_height_start: float | None = None, speed: float | None = None, acceleration: float | None = None) → None#

Move the nozzle across to (x, y) in the deck frame, guarded: Z rises first to the traverse height if it is below it, then the arms move with Z held. Nothing avoids the chip racks.

Over the plate holder the unit’s stage transform places it; elsewhere the arm frame fitted to it. From an approach path the head first leaves along it.

Parameters:
  • x (float) – right of the deck’s front-left corner, mm.

  • y (float) – behind the deck’s front-left corner, mm.

  • minimum_traverse_height_start (float | None) – the nozzle’s height above the deck to rise to first, mm; default_minimum_traverse_height when None.

  • speed (float | None) – the nozzle’s, mm/s; None takes default_xy_speed.

  • acceleration (float | None) – the nozzle’s, mm/s²; None takes default_xy_acceleration.

Raises:
  • MantisConfigurationError – without the unit’s arm or stage block; nothing is sent.

  • MantisMotionError – if the arm is not brought up, a motor faults, or Z does not read at the traverse height after rising to it.

  • MantisKinematicsError – if (x, y) is out of the arm’s reach.

  • ValueError – if a target is outside its motor’s limits, or a speed or acceleration out of range.

Return type:

None