Tools

This section introduces tools and corresponding configurations.

Introduction

Tools, such as grippers and suction cups, are mechanical devices attached to the end of the robotic arm to perform various tasks.

Model of the Tool

In order to visualize the tool in the 3D simulation area and make the tool involve the collision detection, you need to create a visualization model and a collision model of the tool and import them to the model library.

The following table shows the formats of the supported visualization model and collision model of the tool.

Format	STL	OBJ	DAE	Binvox
Visualization Model	√	√	√	×
Collision Model	×	√	×	×

Hint

• The collision models of tools used in the software should be OBJ models that are composed entirely of convex polyhedra (convex hulls). You can use the Model Editor to create convex hulls on the original tool model and convert the model file to OBJ format.

• The visualization model can only be used to visualize the tool in the 3D simulation area and cannot be used in collision detection; while the collision model can only be used in collision detection and cannot be displayed in the 3D simulation area.

Rotational Symmetry

A rotational symmetric tool will coincide with itself after rotating around its axis of symmetry. Configuring the symmetry of the tool can prevent the end of the robot from rotating meaninglessly when picking and placing, and therefore increase the picking success rate and reduce the planning time consumption. Therefore, the robot can move more smoothly and swiftly.

No Rotational Symmetry
2-fold Rotational Symmetry
Rotational Symmetry at Any Angle (Circular)

Tool Center Point (TCP)

The tool is used to pick and place the object. When you move the robot to a specified point to perform pick-or-place task, you are actually moving the TCP (Tool Center Point) to that point. The default TCP is located at the end of the robot, but sometimes you need to adjust the TCP to ensure that the TCP is at the right place for the actual pick-and-place process.

Configure the Tool

Import the Collision Model and Visualization Model

Go to Resources ‣ Model Library and click +. Select the collision model file and visualization model file you need, and then click Open.

Add the Tool

Go to Resources ‣ Tools, and click + to open the Tool Configuration window.

1. Enter a Tool name.

2. Select the Collision model in the drop-down list.

3. Select the Visualization model for the visualization in the 3D simulation area. When the position or size of the visualization model is not correct, please refer to Adjust the Position or Size of the Tool Model to adjust the model.

4. Set the Rotational Symmetry to None, N-fold, or Circular according to the actual situation. If you select N-fold, also set the Number of folds parameter.

5. Follow either of the methods below to set the TCP.

   Modify the TCP parameter	Modify the Euler angles or quaternion directly.
   Use precise TCP data	If you have already obtained the accurate TCP data by other methods, you can click Edit pose and paste the data in the pop-up window.

6. Click OK in the end.

If you need to add more tools, please repeat the above steps.

Delete the Tool

Follow either of the following steps to delete the tool.

• Go to Resources ‣ Tools, select the tool name and press the Delete key.

• Go to Resources ‣ Tools, right-click the tool name and select Delete in the context menu.

Modify the Tool

1. Follow either of the following steps to open the Tool Configuration window.

   • Go to Resources ‣ Tools, double-click the tool name.

   • Go to Resources ‣ Tools, right-click the tool name and select Tool Configuration in the context menu

2. Modify the parameters according to the actual requirement.

3. Click OK.

Set as Active Tool

If you only add one tool, the current tool is the active tool. If you add multiple tools, the first added tool will be used as the active tool by default.

To set a tool as active tool, go to Resources ‣ Tools, right-click the tool you want to use and select Set as Active Tool.

Adjust the Position or Size of the Tool Model

Follow the steps below to adjust the tool model when its position is not correct.

1. Double-click the tool model under Resources ‣ Model Library.

2. Adjust the pose parameters in the pop-up Edit Model Transform window to adjust the model’s position in the 3D simulation area.

Follow the steps below to adjust the model when its size is not correct.

1. Double-click the tool model under Resources ‣ Model Library.

2. In the pop-up Edit Model Transform window:

• Adjust the Scale if you want to adjust the scale of the entire model.

• If you want to adjust the scale on the individual X, Y, or Z direction, clear the Keep ratio for X,Y,Z checkbox, and adjust the scale on each direction respectively.