Move by List

You are viewing an old version of the documentation. You can switch to the documentation of the latest version by clicking the top-right corner of the page.

Function

This Step is used to set multiple waypoints in the path according to the grid, specify the way to move to those waypoints, and guide the robot to move to the waypoints in sequence.

Parameter Description

General Parameters of Move-Type Steps

Send Waypoint

Selected by default to send waypoint poses to the receiver, such as the robot. When this option is unselected, the waypoint will not be sent. However, the waypoint will remain in the planned path.

Try Continuously Running through Succeeding Non-Moves

Unselected by default. When non-move Steps, such as Vision Look, Set DO, Check DI, etc., are connected between move-type Steps, the robot’s path planning will be interrupted, and the actual robot will take a short pause, reducing the smoothness of running. When this option is selected, the project will continue to run without waiting for the current move-type Step to complete execution, and therefore the robot can move in a smooth way without pauses. However, enabling this option may cause the execution of the Step to end prematurely.

Why will this option cause the execution of the Step to end prematurely?

Mech-Viz will send multiple poses simultaneously to the robot when the project is running. When the currently returned JPs of the robot correspond to the last pose sent by Mech-Viz, Mech-Viz will assume that the robot has moved to the last position. For example, there are 10 move-type Steps in a path, and the pose of the 5th move-type Step is the same as that of the last move-type Step. When the robot moves at low speed, it sends JPs to Mech-Viz when it moves to the 5th move-type Step, Mech-Viz may mistakenly determine that the robot has finished the move-type Steps and prematurely ends the Steps since the poses of the 5th move-type Step and the last move-type Step are the same in the path.

Do Not Check Collision with Placed Workobject

Unselected by default, namely that the collision with the already placed objects will not be detected. When this option is selected, the collisions between the robot, end tool, and placed objects will be detected.

In palletizing scenarios, the two possible cases of error are as follows:

In palletizing scenarios, when the robot is placing a carton, the carton to place may come into light contact with the placed cartons while no deformation will be caused. After Mech-Viz detects this collision in simulation, it will plan other positions for placing the carton, and therefore a full stack cannot be formed.
Usually, the TCP of a suction cup is inside the suction cup model instead of on the surface of it. Under this circumstance, the suction cup may be embedded in the model of the carton to be picked in the simulation of picking, while Mech-Viz does not detect the collision between the end tool and the object to be picked. After the robot places the object and the carton model turns into an object model in the scene, a collision between the suction cup and the carton will be detected and the palletizing cannot be completed.

When this option is selected, no collision between the robot, end tool, and the placed object will be detected, and the above two cases of errors can be avoided.

Point Cloud Collision Detection Mode

Select the proper mode according to the requirement of the on-site situation. Usually, the default setting Auto can be used. Do not check collision mode can be used in move-type Steps before the robot picks the object, and Check collision mode can be used after the robot picks the object.

Auto	Default setting. Collision with point cloud is checked only for the “Vision Move” Step and the “Relative Move” Step that depends on the “Vision Move” Step, but not for all move-type Steps.
Do not check collision	Point cloud collisions for all move-type Steps will not be detected.
Check collision	Point cloud collisions for all move-type Steps will be detected.

When Collision detection configuration Detect collision between point cloud and others is switched on, Mech-Viz will detect collisions between the robot model, end tool model, and point cloud when planning the path. Normally, Mech-Viz detects whether the robot collides with other objects during picking and placing. When there are point cloud outliers, non-exiting collisions will be detected, which leads to errors in path planning.

Ignore Workobject Symmetry

This parameter will only take effect when Waypoint type of the Step is set to Workobject pose.

None	Default setting, i.e., do not disable symmetry on any axis.
Around workobject frame Z axis	Only disable symmetry on Z-axis of the workobject reference frame.
Around workobject frame X&Y axis	Disable symmetry on X-axis and Y-axis of the workobject reference frame.
Around all axes	Disable symmetry on all axes.

Once the object symmetry is disabled, the robot will place the objects strictly according to the workobject poses.

In some special cases, objects are not pickable due to their peculiar poses. Setting Rotational symmetry under Workobjects Workobject Configuration in Resources may solve this problem. Candidate poses of the recognized workpiece will be calculated according to the set rotational symmetry angle. When Mech-Viz plans to pick workpieces, if the default pose is not feasible for picking, the candidate poses will be tried. As the candidate poses calculated based on the settings of Rotational symmetry are different from the original poses output from Mech-Vision, the consistency of the objects’ place poses cannot be guaranteed.

Held Workobject Collision Detection Settings

Do Not Check Collision with Scene Object/Robot

Unselected by default. Once this option is selected, the collisions between the held workobject with the scene objects or robot will not be detected, and therefore the calculation workload of collision detection will be reduced, the planning speed can be increased, and the cycle time can be shortened. It is usually enabled in the first one or two move-type Steps after the robot picks the object.

Please enable this option cautiously as there may be collision risks.

