Surface Mask

The Surface Mask tool lets define up to 16 regions to extract data from a surface. Each region’s size, position, and shape (circular, elliptical, and rectangular) can be individually configured, and regions can overlap. The tool can also exclude inner data of circular and elliptical regions, letting you extract rings of surface data. Extracted data is output in a single surface.

The resulting surface can then be further processed or measured by other tools.

For example, given the following scan data:

A circle region box containing a partial ring (cyan)

The image below shows the extracted data. The extracted surface data can then be further processed by other tools, or measurements can be applied to the surface data.

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 surface 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.

Surface Input

The data the tool applies measurements to or processes.

Anchor X

Anchor Y

Anchor Z

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

The Z Angle measurement of another tool to use as a rotational anchor for this tool. Rotational anchors are optional.

Parameters

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

Parameters
Parameter Description

Regions

When expanded, displays the region- and mask-related settings.

Enable

Enables regions and displays the region- and mask-related settings (see below).

Mask Mode

Number of Regions

Region Type {n}

Region {n}

When you enable regions (see above), the tool displays additional settings related to the region type. For details on the regions supported by this tool and their settings, see Flexible Regions.

For general information on regions and the difference between standard and "flexible" regions, see Regions.

External ID

The external ID of the tool that appears in GoHMI Designer. For more information, see GoHMI and GoHMI Designer.

Outputs

All tools provide measurements, geometric features, or data as outputs.

Data
Type Description

Uniform Extracted Region

Point Cloud Extracted Region

The surface containing the extracted region or regions. (Uniform and point cloud data, respectively.)