SALOME documentation central

Blocks Operations
[Transforming geometrical objects]

Functions

def geompy.GetPoint
 Get a vertex, found in the given shape by its coordinates.
def geompy.GetEdge
 Get an edge, found in the given shape by two given vertices.
def geompy.GetEdgeNearPoint
 Find an edge of the given shape, which has minimal distance to the given point.
def geompy.GetFaceByPoints
 Returns a face, found in the given shape by four given corner vertices.
def geompy.GetFaceByEdges
 Get a face of block, found in the given shape by two given edges.
def geompy.GetOppositeFace
 Find a face, opposite to the given one in the given block.
def geompy.GetFaceNearPoint
 Find a face of the given shape, which has minimal distance to the given point.
def geompy.GetFaceByNormale
 Find a face of block, whose outside normale has minimal angle with the given vector.
def geompy.MakeBlockExplode
 Get all the blocks, contained in the given compound.
def geompy.GetBlockNearPoint
 Find block, containing the given point inside its volume or on boundary.
def geompy.GetBlockByParts
 Find block, containing all the elements, passed as the parts, or maximum quantity of them.
def geompy.GetBlocksByParts
 Return all blocks, containing all the elements, passed as the parts.
def geompy.MakeMultiTransformation1D
 Multi-transformate block and glue the result.
def geompy.MakeMultiTransformation2D
 Multi-transformate block and glue the result.
def geompy.Propagate
 Build all possible propagation groups.

Function Documentation

def geompy.GetPoint (   self,
  theShape,
  theX,
  theY,
  theZ,
  theEpsilon 
)

Get a vertex, found in the given shape by its coordinates.

Parameters:
theShape Block or a compound of blocks.
theX,theY,theZ Coordinates of the sought vertex.
theEpsilon Maximum allowed distance between the resulting vertex and point with the given coordinates.
Returns:
New GEOM_Object, containing the found vertex.

Example

def geompy.GetEdge (   self,
  theShape,
  thePoint1,
  thePoint2 
)

Get an edge, found in the given shape by two given vertices.

Parameters:
theShape Block or a compound of blocks.
thePoint1,thePoint2 Points, close to the ends of the desired edge.
Returns:
New GEOM_Object, containing the found edge.

Example

def geompy.GetEdgeNearPoint (   self,
  theShape,
  thePoint 
)

Find an edge of the given shape, which has minimal distance to the given point.

Parameters:
theShape Block or a compound of blocks.
thePoint Point, close to the desired edge.
Returns:
New GEOM_Object, containing the found edge.

Example

def geompy.GetFaceByPoints (   self,
  theShape,
  thePoint1,
  thePoint2,
  thePoint3,
  thePoint4 
)

Returns a face, found in the given shape by four given corner vertices.

Parameters:
theShape Block or a compound of blocks.
thePoint1,thePoint2,thePoint3,thePoint4 Points, close to the corners of the desired face.
Returns:
New GEOM_Object, containing the found face.

Example

def geompy.GetFaceByEdges (   self,
  theShape,
  theEdge1,
  theEdge2 
)

Get a face of block, found in the given shape by two given edges.

Parameters:
theShape Block or a compound of blocks.
theEdge1,theEdge2 Edges, close to the edges of the desired face.
Returns:
New GEOM_Object, containing the found face.

Example

def geompy.GetOppositeFace (   self,
  theBlock,
  theFace 
)

Find a face, opposite to the given one in the given block.

Parameters:
theBlock Must be a hexahedral solid.
theFace Face of theBlock, opposite to the desired face.
Returns:
New GEOM_Object, containing the found face.

Example

def geompy.GetFaceNearPoint (   self,
  theShape,
  thePoint 
)

Find a face of the given shape, which has minimal distance to the given point.

Parameters:
theShape Block or a compound of blocks.
thePoint Point, close to the desired face.
Returns:
New GEOM_Object, containing the found face.

Example

def geompy.GetFaceByNormale (   self,
  theBlock,
  theVector 
)

Find a face of block, whose outside normale has minimal angle with the given vector.

Parameters:
theBlock Block or a compound of blocks.
theVector Vector, close to the normale of the desired face.
Returns:
New GEOM_Object, containing the found face.

Example

def geompy.MakeBlockExplode (   self,
  theCompound,
  theMinNbFaces,
  theMaxNbFaces 
)

Get all the blocks, contained in the given compound.

Parameters:
theCompound The compound to explode.
theMinNbFaces If solid has lower number of faces, it is not a block.
theMaxNbFaces If solid has higher number of faces, it is not a block.
Note:
If theMaxNbFaces = 0, the maximum number of faces is not restricted.
Returns:
List of GEOM_Objects, containing the retrieved blocks.

Example 1
Example 2

def geompy.GetBlockNearPoint (   self,
  theCompound,
  thePoint 
)

Find block, containing the given point inside its volume or on boundary.

Parameters:
theCompound Compound, to find block in.
thePoint Point, close to the desired block. If the point lays on boundary between some blocks, we return block with nearest center.
Returns:
New GEOM_Object, containing the found block.

Example

def geompy.GetBlockByParts (   self,
  theCompound,
  theParts 
)

Find block, containing all the elements, passed as the parts, or maximum quantity of them.

Parameters:
theCompound Compound, to find block in.
theParts List of faces and/or edges and/or vertices to be parts of the found block.
Returns:
New GEOM_Object, containing the found block.

Example

def geompy.GetBlocksByParts (   self,
  theCompound,
  theParts 
)

Return all blocks, containing all the elements, passed as the parts.

Parameters:
theCompound Compound, to find blocks in.
theParts List of faces and/or edges and/or vertices to be parts of the found blocks.
Returns:
List of GEOM_Objects, containing the found blocks.

Example

def geompy.MakeMultiTransformation1D (   self,
  Block,
  DirFace1,
  DirFace2,
  NbTimes 
)

Multi-transformate block and glue the result.

Transformation is defined so, as to superpose direction faces.

Parameters:
Block Hexahedral solid to be multi-transformed.
DirFace1 ID of First direction face.
DirFace2 ID of Second direction face.
NbTimes Quantity of transformations to be done.
Note:
Unique ID of sub-shape can be obtained, using method GetSubShapeID().
Returns:
New GEOM_Object, containing the result shape.

Example

def geompy.MakeMultiTransformation2D (   self,
  Block,
  DirFace1U,
  DirFace2U,
  NbTimesU,
  DirFace1V,
  DirFace2V,
  NbTimesV 
)

Multi-transformate block and glue the result.

Parameters:
Block Hexahedral solid to be multi-transformed.
DirFace1U,DirFace2U IDs of Direction faces for the first transformation.
DirFace1V,DirFace2V IDs of Direction faces for the second transformation.
NbTimesU,NbTimesV Quantity of transformations to be done.
Returns:
New GEOM_Object, containing the result shape.

Example

def geompy.Propagate (   self,
  theShape 
)

Build all possible propagation groups.

Propagation group is a set of all edges, opposite to one (main) edge of this group directly or through other opposite edges. Notion of Opposite Edge make sence only on quadrangle face.

Parameters:
theShape Shape to build propagation groups on.
Returns:
List of GEOM_Objects, each of them is a propagation group.

Example

 All Data Structures Namespaces Files Functions Variables

Copyright © 2007-2008 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