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

async MantisSimulationArm.move_to_joint_state(*, joint_state: Dict[int, float], minimum_traverse_height_start: float | None = None, xy_speed: float | None = None, xy_acceleration: float | None = None, z_speed: float | None = None, z_acceleration: float | None = None) → None#

Move the motors named to a joint state, queued (command 68); the others hold.

A move of an arm motor is guarded, as v1 STAR’s moves across the deck: Z rises first to the traverse height if its encoder reads it below it, and is read back there, then the arms move with Z held, then Z moves if named. A move of Z alone is one queued move, refused on an approach path. The arms move in one joint move, not along a route: nothing here avoids the chip racks. From an approach path the arms first leave along it; every check runs before.

Parameters:
  • joint_state (Dict[int, float]) – each motor’s target, by motor, as request_joint_state reads them.

  • minimum_traverse_height_start (float | None) – the nozzle’s height above the deck to rise to before the arms move, mm, over where it starts and ends; default_minimum_traverse_height when None.

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

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

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

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

Raises:
  • MantisConfigurationError – for a traverse height in the deck frame without the unit’s stage block; nothing moves.

  • MantisMotionError – if the arm is not brought up, Z alone is to move on an approach path (nothing moves), a motor faults, or Z does not read at the traverse height after rising.

  • MantisKinematicsError – if the links cannot meet at the arm motors’ targets.

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

Return type:

None