Import STL File to Generate Point Cloud Model and Configure Pick Points Manually
In this workflow, you can import an STL file to generate a point cloud model and create a target object quickly. The imported model can be directly used to conduct collision detection for the target object to be recognized. This workflow is suitable for scenarios where the consistency between the point cloud acquired by the camera and the STL model is high.
On the homepage of the target object editor, click Select under the Import STL file workflow, and set the target object name and the path of the STL file to enter the configuration process. The overall configuration process is shown in the figure below.
-
Configure STL file: Set the unit, view, and other parameters for the imported STL file to generate the point cloud model.
-
Edit model: Edit the generated point cloud model, including the configurations for the point cloud display and calibration of the object center point, to ensure better performance of the subsequent matching task.
-
Set pick point: Add pick points or the pick point array on the point cloud model which is 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.
Configure STL File
After importing the STL file, you need to configure the STL file to generate the point cloud model.
|
If you need to switch the STL file during the configuration, you can click Select STL file to import another STL file. |
Set Unit
To fit the generated point cloud model to the actual dimensions of the target object, you need to set the dimensional unit for the STL model to either millimeters (mm) or meters (m), according to actual needs.
Set View
Select the view(s) according to actual needs to generate the point cloud model consisting of various viewpoints.
Set Template Sampling Method
To ensure the density and uniform distribution of the point cloud and to maintain the matching speed, the point cloud template needs to be downsampled.
You can select Automatic downsampling or Custom downsampling under the Template sampling method. If the option Custom downsampling is selected, you need to set the Sampling interval.
Now, the configuration for the STL file is finished. Click Next to edit the generated point cloud model.
Edit Model
The generated point cloud model should be edited for better performance in the subsequent matching task.
Check Point Cloud Model Information
You can check the name of the point cloud model under Model information.
To hide the model of the target object and view the point cloud model only, click the “eye” icon on the right of the name. The left figure below shows both the point cloud model and the target object model, while the right figure below only shows the point cloud model.
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.
|
|
Calibrate to center of feature |
Calculate the object center point according to the selected Feature type and the set 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. |
|
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.
|
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. |
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.
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.
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.