Version: 6.5.0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Groups Pages
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 major limitations of these operations.

To produce a Partition in the Main Menu select Operations - > Partition

This operation builds a compound by intersection of several shapes with a set of tool objects or with a plane. The Result will be a GEOM_Object.


Intersection of two shapes.

partition1.png

Arguments: Name + 2 lists of shapes (the shapes from the first list will be intersected with the shapes from the second list) + 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.

The Resulting type has to be equal or lower than the type of the Objects. In other words, if the Objects don't contain any shape of this type, Partition fails.

Keep shapes of lower type checkbox manages standalone shapes of type other than the Limit. If it is checked, lower dimension objects will be preserved, else they will be lost.

For example, you partition a box (Solid) and a face (Face) without any tool (the box is split in two parts by the shape). If you choose the Resulting Type "Solid", you will obtain a compound of two solids, but if you also check Keep shapes of lower type checkbox, you will obtain a compound of two solids and one face (there will be a hole in the resulting face, where the original face intersects with the box, see the corresponding 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: Set presentation parameters and sub-shapes from arguments.

Note
Partition is a complex operation, so its result of it depends on the quality of the initial shapes. Sometimes, if partition fails, such healing operations as Shape Processing and Limit Tolerance can help to attune source shapes to obtain correct result of the Partition. See also TUI example of shape healing.

TUI Command (with sub-shapes intersection):

geompy.MakePartition(ListOfShapes, ListOfTools, ListOfKeepInside, ListOfRemoveInside, Limit, RemoveWebs, ListOfMaterials, KeepNonlimitShapes)

TUI Command (without sub-shapes intersection):

geompy.MakePartitionNonSelfIntersectedShape(ListOfShapes, ListOfTools, ListOfKeepInside, ListOfRemoveInside, Limit, RemoveWebs, ListOfMaterials, KeepNonlimitShapes)

Here,

  • ListOfShapes is a list of shapes to be intersected
  • ListOfTools is a list of shapes to intersect the shapes from ListOfShapes
  • Limit is a Type of resulting shapes
  • KeepNonlimitShapes is a flag that allows to preserve standalone shapes of low dimension (than Limit) in the result.
  • Other parameters are obsolete and kept only for compatibility with previous versions of SALOME.


Intersection of a Shape and a Plane.

partition2.png

Arguments: Name + 1 shape to be intersected + 1 cutting plane.

Advanced option: Set presentation parameters and sub-shapes from arguments.

TUI Command:

geompy.MakeHalfPartition(Shape, Plane), where:

  • Shape is a source shape to be intersected by the Plane
  • Plane is a tool shape, to intersect the Shape.

Examples:

partitionsn1.png
Box intersected by a plane
partitionsn2.png
Result of intersection

partitionsn3.png
Result of intersection of a box and a plane (both as Objects, no tools) with the Resulting type Solid and checked 'Keep shapes of lower type'

Our TUI Scripts provide you with useful examples of Basic Operations.

Copyright © 2007-2012 CEA/DEN, EDF R&D, OPEN CASCADE
Copyright © 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN, CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS