Extrusion and Revolution

Functions
def	RotationSweepObjects
	Generate new elements by rotation of the given elements and nodes around the axis. More...
def	RotationSweep
	Generate new elements by rotation of the elements around the axis. More...
def	RotationSweepObject
	Generate new elements by rotation of the elements of object around the axis. More...
def	RotationSweepObject1D
	Generate new elements by rotation of the elements of object around the axis. More...
def	RotationSweepObject2D
	Generate new elements by rotation of the elements of object around the axis. More...
def	ExtrusionSweepObjects
	Generate new elements by extrusion of the given elements and nodes. More...
def	ExtrusionSweep
	Generate new elements by extrusion of the elements with given ids. More...
def	ExtrusionByNormal
	Generate new elements by extrusion along the normal to a discretized surface or wire. More...
def	ExtrusionSweepObject
	Generate new elements by extrusion of the elements or nodes which belong to the object. More...
def	ExtrusionSweepObject1D
	Generate new elements by extrusion of edges which belong to the object. More...
def	ExtrusionSweepObject2D
	Generate new elements by extrusion of faces which belong to the object. More...
def	AdvancedExtrusion
	Generate new elements by extrusion of the elements with given ids. More...
def	ExtrusionAlongPathObjects
	Generate new elements by extrusion of the given elements and nodes along the path. More...
def	ExtrusionAlongPathX
	Generate new elements by extrusion of the given elements The path of extrusion must be a meshed edge. More...
def	ExtrusionAlongPath
	Generate new elements by extrusion of the given elements The path of extrusion must be a meshed edge. More...
def	ExtrusionAlongPathObject
	Generate new elements by extrusion of the elements which belong to the object The path of extrusion must be a meshed edge. More...
def	ExtrusionAlongPathObject1D
	Generate new elements by extrusion of mesh segments which belong to the object The path of extrusion must be a meshed edge. More...
def	ExtrusionAlongPathObject2D
	Generate new elements by extrusion of faces which belong to the object The path of extrusion must be a meshed edge. More...

Detailed Description

Function Documentation

def RotationSweepObjects	(		self,
			nodes,
			edges,
			faces,
			Axis,
			AngleInRadians,
			NbOfSteps,
			Tolerance,
			MakeGroups = False,
			TotalAngle = False
	)

Generate new elements by rotation of the given elements and nodes around the axis.

Parameters

nodes	- nodes to revolve: a list including ids, groups, sub-meshes or a mesh
edges	- edges to revolve: a list including ids, groups, sub-meshes or a mesh
faces	- faces to revolve: a list including ids, groups, sub-meshes or a mesh
Axis	the axis of rotation: AxisStruct, line (geom object) or [x,y,z,dx,dy,dz]
AngleInRadians	the angle of Rotation (in radians) or a name of variable which defines angle in degrees
NbOfSteps	the number of steps
Tolerance	tolerance
MakeGroups	forces the generation of new groups from existing ones
TotalAngle	gives meaning of AngleInRadians: if True then it is an angular size of all steps, else - size of each step

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh._getIdSourceList(), smeshBuilder.ParseAngles(), smeshBuilder.ParseParameters(), and Mesh.RotationSweep().

def RotationSweep	(		self,
			IDsOfElements,
			Axis,
			AngleInRadians,
			NbOfSteps,
			Tolerance,
			MakeGroups = False,
			TotalAngle = False
	)

Generate new elements by rotation of the elements around the axis.

Parameters

IDsOfElements	the list of ids of elements to sweep
Axis	the axis of rotation, AxisStruct or line(geom object)
AngleInRadians	the angle of Rotation (in radians) or a name of variable which defines angle in degrees
NbOfSteps	the number of steps
Tolerance	tolerance
MakeGroups	forces the generation of new groups from existing ones
TotalAngle	gives meaning of AngleInRadians: if True then it is an angular size of all steps, else - size of each step

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.RotationSweepObject(), and Mesh.RotationSweepObjects().

def RotationSweepObject	(		self,
			theObject,
			Axis,
			AngleInRadians,
			NbOfSteps,
			Tolerance,
			MakeGroups = False,
			TotalAngle = False
	)

