Alignment

Description

This Step is used to match the model features to the features in the image. Transform the input image by scaling, rotation, or translation to eliminate its differences from the model.

Workflow

The process of configuring this Step is shown below.

alignment process
  1. Configure the input. Connect the ports manually or select the input(s) under Input in the parameter configuration panel.

  2. Make and select a model. For more information on how to make a model, please refer to 2D Model Editor.

  3. Set Matching Parameters.

  4. Select the desired output(s) under Output. For an expandable output item, click ▶ and configure the Min and Max values of the acceptable range.

  5. Run the Step and view output.

Parameter Description

Parameter Description

Use Intensity Image

This parameter determines whether to use intensity image. Once this parameter is selected, the input intensity image will be used for matching with an intensity image model. It is not checked by default.

Use Feature Region

Feature region defines the area to be processed by the algorithm. When this option is selected, this Step will only process data within the feature region.

For more information on how to set and adjust the feature region, see Feature Region.

Model Settings

Parameter Description

Select Model

This parameter is used to set the matching model.

Click Edit Model to open 2D Model Editor, where you can edit the model for alignment. After setting and saving the model, click and select the model in the drop-down menu. For instructions on how to use the editor, please refer to 2D Model Editor.

Once the Use Intensity Image option is selected, you should select an intensity image model; otherwise, select a depth map model.

Matching Settings

Parameter Description

Pyramid Level

This parameter determines from which level of the pyramid to start for downward model matching.

This parameter should be set according to the size of the object and the image resolution. Generally, for larger objects and higher-resolution images, a higher pyramid level is required.

Matching Score Threshold

This parameter is used to determine whether a matching result is valid. Result with a matching score below this threshold will be discarded.

Default setting: 50.0

Max Padding Size

This parameter determines the maximum number of pixels to be padded.

Default setting: 0

When a part of the object to be matched is outside the image, padding is required. If the number of pixels of the object outside the image after matching is above the set value, a matching failure will occur.

Max Overlap Ratio

This parameter defines the upper limit of the overlap ratio if there is an overlap between two matching results. If the overlap ratio is above the set value, the result with the higher matching score will be retained, while the result with the lower score will be discarded.

Default setting: 0.40

Skip Lowest Level

This parameter is used to determine whether to ignore the lowest level of the pyramid during matching. The parameter is selected by default, and it can accelerate matching.

Refinement Setting

Parameter Description

Use Non Rigid Refinement

Once this option is selected, a non-rigid method for pose refinement will be used.

This is suitable for scenes where there is object deformation.

Search Radius

This parameter is used to set the radius when searching for the corresponding point in pose refinement.

Default setting: 10

When the matching effect is poor, increase the value appropriately.

Canny Low Threshold

This parameter determines the minimum number of edge pixels to be extracted during pose refinement. A lower value implies a greater number of pixels recognized as edges.

Default setting: 30

Canny High Threshold

This parameter determines the maximum number of edge pixels to be extracted during pose refinement. A higher value implies a greater number of pixels recognized as edges.

Default setting: 60

ICP Model Downsampling Step

This parameter specifies the step size for model downsampling, accelerating the matching. Increasing this value will help speed up pose refinement but may decrease the accuracy.

Default setting: 1

ICP Scene Downsampling Step

This parameter specifies the step size for scene downsampling, accelerating the matching. Increasing this value will help speed up pose refinement but may decrease the accuracy.

Default setting: 1

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 Min and Max values to determine the acceptable range. If the output value falls within the acceptable range, the measurement item is judged as passing (OK), or else it is judged as failing (NG).

Output Item Description

Surface Data

The surface data after alignment.

Confidence

The confidence of the matching result or the accuracy of the match.

Alignment Parameter Group

A parameter group containing the coordinates of the reference point and the reference orientation.

Troubleshooting

See Error Code List for common error messages and solutions.

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.