Extract Surface Section

You are viewing an old version of the documentation. You can switch to the documentation of the latest version by clicking the top-right corner of the page.

Description

This Step is used to extract a profile from the surface data. You can form a plane perpendicular to the XOY plane by the connecting line of two feature points on the surface or the center line of the set feature region. The intersection of the formed plane with the surface data can produce a section profile.

The extracted section profile may have a specific orientation, but the output profile of this Step is on the XOZ plane, starting with X = 0.

feature region for profile

output profile

Uses a feature region to extract a section profile

Profile output by the Step

Workflow

The process of configuring this Step is shown below.

extract surface section 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. Set Sectioning Mode.

  3. Set other parameters.

  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

Sectioning Mode

The method of extracting a section profile from the surface data.

Options: Feature region, Feature points

  • Feature region: Define a feature region on the surface, and a plane perpendicular to the XOY plane and passing through the center line of the region will be formed to intersect with the surface data and thus produce a section profile (the red lines shown in the figure below).

    The center line of the feature region is the line initially connecting the midpoints of two edges along the Y-axis.

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

    sectioning feature region 2d

    sectioning feature region

    2D image

    3D image

  • Feature points: Select two data points from the surface data as feature points. The plane perpendicular to the XOY plane and passing through the two feature points is thus formed to intersect with the surface data, generating a profile (the red lines shown in the figure below). The endpoints of the profile are the two feature points (the two yellow dots shown in the figure below).

    In this case, two feature points are the required input of the Step. You need to connect the ports manually or configure the input under Input.

    sectioning feature points 2d

    sectioning feature points

    2D image

    3D image

Feature points provide precise positional information, specifying the endpoints of an intersection to form a plane perpendicular to the surface. It is preferable to use feature points when you already know exactly where the endpoints are located.

Feature region helps you define the position of the sectioning plane more flexibly. If you want to extract the profile from a wide region and do not need to specify endpoints, a feature region may be a better choice.

Average Profiles

The profile is generated by averaging the data points along the direction perpendicular to the center line of the feature region or the line connecting the two feature points.

  • Selected:

    • When Sectioning Mode is set to Feature region, the average Z value of the data points is calculated within the length of the feature region, along the direction perpendicular to the center line of the feature region. The averaged data points (which may be empty) form a profile.

    • When Sectioning Mode is set to Feature points, the average Z value of the data points is calculated within Averaging Width, along the direction perpendicular to the line connecting the two feature points. The averaged data points (which may be empty) form a profile.

      This takes into account not only the data points under the line connecting the two feature points or the center line of the feature region but also the neighboring data points, for a more comprehensive characterization of the region.

      average profile

      In the case of a feature region, the profile is averaged in the direction perpendicular to the profile, and each point on the averaged profile is the average of pixels within the length of the feature region.

  • Unselected (default):

    Use the raw data points (which may be empty) on the intersection directly without averaging. This will only consider the data points under the line connecting the two feature points or the center line of the feature region, reflecting local features.

Min Valid Points

Only valid when Average Profiles is selected. This parameter is used to specify the percentage of valid points within Averaging Width or the length of the feature region. When the actual percentage of valid points is lower than this value, the data point on the profile will be judged as non-existent.

If certain data points on the profile are judged as non-existent, the region may be too sparse.

Show Detail

Once this option is selected, the generated section profile will be displayed on the raw data.

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

Profile

The resulting profile.

Start X

The X coordinate of the start point of the profile.

End X

The X coordinate of the end point of the profile.

Start Y

The Y coordinate of the start point of the profile.

End Y

The Y coordinate of the end point of the profile.

Rotation Angle

The rotation of the extracted profile counterclockwise around the Z-axis (the angle between extracted profile and positive X-axis).

Troubleshooting

See Common Errors and Solutions for common error messages and fixes for all Steps.

Invalid Parameter

No. Error Possible Causes Solution

1

Inappropriate min valid points

The set value of min valid points is not within [0, 1].

Reset Min Valid Points and ensure that the value is within [0, 1].

Invalid Input

No. Error Possible Causes Solution

1

Invalid input “Feature Point 1”

-

Check and adjust the input “Feature Point 1” to ensure that it is a valid feature point.

2

Invalid input “Feature Point 2”

-

Check and adjust the input “Feature Point 2” to ensure that it is a valid feature point.

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.