Public Member Functions | Private Attributes | List of all members
moveit_commander.move_group.MoveGroupCommander Class Reference
Inheritance diagram for moveit_commander.move_group.MoveGroupCommander:
Inheritance graph

Public Member Functions

def __init__ (self, name, robot_description="robot_description", ns="", wait_for_servers=5.0)
def allow_looking (self, value)
def allow_replanning (self, value)
def attach_object (self, object_name, link_name="", touch_links=[])
def clear_path_constraints (self)
def clear_pose_target (self, end_effector_link)
def clear_pose_targets (self)
def clear_trajectory_constraints (self)
def compute_cartesian_path (self, waypoints, eef_step, jump_threshold, avoid_collisions=True, path_constraints=None)
def detach_object (self, name="")
def enforce_bounds (self, robot_state_msg)
def execute (self, plan_msg, wait=True)
def forget_joint_values (self, name)
def get_active_joints (self)
def get_current_joint_values (self)
def get_current_pose (self, end_effector_link="")
def get_current_rpy (self, end_effector_link="")
def get_current_state (self)
def get_current_state_bounded (self)
def get_end_effector_link (self)
def get_goal_joint_tolerance (self)
def get_goal_orientation_tolerance (self)
def get_goal_position_tolerance (self)
def get_goal_tolerance (self)
def get_interface_description (self)
def get_jacobian_matrix (self, joint_values, reference_point=None)
def get_joint_value_target (self)
def get_joints (self)
def get_known_constraints (self)
def get_name (self)
def get_named_target_values (self, target)
def get_named_targets (self)
def get_path_constraints (self)
def get_planner_id (self)
def get_planning_frame (self)
def get_planning_pipeline_id (self, planning_pipeline)
def get_planning_time (self)
def get_pose_reference_frame (self)
def get_random_joint_values (self)
def get_random_pose (self, end_effector_link="")
def get_remembered_joint_values (self)
def get_trajectory_constraints (self)
def get_variable_count (self)
def go (self, joints=None, wait=True)
def has_end_effector_link (self)
def pick (self, object_name, grasp=[], plan_only=False)
def place (self, object_name, location=None, plan_only=False)
def plan (self, joints=None)
def remember_joint_values (self, name, values=None)
def retime_trajectory (self, ref_state_in, traj_in, velocity_scaling_factor=1.0, acceleration_scaling_factor=1.0, algorithm="iterative_time_parameterization")
def set_constraints_database (self, host, port)
def set_end_effector_link (self, link_name)
def set_goal_joint_tolerance (self, value)
def set_goal_orientation_tolerance (self, value)
def set_goal_position_tolerance (self, value)
def set_goal_tolerance (self, value)
def set_joint_value_target (self, arg1, arg2=None, arg3=None)
def set_max_acceleration_scaling_factor (self, value)
def set_max_velocity_scaling_factor (self, value)
def set_named_target (self, name)
def set_num_planning_attempts (self, num_planning_attempts)
def set_orientation_target (self, q, end_effector_link="")
def set_path_constraints (self, value)
def set_planner_id (self, planner_id)
def set_planning_pipeline_id (self, planning_pipeline)
def set_planning_time (self, seconds)
def set_pose_reference_frame (self, reference_frame)
def set_pose_target (self, pose, end_effector_link="")
def set_pose_targets (self, poses, end_effector_link="")
def set_position_target (self, xyz, end_effector_link="")
def set_random_target (self)
def set_rpy_target (self, rpy, end_effector_link="")
def set_start_state (self, msg)
def set_start_state_to_current_state (self)
def set_support_surface_name (self, value)
def set_trajectory_constraints (self, value)
def set_workspace (self, ws)
def shift_pose_target (self, axis, value, end_effector_link="")
def stop (self)

Private Attributes


Detailed Description

Execution of simple commands for a particular group

Definition at line 56 of file

Constructor & Destructor Documentation

◆ __init__()

