Process Profile by Filter

Description

This Step is used to process the profile by a filter to obtain a better profile. The optional filters include Gaussian, median, mean, decimation, and gap filling.

Workflow

The process of configuring this Step is shown below.

Configure the input. Connect the ports manually in the graphical programming workspace or select the input(s) under Input in the parameter configuration panel.
Determine whether to use a feature region. For more information, refer to Use Feature Region.
Select the filter type and set the corresponding parameters. For more information on the available filters, refer to Filter Type.
Select the output item Profile (selected by default).
Run the Step and view output.

Parameter Description

Parameter

Description

Use Feature Region

Use feature region(s) to define the region where profile preprocessing will be performed. Once this parameter is selected, only data within the feature region(s) will be processed.

Feature Region

Visible only when the Use Feature Region parameter is selected.

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

Filter Type

The filter for profile preprocessing.

Options: Mean, Gaussian, Median, Gap Filling, Decimation. For the detailed information on filters, please refer to Filter Type.

Filter Type

Filter Type

Description

Mean

The mean filter can smooth the image by calculating the neighbors of pixels in the image and replacing the pixel values in the original image with the calculated average.

When selecting this option, the following parameters need to be set:

X-Direction Window Size

The number of points in the window along the X direction. It defines how many neighboring data points along the X direction are considered for mean filtering.

The larger the window size, the smoother the profile, but the profile details may be lost.

Gaussian

Gaussian filtering is used to remove the noise in the profile, smoothing the profile without losing major details.

When selecting this option, the following parameters need to be set:

X-Direction Window Size

The number of points in the window along the X direction. It defines how many neighboring data points along the X direction are considered for Gaussian filtering.
Sigma

Sigma, the standard deviation, is used to control the shape of the Gaussian distribution. A larger sigma is accompanied by a flatter Gaussian distribution curve and a better smoothing effect.

Median

Median filtering is used to smooth and sharpen the profile by removing unwanted fluctuations and outliers.

When selecting this option, the following parameters need to be set:

X-Direction Window Size

The number of points in the window along the X direction. It defines how many neighboring data points along the X direction are considered for median filtering.

As the window size increases, the filtering effect becomes more pronounced, resulting in greater noise reduction. However, this also leads to longer computing time.

Gap Filling

With the maximum or minimum Z values of the nearest neighbors or linear interpolation between neighboring values, this filter fills in missing data in the specified window.

When selecting this option, the following parameters need to be set:

Gap Filling Type
- Min Z point filling: Use the minimum Z value of the gap endpoints to fill the gap.
- Max Z point filling: Use the maximum Z value of the gap endpoints to fill the gap.
- Linear interpolation filling: Use Z values of the gap endpoints to perform linear interpolation and thus fill the gap.
X-Direction Window Size

Maximum gap width along the X direction. Only gaps equal to or narrower than this width will be filled.

Gap filling may distort features with abrupt depth variations, such as object edges. Adjust this parameter according to the size of the gap to be filled.

Decimation

Decimation reduces the size or resolution of the image. During decimation, some pixels in the raw image will be discarded or merged to generate a small-sized image.

When selecting this option, the following parameters need to be set:

X-Direction Window Size

The sampling interval along the X direction. For instance, if the value is set to 2, the filter will begin selecting data points from the leftmost end of the profile and move in step size of 2 away from that starting point.

Output Description

The output of this Step is a processed profile that can be used as input to other Steps.

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

Error: The sigma value is outside of the valid range.

Possible cause: The parameter value is less than 0.

Solution: Make sure the parameter value is greater than or equal to 0.

CV-W6002

Error: The X-direction window size is outside of the valid range.

Possible cause: The parameter value is less than 3.

Solution: Reset the X-direction window size of the filter to ensure that it is greater than or equal to 3.

CV-W6003

Error: The selected gap filling type is invalid.

Possible cause: The gap filling type was not selected properly.

Solution: Select Gap Filling Type again in the drop-down list.

CV-W6004

Error: The selected filter type is invalid.

Possible cause: The filter type was not selected properly.

Solution: Select Filter Type again in the drop-down list.

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.

I accept

I don't accept