Class Limb

Constructor.

Parameters:

• limb (str) - limb to interface

Overrides: object.__init__

Return the names of the joints for the specified limb.

Returns: [str]

ordered list of joint names from proximal to distal (i.e. shoulder to wrist).

Return the requested joint angle.

Parameters:

• joint (str) - name of a joint

Returns: float

angle in radians of individual joint

Return all joint angles.

Returns: dict({str:float})

unordered dict of joint name Keys to angle (rad) Values

Return the requested joint velocity.

Parameters:

• joint (str) - name of a joint

Returns: float

velocity in radians/s of individual joint

Return all joint velocities.

Returns: dict({str:float})

unordered dict of joint name Keys to velocity (rad/s) Values

Return the requested joint effort.

Parameters:

• joint (str) - name of a joint

Returns: float

effort in Nm of individual joint

Return all joint efforts.

Returns: dict({str:float})

unordered dict of joint name Keys to effort (Nm) Values

Return Cartesian endpoint pose {position, orientation}.

Returns: dict({str:Limb.Point,str:Limb.Quaternion})

position and orientation as named tuples in a dict

pose = {'position': (x, y, z), 'orientation': (x, y, z, w)}

• 'position': Cartesian coordinates x,y,z in namedtuple Limb.Point
• 'orientation': quaternion x,y,z,w in named tuple Limb.Quaternion

Return Cartesian endpoint twist {linear, angular}.

Returns: dict({str:Limb.Point,str:Limb.Point})

linear and angular velocities as named tuples in a dict

twist = {'linear': (x, y, z), 'angular': (x, y, z)}

• 'linear': Cartesian velocity in x,y,z directions in namedtuple Limb.Point
• 'angular': Angular velocity around x,y,z axes in named tuple Limb.Point

Return Cartesian endpoint wrench {force, torque}.

Returns: dict({str:Limb.Point,str:Limb.Point})

force and torque at endpoint as named tuples in a dict

wrench = {'force': (x, y, z), 'torque': (x, y, z)}

• 'force': Cartesian force on x,y,z axes in namedtuple Limb.Point
• 'torque': Torque around x,y,z axes in named tuple Limb.Point

Set the timeout in seconds for the joint controller

Parameters:

• timeout (float) - timeout in seconds

Clean exit from advanced control modes (joint torque or velocity).

Resets control to joint position mode with current positions.

Parameters:

• timeout (float) - control timeout in seconds [0.2]

Set ratio of max joint speed to use during joint position moves.

Set the proportion of maximum controllable velocity to use during joint position control execution. The default ratio is `0.3`, and can be set anywhere from [0.0-1.0] (clipped). Once set, a speed ratio will persist until a new execution speed is set.

Parameters:

• speed (float) - ratio of maximum joint speed for execution default= 0.3; range= [0.0-1.0]

Commands the joints of this limb to the specified positions.

IMPORTANT: 'raw' joint position control mode allows for commanding joint positions, without modification, directly to the JCBs (Joint Controller Boards). While this results in more unaffected motions, 'raw' joint position control mode bypasses the safety system modifications (e.g. collision avoidance). Please use with caution.

Parameters:

• positions (dict({str:float})) - joint_name:angle command
• raw (bool) - advanced, direct position control mode

Commands the joints of this limb to the specified velocities.

IMPORTANT: set_joint_velocities must be commanded at a rate great than the timeout specified by set_command_timeout. If the timeout is exceeded before a new set_joint_velocities command is received, the controller will switch modes back to position mode for safety purposes.

Parameters:

• velocities (dict({str:float})) - joint_name:velocity command

Commands the joints of this limb to the specified torques.

IMPORTANT: set_joint_torques must be commanded at a rate great than the timeout specified by set_command_timeout. If the timeout is exceeded before a new set_joint_torques command is received, the controller will switch modes back to position mode for safety purposes.

Parameters:

• torques (dict({str:float})) - joint_name:torque command

Command the joints to the center of their joint ranges

Neutral is defined as:

 ['*_s0', '*_s1', '*_e0', '*_e1', '*_w0', '*_w1', '*_w2']
 [0.0, -0.55, 0.0, 0.75, 0.0, 1.26, 0.0]

Parameters:

• timeout (float) - seconds to wait for move to finish [15]

(Blocking) Commands the limb to the provided positions.

Waits until the reported joint state matches that specified.

This function uses a low-pass filter to smooth the movement.

Parameters:

• positions (dict({str:float})) - joint_name:angle command
• timeout (float) - seconds to wait for move to finish [15]
• threshold (float) - position threshold in radians across each joint when move is considered successful [0.008726646]