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=dfee4899f83d0454687e638f6071c8092d56d7ba;hpb=eb33929a623da3858f8105e54f0834f8393f5414;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 dfee4899f..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,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, @@ -73,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 @@ -82,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. @@ -91,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: