Measure Surface Track

Description

Use pre-defined track lines and measurement parameters to inspect whether the height, width and position of a track in the surface data are qualified, thereby detecting overflow, breakage, and other issues.

Basic Concepts

Track and track line

  • Track

    The target of measurement, usually refers to glue bead lines. The “Measure Surface Track” Step can be used to measure the width and height of such tracks and judge whether the dimensions of all kinds can meet the requirements.

  • Track line

    The line that a track should follow, ideally the centerline of a track. Track lines should be manually drawn. See Track Line Editor for details on how to create and adjust track lines.

track n track line demo

As shown in the figure, the track is light gray, and the track line is the cyan line.

Section profile, peak point, side point, and center point

Sampling section profiles from the surface data of the track can help judge whether the dimensions of the track, such as height and width, can meet the standards.

  • Section profile

    Every time a section is sampled from the surface data of the track, a section profile of the track can be obtained. On this basis, the measurement of dimensions, such as height and width, can be performed.

  • Peak point

    The point with the greatest height on each profile.

  • Side point

    There are two side points for each profile, which reflect the farthest points on both sides of the track. The distance between the points after projection onto the XOY plane is the track width at a section.

  • Center points

    The midpoint of two side points is a center point. The distance from the measured center point to the track line is the offset. If the offset value is outside of the valid range, the corresponding center point is judged as NG. Such a case shows that the track at the section may have issues such as overflow and breakage. These issues need to be clarified according to the actual situation. The center point is displayed in green when judged as OK, and in red when judged as NG. The center point is not necessarily the peak point.

section profile demo

As shown in the figure above, a peak point (in orange), two side points (in blue), and a center point (in green) can be detected from the section profile. On this profile, the peak point coincides with the center point.

Workflow

The process of configuring this Step is shown below.

measure surface track process

  1. Configure the input. Connect the Step ports in the graphical programming workspace or select the input under Input in the parameter configuration panel.

  2. Select or create a track line file. See Track Line Editor to learn how to create or adjust track lines.

  3. Set the parameters under Detection Settings, Judgment Settings, and Display Settings.

  4. Select the desired output items under Output. For an expandable output item, click ▶ and configure the Min and Max values to determine the acceptable range for the item.

  5. Run the Step and view output.

Parameter Description

Track Line Settings

Parameter Description

Select Track Line File

Select a track line file from the drop-down list.

The track line file is used to determine the path that the track should follow and contains settings related to sampling section profiles from the track.
See the instructions on Track Line Editor to learn how to create and adjust track lines.

Detection Settings

Parameter Description

Interpolation Along Profiles

Select this parameter to perform linear interpolation on the section profiles

to make the track width and height measurements more accurate.

Use Height Filter

After selecting this option, set a height range for data points on the section profiles to filter out noise or useless data points.

Once this parameter is selected, set Max Height and Min Height to determine the height range for data points to be retained.

Use Median Filter

Select this parameter to perform median filtering on the section profiles and thus make them smoother.

You need to set the Window Size for median filtering.

Include Null Points

Use this parameter to determine whether to include null points or not in the detection process. (Null points are points without depth or intensity information, which are often the result of data loss.)

Once this parameter is selected, set Null Filling Value of Depth.

Null Filling Value of Depth

A depth value for filling null points.

Only needs to be set after Include Null Points is selected.

Window Size for Peak Detection

The size of windows for detecting the peak points of a section profile. The two windows are separated by a point on the profile.

It is recommended to start by setting the value to 1 to 5 times the image resolution.

Peak Detection Threshold

A point is considered a candidate peak point when its height exceeds the average heights of points in both the left and right windows by the set “Peak Detection Threshold.” The candidate peak point with the largest average height difference over both windows is then considered a peak point.

Height Mode

This parameter is used to determine the meaning of Nominal Height.

  • Absolute height: The “Nominal Height” of a track refers to its actual height value, represented by the actual Z values.

  • Step height: The “Nominal Height” of a track refers to its height value relative to its surrounding flat surface.

Side Detection Method

The method for detecting track sides from section profiles to better determine the side points.

When the slope of track sides is steep, select Maximum gradient; otherwise, select Height threshold.

Side Window Size

The window size for detecting the side points from both sides of section profiles.

The parameter value should be set to 3 or 5 times the lower resolution of the image’s X or Y axis.

This parameter is only visible when the “Side Detection Method” is set to Maximum gradient.

Max Track Width

The distance between the points after projection onto the XOY plane is the track width at a section. Setting a maximum track width can help eliminate side points that do not meet the requirements.

The “Max Track Width” should be slightly greater than Side Window Size.

This parameter is only visible when the “Side Detection Method” is set to Maximum gradient.

Side Height Threshold

During side point detection from a section profile, side points are the leftmost and rightmost points with height values below the set threshold.

This parameter is only visible when the “Side Detection Method” is set to Height threshold.

Gap Filling Threshold

The data points on a section profile may have gaps due to occlusion. When the size of a gap on a profile is less than or equal to the set threshold, use the nearest valid point from the lower side of the gap to fill the gap. When the gap size exceeds the set threshold, leave the gap as null point(s).

gap filling
If the gap size exceeds the set threshold, you can decide whether to Include Null points or not in the detection process.

Judgment Settings

Parameter Description

Nominal Width

The expected width of the track.

Width Tolerance

The maximum acceptable deviation of the actual track width from the nominal width.

Nominal Height

The expected height of the track.

Height Tolerance

The maximum acceptable deviation of the actual track height from the nominal height.

Nominal Cross-Sectional Area

The expected cross-sectional area of the track.

Cross-Sectional Area Tolerance

The maximum acceptable deviation of the actual cross-sectional area from the nominal cross-sectional area.

Offset Tolerance

The maximum allowed distance between center points and track line.

Display settings

Parameter Description

Show Track Line and Profile Spacing

Select this parameter to show the selected track line(s) and profile spacing in the data visualization window.

Show Measured Results

Select this parameter to show all section profiles and their respective center points and peak points obtained through measurement in the data visualization window.

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 should 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

OK Count

The number of section profiles that satisfy the requirements of all judgment settings.

NG Count

The number of section profiles that cannot satisfy the requirements of all judgment settings.

Min Width

The measured minimum track width.

Max Width

The measured maximum track width.

Mean Width

The mean of all measured track widths.

Min Height

The measured minimum track height.

Max Height

The measured maximum track height.

Mean Height

The mean of all measured track heights.

Min Cross-Sectional Area

The measured minimum cross-sectional area of the track.

Max Cross-Sectional Area

The measured maximum cross-sectional area of the track.

Mean Cross-Sectional Area

The mean of all measured cross-sectional areas of the track.

Cross-Sectional Area

The cross-sectional areas measured from all section profiles.

Width

The track widths measured from all section profiles.

Height

The peak heights measured from all section profiles.

Offset

The measured offsets of all center points from the selected track line.

Center Points

The center points measured from all section profiles.

Troubleshooting

  • For common errors, see Error Code List.

  • If the error code is inconsistent with the error message, please contact Technical Support for help.

CV-W3501

Error: The “Length” value set for section profiles is outside of the valid range.

Possible cause: The parameter value is less than or equal to 0, or it is greater than the length of the longest side of the image.

Solution: Ensure the parameter value is greater than 0 and less than the length of the longest side of the image.

CV-W3502

The “Width” value set for section profiles is outside of the valid range.

Possible cause: The parameter value is less than or equal to 0, or it is greater than the length of the longest side of the image.

Solution: Ensure the parameter value is greater than 0 and less than the length of the longest side of the image.

CV-W3503

Error: The “Window Size for Peak Detection” value is outside of the valid range.

Possible causes:

  • The parameter value is less than 0.

  • The parameter value is greater than the length of the longest side of the image.

  • The parameter value is greater than half the length of section profiles.

Solutions:

  • Ensure the parameter value is greater than 0.

  • Ensure the parameter value is less than the length of the longest side of the image.

  • Ensure the parameter value is less than half the length of section profiles.

CV-W3504

Error: The “Max Track Width” value is outside of the valid range.

Possible causes:

  • The parameter value is less than or equal to 0.

  • The parameter value is greater than twice the length of the longest side of the image.

Solutions:

  • Ensure the parameter value is greater than 0.

  • Ensure the parameter value is less than twice the length of the longest side of the image.

CV-W3505

Error: The “Side Window Size” value is outside of the valid range.

Possible causes:

  • The parameter value is less than 0.

  • The parameter value is greater than the length of the longest side of the image.

  • The parameter value is greater than or equal to half the length of section profiles.

Solutions:

  • Ensure the parameter value is greater than 0.

  • Ensure the parameter value is less than the length of the longest side of the image.

  • Ensure the parameter value is less than half the length of section profiles.

CV-W3506

Error: The “Window Size” value is outside of the valid range.

Possible cause:

  • The parameter value is less than 0.

  • The parameter value is greater than the length of the longest side of the image.

  • The parameter value is greater than or equal to the length of section profiles.

Solution:

  • Ensure the parameter value is greater than 0.

  • Ensure the parameter value is less than the length of the longest side of the image.

  • Ensure the parameter value is less than the length of section profiles.

CV-W3507

The drawn track line is not within the image.

Solution: Redraw or modify the track lines in the “Track Line Editor” to ensure the track lines are within the image.

CV-W3508

Error: The “Null Filling Value of Depth” value is not within the valid range.

Possible cause: The parameter value is less than −10000 or greater than 10000.

Solution: Make sure the parameter value is within −10000–10000.

CV-W3509

Error: The “Gap Filling Threshold” value is not within the valid range.

Possible cause: The parameter value is less than 0 or greater than the length of the longest side of the image.

Solution: Ensure the parameter value is greater than or equal to 0 and less than the length of the longest side of the image.

CV-W3510

Error: The set “Side Detection Method” is invalid.

Solution: Select a valid side detection method from the drop-down list.

CV-W3511

Error: The set “Height Mode” is invalid.

Solution: Select a valid height mode from the drop-down list.

CV-W3512

Error: The “Side Height Threshold” is outside of the valid range.

Possible cause: The parameter value is less than −10000 or greater than 10000.

Solution: Make sure the parameter value is within −10000–10000.

CV-W3513

Error: The “Max Height” is outside of the valid range.

Possible cause: The parameter value is less than −10000 or greater than 10000.

Solution: Make sure the parameter value is within −10000–10000.

CV-W3514

Error: The “Min Height” is outside of the valid range.

Possible cause: The parameter value is less than −10000 or greater than 10000.

Solution: Make sure the parameter value is within −10000–10000.

CV-W3515

Error: The “Min Height” value is greater than or equal to the “Max Height” value.

Solution: Make sure the “Min Height” value is less than the “Max Height” value.

CV-W3516

Error: The “Peak Detection Threshold” is outside of the valid range.

Possible cause: The parameter value is less than −10000 or greater than 10000.

Solution: Make sure the parameter value is within −10000–10000.

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.

  • Preference
  • I accept
  • I don't accept