Segmentation

Count

Returns the total number of segments identified, based on the tool's parameters.

Min Dimension

Max Dimension

The minimum and maximum dimensions among all of the identified segments.

Mean Width

Mean Length

The mean width and length of the segments, respectively.

Min Area

Max Area

The minimum and maximum area among all of the identified segments.

Sum Area

The sum of the areas of the segments.

Mean Area

The mean area of the segments.

Min Height

Max Height

The minimum and maximum heights among all of the identified segments.

Mean Height

The mean height of the segments.

X Center {n}

Y Center {n}

The X and Y positions of the center of a part segmented from the surface.

The Number of Part Outputs setting determines the number of measurements listed in the Measurements tab.

Z Average {n}

Z Min {n}

Z Max {n}

The average, minimum, and maximum Z value of a part segmented from the surface.

The Number of Part Outputs setting determines the number of measurements listed in the Measurements tab.

Width {n}

Length {n}

The width and length of a part segmented from the surface. These are always the major and minor axis of a part, respectively.

The Number of Part Outputs setting determines the number of measurements listed in the Measurements tab.

An array containing the segments. For an example of how to access this data from an SDK application or a GDK tool, see the appropriate sample in the SDK samples; for more information, see Setup and Locations.

Surface data you can use to evaluate the impact of the tool's kern size and iteration settings, which the tool uses to separate potential segments.

The sensor that provides data for the tool's measurements.

Causes the tool to use intensity. The option is only displayed if intensity data is available.

Only displayed on older instances of this tool. Newer instances use "flexible regions" (see the parameters below in this table).

Indicates whether the tool uses a user-defined region.

If this option is not checked, the tool uses data from the entire active area.

Only displayed on newer instances of this tool.

When you enable Use Region, the tool displays additional settings related to the measure region type. For details on flexible regions and their settings, see Flexible Regions.

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

The minimum and maximum areas in square millimeters for a part of the scan data to be identified as a segment.

The minimum and maximum aspect ratios (minimum axis length in mm) / (maximum axis length in mm) of the best fit ellipse to the segment contour points for a segment to qualify to be added to the list of found segments.

These settings perform background separation. The greater each of these values is, the more separation will be achieved. You must find a balance that removes noise adequately without degrading the segment find quality.

Use this value to adjust the “granularity” of the part edge detection.

Controls the separation of the parts, increasing the gap between the parts so that they can be detected more easily.

Use this setting to detect segments when they are surrounded by background data. Choose one of the following: All Parts or External Parts.

All Parts

This option lets you segment parts with surrounding background data.

This is the default behavior in firmware 6.0 and later. Jobs created using firmware 5.3 SR1 or earlier default to External Parts (see below).

For example, in the following image, with All Parts selected, the sphere is correctly segmented from the surrounding background.

Note that this option may result in "over-segmentation": the tool may segment a part into two segments.

External Parts

In the following image, with External Parts, the sphere is not identified as a segment because of the surrounding background. It is treated as part of a large segment that includes all of the background. (This "segment" is indicated by a red border that shows it's currently selected. Note that to exclude this kind of segment, you can set a maximum acceptable part area in the tool.)

When enabled, discards parts that are too close to the edge of the scanning area or the region, based on the left, right, top, and bottom values.

The tool filters the parts using the center point.

In the following, a part's center point is close to the edge of the XY scan area; the right margin is set to 0, so the part is not discarded. (Total part count is 9.)

In the following, the right margin has been set to 10 mm. Because the center point of the part is now within the margin, the tool discards the part. (Total part count is reduced to 8.)

Orders the measurements, features, and surface data of the individual parts output by the tool. Choose one of the following:

• Area - Large to small
• Area - Small to large
• Position - X increasing
• Position - X decreasing
• Position - Y increasing
• Position - Y decreasing
• Position - Z increasing
• Position - Z decreasing

Returns more accurate width, height, and area measurements, as well as a better Surface output, but the trade-off is greater processing time. If you only need center points or the number of parts, disable this parameter for faster processing.

Toggles whether the tool displays the index and area of each individual part.

Determines the number of parts the tool outputs as measurements, features (center points of parts), and surface data. Currently limited to 200 parts.

When this parameter is enabled, the tool outputs the minimum, maximum, and average Z value of each segment. This can be useful in applications where a large number of segments is expected when you need these Z measurements for each one.

The filters that are applied to measurement values before they are output. For more information, see Filters.

Lets you choose the X or Z measurement of another tool to use as a positional anchor for this tool.