Finding Surface Overlap
The surface overlap capability finds surfaces that overlap each other, with the capability to specify a distance and angle range between them. This is useful for debugging geometry imprinting and merging problems, as well as for finding gaps in large assembly models.  Finding overlapping geometry is done using the command: Find [Surface] Overlap [Body <id_list>] If a body list is not specified, all bodies in the model are checked. The command does not check the surfaces within a given body against each other; rather, it only checks surfaces between bodies.

Facetted Representation

This command works entirely off of the facetted surface representation of the model (the facetted representation is what you see in a shaded view in the graphics). There are inherent advantages and disadvantages with this method. The biggest advantage is avoidance of closest-point calculations with NURBS based geometry, which tends to be slow. This method also eliminates possible problems with unhealed ACIS geometry. The disadvantage is working with a less accurate (i.e., facetted) representation of the geometry. To circumvent problems with this facetted geometry, various settings can be used to control the algorithm.

You might consider generating a more accurate facetted representation of the model before using this command. This can be done with the Graphics Tolerance {Angle|Distance} <value> command, followed by an Update Hack. This will rebuild the entire graphics tree using the new tolerance values you specified. The angular tolerance indicates the maximum angle between normals of adjacent surface facets. The default angular tolerance is 15° - consider using a value of 5° . The distance tolerance means the maximum actual distance between the generated facets and the surface. This value is by default ignored by the facetter - consider specifying a reasonable value here for more accurate results.

Find Overlap Settings

Various settings are used to control the precision and handling of overlaps during the find overlap process.  A listing of the settings that find overlap uses is printed using the command:

Find [Surface] Overlap Settings These settings, and the commands used to control them, are described below. 

Gap - Minimum/Maximum - the algorithm will search for surfaces that are within a distance from the minimum to maximum specified. The default range is 0 to 0.01. Testing has shown this to be about right when searching for coincident surfaces. Gaps can be found by using a range such as 3.95 to 5.05.

set Overlap {Minimum|Maximum} Gap <value>
Angle - Minimum/Maximum - the algorithm will search for surfaces that are within this angle range of each other. The default range is 0.0 to 5.0 degrees. Testing has shown that this range works well for most models. It is usually necessary to have a range up to 5.0 degrees even if you are looking for coincident surfaces because of the different types of facetting that can occur on curvy type surfaces. For example, for the case of a shaft in a hole, the facets of the shaft usually won't be coincident with the facets of the hole, but may be offset by a certain distance circumferentially with each other. The 5 degree max angle range will account for this. If you find that the algorithm is not finding coincident surfaces when it should, you can increase the upper range of this value. Note that this parameter is useful also for finding plates coming together at an angle.
set Overlap {Minimum|Maximum} Angle <value>
Normal - this setting determines whether to search for surfaces whose normals point towards each other (same), away from each other (opposite) or either (any). The default is ANY, but it may be useful to limit this search to opposite, as this would be the usual case for most finds.
set Overlap Normal {ANY|opposite|same}
Tolerance - two individual facets must overlap by more than this area for a match to be found. Consider the two cylindrical curves at the interface of the shaft and the block in Figure 1. Note that some of the facets actually overlap, even though the curves will analytically be coincident. You can filter out false matches by increasing the overlap tolerance area.  The default value for this setting is 0.001.
set Overlap Tolerance <value>

Figure 1. Possible false find due to overlap (tolerance will prevent finding match)

Imprint - If on, Cubit will imprint the overlapping surfaces that it finds togetherThis will often force imprints that just imprinting bodies together will miss. For each pair of overlapping surfaces, the containing body of one surface is imprinted with the individual curves of the other surface, until the resulting surfaces no longer overlap.
set overlap imprint {on|OFF}
Group - the surface pairs found can optionally be placed into a group. The name of the group defaults to "overlap_surfaces".
set Overlap Group {ON|off}
List - by default the command lists out each overlapping pair - this can be turned off using the command:
set Overlap List {ON|off}
Display - by default the command clears the graphics and displays each overlapping pair - this can be turned off using the command:
set Overlap Display {ON|off}