Generate new elements by rotation of the elements of object around the axis.

Parameters

theObject	object which elements should be sweeped. It can be a mesh, a sub mesh or a group.
Axis	the axis of rotation, AxisStruct or line(geom object)
AngleInRadians	the angle of Rotation
NbOfSteps	number of steps
Tolerance	tolerance
MakeGroups	forces the generation of new groups from existing ones
TotalAngle	gives meaning of AngleInRadians: if True then it is an angular size of all steps, else - size of each step

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.RotationSweepObject1D(), and Mesh.RotationSweepObjects().

def RotationSweepObject1D	(		self,
			theObject,
			Axis,
			AngleInRadians,
			NbOfSteps,
			Tolerance,
			MakeGroups = False,
			TotalAngle = False
	)

Generate new elements by rotation of the elements of object around the axis.

Parameters

theObject	object which elements should be sweeped. It can be a mesh, a sub mesh or a group.
Axis	the axis of rotation, AxisStruct or line(geom object)
AngleInRadians	the angle of Rotation
NbOfSteps	number of steps
Tolerance	tolerance
MakeGroups	forces the generation of new groups from existing ones
TotalAngle	gives meaning of AngleInRadians: if True then it is an angular size of all steps, else - size of each step

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.RotationSweepObject2D(), and Mesh.RotationSweepObjects().

def RotationSweepObject2D	(		self,
			theObject,
			Axis,
			AngleInRadians,
			NbOfSteps,
			Tolerance,
			MakeGroups = False,
			TotalAngle = False
	)

Generate new elements by rotation of the elements of object around the axis.

Parameters

theObject	object which elements should be sweeped. It can be a mesh, a sub mesh or a group.
Axis	the axis of rotation, AxisStruct or line(geom object)
AngleInRadians	the angle of Rotation
NbOfSteps	number of steps
Tolerance	tolerance
MakeGroups	forces the generation of new groups from existing ones
TotalAngle	gives meaning of AngleInRadians: if True then it is an angular size of all steps, else - size of each step

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.ExtrusionSweepObjects(), and Mesh.RotationSweepObjects().

def ExtrusionSweepObjects	(		self,
			nodes,
			edges,
			faces,
			StepVector,
			NbOfSteps,
			MakeGroups = False,
			scaleFactors = [],
			linearVariation = False,
			basePoint = []
	)

Generate new elements by extrusion of the given elements and nodes.

Parameters

nodes	nodes to extrude: a list including ids, groups, sub-meshes or a mesh
edges	edges to extrude: a list including ids, groups, sub-meshes or a mesh
faces	faces to extrude: a list including ids, groups, sub-meshes or a mesh
StepVector	vector or DirStruct or 3 vector components, defining the direction and value of extrusion for one step (the total extrusion length will be NbOfSteps * ||StepVector||)
NbOfSteps	the number of steps
MakeGroups	forces the generation of new groups from existing ones
scaleFactors	optional scale factors to apply during extrusion
linearVariation	if True, scaleFactors are spread over all scaleFactors, else scaleFactors[i] is applied to nodes at the i-th extrusion step
basePoint	optional scaling center; if not provided, a gravity center of nodes and elements being extruded is used as the scaling center. It can be either a list of tree components of the point or a node ID or a GEOM point

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh._getIdSourceList(), Mesh.GetNodeXYZ(), and smeshBuilder.ParseParameters().

def ExtrusionSweep	(		self,
			IDsOfElements,
			StepVector,
			NbOfSteps,
			MakeGroups = False,
			IsNodes = False
	)

Generate new elements by extrusion of the elements with given ids.

Parameters

IDsOfElements	the list of ids of elements or nodes for extrusion
StepVector	vector or DirStruct or 3 vector components, defining the direction and value of extrusion for one step (the total extrusion length will be NbOfSteps * ||StepVector||)
NbOfSteps	the number of steps
MakeGroups	forces the generation of new groups from existing ones
IsNodes	is True if elements with given ids are nodes

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.ExtrusionByNormal(), and Mesh.ExtrusionSweepObjects().

def ExtrusionByNormal	(		self,
			Elements,
			StepSize,
			NbOfSteps,
			ByAverageNormal = False,
			UseInputElemsOnly = True,
			MakeGroups = False,
			Dim = 2
	)

Generate new elements by extrusion along the normal to a discretized surface or wire.

Parameters

Elements	elements to extrude - a list including ids, groups, sub-meshes or a mesh. Only faces can be extruded so far. A sub-mesh should be a sub-mesh on geom faces.
StepSize	length of one extrusion step (the total extrusion length will be NbOfSteps * StepSize ).
NbOfSteps	number of extrusion steps.
ByAverageNormal	if True each node is translated by StepSize along the average of the normal vectors to the faces sharing the node; else each node is translated along the same average normal till intersection with the plane got by translation of the face sharing the node along its own normal by StepSize.
UseInputElemsOnly	to use only Elements when computing extrusion direction for every node of Elements.
MakeGroups	forces generation of new groups from existing ones.
Dim	dimension of elements to extrude: 2 - faces or 1 - edges. Extrusion of edges is not yet implemented. This parameter is used if Elements contains both faces and edges, i.e. Elements is a Mesh.

Returns

the list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise.

References Mesh.GetIDSource(), and smeshBuilder.ParseParameters().

def ExtrusionSweepObject	(		self,
			theObject,
			StepVector,
			NbOfSteps,
			MakeGroups = False,
			IsNodes = False
	)

Generate new elements by extrusion of the elements or nodes which belong to the object.

Parameters

theObject	the object whose elements or nodes should be processed. It can be a mesh, a sub-mesh or a group.
StepVector	vector or DirStruct or 3 vector components, defining the direction and value of extrusion for one step (the total extrusion length will be NbOfSteps * ||StepVector||)
NbOfSteps	the number of steps
MakeGroups	forces the generation of new groups from existing ones
IsNodes	is True if elements to extrude are nodes

Returns

list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.ExtrusionSweepObjects().

def ExtrusionSweepObject1D	(		self,
			theObject,
			StepVector,
			NbOfSteps,
			MakeGroups = False
	)

Generate new elements by extrusion of edges which belong to the object.

Parameters

theObject	object whose 1D elements should be processed. It can be a mesh, a sub-mesh or a group.
StepVector	vector or DirStruct or 3 vector components, defining the direction and value of extrusion for one step (the total extrusion length will be NbOfSteps * ||StepVector||)
NbOfSteps	the number of steps
MakeGroups	to generate new groups from existing ones

Returns

list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.ExtrusionSweepObjects().

def ExtrusionSweepObject2D	(		self,
			theObject,
			StepVector,
			NbOfSteps,
			MakeGroups = False
	)

Generate new elements by extrusion of faces which belong to the object.

Parameters

theObject	object whose 2D elements should be processed. It can be a mesh, a sub-mesh or a group.
StepVector	vector or DirStruct or 3 vector components, defining the direction and value of extrusion for one step (the total extrusion length will be NbOfSteps * ||StepVector||)
NbOfSteps	the number of steps
MakeGroups	forces the generation of new groups from existing ones

Returns

list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.AdvancedExtrusion(), and Mesh.ExtrusionSweepObjects().

def AdvancedExtrusion	(		self,
			IDsOfElements,
			StepVector,
			NbOfSteps,
			ExtrFlags,
			SewTolerance,
			MakeGroups = False
	)

Generate new elements by extrusion of the elements with given ids.

Parameters

IDsOfElements	is ids of elements
StepVector	vector or DirStruct or 3 vector components, defining the direction and value of extrusion for one step (the total extrusion length will be NbOfSteps * ||StepVector||)
NbOfSteps	the number of steps
ExtrFlags	sets flags for extrusion
SewTolerance	uses for comparing locations of nodes if flag EXTRUSION_FLAG_SEW is set
MakeGroups	forces the generation of new groups from existing ones

Returns

list of created groups (SMESH_GroupBase) if MakeGroups=True, empty list otherwise

References Mesh.ExtrusionAlongPathObjects().

