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 ?" 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: