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_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_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 46 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 51 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 392 of file

◆ allow_replanning()

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

Definition at line 396 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 569 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 421 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 321 of file

◆ clear_pose_targets()

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

Definition at line 325 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 442 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 547 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 573 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 626 of file

◆ execute()

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

Definition at line 562 of file

◆ forget_joint_values()

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

Definition at line 356 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 63 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 106 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 110 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 117 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 166 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 159 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 79 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 364 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 372 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 368 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 360 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 88 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 622 of file

◆ get_joint_value_target()

def moveit_commander.move_group.MoveGroupCommander.get_joint_value_target (   self)

Definition at line 173 of file

◆ get_joints()

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

Definition at line 67 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 400 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 55 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 342 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 333 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 404 of file

◆ get_planner_id()

def moveit_commander.move_group.MoveGroupCommander.get_planner_id (   self)
Get the current planner_id 

Definition at line 462 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 102 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 454 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 94 of file

◆ get_random_joint_values()

def moveit_commander.move_group.MoveGroupCommander.get_random_joint_values (   self)

Definition at line 124 of file

◆ get_random_pose()

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

Definition at line 127 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 352 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 425 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 71 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 499 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 75 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 577 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 584 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 521 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 346 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 614 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 446 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 83 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 380 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 388 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 384 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 376 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 176 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 491 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 483 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 337 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 466 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 258 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 411 of file

◆ set_planner_id()

def moveit_commander.move_group.MoveGroupCommander.set_planner_id (   self,
Specify which planner to use when motion planning 

Definition at line 458 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 450 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 98 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 277 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 296 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 269 of file

◆ set_random_target()

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

Definition at line 329 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 247 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 136 of file

◆ set_start_state_to_current_state()

def moveit_commander.move_group.MoveGroupCommander.set_start_state_to_current_state (   self)

Definition at line 133 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 610 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 432 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 470 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 304 of file

◆ stop()

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

Definition at line 59 of file

Member Data Documentation

◆ _g


Definition at line 53 of file

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

Author(s): Ioan Sucan
autogenerated on Sat Dec 12 2020 03:27:14