def ExtrusionAlongPathObjects	(		self,
			Nodes,
			Edges,
			Faces,
			PathMesh,
			PathShape = None,
			NodeStart = 1,
			HasAngles = False,
			Angles = [],
			LinearVariation = False,
			HasRefPoint = False,
			RefPoint = [0,
			MakeGroups = False
	)

Generate new elements by extrusion of the given elements and nodes along the path.

The path of extrusion must be a meshed edge.

Parameters

Nodes	nodes to extrude: a list including ids, groups, sub-meshes or a mesh
Edges	edges to extrude: a list including ids, groups, sub-meshes or a mesh
Faces	faces to extrude: a list including ids, groups, sub-meshes or a mesh
PathMesh	1D mesh or 1D sub-mesh, along which proceeds the extrusion
PathShape	shape (edge) defines the sub-mesh of PathMesh if PathMesh contains not only path segments, else it can be None
NodeStart	the first or the last node on the path. Defines the direction of extrusion
HasAngles	allows the shape to be rotated around the path to get the resulting mesh in a helical fashion
Angles	list of angles
LinearVariation	forces the computation of rotation angles as linear variation of the given Angles along path steps
HasRefPoint	allows using the reference point
RefPoint	the point around which the shape is rotated (the mass center of the shape by default). The User can specify any point as the Reference Point.
MakeGroups	forces the generation of new groups from existing ones

Returns

list of created groups (SMESH_GroupBase) and SMESH::Extrusion_Error

References Mesh._getIdSourceList(), Mesh.ExtrusionAlongPathX(), and smeshBuilder.ParseAngles().

def ExtrusionAlongPathX	(		self,
			Base,
			Path,
			NodeStart,
			HasAngles = False,
			Angles = [],
			LinearVariation = False,
			HasRefPoint = False,
			RefPoint = [0,
			MakeGroups = False,
			ElemType = SMESH.FACE
	)

Generate new elements by extrusion of the given elements The path of extrusion must be a meshed edge.

Parameters

Base	mesh or group, or sub-mesh, or list of ids of elements for extrusion
Path	- 1D mesh or 1D sub-mesh, along which proceeds the extrusion
NodeStart	the start node from Path. Defines the direction of extrusion
HasAngles	allows the shape to be rotated around the path to get the resulting mesh in a helical fashion
Angles	list of angles in radians
LinearVariation	forces the computation of rotation angles as linear variation of the given Angles along path steps
HasRefPoint	allows using the reference point
RefPoint	the point around which the elements are rotated (the mass center of the elements by default). The User can specify any point as the Reference Point. RefPoint can be either GEOM Vertex, [x,y,z] or SMESH.PointStruct
MakeGroups	forces the generation of new groups from existing ones
ElemType	type of elements for extrusion (if param Base is a mesh)

Returns

list of created groups (SMESH_GroupBase) and SMESH::Extrusion_Error if MakeGroups=True, only SMESH::Extrusion_Error otherwise

References Mesh.ExtrusionAlongPath(), and Mesh.ExtrusionAlongPathObjects().

def ExtrusionAlongPath	(		self,
			IDsOfElements,
			PathMesh,
			PathShape,
			NodeStart,
			HasAngles = False,
			Angles = [],
			HasRefPoint = False,
			RefPoint = [],
			MakeGroups = False,
			LinearVariation = False
	)

Generate new elements by extrusion of the given elements The path of extrusion must be a meshed edge.

Parameters

IDsOfElements	ids of elements
PathMesh	mesh containing a 1D sub-mesh on the edge, along which proceeds the extrusion
PathShape	shape(edge) defines the sub-mesh for the path
NodeStart	the first or the last node on the edge. Defines the direction of extrusion
HasAngles	allows the shape to be rotated around the path to get the resulting mesh in a helical fashion
Angles	list of angles in radians
HasRefPoint	allows using the reference point
RefPoint	the point around which the shape is rotated (the mass center of the shape by default). The User can specify any point as the Reference Point.
MakeGroups	forces the generation of new groups from existing ones
LinearVariation	forces the computation of rotation angles as linear variation of the given Angles along path steps

Returns

list of created groups (SMESH_GroupBase) and SMESH::Extrusion_Error if MakeGroups=True, only SMESH::Extrusion_Error otherwise

References Mesh.ExtrusionAlongPathObject(), and Mesh.ExtrusionAlongPathObjects().

def ExtrusionAlongPathObject	(		self,
			theObject,
			PathMesh,
			PathShape,
			NodeStart,
			HasAngles = False,
			Angles = [],
			HasRefPoint = False,
			RefPoint = [],
			MakeGroups = False,
			LinearVariation = False
	)

Generate new elements by extrusion of the elements which belong to the object The path of extrusion must be a meshed edge.

Parameters

theObject	the object whose elements should be processed. It can be a mesh, a sub-mesh or a group.
PathMesh	mesh containing a 1D sub-mesh on the edge, along which the extrusion proceeds
PathShape	shape(edge) defines the sub-mesh for the path
NodeStart	the first or the last node on the edge. Defines the direction of extrusion
HasAngles	allows the shape to be rotated around the path to get the resulting mesh in a helical fashion
Angles	list of angles
HasRefPoint	allows using the reference point
RefPoint	the point around which the shape is rotated (the mass center of the shape by default). The User can specify any point as the Reference Point.
MakeGroups	forces the generation of new groups from existing ones
LinearVariation	forces the computation of rotation angles as linear variation of the given Angles along path steps

Returns

list of created groups (SMESH_GroupBase) and SMESH::Extrusion_Error if MakeGroups=True, only SMESH::Extrusion_Error otherwise

References Mesh.ExtrusionAlongPathObject1D(), and Mesh.ExtrusionAlongPathObjects().

def ExtrusionAlongPathObject1D	(		self,
			theObject,
			PathMesh,
			PathShape,
			NodeStart,
			HasAngles = False,
			Angles = [],
			HasRefPoint = False,
			RefPoint = [],
			MakeGroups = False,
			LinearVariation = False
	)

Generate new elements by extrusion of mesh segments which belong to the object The path of extrusion must be a meshed edge.

Parameters

theObject	the object whose 1D elements should be processed. It can be a mesh, a sub-mesh or a group.
PathMesh	mesh containing a 1D sub-mesh on the edge, along which the extrusion proceeds
PathShape	shape(edge) defines the sub-mesh for the path
NodeStart	the first or the last node on the edge. Defines the direction of extrusion
HasAngles	allows the shape to be rotated around the path to get the resulting mesh in a helical fashion
Angles	list of angles
HasRefPoint	allows using the reference point
RefPoint	the point around which the shape is rotated (the mass center of the shape by default). The User can specify any point as the Reference Point.
MakeGroups	forces the generation of new groups from existing ones
LinearVariation	forces the computation of rotation angles as linear variation of the given Angles along path steps

Returns

list of created groups (SMESH_GroupBase) and SMESH::Extrusion_Error if MakeGroups=True, only SMESH::Extrusion_Error otherwise

References Mesh.ExtrusionAlongPathObject2D(), and Mesh.ExtrusionAlongPathObjects().

def ExtrusionAlongPathObject2D	(		self,
			theObject,
			PathMesh,
			PathShape,
			NodeStart,
			HasAngles = False,
			Angles = [],
			HasRefPoint = False,
			RefPoint = [],
			MakeGroups = False,
			LinearVariation = False
	)

Generate new elements by extrusion of faces which belong to the object The path of extrusion must be a meshed edge.

Parameters

theObject	the object whose 2D elements should be processed. It can be a mesh, a sub-mesh or a group.
PathMesh	mesh containing a 1D sub-mesh on the edge, along which the extrusion proceeds
PathShape	shape(edge) defines the sub-mesh for the path
NodeStart	the first or the last node on the edge. Defines the direction of extrusion
HasAngles	allows the shape to be rotated around the path to get the resulting mesh in a helical fashion
Angles	list of angles
HasRefPoint	allows using the reference point
RefPoint	the point around which the shape is rotated (the mass center of the shape by default). The User can specify any point as the Reference Point.
MakeGroups	forces the generation of new groups from existing ones
LinearVariation	forces the computation of rotation angles as linear variation of the given Angles along path steps

Returns

list of created groups (SMESH_GroupBase) and SMESH::Extrusion_Error if MakeGroups=True, only SMESH::Extrusion_Error otherwise

References Mesh.ExtrusionAlongPathObjects().