set_pose()
  • 1 Minute to read

set_pose()


Article summary

Sets the end effector of one arm to the specified coordinates and rotations. Uses roll, pitch, and yaw to specify target pose.

Reference

Arguments

ArgumentsTypeDefault valueDescription
armstrThe arm to set the pose for.
xfloatX-coordinate of the pose.
yfloatY-coordinate of the pose.
zfloatZ-coordinate of the pose.
rollfloatRoll angle of the pose.
pitchfloatPitch angle of the pose.
yawfloatYaw angle of the pose.
pose_dictdictNoneDict with the pose to execute {'position': [x, y, z], 'orientation': [roll, pitch, yaw]}
unitsANGLE_UNITANGLE_UNIT.DEGREESUnit for angles (DEGREES or RADIANS).
cartesian_pathboolFalseWhether to follow a cartesian path.
tilt_constraintboolFalseWhether to apply a tilt constraint.
use_obstaclesboolFalseWhether to use obstacles during execution.
cameraslist[]List of cameras.
update_obstaclesboolFalseWhether to update obstacles.
min_bbox_clear_obstacleslist[]List of minimum bounding boxes for clearing obstacles.
max_bbox_clear_obstacleslist[]List of maximum bounding boxes for clearing obstacles.
save_trajectoryboolFalseWhether to save the trajectory.
name_trajectorystr''Name of the trajectory .
velocity_scalingfloat0.0Scaling factor for velocity.
acceleration_scalingfloat0.0Sscaling factor for acceleration.
callback_feedbackCallableNoneCallable function for feedback.
callback_feedback_asyncCallableNoneCallable function for feedback.
callback_finishCallableNoneCallable function for finish.
callback_finish_asyncCallableNoneCallable function for finish.
waitboolFalseBoolean indicating whether to wait for user response .

Return

TypeDescription
floatFraction of the trajectory realized.

Exceptions

  • RayaInvalidCallback
  • RayaArmsException
  • RayaArmsInvalidArmOrGroupName
  • RayaArmsExternalException

See the complete list of arms exceptions

Feedbacks

  • [1] The arm is in execution of the command
  • [3] Planning of the trajectory in progress
  • [4] Updating obstacles in progress

See the complete list of arms feedbacks

Callback Arguments

callback_feedback

ArgumentTypeDescription
feedback_codeintCode for the type of feedback.
feedback_msgstrDetails regarding the feedback code (empty if no error).
armstrName of the arm.
percentagefloatPercent of movement completed until target pose is reached.

callback_finish

ArgumentTypeDescription
errorintCode for the type of error encountered (0 if no error).
error_msgstrDetails regarding the error (empty if no error).
fractionfloatFraction of the trajectory realized.

Usage Example

See the Arms Set Pose Example and Arms Set Pose Obstacles Example to check some valid uses.


Was this article helpful?

What's Next