def moveit_commander.move_group.MoveGroupCommander.__init__ (   self,
  robot_description = "robot_description",
  ns = "",
  wait_for_servers = 5.0 
Specify the group name for which to construct this commander instance. Throws an exception if there is an initialization error. 

Definition at line 61 of file

Member Function Documentation

◆ allow_looking()

def moveit_commander.move_group.MoveGroupCommander.allow_looking (   self,
Enable/disable looking around for motion planning 

Definition at line 463 of file

◆ allow_replanning()

def moveit_commander.move_group.MoveGroupCommander.allow_replanning (   self,
Enable/disable replanning 

Definition at line 467 of file

◆ attach_object()

def moveit_commander.move_group.MoveGroupCommander.attach_object (   self,
  link_name = "",
  touch_links = [] 
Given the name of an object existing in the planning scene, attach it to a link. The link used is specified by the second argument. If left unspecified, the end-effector link is used, if one is known. If there is no end-effector link, the first link in the group is used. If no link is identified, failure is reported. True is returned if an attach request was succesfully sent to the move_group node. This does not verify that the attach request also was successfuly applied by move_group.

Definition at line 683 of file

◆ clear_path_constraints()

def moveit_commander.move_group.MoveGroupCommander.clear_path_constraints (   self)
Specify that no path constraints are to be used during motion planning 

Definition at line 494 of file

◆ clear_pose_target()

def moveit_commander.move_group.MoveGroupCommander.clear_pose_target (   self,
Clear the pose target for a particular end-effector 

Definition at line 386 of file

◆ clear_pose_targets()

def moveit_commander.move_group.MoveGroupCommander.clear_pose_targets (   self)
Clear all known pose targets 

Definition at line 390 of file

◆ clear_trajectory_constraints()

def moveit_commander.move_group.MoveGroupCommander.clear_trajectory_constraints (   self)
Specify that no trajectory constraints are to be used during motion planning 

Definition at line 519 of file

◆ compute_cartesian_path()

def moveit_commander.move_group.MoveGroupCommander.compute_cartesian_path (   self,
  avoid_collisions = True,
  path_constraints = None 
Compute a sequence of waypoints that make the end-effector move in straight line segments that follow the poses specified as waypoints. Configurations are computed for every eef_step meters; The jump_threshold specifies the maximum distance in configuration space between consecutive points in the resultingpath; Kinematic constraints for the path given by path_constraints will be met for every point along the trajectory, if they are not met, a partial solution will be returned. The return value is a tuple: a fraction of how much of the path was followed, the actual RobotTrajectory. 

Definition at line 640 of file

◆ detach_object()

def moveit_commander.move_group.MoveGroupCommander.detach_object (   self,
  name = "" 
Given the name of a link, detach the object(s) from that link. If no such link exists, the name is interpreted as an object name. If there is no name specified, an attempt is made to detach all objects attached to any link in the group.

Definition at line 687 of file

◆ enforce_bounds()

def moveit_commander.move_group.MoveGroupCommander.enforce_bounds (   self,
Takes a moveit_msgs RobotState and enforces the state bounds, based on the C++ RobotState enforceBounds() 

Definition at line 778 of file

◆ execute()

def moveit_commander.move_group.MoveGroupCommander.execute (   self,
  wait = True 
Execute a previously planned path

Definition at line 676 of file

◆ forget_joint_values()

def moveit_commander.move_group.MoveGroupCommander.forget_joint_values (   self,
Forget a stored joint configuration 

Definition at line 423 of file

◆ get_active_joints()

def moveit_commander.move_group.MoveGroupCommander.get_active_joints (   self)
Get the active joints of this group 

Definition at line 77 of file

◆ get_current_joint_values()

def moveit_commander.move_group.MoveGroupCommander.get_current_joint_values (   self)
Get the current configuration of the group as a list (these are values published on /joint_states) 

Definition at line 120 of file

◆ get_current_pose()

def moveit_commander.move_group.MoveGroupCommander.get_current_pose (   self,
  end_effector_link = "" 
Get the current pose of the end-effector of the group. Throws an exception if there is not end-effector. 

Definition at line 124 of file

◆ get_current_rpy()

def moveit_commander.move_group.MoveGroupCommander.get_current_rpy (   self,
  end_effector_link = "" 
Get a list of 3 elements defining the [roll, pitch, yaw] of the end-effector. Throws an exception if there is not end-effector. 

Definition at line 135 of file

◆ get_current_state()

def moveit_commander.move_group.MoveGroupCommander.get_current_state (   self)
Get the current state of the robot.

Definition at line 188 of file

◆ get_current_state_bounded()

def moveit_commander.move_group.MoveGroupCommander.get_current_state_bounded (   self)
Get the current state of the robot bounded.

Definition at line 181 of file

◆ get_end_effector_link()

def moveit_commander.move_group.MoveGroupCommander.get_end_effector_link (   self)
Get the name of the link that is considered to be an end-effector. Return an empty string if there is no end-effector. 

Definition at line 93 of file

◆ get_goal_joint_tolerance()

def moveit_commander.move_group.MoveGroupCommander.get_goal_joint_tolerance (   self)
Get the tolerance for achieving a joint goal (distance for each joint variable) 

Definition at line 435 of file

◆ get_goal_orientation_tolerance()

def moveit_commander.move_group.MoveGroupCommander.get_goal_orientation_tolerance (   self)
When moving to an orientation goal or to a pose goal, the tolerance for the goal orientation is specified as the distance (roll, pitch, yaw) to the target origin of the end-effector 

Definition at line 443 of file

◆ get_goal_position_tolerance()

def moveit_commander.move_group.MoveGroupCommander.get_goal_position_tolerance (   self)
When moving to a position goal or to a pose goal, the tolerance for the goal position is specified as the radius a sphere around the target origin of the end-effector 

Definition at line 439 of file

◆ get_goal_tolerance()

def moveit_commander.move_group.MoveGroupCommander.get_goal_tolerance (   self)
Return a tuple of goal tolerances: joint, position and orientation. 

Definition at line 427 of file

◆ get_interface_description()

def moveit_commander.move_group.MoveGroupCommander.get_interface_description (   self)
Get the description of the planner interface (list of planner ids) 

Definition at line 102 of file

◆ get_jacobian_matrix()

def moveit_commander.move_group.MoveGroupCommander.get_jacobian_matrix (   self,
  reference_point = None 
Get the jacobian matrix of the group as a list

Definition at line 771 of file

◆ get_joint_value_target()

def moveit_commander.move_group.MoveGroupCommander.get_joint_value_target (   self)

Definition at line 195 of file

◆ get_joints()

def moveit_commander.move_group.MoveGroupCommander.get_joints (   self)
Get the joints of this group 

Definition at line 81 of file

◆ get_known_constraints()

def moveit_commander.move_group.MoveGroupCommander.get_known_constraints (   self)
Get a list of names for the constraints specific for this group, as read from the warehouse 

Definition at line 471 of file

◆ get_name()

def moveit_commander.move_group.MoveGroupCommander.get_name (   self)
Get the name of the group this instance was initialized for 

Definition at line 69 of file

◆ get_named_target_values()

def moveit_commander.move_group.MoveGroupCommander.get_named_target_values (   self,
Get a dictionary of joint values of a named target

Definition at line 409 of file

◆ get_named_targets()

def moveit_commander.move_group.MoveGroupCommander.get_named_targets (   self)
Get a list of all the names of joint configurations.

Definition at line 398 of file

◆ get_path_constraints()

def moveit_commander.move_group.MoveGroupCommander.get_path_constraints (   self)
Get the acutal path constraints in form of a moveit_msgs.msgs.Constraints 

Definition at line 475 of file

◆ get_planner_id()

def moveit_commander.move_group.MoveGroupCommander.get_planner_id (   self)
Get the current planner_id (e.g. RRTConnect, LIN) of the currently selected pipeline 

Definition at line 547 of file

◆ get_planning_frame()

def moveit_commander.move_group.MoveGroupCommander.get_planning_frame (   self)
Get the name of the frame where all planning is performed 

Definition at line 116 of file

◆ get_planning_pipeline_id()

def moveit_commander.move_group.MoveGroupCommander.get_planning_pipeline_id (   self,
Get the current planning_pipeline_id (e.g. ompl, pilz_industrial_motion_planner) 

Definition at line 539 of file

◆ get_planning_time()

def moveit_commander.move_group.MoveGroupCommander.get_planning_time (   self)
Specify the amount of time to be used for motion planning. 

Definition at line 531 of file

◆ get_pose_reference_frame()

def moveit_commander.move_group.MoveGroupCommander.get_pose_reference_frame (   self)
Get the reference frame assumed for poses of end-effectors 

Definition at line 108 of file

◆ get_random_joint_values()

def moveit_commander.move_group.MoveGroupCommander.get_random_joint_values (   self)

Definition at line 142 of file

◆ get_random_pose()

def moveit_commander.move_group.MoveGroupCommander.get_random_pose (   self,
  end_effector_link = "" 

Definition at line 145 of file

◆ get_remembered_joint_values()

def moveit_commander.move_group.MoveGroupCommander.get_remembered_joint_values (   self)
Get a dictionary that maps names to joint configurations for the group 

Definition at line 419 of file

◆ get_trajectory_constraints()

def moveit_commander.move_group.MoveGroupCommander.get_trajectory_constraints (   self)
Get the actual trajectory constraints in form of a moveit_msgs.msgs.Constraints 

Definition at line 498 of file

◆ get_variable_count()

def moveit_commander.move_group.MoveGroupCommander.get_variable_count (   self)
Return the number of variables used to parameterize a state in this group (larger or equal to number of DOF)

Definition at line 85 of file

◆ go()

def moveit_commander.move_group.MoveGroupCommander.go (   self,
  joints = None,
  wait = True 
Set the target of the group and then move the group to the specified target 

Definition at line 590 of file

◆ has_end_effector_link()

def moveit_commander.move_group.MoveGroupCommander.has_end_effector_link (   self)
Check if this group has a link that is considered to be an end effector 

Definition at line 89 of file

◆ pick()

def moveit_commander.move_group.MoveGroupCommander.pick (   self,
  grasp = [],
  plan_only = False 
Pick the named object. A grasp message, or a list of Grasp messages can also be specified as argument.

Definition at line 691 of file

◆ place()

def (   self,
  location = None,
  plan_only = False 
Place the named object at a particular location in the environment or somewhere safe in the world if location is not provided

Definition at line 702 of file

◆ plan()

def moveit_commander.move_group.MoveGroupCommander.plan (   self,
  joints = None 
Return a tuple of the motion planning results such as
(success flag : boolean, trajectory message : RobotTrajectory,
 planning time : float, error code : MoveitErrorCodes)

Definition at line 612 of file

◆ remember_joint_values()

def moveit_commander.move_group.MoveGroupCommander.remember_joint_values (   self,
  values = None 
Record the specified joint configuration of the group under the specified name. If no values are specified, the current state of the group is recorded. 

Definition at line 413 of file

◆ retime_trajectory()

def moveit_commander.move_group.MoveGroupCommander.retime_trajectory (   self,
  velocity_scaling_factor = 1.0,
  acceleration_scaling_factor = 1.0,
  algorithm = "iterative_time_parameterization" 

Definition at line 750 of file

◆ set_constraints_database()

def moveit_commander.move_group.MoveGroupCommander.set_constraints_database (   self,
Specify which database to connect to for loading possible path constraints 

Definition at line 523 of file

◆ set_end_effector_link()

def moveit_commander.move_group.MoveGroupCommander.set_end_effector_link (   self,
Set the name of the link to be considered as an end effector 

Definition at line 97 of file

◆ set_goal_joint_tolerance()

def moveit_commander.move_group.MoveGroupCommander.set_goal_joint_tolerance (   self,
Set the tolerance for a target joint configuration 

Definition at line 451 of file

◆ set_goal_orientation_tolerance()

def moveit_commander.move_group.MoveGroupCommander.set_goal_orientation_tolerance (   self,
Set the tolerance for a target end-effector orientation 

Definition at line 459 of file

◆ set_goal_position_tolerance()

def moveit_commander.move_group.MoveGroupCommander.set_goal_position_tolerance (   self,
Set the tolerance for a target end-effector position 

Definition at line 455 of file

◆ set_goal_tolerance()

def moveit_commander.move_group.MoveGroupCommander.set_goal_tolerance (   self,
Set the joint, position and orientation goal tolerances simultaneously 

Definition at line 447 of file

◆ set_joint_value_target()

def moveit_commander.move_group.MoveGroupCommander.set_joint_value_target (   self,
  arg2 = None,
  arg3 = None 
Specify a target joint configuration for the group.
- if the type of arg1 is one of the following: dict, list, JointState message, then no other arguments should be provided.
The dict should specify pairs of joint variable names and their target values, the list should specify all the variable values
for the group. The JointState message specifies the positions of some single-dof joints.
- if the type of arg1 is string, then arg2 is expected to be defined and be either a real value or a list of real values. This is
interpreted as setting a particular joint to a particular value.
- if the type of arg1 is Pose or PoseStamped, both arg2 and arg3 could be defined. If arg2 or arg3 are defined, their types must
be either string or bool. The string type argument is interpreted as the end-effector the pose is specified for (default is to use
the default end-effector), and the bool is used to decide whether the pose specified is approximate (default is false). This situation
allows setting the joint target of the group by calling IK. This does not send a pose to the planner and the planner will do no IK.
Instead, one IK solution will be computed first, and that will be sent to the planner.

Definition at line 198 of file

◆ set_max_acceleration_scaling_factor()

def moveit_commander.move_group.MoveGroupCommander.set_max_acceleration_scaling_factor (   self,
Set a scaling factor to reduce the maximum joint accelerations. Allowed values are in (0,1].
The default value is set in the joint_limits.yaml of the moveit_config package.

Definition at line 580 of file

◆ set_max_velocity_scaling_factor()

def moveit_commander.move_group.MoveGroupCommander.set_max_velocity_scaling_factor (   self,
Set a scaling factor to reduce the maximum joint velocities. Allowed values are in (0,1].
The default value is set in the joint_limits.yaml of the moveit_config package.

Definition at line 570 of file

◆ set_named_target()

def moveit_commander.move_group.MoveGroupCommander.set_named_target (   self,
Set a joint configuration by name. The name can be a name previlusy remembered with remember_joint_values() or a configuration specified in the SRDF. 

Definition at line 402 of file

◆ set_num_planning_attempts()

def moveit_commander.move_group.MoveGroupCommander.set_num_planning_attempts (   self,
Set the number of times the motion plan is to be computed from scratch before the shortest solution is returned. The default value is 1. 

Definition at line 551 of file

◆ set_orientation_target()

def moveit_commander.move_group.MoveGroupCommander.set_orientation_target (   self,
  end_effector_link = "" 
Specify a target orientation for the end-effector. Any position of the end-effector is acceptable.

Definition at line 306 of file

◆ set_path_constraints()

def moveit_commander.move_group.MoveGroupCommander.set_path_constraints (   self,
Specify the path constraints to be used (as read from the database) 

Definition at line 482 of file

◆ set_planner_id()

def moveit_commander.move_group.MoveGroupCommander.set_planner_id (   self,
Specify which planner of the currently selected pipeline to use when motion planning (e.g. RRTConnect, LIN) 

Definition at line 543 of file

◆ set_planning_pipeline_id()

def moveit_commander.move_group.MoveGroupCommander.set_planning_pipeline_id (   self,
Specify which planning pipeline to use when motion planning (e.g. ompl, pilz_industrial_motion_planner) 

Definition at line 535 of file

◆ set_planning_time()

def moveit_commander.move_group.MoveGroupCommander.set_planning_time (   self,
Specify the amount of time to be used for motion planning. 

Definition at line 527 of file

◆ set_pose_reference_frame()

def moveit_commander.move_group.MoveGroupCommander.set_pose_reference_frame (   self,
Set the reference frame to assume for poses of end-effectors 

Definition at line 112 of file

◆ set_pose_target()

def moveit_commander.move_group.MoveGroupCommander.set_pose_target (   self,
  end_effector_link = "" 
Set the pose of the end-effector, if one is available. The expected input is a Pose message, a PoseStamped message or a list of 6 floats:
[x, y, z, rot_x, rot_y, rot_z] or a list of 7 floats [x, y, z, qx, qy, qz, qw] 

Definition at line 333 of file

◆ set_pose_targets()

def moveit_commander.move_group.MoveGroupCommander.set_pose_targets (   self,
  end_effector_link = "" 
Set the pose of the end-effector, if one is available. The expected input is a list of poses. Each pose can be a Pose message, a list of 6 floats: [x, y, z, rot_x, rot_y, rot_z] or a list of 7 floats [x, y, z, qx, qy, qz, qw] 

Definition at line 358 of file

◆ set_position_target()

def moveit_commander.move_group.MoveGroupCommander.set_position_target (   self,
  end_effector_link = "" 
Specify a target position for the end-effector. Any orientation of the end-effector is acceptable.

Definition at line 321 of file

◆ set_random_target()

def moveit_commander.move_group.MoveGroupCommander.set_random_target (   self)
Set a random joint configuration target 

Definition at line 394 of file

◆ set_rpy_target()

def moveit_commander.move_group.MoveGroupCommander.set_rpy_target (   self,
  end_effector_link = "" 
Specify a target orientation for the end-effector. Any position of the end-effector is acceptable.

Definition at line 291 of file

◆ set_start_state()

def moveit_commander.move_group.MoveGroupCommander.set_start_state (   self,
Specify a start state for the group.

msg : moveit_msgs/RobotState

>>> from moveit_msgs.msg import RobotState
>>> from sensor_msgs.msg import JointState
>>> joint_state = JointState()
>>> joint_state.header = Header()
>>> joint_state.header.stamp =
>>> = ['joint_a', 'joint_b']
>>> joint_state.position = [0.17, 0.34]
>>> moveit_robot_state = RobotState()
>>> moveit_robot_state.joint_state = joint_state
>>> group.set_start_state(moveit_robot_state)

Definition at line 158 of file

◆ set_start_state_to_current_state()

def moveit_commander.move_group.MoveGroupCommander.set_start_state_to_current_state (   self)

Definition at line 155 of file

◆ set_support_surface_name()

def moveit_commander.move_group.MoveGroupCommander.set_support_surface_name (   self,
Set the support surface name for a place operation 

Definition at line 746 of file

◆ set_trajectory_constraints()

def moveit_commander.move_group.MoveGroupCommander.set_trajectory_constraints (   self,
Specify the trajectory constraints to be used 

Definition at line 505 of file

◆ set_workspace()

def moveit_commander.move_group.MoveGroupCommander.set_workspace (   self,
Set the workspace for the robot as either [], [minX, minY, maxX, maxY] or [minX, minY, minZ, maxX, maxY, maxZ] 

Definition at line 555 of file

◆ shift_pose_target()

def moveit_commander.move_group.MoveGroupCommander.shift_pose_target (   self,
  end_effector_link = "" 
Get the current pose of the end effector, add value to the corresponding axis (0..5: X, Y, Z, R, P, Y) and set the new pose as the pose target 

Definition at line 369 of file

◆ stop()

def moveit_commander.move_group.MoveGroupCommander.stop (   self)
Stop the current execution, if any 

Definition at line 73 of file

Member Data Documentation

◆ _g


Definition at line 63 of file

The documentation for this class was generated from the following file:

Author(s): Ioan Sucan
autogenerated on Sat May 15 2021 02:26:40