Point Cloud Shape Detector
Function
This Step detects and outputs point clouds of a plane or cylindrical shape; the shape can be selected in the parameter.
Usage Scenario
This Step is usually used to detect objects with flat and cylindrical shapes.
If you need to calculate the pick points of cylinder point clouds, this Step can be followed by the Calc Cylinder Poses Step.
Input and Output
Input
| Input port | Data type | Description |
|---|---|---|
Point Clouds (with normals) |
PointCloud/XYZNormal[] |
Point clouds in the input list of this port will be checked for shape. |
Classification Labels |
String[] |
List of classification labels corresponding to point clouds (optional). |
Point Cloud Confidences |
Number[] |
List of confidences corresponding to point clouds (optional). |
Output
| Output port | Data type | Description |
|---|---|---|
Detected Point Clouds (with normals) |
PointCloud/XYZNormal[] |
List of detected point clouds of corresponding shapes. |
Point Cloud Shape Info |
Shape3D [] |
List of shape information corresponding to each point cloud. |
Classification Labels |
String[] |
List of labels corresponding to each point cloud. |
Point Cloud Confidences |
Number[] |
List of confidence values corresponding to each point cloud. |
Parameter Description
Shapes to Detect
| Parameter | Description |
|---|---|
Shapes to Detect |
Description: This parameter is used to select the target shape type for detection. There are three options: Plane, Cylinder, and Sphere.
|
Detection Settings
| Parameter | Description |
|---|---|
Detector |
Description: This parameter is used to choose the type of detector used during detection, including Method 1 and Method 2. (Upon optimization, there will be only Method 1.)
|
Normal Deviation |
Description: This parameter is used to set the upper limit of the angle difference (in °) between the normal of point in the image and the normal of projected theoretically corresponding standard shape.
|
Acceptable Point Cloud Fluctuation |
Description: This parameter is the upper limit (in mm) of the acceptable range of the point cloud fluctuation error.
|
Min Cluster Interval |
Description: This parameter is the lower limit (in mm) of the interval of point cloud connectivity judgement. When this parameter becomes large, points far away from each other will be clustered into one class; when it becomes smaller, however, points close to each other will be clustered into different classes.
|
Point Cloud Quantization Resolution |
Description: This parameter is used to control the number and intensity of points. The unit is millimeters. Greater number and intensity correspond to higher accuracy and longer computing time; when this parameter is set lower, the point cloud becomes sparser, which may decrease calculation accuracy but save computation time.
|
Number of Results per Point Cloud |
Description: This parameter determines the number of final outputted results for each input point cloud.
|
Sort by Point Counts |
Description: This parameter decides whether to sort the final result according to the size of point cloud or not.
|
Success Probability (0–1.0) |
Description: This parameter is used to adjust the success rate of detection, ensuring that there is a sufficient success rate to detect the corresponding shape.
|
Candidates Filter
| Parameter | Description |
|---|---|
Min Shape Point Count Ratio (0–1.0) |
Description: This parameter is used to set the lower limit of the ratio between the detected points belonging to one shape and the total number of points with shape labels. The points that have shape labels and are under this limit will be filtered out.
|
Min Mean Dist Error (0–1.0) |
Description: This parameter is used to set the lower limit of the mean distance deviation (in mm) between real points and the points of corresponding detected theoretical shape. When this parameter becomes larger, point clouds with huge deviations will be retained; when it becomes smaller, however, point clouds with small deviations will be filtered out.
|
Min Mean Angle Error (0–90) |
Description: This parameter is used to set the lower limit of the mean angle deviation (in °) between real points and the points of corresponding detected theoretical shape. When this parameter becomes larger, point clouds with huge deviations will be retained; when it becomes smaller, however, point clouds with small deviations will be filtered out.
|
Cylinder Property
| Parameter | Description |
|---|---|
Min Radius |
Instruction: This parameter is used to set the lower limit of the cylinder (in mm). Cylinders with a radius lower than this limit will be filtered out.
|
Max Radius |
Instruction: This parameter is used to set the upper limit of the cylinder (in mm). Cylinders with a radius greater than this limit will be filtered out.
|
Optimize Cylinder Positions |
Instruction: This parameter decides whether to optimize the shape parameters of cylinder, center point and axis included.
|