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