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

class pylabrobot.formulatrix.mantis.driver.simulator.MantisSimulationArm(*, driver: MantisSimulationDriver, configuration: MantisArmConfiguration)#

Bases: Arm

An arm with no device behind it: each command sets where its motors are, at once.

It stands at idle, as a parked arm does, and its absolute encoders read where it stands, so it needs no encoder correction. Until declared, the controller holds every motor at 0, as after power-on. Without a declared arm block its offsets are 0. A v3 arm’s retract seats it against its stop: it reads a following error until its faults are cleared.

Attributes

default_minimum_traverse_height

The nozzle's height above the deck it rises to before it moves across, mm, where a move's minimum_traverse_height_start is None; None takes the safe height, SAFE_HEIGHT above Z's flag.

default_xy_acceleration

The nozzle's acceleration across the deck for a move, mm/s²; None takes the route profile.

default_xy_speed

The nozzle's speed across the deck for a move, mm/s; None takes the route profile.

default_z_acceleration

Z's acceleration for a move, and its deceleration at a stop, in mm/s², within Z_ACCELERATION_RANGE.

default_z_speed

Z's speed for a move, in mm/s, within Z_SPEED_RANGE.

is_initialized

Whether initialize brought the arm up since the link opened.

Methods

__init__(*, driver, configuration)

initialize()

Bring the arm and Z up from power-on: a v4 from where its absolute encoders read, a v3 from its stops and flags.

is_xy_reachable(*, x, y)

Whether the head can reach a deck-frame (x, y), mm, by the arm's inverse kinematics.

move_to_joint_state(*, joint_state[, ...])

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

move_to_location(*, location[, ...])

Move the nozzle to a deck-frame location: across as move_to_xy_position, then down as move_to_z_position.

move_to_wash(*, position[, with_model_updates])

Move the head into a wash position along the unit's approach path, from wherever it stands; from the other wash position without leaving the wash.

move_to_waste(*[, with_model_updates])

Move the head into the waste along the unit's approach path, from wherever it stands.

move_to_xy_position(*, x, y[, ...])

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.

move_to_z_position(*, z[, speed, acceleration])

Move the nozzle to a height in the deck frame where it stands; the arms hold.

park(*[, minimum_traverse_height_start, ...])

Move the head to idle along its zone's route, from any zone; from an approach path, first out along it.

recover_from_fault()

Recover from a motor fault as recorded: stop every motor, clear Z's faults then the arms', and recover to idle as initialize does: a v4 from its absolute encoders, a v3 by its whole bring-up again.

request_absolute_joint_state()

Each arm motor's angle from its absolute encoder, in degrees, by motor; nothing moves.

request_is_parked(*[, tolerance])

Whether the head is at idle: each arm motor at its idle target by its absolute encoder, and Z at or above its home flag by its encoder (command 84).

request_joint_state()

Where the controller holds each motor: 0 and 1 in degrees, 2 (Z) in mm down from its flag.

request_pose()

Where every joint of the arm is and where the nozzle is, in the deck frame, worked out from the joint state; nothing moves.

Parameters: