tbs-ualberta / manipulator_pose_following

A ROS package implementing methods for pose-following of manipulators.

This package implements methods for pose-following of manipulators (e.g., articulated arms) where the end-effector of a manipulator follows a given pose stream (e.g., from a haptic interface). The package also includes utility interfaces to move the manipulator to a desired end-effector pose through services.

The package can be used for example to teleoperate a manipulator using a haptic interface or other device.

Nodes:

pose_following:

The main node facilitating pose-following.

• Subscribed topics:
  • pose_following/cmd_vel - (geometry_msgs/Twist)
    The pose derivative expressed as twist.
  • pose_following/pose - (geometry_msgs/PoseStamped)
    The current pose of the device used for pose-following. The pose derivative is calculated internally.
  • joint_states - (sensor_msgs/JointState)
    The current joint states of the manipulator.
• Published topics:
  • joint_command - (trajectory_msgs/JointTrajectory)
    See http://wiki.ros.org/Industrial/Industrial_Robot_Driver_Spec
• Services:
  • /pose_following/start
    Enables the node to accept pose or pose derivative messages.
  • /pose_following/stop
    Sets the node to an idle state where pose or pose derivative messages are ignored.
• Parameters:
  • rate - (int, default: 100) [Hz]
    The node's sampling rate
  • group - (string, default: 'manipulator')
    The name of the manipulator group.
  • w0 - (double, default: 0.1)
    Factor determining the proximity to a singularity (see Nakamura et al.).
  • k0 - (double, default: 0.001)
    Adjustment factor to inverse of Jacobian in proximity of a simgularity (see Nakamura et al.).
  • theta_d_lim - (double, default: 3.14) [rad/s]
    Joint velocity limit threshold. If exceeded, the node's state changes to idle.
  • dt_pose_lim - (double, default: 0.5) [s]
    if(dt_cb > dt_pose_lim): STATE_POSE_FOLLOW --> STATE_IDLE: If the most recent pose or cmd_vel message has been received more than dt_pose_lim s ago, transition to state STATE_IDLE.

moveit_interface:

Interface node for planning and executing trajectories using MoveIt!, and for moving the manipulator's end-effector to desired poses and pre-definded configurations (e.g., home position) from which to begin pose-following.

• Services:
  • /moveit_interface/plan_to_rpy
    Plans joint trajectories to reach a given end-effector pose where the orientation is given as Euler angles (RPY).
    • Parameters:
      • pose_rpy (double[6]): Desired end-effector pose with orientation as Euler angles (RPY).
      • max_vel_fact (double): Scaling factor to reduce the maximum joint velocity [0,1]
      • max_acc_fact (double): Scaling factor to reduce the maximum joint acceleration [0,1]
  • /moveit_interface/plan_to_quat
    Plans joint trajectories to reach a given end-effector pose where the orientation is given as quaternions.
    • Parameters:
      • pose_quat (double[7]): Desired end-effector pose with orientation as quaternions.
      • max_vel_fact (double): Scaling factor to reduce the maximum joint velocity [0,1]
      • max_acc_fact (double): Scaling factor to reduce the maximum joint acceleration [0,1]
  • /moveit_interface/execute_plan
    Executes the trajectories planned through service calls plan_to_rpy or plan_to_quat.
  • /moveit_interface/move_home
    Moves the manipulator to the configuration where all joint angles are zero.
    • Parameters:
      • max_vel_fact (double): Scaling factor to reduce the maximum joint velocity [0,1]
      • max_acc_fact (double): Scaling factor to reduce the maximum joint acceleration [0,1]
  • /moveit_interface/move_to_rpy
    Moves the end-effector to a given pose where the orientation is given as Euler angles (RPY).
    • Parameters:
      • pose_rpy (double[6]): Desired end-effector pose with orientation as Euler angles (RPY).
      • max_vel_fact (double): Scaling factor to reduce the maximum joint velocity [0,1]
      • max_acc_fact (double): Scaling factor to reduce the maximum joint acceleration [0,1]
  • /moveit_interface/move_to_quat
    Moves the end-effector to a given pose where the orientation is given as quaternions.
    • Parameters:
      • pose_quat (double[7]): Desired end-effector pose with orientation as quaternions.
      • max_vel_fact (double): Scaling factor to reduce the maximum joint velocity [0,1]
      • max_acc_fact (double): Scaling factor to reduce the maximum joint acceleration [0,1]

kb_jogging:

Node for jogging the manipulator's end-effector pose via keyboard.

• Key assignments:

  Translation: +x: "1" | +y: "2" | +z: "3"
               -x: "q" | -y: "w" | -z: "e"  
  
    Rotation:  +x: "4" | +y: "5" | +z: "6"
               -x: "r" | -y: "t" | -z: "y"
  
    Velocity:   +: "0"
                -: "p"
  
    Stop:          "x"
  

• Published topics:

  • pose_following/cmd_vel - (geometry_msgs/Twist)
    The pose derivative expressed as twist.

• Parameters:

  • rate - (int, default: 40): Node loop rate [Hz]
  • jogging_vel - (double, default: 0.1): Velocity adjustment factor [0,1]
  • max_trans_vel - (double, default: 0.5): Maximum translational end-effector velocity [m/s]
  • max_rot_vel - (double, default: 1): Maximum rotational end-effector velocity [rad/s]

smooth_jogging:

Node for smoothing of velocity step changes created by e.g., keyboard input.

• Subscribed topics:
  • smooth_jogging/cmd_vel - (geometry_msgs/Twist)
    The pose derivative expressed as twist.
• Published topics:
  • pose_following/cmd_vel - (geometry_msgs/Twist)
    The pose derivative expressed as twist.
• Parameters:
  • rate - (int, default: 40): Node loop rate [Hz]