Import processed point cloud to generate point cloud model and pick points

In this workflow, you can select the project, point cloud, and the Step port outputting pick points, and then the target object model and target object can be created. Importing and saving point cloud model files is not required. This workflow is suitable for scenarios with special requirements for point cloud model preprocessing.

In the homepage of the target object editor, click Select under the Import processed point cloud workflow, and set the target object name to enter the configuration process. The overall configuration process is shown in the figure below.

Import project information: Select the project, point cloud, and the Step port outputting pick points, and then the target object model can be generated automatically.
Edit model: Edit the generated point cloud model, including the configurations for the point cloud display and the calibration of the object center point, to ensure better performance of the matching task.
Set pick point: Add pick points or the pick point array on the point cloud model which already edited.
Set collision model (optional): Generate the collision model for collision detection during path planning.

The following sections provide detailed instructions on the configuration.

Import Project Information

Add Project Configuration

To obtain information from the project, select the corresponding project, the Step port outputting the surface/edge point cloud in the project, and the Step port outputting the pick point. Then click Preview to view the point cloud model in the visualization area on the left.

Now the project information has been import. Click Next to edit the generated point cloud model.

Edit Point Cloud Model

The generated point cloud model should be edited for better performance in the subsequent matching task.

Configure Point Cloud Display Settings

By configuring Point cloud display settings, you can view different types of point cloud models, i.e., the models of all point clouds, surface point cloud only, and edge point cloud only, for the current target object and edit the point cloud model according to actual requirements. You can also change the display color of the point cloud model and view relevant reference information, such as the pseudo-textured point cloud.

Calibrate Object Center Point

The tool can automatically calculate the object center point. If you need to calibrate the object center point, select the calculating method under Calibrate center point by application, and click Start calculating.

Method	Introduction	Operation
Re-calculate by using original center point	The default calculation method. Calculate the object center point according to the original object center point and features of the target object.
Calibrate to center of symmetry	Calculate the object center point according to the object’s symmetry. After calculating the symmetry of the current model, the object center point will be set to the center of symmetry. There may be deviations in the calculation. If deviations occur, please adjust manually.
Calibrate to center of feature	Calculate the object center point according to the selected Feature type and the set 3D ROI.	Select the Feature type according to the geometric features of the object, and the tool will calculate the object center point according to the feature type. (Optional) Enable Use 3D ROI. After the 3D ROI is set for the target object, the tool will automatically calculate the object center point according to the features of the target object in the 3D ROI.

Method

Introduction

Operation

Re-calculate by using original center point

The default calculation method. Calculate the object center point according to the original object center point and features of the target object.

Calibrate to center of symmetry

Calculate the object center point according to the object’s symmetry.
After calculating the symmetry of the current model, the object center point will be set to the center of symmetry. There may be deviations in the calculation. If deviations occur, please adjust manually.

Calibrate to center of feature

Calculate the object center point according to the selected Feature type and the set 3D ROI.

Select the Feature type according to the geometric features of the object, and the tool will calculate the object center point according to the feature type.
(Optional) Enable Use 3D ROI. After the 3D ROI is set for the target object, the tool will automatically calculate the object center point according to the features of the target object in the 3D ROI.

Configure Point Cloud Model

To better use the point cloud model in the subsequent matching task and enhance matching accuracy, the tool provides the following two options for configuring the point cloud model. You can enable the Configure point cloud model switch as needed.

Avoid False Matches

Once Avoid false matches is enabled, more matching attempts will be made based on the settings to obtain matching results with higher confidence. However, more matching attempts will lead to longer processing time.

Two methods to avoid false matches are offered, i.e., Auto-calculate unlikely poses and Configure symmetry manually. See the table below for more information.

Method	Introduction	Operation
Auto-calculate unlikely poses	Poses that may cause false matches will be calculated automatically. In subsequent matches, poses that successfully match these poses will be considered unqualified and filtered out.	ClickCalculate unlikely poses to calculate potentially mismatched poses. If you think a pose in the list will not cause a false match, you can click the × sign to remove it from the list.
Configure symmetry manually	For rotationally symmetric target objects, configuring the rotational symmetry of the point cloud model can prevent the robot’s end tool from unnecessary rotations when it is holding the target objects. This increases the success rate of path planning and reduces the time required for path planning, allowing the robot to move more smoothly and swiftly.	Select the symmetry axis by referring to Rotational Symmetry of Target Objects, and then set the Order of symmetry and Angle range.

Method

Introduction

Operation

Auto-calculate unlikely poses

Poses that may cause false matches will be calculated automatically. In subsequent matches, poses that successfully match these poses will be considered unqualified and filtered out.

ClickCalculate unlikely poses to calculate potentially mismatched poses.
If you think a pose in the list will not cause a false match, you can click the × sign to remove it from the list.

Configure symmetry manually

