\page check_compound_of_blocks_page Check Compound of Blocks
This operation checks whether a shape is a compound of glued blocks
-and tries to improve the shape to make it include only valid blocks.
+and improves the shape to include only valid blocks.
\image html measures10.png
- Not connected;
- Extra or degenerated edge.
- <b>Incriminated Sub-shapes</b> field outputs the list of sub-shapes that cause problem.
-- \b Apply and <b>Apply and Close</b> buttons launch an improving process
-and publish a result shape which includes valid blocks only. The
-improving process tries to
- - remove seam edges and degenerated edges of surfaces of revolution;
+- \b Apply and <b>Apply and Close</b> buttons launch the improvement process
+and publish the result shape, which includes valid blocks only. The
+algorithm tries to:
+ - remove seam and degenerated edges from surfaces of revolution;
- re-approximate surfaces to exclude singularities on boundaries;
- unite edges and faces;
- glue faces.
-
\n <b>TUI Command:</b>
<em>geompy.CheckCompoundOfBlocks(Compound, theIsUseC1 = False, theAngTolerance = 1.e-12).</em> Checks if the shape
is a valid compound of blocks. If it is true, then the validity flag
\page check_self_intersections_page Detect Self-intersections
-\n To <b>Detect Self-intersections</b> in the <b>Main Menu</b> select
+\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_fast
<br><h3>Fast intersection</h3>
-This operations allows to quickly detect self-interferences of the given shape by means of algorithm based on mesh intersections.
+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 tesselation 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
-This algorithm works on the faces level, i.e. it computes only face-to-face intersections. No additional types of intersections is computed.
-This case can be useful in order to detect all the intersections between the subshapes of type "surface" inside assembly.
-Quality of result will depend on the quality of tesselation (managed via the deflection parameter). However, small values of deflection can
-significantly decrease performance of the algorithm.
-Nevertheless, performance of Fast Intersect algorithm is much higher than topological intersection.
+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 tesselation 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 is a linear deflection coefficient that specifies quality of tesselation. If theDeflection <= 0, default deflection 0.001 is used.
-\em theTolerance Specifies a distance between shapes used for detecting gaps:
- - if theTolerance <= 0, algorithm detects intersections;
- - if theTolerance > 0, algorithm detects gaps.
+\em theDeflection that specifies the quality of tesselation.
+\em theTolerance Specifies the distance between shapes used for detecting gaps.
See also a \ref tui_check_self_intersections_fast_page "TUI example".
All necessary parameters of Dependency Tree Viewer can be edited in the \ref pref_dependency_tree "Preferences".
-\note This functionality is available only if GUI module is builded with Graphics view (set option SALOME_USE_GRAPHICSVIEW to ON when building GUI module).
+\note This functionality is available only if the GUI module is built with Graphics view (option SALOME_USE_GRAPHICSVIEW is ON when building GUI module).
<hr>
\anchor dependency_tree_nodes_anchor <h2>Nodes</h2>
- <b>Length angle</b> where the total length of
the wire should be projected. If it is unchecked the projection is not scaled and the natural
wire length is kept for the projection.
-- <b>Rotation angle</b> the desired angle between the tangent vector to
-the first curve at the first point of the theObject's projection in 2D space
-and U-direction of cylinder's 2D space.
+- <b>Rotation angle</b> the angle between the tangent vector to
+the first curve at the first point of the object projection in 2D space
+and U-direction of the cylinder in 2D space.
- \ref restore_presentation_parameters_page "Advanced options".
\image html proj_on_cyl_dlg.png
-\n The following figure explains meaning of each input angle:
+\n The following figure explains the meaning of each input angle:
\image html proj_on_cyl_angles.png "Input angles of projection on the cylinder"
- "Selected objects" standard selection box allows selecting one or more geometrical objects.
- "Type" combo-box with the following items: "Edges length", "Faces area", "Solids volume".
-\note "Type" combo-box includes only parameters applied to the currently selected shape (e.g. "Solids volume" will not be available for face or shell being selected); multiple selection is processed correspondingly (i.e. only types applicable for all selected shapes will be available).
+\note "Type" combo-box includes only parameters applied to the currently selected shape (e.g. "Solids volume" will not be available for a selected face or shell); multiple selection is processed correspondingly (i.e. only types applicable for all selected shapes will be available).
- "Number of intervals" spin box is used to specify number of distribution histogram ranges.
-- "Scalar range" checkable group box that, when switched ON, allows specifying custom values range used for plotting and creating groups.
-\note By default, "Scalar range" controls is empty; pressing "Compute" button allows automatic computing initial range of the chosen parameter. This is needed as computation of the parameters range can be time-consuming for large or complex models. In case of multiple selection, scalar range is computed as common from all selected shapes.
+- "Scalar range" checkable group box, when switched ON, allows specifying custom values range used for plotting and creating groups.
+\note By default, "Scalar range" controls are empty; pressing "Compute" button allows automatically computing the initial range of the chosen parameter. This is necessary as the computation of the parameters range can be time-consuming for large or complex models. In case of multiple selection, the scalar range is computed for all selected shapes.
- "Plot" button opens or uses an opened Plot2d viewer and plots the distribution histogram for the selected shape(s).
-- "Create groups" button allows creating a groups according to the currently specified parameters. The groups names will include numerical values of the range, e.g. "Edges_length_0-20", "Edges_length_20-40", etc. Empty groups are not created.
+- "Create groups" button allows creating groups according to the currently specified parameters. The group names will include numerical values of the range, e.g. "Edges_length_0-20", "Edges_length_20-40", etc. Empty groups are not created.
- Close dialog box, by pressing <b>Close</b> button.
-\note This functionality is available only if GUI module is builded with Plot 2D Viewer (set option SALOME_USE_PLOT2DVIEWER to ON when building GUI module).
+\note This functionality is available only if GUI module is built with Plot 2D Viewer (option SALOME_USE_PLOT2DVIEWER is ON when building GUI module).
*/
The entities, which satisfy the entered filtering parameters, will be automatically highlighted
in the 3D viewer.
-\b Plot button into "Filter" group box provides an access
-to the \ref shape_statistics_operation_page "Shape Statistics" functionality with simplified look-n-feel:
+\b Plot button gives access
+to the \ref shape_statistics_operation_page "Shape Statistics" functionality with a simplified look-and-feel:
\image html shape_statistics_simple.png
