pylabrobot.formulatrix.mantis.driver.simulator.MantisSimulationArm.move_to_z_position#

async MantisSimulationArm.move_to_z_position(*, z: float, speed: float | None = None, acceleration: float | None = None) → None#

Move the nozzle to a height in the deck frame where it stands; the arms hold. The stage’s tilt under the nozzle is taken in. Refused on an approach path.

Parameters:
  • z (float) – above the deck, mm.

  • speed (float | None) – in mm/s; None takes default_z_speed.

  • acceleration (float | None) – in mm/s²; None takes default_z_acceleration.

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

  • MantisMotionError – if the arm is not brought up, the head stands on an approach path (nothing moves), or Z faults.

  • MantisKinematicsError – if the links cannot meet at the angles read.

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

Return type:

None