When Collision detection configuration Configuration on held workobject＞Detect collision between held object and others is enabled, the software will detect whether the model of the held object collides with the models of the scene objects and the robot. In palletizing projects, the calculated carton dimensions have millimeter-level errors with the actual dimensions, and frictions between cartons may occur during picking but no collisions will occur. For some move-type Steps that will obviously not cause collisions, detecting such collisions only adds to the calculation workload and planning time, and consequently extending the cycle time. In palletizing projects, enabling Do Not Check Collision with Scene Objects does not affect the collision detection between the held carton and the placed cartons. This option can be enabled when there are scene objects under the stack to avoid failure of finding the palletizing solution.

Do Not Check Collision with Point Cloud

Unselected by default. Once this option is selected, the collisions between the held workobject with the point clouds in the scene will not be detected, and therefore the calculation workload of collision detection will be reduced, the planning speed can be increased, and the cycle time can be shortened.

When both Collision detection configuration Configuration on held workobject＞Detect collision between held object and others and Configuration on point cloud Detect collision between point cloud and others are enabled, the software will detect whether the model of the held workobject will collide with the point cloud in the scene.
When Mech-Vision sends the point cloud and object model to Mech-Viz, the point cloud and the object model are fitted together. After the robot picks the object, the model moves along the planned path, and the collision between the model of the held workobject and the point cloud will occur.
It is known that the model of the held workobject will have false collisions with the point cloud. Detecting such collisions unnecessarily adds to the calculation workload and extends the planning time.

Do Not Check Collision with Robot is usually used in the first or second move-type Steps after the robot picks the object. It may increase the risk of collision. Please enable it with caution. Enabling Do Not Check Collision with Scene Objects will not affect the collision detection between the held carton and the placed cartons. When there are scene objects under the pallet, this function can be used to avoid solution selection failure for palletizing.

Index

Starting Index

The index of the waypoint to be executed.

Example: The index of the first waypoint is 0. If you want the robot to move from the third waypoint in the grid, please set the value to 2.

Current Index

The index of the waypoint currently being executed.

All Waypoints in One Move

Once this parameter is selected, the Index will be disabled. When the Step Move by List is executed in a Mech-Viz project, the robot will move through all waypoints in the list in sequence at once.

Use Basic Move Settings at Global Scale

Once this parameter is selected, all waypoints in the move list will use the same Basic Move parameters.

Basic Move Settings

Basic move settings of move-type Steps are used to set the velocity and motion type for the robot when it moves to the waypoint.

Pick or place

Unspecified	Default value
Pick	Please select this option when the move-type Step is before “Vision Move”.
Place	Please select this option when the move-type Step is after “Vision Move”.
Notes	Setting this parameter facilitates checking the logic of the Mech-Viz project. Please select a proper option according to the on-site situation and ensure that the Step used to pick is placed before the Step used to place.

Motion type

Joint move	Joint motion, which guides the robot to move in a curved path. It is less likely to reach singularities in the path for joint motion. This motion type is applicable to scenarios where the requirement of path accuracy is not strict and the robot moves in a large space.
Linear move	Linear motion, which guides the robot to move linearly. This motion type is applicable to scenarios where there is a strict requirement for path accuracy, such as welding, gluing, and certain types of picking.

Velocity & Acceleration

Velocity and acceleration determine how fast the robot can move. Usually, the set acceleration should be lower than the velocity. When the set acceleration is higher than the velocity, the robot will move in a choppy way.

The velocities of Vision Move and its prior and subsequent Steps should be relatively low to ensure that the objects can be picked steadily.

Blend radius

Default value

50.00 mm

Notes

Usually, the default setting can be used.

The blend radius refers to the distance between the target point and the point where the robot starts to turn. The larger the blend radius, the more smoother the robot motion transitions are. If the robot moves in a relatively small space, please set the blend radius to a smaller value.

If the robot moves in a relatively large space without obstacles and the distance between two consecutive path segments is long, please set the blend radius to a larger value.

Waypoint Type

TCP	The waypoint will be represented by the X, Y, Z values and Euler angles or quaternions in the tool reference frame.
JPs	The waypoint will be represented by the joint positions of the robot.
Workobject pose	The waypoint will be represented by the X, Y, Z values and Euler angles or quaternions in the object reference frame.

The method to determine the waypoint type is shown in the figure below.

Edit pose	Enter quaternions or Euler angles directly to adjust the pose. You can also copy and paste the pose.
Transform pose	Transform the current pose to a new one. It is suitable for fine-tuning.
Rectify pose	Set the coordinate of P1, P2, and P3 according to the instruction, and then rectify the object pose with the three-point method. It is suitable for scenarios where the objects are tilted and their poses cannot be easily determined. For instance, when a cuboid tilts, its pose is hard to determine. Rectify pose can be used here to calculate the pose of the cuboid and therefore the robot can move to the rectified pose.
Edit JPs	Similar to Edit Pose above; edit the JPs by copying and pasting or editing the JPs in either radians or degrees, which can be switched based on the actual requirement.
	Click to move the robot back to the specified waypoint.
	Get the pose of the simulated robot and set it as the waypoint.
	Show all the JPs solutions to the current waypoint.

Move List

Add the waypoints in the move list in sequence manually and set corresponding parameters.

Click + to add a waypoint at the end of the list, and click - to delete the selected waypoint.

Add TCP list

You can add multiple waypoints as TCP in the list at once.

Input TCP as individual lines in the Add TCP list window.