For rotationally symmetric target objects, configuring the rotational symmetry of the point cloud model can prevent the robot’s end tool from unnecessary rotations when it is holding the target objects. This increases the success rate of path planning and reduces the time required for path planning, allowing the robot to move more smoothly and swiftly.

Select the symmetry axis by referring to Rotational Symmetry of Target Objects, and then set the Order of symmetry and Angle range.

When Auto-calculate unlikely poses is selected, for the option to take effect in the subsequent matching, you need to configure the relevant parameters in the used matching Steps. See the following for details.

If the “3D Matching” Step is used, go to Avoid False Matches Adjust Poses, and select Filter out unlikely poses in the drop-down menu. This parameter will appear when the parameter tuning level is set to Advanced or Expert.
If the “3D Target Object Recognition” Step is used, go to Avoid false matches Adjust poses in the “Target object selection and recognition” process, and select Filter out unlikely poses. This parameter will appear when the Advanced mode switch is turned on.

Set Weight Template

In the target object recognition process, setting a weight template can enhance the accuracy of matching results by emphasizing the selected features for recognition. Weight templates are typically used to distinguish the orientation of the target object, and the set weight template will affect the matching results. The procedures to set a weight template are as follows.

A weight template can only be set when the Point cloud display settings is set to Display surface point cloud only.

Click Edit template.
In the visualization area, hold and press the right mouse button to select a part of the features on the target object. The selected part, i.e., the weight template, will be assigned more weight in the matching process.

By holding Shift and the right mouse button together, you can set multiple weighted areas in a single point cloud model.
Click Apply to complete setting the weight template.

For the configured weight template to take effect in the subsequent matching, go to the “Model Settings” parameter of the “3D Matching” Step, and select the model with properly set weight template. Then, go to “Pose Filtering” and turn on the switch Consider Weight in Result Verification. The “Consider Weight in Result Verification” parameter will appear after the “Parameter Tuning Level” is set to Expert.

Now the editing of the point cloud model is completed. You can click Next to set the pick point for the point cloud model.

Set Pick Point

Adjust Pick Point

By default, the pick point list displays the added pick points, the origin of which is the object center point. Changing the object center point will influence the pick points.

If you need to adjust the pick point, for example, delete and hide it, you can hover the cursor over the ? icon to the right of Pick point list to view the instructions. You can also set relevant values under Pick point settings, or drag the pick point to an appropriate position in the visualization area on the left.

Set Pick Point Array

When the target object is symmetrical, you can set the pick point array based on the object center point according to actual needs. Setting the pick point array can prevent the robot’s end tool from unnecessary rotations during picking. This increases the success rate of path planning and reduces the time required for path planning, allowing the robot to move more smoothly and swiftly. The procedures for setting are as follows.

Under “Pick point settings’, click Generate next to Pick point array.
Refer to Rotational Symmetry of Target Objects to select the axis of symmetry, and then set the Order of symmetry and Angle range.

Add Picking Configuration

If a tool has been configured in the “Path Planning” Step or Mech-Viz, you can enable the tool in the tool list to preview the relative position between the tool and the pick point. Once the tool is enabled, you can preview the relative position between the tool and the pick point, helping to determine if the pick point is set appropriately.

If you have modified the tool configurations in the “Path Planning” Step or Mech-Viz, save the changes to update the tool list.

Now you can click Save to save the configurations for the target object. To set the collision model, click Next.

Set Collision Model (Optional)

The collision model is a 3D virtual object used in collision detection for path planning. You can configure the following settings on the collision model according to the actual situation.

Select Collision Model Generating Mode

The tool automatically recommends the collision model generating mode based on the current configuration workflow. The recommended mode for this case is Use STL model to generate point cloud cube. This tool will generate the point cloud cube based on the imported STL model and conduct collision detection. The collision model generated in this method features high accuracy, while the collision detection speed is lower.

Select STL model

Click Select STL model and then select the STL model used to generate the point cloud cube.

Configure point cloud cube

Point cloud cubes are the cubes centered at each point in the point cloud. If these cubes collide with other objects, the point cloud is considered to have collided with these objects.

To perform collision detection, the point cloud is filled with cubes with an edge length of 2 mm. When the target object is too small and its dimensions are close to the edge length of the point cloud cube, the accuracy of the collision model will decrease. When the target object is too large and the collision model includes too many point cloud cubes, the collision detection speed will slow down.

Align Models

Aligning the collision model with the point cloud model of the target object ensures effective collision detection. You can click Auto-align point cloud model and collision model or manually adjust the pose of the collision model to achieve the alignment with the point cloud model of the target object.

Configure Symmetry of Held Target Object

Refer to Rotational Symmetry of Target Objects to select the axis of symmetry, and then set the Order of symmetry and Angle range.

Now, the collision model settings are completed. Click Save to save the target object to Solution folder\resource\workobject_library. Then the target object can be used in subsequent matching Steps.