geom/doc/salome/gui/GEOM/input/check_self_intersections.doc

/*!

\page check_self_intersections_page Detect Self-intersections

\n To <b>Detect Self-intersections,</b> select in the <b>Main Menu</b> 
<b>Inspection - > Detect Self-intersections</b>.

There are two ways to check self-intersections.

\anchor check_self_intersections_topological
<br><h3>Check topological intersections</h3>

This operation checks the topology of the selected shape to detect self-intersections.

\image html measures11.png

In this dialog:

- \b Object - the checked object. \b Selection button allows picking it in the viewer or in the object browser.
- <b>Level of check</b> - combo box allows setting the level of self-interference checking. It defines, which interferences will be checked. The default value is "All interferences".
- <b>Compute self-intersections</b> button performs the computation.
- \b Summary section contains the general report about self-intersections of the object and/or errors that occurred during the computation.
- \b Self-intersections list contains the list of detected self-intersections. Select the intersection to show <b>Sub-shapes</b> in the field to the right. 
- \b Apply and <b>Apply and Close</b> buttons store the interferences selected in the <b>Self-intersections</b> list box in the study for further analysis. 
If no interferences are selected, all of them are published in the study. Each interference is published as a child compound of the source shape and contains a couple of intersecting sub-shapes.

\note This tool is useful for detection of shapes that are not suitable as
arguments of Boolean operations and Partition algorithm.
For more information about Partition and Boolean Operations Algorithms
and their limitations refer to <a href="SALOME_BOA_PA.pdf">this document</a>.

\n <b>Result:</b> Boolean.
\n <b>TUI Command:</b> <em>geompy.CheckSelfIntersections(theShape, theCheckLevel = GEOM.SI_ALL),</em> \n
where: \n
\em theShape is the shape checked for validity. \n
\em theCheckLevel is the level of check. Default value is GEOM.SI_ALL to check all interferences.

See also a \ref tui_check_self_intersections_page "TUI example".

\anchor check_self_intersections_fast
<br><h3>Fast intersection</h3>

This operation allows quickly detecting self-interferences of the given shape using the algorithm based on mesh intersections.

The algorithm works on the face level, i.e. it computes only face-to-face intersections. No additional intersection types are computed.

This can be useful to detect all intersections between subshapes of type "surface" in an assembly.
The result quality will depend on the tessellation quality. However, small deflection values can significantly decrease the performance of the algorithm.
Nevertheless, the performance of Fast Intersect algorithm is much higher than that of the topological intersection.

\image html measures13.png

In this dialog:

- \b Object - the checked object. \b Selection button allows picking it in the viewer or in the object browser.
- <b>Deflection coefficient</b> -  a linear deflection coefficient that defines the tessellation quality. If theDeflection <= 0, default deflection 0.001 is used.
- <b>Detect gaps with tolerance</b> specifies the distance between shapes used for detecting gaps:
     - if theTolerance <= 0, the algorithm detects intersections;
     - if theTolerance > 0, the algorithm detects gapss. 
- <b>Compute self-intersections</b> button performs the computation.
- \b Summary section contains the general report about self-intersections of the object and/or errors that occurred during the computation.
- \b Self-intersections list contains the list of detected self-intersections. Select the intersection to show <b>Sub-shapes</b> in the field to the right. 
- \b Apply and <b>Apply and Close</b> buttons store the interferences selected in the <b>Self-intersections</b> list box in the study for further analysis. 
If no interferences are selected, all of them are published in the study. Each interference is published as a child compound of the source shape and contains a couple of intersecting sub-shapes.

\n <b>Result:</b> Boolean.
\n <b>TUI Command:</b> <em>geompy.CheckSelfIntersectionsFast(theShape, theDeflection, theTolerance),</em> \n
where: \n
\em theShape is the shape checked for validity. \n
\em theDeflection that specifies the quality of tessellation. 
\em theTolerance Specifies the distance between shapes used for detecting gaps.

See also a \ref tui_check_self_intersections_fast_page "TUI example".

*/