X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fpartition.doc;h=48d56c0366c71c68d346862ef646f30101740e41;hb=ef20f40494c9ede9394c4465ed565a5a30332611;hp=9af094e702866038a70e4d4d54755f43e8f05316;hpb=73555c78ebf12a1fdb85157b8e7934ad566ae90a;p=modules%2Fgeom.git
diff --git a/doc/salome/gui/GEOM/input/partition.doc b/doc/salome/gui/GEOM/input/partition.doc
old mode 100644
new mode 100755
index 9af094e70..48d56c036
--- a/doc/salome/gui/GEOM/input/partition.doc
+++ b/doc/salome/gui/GEOM/input/partition.doc
@@ -2,12 +2,12 @@
\page partition_page Partition
-For detail description of the Partition operation please refer to
-this document.
-It provides a general review of the Partition and Boolean
-operations algorithms, describes the usage methodology and highlighs
+For a detailed description of the Partition operation please refer to this document.
+It provides a general review of the Partition and Boolean operations algorithms, describes the usage methodology and highlights
major limitations of these operations.
+Perhaps you also ask yourself : \ref partition_explanation "What's the difference between partition, compounds and fuse operation ?"
+
To produce a \b Partition in the Main Menu select Operations - > Partition
This operation builds a compound by intersection of several shapes
@@ -24,7 +24,7 @@ Resulting Type of shape.
As far as the intersection of two objects can produce any type of
geometrical objects, Resulting type box allows choosing the
-preferrable result, i.e. a solid, a shell, a list of faces, etc.
+preferable result, i.e. a solid, a shell, a list of faces, etc.
The Resulting type has to be equal or lower than the type of the
\em Objects. In other words, if the \em Objects don't contain any
@@ -43,15 +43,28 @@ face (there will be a hole in the resulting face, where the original
face intersects with the box, see the corresponding \ref partition_picture_3 "picture" below).
No sub-shapes intersection (Compounds only) check box affects
-only input shapes of the Compound type. If this option is switched off (default
-behavior) each input compound will be automatically exploded into
-sub-shapes and the intersection between these shapes will be also
-computed. If this option is switched on, the intersection between
-sub-shapes will not be performed. In this case the Partition algorithm
-will work faster, but the result might differ from the default behavior.
-
- Advanced option:
- \ref restore_presentation_parameters_page "Set presentation parameters and sub-shapes from arguments".
+only input shapes of the Compound type.
+- If this option is switched off (default behavior) each input compound will be automatically
+exploded into sub-shapes and the intersection between these shapes will be also computed.
+- If this option is switched on, the intersection between sub-shapes will not be performed.
+In this case the Partition algorithm will work faster, but the result might differ from the
+default behavior.
+
+Detect Self-intersections check box is used to check self-intersection of arguments.
+It is enabled only if No sub-shapes intersection (Compounds only) is checked.
+- If this option is switched off (by default), the partition algorithm is
+performed without self-intersection checks.
+- If this option is switched on, each input shape is checked for self-intersection.
+If self-intersection is detected, the operation is aborted.
+
+\note This algorithm does not find all types of self-intersections. It is tuned
+ to detect vertex/vertex, vertex/edge, edge/edge, vertex/face and edge/face
+ intersections. Face/face intersections detection is switched off as it
+ is a time-consuming operation that gives an impact on performance. To find
+ all self-intersections please use \ref check_self_intersections_page
+ "Detect Self-intersection tool".
+
+- Activate \ref restore_presentation_parameters_page "Advanced options" if required.
\note Partition is a complex operation, so its result of it depends
on the quality of the initial shapes. Sometimes, if partition fails,
@@ -69,7 +82,7 @@ KeepNonlimitShapes)
geompy.MakePartitionNonSelfIntersectedShape(ListOfShapes,
ListOfTools, ListOfKeepInside, ListOfRemoveInside, Limit, RemoveWebs,
-ListOfMaterials, KeepNonlimitShapes)
+ListOfMaterials, KeepNonlimitShapes, checkSelfInte)
Here,
- \em ListOfShapes is a list of shapes to be intersected
@@ -78,6 +91,8 @@ Here,
- \em Limit is a Type of resulting shapes
- \em KeepNonlimitShapes is a flag that allows to preserve standalone
shapes of low dimension (than \em Limit) in the result.
+- \em checkSelfInte is a flag that indicates if the arguments should
+be checked for self-intersection prior to the operation.
- Other parameters are obsolete and kept only for compatibility with
previous versions of SALOME.
@@ -87,8 +102,7 @@ previous versions of SALOME.
Arguments: Name + 1 shape to be intersected + 1 cutting plane.
-Advanced option:
-\ref restore_presentation_parameters_page "Set presentation parameters and sub-shapes from arguments".
+Activate \ref restore_presentation_parameters_page "Advanced options" if required.
TUI Command: