X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FGEOM%2Finput%2Fpartition.doc;h=48d56c0366c71c68d346862ef646f30101740e41;hb=97d9c2c6b1eb1b8c37b74e9409ebdb89c42c8c27;hp=13b09a7912aa6a370049fbf19fa64726015b909d;hpb=a71c6a5e82c6a3063a15503394415ba3c3c5f2b2;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 13b09a791..48d56c036
--- a/doc/salome/gui/GEOM/input/partition.doc
+++ b/doc/salome/gui/GEOM/input/partition.doc
@@ -2,15 +2,11 @@
\page partition_page Partition
-
-- 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 ?"
-
+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
@@ -28,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
@@ -47,28 +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.
-
-Detect Self-intersections check box is used to check arguments
-self-intersections. If this option is switched on (default behavior)
-each input shape is checked for self-intersection. In case of its detection
-the operation is aborted. If this option is switched off, the partition
-algorithm is performed without self-intersection checks.
-
-\note This algorithm doesn't find all types of self-intersections. It is tuned
+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".
- 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.
\note Partition is a complex operation, so its result of it depends
on the quality of the initial shapes. Sometimes, if partition fails,
@@ -80,7 +76,7 @@ algorithm is performed without self-intersection checks.
geompy.MakePartition(ListOfShapes, ListOfTools, ListOfKeepInside,
ListOfRemoveInside, Limit, RemoveWebs, ListOfMaterials,
-KeepNonlimitShapes, checkSelfInte)
+KeepNonlimitShapes)
TUI Command (without sub-shapes intersection):
@@ -95,7 +91,7 @@ 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 tells if the arguments should
+- \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.
@@ -106,16 +102,13 @@ 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:
-geompy.MakeHalfPartition(Shape, Plane, checkSelfInte), where:
+geompy.MakeHalfPartition(Shape, Plane), where:
- \em Shape is a source shape to be intersected by the \em Plane
- \em Plane is a tool shape, to intersect the \em Shape.
-- \em checkSelfInte is a flag that tells if the arguments should
-be checked for self-intersection prior to the operation.
Examples: