Locate Feature Point of Surface
Description
This Step is used to locate a feature point on the surface, such as a point with a maximum or minimum Z value.
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.
-
Determine whether to use feature region. For a feature region used, you need to set Feature Region Mode. For more information, please refer to Use Feature Region.
-
Determine whether to use reference plane. If a reference plane is used, an additional input will be displayed. You can manually connect the corresponding ports in the graphical programming workspace or configure the input under Input.
-
Select the desired output(s) under Output. For an expandable output item, click ▶ and configure the Min and Max values of the acceptable range.
Parameter Description
- Feature Point Type
-
This parameter is used to determine the type of the feature point. For more detailed information, please refer to Feature Points.
Options: Min X, Max X, Min Y, Max Y, Min Z, Max Z, Average, Centroid, Median
Default setting: Average
Instruction: Complete the configuration according to the actual requirement. Notably, only a few of the above types are available when a reference plane is used.
- 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 or outside the feature region.
Default setting: Selected
Instruction: Complete the configuration according to the actual requirement.
- Feature Region Mode
-
Once Use Feature Region is selected, this parameter is used to select whether to process the data within the feature region or outside it.
Options: Include data in Region, Exclude data in Region
Default setting: Include data in Region
Instruction: To process data within the feature region, select Include data in Region; otherwise, select Exclude data in Region.
For other parameter settings of the feature region, please refer to Set the Feature Region. |
- Use Reference Plane
-
Once this option is selected, a feature point will be located according to its distance to the reference plane.
Default setting: Unselected
Instruction: Once this option is selected, please reset Feature Point Type.
- Feature Point Type (Use Reference Plane selected)
-
This parameter is used to select the type of the feature point when a reference plane is used.
Options: Min Z, Max Z, Average Z, Median Z (Z is the distance of points in the region to the reference plane)
-
Max Z: The point in the region with the largest distance to the reference plane.
-
Min Z: The point in the region with the smallest distance to the reference plane.
-
Average Z: The point in the region whose distance to the reference plane is on average.
-
Median Z: The point in the region whose distance to the reference plane is the median.
Default setting: Average Z
-
Output Description
Select the output item(s) according to the actual measurement requirements. Then the corresponding data will be output after the Step is run.
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 |
---|---|
X-Coordinate |
The X value of the feature point. |
Y-Coordinate |
The Y value of the feature point. |
Z-Coordinate |
The Z value of the feature point. |
Feature Point |
The located feature point. |
Troubleshooting
Invalid Type
No. | Error | Error Description | Possible Causes | Solution |
---|---|---|---|---|
1 |
Invalid feature point type |
The feature point type selected is invalid and Use Reference Plane is unselected. |
The feature point type is not selected properly. |
Adjust Feature Point Type. |
2 |
Invalid feature point type |
The feature point type selected is invalid and Use Reference Plane is selected. |
The feature point type is not selected properly. |
Adjust Feature Point Type. |
Invalid Input
No. | Error | Error Description | Possible Causes | Solution |
---|---|---|---|---|
1 |
Invalid reference plane |
When a reference plane is used, the input reference plane is invalid. |
The parameters related to the reference plane is not set properly. |
Check the parameters related to the reference plane and ensure that the input reference plane is valid. |