Profile Filter

The Profile Filter tool provides processing filters that you can apply to a uniform profile (not point cloud profiles), letting you process scan data to get more repeatable measurements. You can enable up to seven of the filters at once, in any order. Filters in the tool are chained together. Any Profile tool can use the resulting filtered profile as input.

Profile with no filtering (top) and with averaging filter (bottom)

For a list of the filters, see Filters.

The Filter tool provides no measurements or decisions. It only outputs processed profile data.

A limited set of filters is also available on the Scan page. These filters let you process scan data without needing to add tools. This can be useful if you are using a sensor mostly as an acquisition device.

For information on adding, managing, and removing tools, as well as detailed descriptions of settings common to most tools, see Tool Configuration.

Inputs

You configure the tool's inputs in the expandable Inputs section.

To use a measurement as an anchor, it must be enabled and properly configured in the tool providing the anchor. For more information on anchoring, see Measurement Anchoring.

Inputs
Name Description
Enable Batching

When Enable Batching is checked, the tool takes an array as input and processes each profile in the array individually. There is no limit to the size of the array, other than processing limitations of the sensor.

For more information on arrays, batching, and aggregating, see Arrays, Batching, and Aggregation.

Profile Input

The data the tool applies measurements to or processes.

Anchor X or Anchor Z

The X or Z measurement of another tool that this tool uses as a positional anchor. Positional anchors are optional.

Parameters

You configure the tool's parameters in the expandable Parameters section.

Parameters
Parameter Description

Use Region

When enabled, displays Region parameters (see below). When disabled, the tool uses all data.

Number of Regions

Region {n}

Lets you set the number of regions, and for each region, the position and dimension.

For more information on regions, see Regions.

Filter Type

The type of filter. For more information on the available filters, see Filters.

Units

The units the filter uses for the window or windows: points or distance (mm). Not available with all filters. This parameter is only displayed after enabling Filter in X or Filter in Y.

Filter in X

Filter in Y

When enabled, filters along X and Y, respectively, and displays X Window Size or Y Window Size parameters you use to set the window size, using the unit set in Units. (The gap filling and Gaussian filters only let you filter along the X axis.)

Sigma

The Gaussian curve’s sigma value. (Only displayed with the Gaussian filter and when Filter in X is enabled.)

The following filters are available in the Profile Filter tool.

Filters
Name Description

Gap Filling

Fills in missing data caused by occlusions using information from the nearest neighbors. Gap filling also fills gaps where no data is detected, which can be due to the surface reflectivity, for example dark or specular surface areas, or to actual gaps in the surface. The value in X Window Size represents the maximum gap width that the sensor will fill. Gaps wider than the maximum width will not be filled.

Gap filling works by filling in missing data points using either the lowest values from the nearest neighbors or linear interpolation between neighboring values (depending on the Z difference between neighboring values), in the specified window.

Median

Substitutes the value of a data point with the median calculated within the window or windows set in X Window Size or Y Window Size around the data point. If the number of valid (non-null) data points in the window is even, the median value is simply the value in the center of the sorted list of values. If the number of valid points is odd, the average of the two values in the center is used instead.

Missing data points will not be filled with the median value calculated from data points in the neighbourhood.

With an odd window size, the output is at the center of the window. With an even window size, the output is 0.5 pixels to the right of the center (that is, using window / 2-1 values from the left, and window / 2 from the right.

Averaging

Substitutes a data point value with the mean value of that data point and its nearest neighbors within the window or windows set in X Window Size or Y Window SizeX smoothing works by calculating a moving average across samples within the same profile. Y smoothing works by calculating a moving average in the direction of travel at each X location.

If both X and Y smoothing are enabled, the data is smoothed along X axis first, then along the Y axis.

Missing data points will not be filled with the mean value calculated from data points in the neighbourhood.

Decimation

Decimation reduces the number of data points along the X or Y axis by choosing data points at the end of a specified window around the data point. For example, by setting X Window Size to 0.2, only points every 0.2 millimeters will be used. The filter generates points starting from the leftmost edge of the scan data, stepping in equal steps away from that side.

Gaussian

A Gaussian filter applied over the specified kernel using the provided sigma. Enables a Sigma parameter.

Outputs

The tool provides the following output.

Data
Type Description
Uniform Profile

The filtered uniform profile.