Surface Alignment
Description
This Step aligns the input surface data to a template in the XOY plane via translation and rotation, ensuring the consistency between the two.
Workflow
The process of configuring this Step is shown below:
-
Configure the input. Connect the ports manually or select the input(s) under Input in the parameter configuration panel.
-
Make and select a template. For more information on how to make a template, refer to 2D Template Editor.
-
Determine whether to enable Use Intensity Image and Use Feature Region based on the actual scenario.
-
Set Matching Settings.
-
Select the desired output(s) under Output.
-
Run the Step and view output.
Input Description
| Input Item | Description |
|---|---|
Surface Data |
Surface data used for alignment with the template. |
Parameter Description
| Parameter | Description |
|---|---|
Use Intensity Image |
Determines whether to use the intensity image for template matching. If selected, you must use an intensity image when creating the template; otherwise, the matching will fail. Unchecked by default. When this option is cleared, the Step uses the depth map in the surface data for matching. |
Use Feature Region |
Restricts the matching algorithm to work only within the specified region, improving matching speed and reducing false matches. For more information on how to set and adjust the feature region, see Feature Region. |
Template Settings
| Parameter | Description | ||
|---|---|---|---|
Select Template |
This parameter sets the matching template. Click Open the editor to open 2D Template Editor, where you can edit the template for alignment. After setting and saving the template, click ▼ and select the template in the drop-down menu. For instructions on how to use the editor, refer to 2D Template Editor.
|
Matching Settings
Frequently Used Parameters
| Parameter | Description |
|---|---|
Edge Polarity Sensitive |
This parameter controls whether edge polarity must match the template. The polarity indicates the direction of intensity changes along the edges, e.g., light-to-dark or dark-to-light. If there is not a large disparity in the data acquisition scenarios, enable this option to ensure matching accuracy. If there is a large disparity, disable this option to enhance the matching generalization ability. Enabled by default. |
Min Matching Score |
This parameter is used to determine whether a matching result is valid. Any result whose score is below this value will be discarded. Default value: 50.0 |
Min Rotation Angle |
The minimum rotation angle of the target relative to the template. A narrower rotation angle range improves matching speed. Default value: -15° |
Max Rotation Angle |
The maximum rotation angle of the target relative to the template. A narrower rotation angle range improves matching speed. Default value: 15° |
|
Min Rotation Angle must be less than or equal to Max Rotation Angle. |
Advanced Parameters
| Parameter | Description | ||
|---|---|---|---|
Min Valid Match Ratio |
The minimum ratio of valid matched edge points to the total number of edge points in the template. Default value: 50% |
||
Search Radius |
The radius of the circular search area for finding corresponding matching points of each template feature point in the target image during pose refinement. Default value: 8
|
||
Max Overlap Ratio |
Used to filter out duplicate matching results. If there is an overlap between two matching results and the overlap ratio exceeds this value, only the result with the higher matching score will be retained. Default value: 50% |
||
Padding Ratio |
Specifies the ratio of allowed padded size to template size when the target object may be partially outside the image. Padding can recover edge matches that would otherwise fail, but generally increases computation.
|
||
Edge Threshold Type |
How the edge threshold is set.
|
||
Edge Threshold |
Points with gradient magnitude greater than or equal to this value are considered edge features for template matching. This parameter is visible only when Edge Threshold Type is set to Custom threshold. |
||
Show Edge Points |
When enabled, the data visualization window displays the extracted edge points. This parameter is for visualization only and does not affect the processing result. |
Output Description
Select the output item(s) to add the output port(s) to the Step, and the corresponding data will be output after the Step is run. You can select the output according to the actual measurement requirements.
|
If you select an expandable output item, you must expand it by clicking ▶, and then set the Lower Limit and Upper Limit values to determine the acceptable range. If the output value falls within the acceptable range, the measurement item is judged as OK; otherwise, it is judged as NG. |
| Output Item | Description | ||
|---|---|---|---|
Aligned Surface Data |
The surface data after alignment. |
||
Matching Score |
Used for evaluating the quality of the matching result. |
||
Alignment Parameter Group |
Provides the translation and rotation parameters required to align the matched object with the template.
|
||
Object Pose |
The position and orientation of the aligned object in the surface data coordinate system. |
Troubleshooting
See Error Code List for common error messages and solutions.