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_statereads 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_heightwhen 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
stageblock; 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