Tools

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.

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

×

×

×

  • The collision models of tools used in the software should be OBJ models that are composed entirely of convex polyhedra. 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

pathplanning end tool end tool symmetry1

180° Rotational Symmetry

pathplanning end tool end tool symmetry2

Rotational Symmetry at Any Angle (Circular)

pathplanning end tool end tool symmetry3

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.

pathplanning end tool end tool tcp

Configure the Tool

Import the Collision Model and Visualization Model

Click the + next to Resources  Model Library, and select the collision model and visualization model in the pop-up window, 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, you also need to 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.

We Value Your Privacy

We use cookies to provide you with the best possible experience on our website. By continuing to use the site, you acknowledge that you agree to the use of cookies. If you decline, a single cookie will be used to ensure you're not tracked or remembered when you visit this website.