Regions

Many measurement tools use user-defined regions to limit the area in which measurements occur or to help in the identification of a feature (Feature Points), a fit line (Fit Lines), or left or right side of the Panel tool (see Panel). Unlike reducing the active area, reducing the measurement region does not increase the maximum frame rate of the sensor.

You can disable regions and force a tool to use the entire active area by unchecking the checkbox next to the Regions setting. For more information on active area, see Active Area.

All tools provide region settings under the upper, tool-level Parameters tab. This region applies to all of a tool's measurements. Region settings are sometimes found within expandable feature sections in a tool's panel.

Some of LMI's more recent tools provide "flexible" regions, which in addition to rectangular regions let you create circular and elliptical regions (which can optionally be annular) and polygon regions. These tools also let you use Surface and Surface Intensity data as masks. As of this writing, the following tools have flexible regions:

Other tools are currently limited to rectangular regions. However, you can get "flexible regions" in a tool that doesn't directly support them by using the Surface Mask tool, and using that tool's output as the other tool's input. For more information, see Mask.

For information on setting "flexible" regions, see Flexible Regions.

In 2D mode, the tool region defaults to the center of the current data view, not the global field of view. In 3D mode, the region defaults to the global field of view.

Use the region reset button () to set the size of a region to its default. This is useful after zooming in or out in the data viewer.

Standard Regions

The standard regions are limited to rectangles or boxes.

To configure standard regions:

1. Go to the Measure page by clicking on the Measure icon.

The scan mode must be set to the type of measurement you need to configure. Otherwise, the wrong tools, or no tools, will be listed on the Measure page.

2. In the Tools panel, click on a tool in the tool list.
3. Configure the region using the mouse in the data viewer.

You can also configure regions manually by clicking the expand button () and entering values in the fields. This is useful if you need to set precise values.

Flexible Regions

The following parameters are available in tools that support flexible regions

Flexible Region Parameters
Parameter Description

Number of Regions

The number of regions the tool uses to extract surface data. You can define up to 15 or 16 regions. This parameter is not available in some tools.

When you specify more than one region, the regions are initially stacked on top of one another, in the same location.

Mask Type {n}

Region Type {n}

For each mask (in the Surface Mask tool) or region, the type. Regions can overlap. One of the following. (For more information on the settings you use with the Circle and Ellipse types, see Working with Circular and Elliptical Regions.

 

Circle

Extracts a circular region from the surface data, constrained by a square region.

Set the region's inner circle (inner cyan circle below) using the Inner Circle Diameter parameter to extract annular data.

Use the Sector Start Angle and Sector Angle Range settings to extract a partial circular or elliptical region.

 

Ellipse

Extracts an elliptical region from the surface data, constrained by a square or rectangular region.

Set the region's inner ellipse (inner cyan ellipse below) using the Inner Ellipse Major Axis and Inner Ellipse Minor Axis parameters to extract annular data.

Use the Sector Start Angle and Sector Angle Range settings to extract a partial circular or elliptical region.

 

Polygon

Extracts a polygonal region with the number of vertices specified in Vertex Count. You can define the shape of the polygon using a mouse in the data viewer, dragging and dropping the vertex points.

Note that you can't adjust the height of a polygon region: it occupies the entire vertical space available:

Rectangle

Extracts a rectangular region from the surface data.

Surface

Uses the Surface data you select in Mask Source to create a mask.

Surface Intensity

Uses the intensity data you select in Mask Source to create a mask.

Set the Low Threshold and High Threshold parameters as required.

Inner Circle Diameter

Only available when Region Type {n} is set to Circle.

Defines the diameter of the inner circle.

Set this parameter to a value greater than 0 to extract a ring of data. Set this parameter to 0 to extract a circle of data.

Inner Ellipse Major Axis

Inner Ellipse Minor Axis

Only available when Region Type {n} is set to Ellipse.

These parameters define the major and minor axes of the inner ellipse, respectively

Set this parameter to a value greater than 0 to extract a ring of data. Set this parameter to 0 to extract an elliptical disk of data.

Sector Start Angle

Sector Angle Range

Only available when Region Type {n} is set to Circle or Ellipse

Use these parameters together to extract a partial ring of data. Sector Start Angle controls the starting angle of the data, whereas Sector Angle Range controls the length of the arc.

Note that the angles and ranges in these parameters are measured clockwise around Z, where 0 degrees is along the positive X axis.

For example, in the first image below, Sector Start Angle is set to 135, and Sector Angle Range is set to 270. The resulting extracted partial ring (or annular data) is shown below that.

For more information on how these settings work together, see Working with Circular and Elliptical Regions.

Mask Source

Only available when Region Type {n} is set to Surface or Surface Intensity.

The Surface or Surface Intensity data the tool uses to create a mask.

Low Threshold

High Threshold

Only available when Region Type {n} is set to Surface Intensity.

The low and high thresholds the tool uses in combination with the intensity mask.

Working with Circular and Elliptical Regions

When you set a region's type to Circle or Ellipse, the tool displays several additional settings that work together to define the region. Sector Start Angle and Sector Angle Range work together to define the start and end of a partial circular/elliptical region (solid or annular). A region will be annular if Inner Circle Diameter is non-zero. Note that the "length" of the partial region extends from the start angle. In the following illustration, the start angle (θ) is 135 degrees relative to the 0-degree point indicated below, and the region extends 270 degrees (δ) from that, clockwise around Z.

Sector Start Angle starts at the 0-degree point around Z.

Note that the angles defining a partial circular/elliptical region are relative to the region, and not the sensor's coordinate system. So a region rotated 30 degrees using its Z Angle setting rotates the start angle and angle range by 30 degrees.

When you set a region type to Ellipse, instead of the inner circle diameter, you must set the major and minor axes of the inner ellipse.

Region Rotation

The measurement region of some tools can be rotated by setting the region's Z Angle to better accommodate features that are on an angle on a target. By rotating the measurement region, data not related to the feature can often be excluded, improving accuracy of measurements.

To rotate measurement regions:

1. Determine the length and width of the region that will be required once it is rotated.

2. Expand the Region setting and then set a value in Z Angle.

The region rotates clockwise around the Z axis relative to the X axis.

Once the region has been rotated, you can modify its size and location in the data viewer using the mouse. You can also modify its dimensions and its location manually by changing the region's values in the Region setting.

Some tools let you disable regions entirely and force the measurement tool to use the entire active area by unchecking the checkbox next to the Regions setting. For more information on active area, see Active Area.