Duplication of nodes and elements (to emulate cracks)

Functions
def	DoubleElements
	Create duplicates of given elements, i.e. More...
def	DoubleNodes
	Create a hole in a mesh by doubling the nodes of some particular elements. More...
def	DoubleNode
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	DoubleNodeGroup
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	DoubleNodeGroups
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	DoubleNodeElem
	Create a hole in a mesh by doubling the nodes of some particular elements. More...
def	DoubleNodeElemInRegion
	Create a hole in a mesh by doubling the nodes of some particular elements. More...
def	DoubleNodeElemGroup
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	DoubleNodeElemGroupInRegion
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	DoubleNodeElemGroups
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	DoubleNodeElemGroupsInRegion
	Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above. More...
def	AffectedElemGroupsInRegion
	Identify the elements that will be affected by node duplication (actual duplication is not performed. More...
def	DoubleNodesOnGroupBoundaries
	Double nodes on shared faces between groups of volumes and create flat elements on demand. More...
def	CreateFlatElementsOnFacesGroups
	Double nodes on some external faces and create flat elements. More...

Detailed Description

Function Documentation

def DoubleElements	(		self,
			theElements,
			theGroupName = ""
	)

Create duplicates of given elements, i.e.

create new elements based on the same nodes as the given ones.

Parameters

theElements	- container of elements to duplicate. It can be a Mesh, sub-mesh, group, filter or a list of element IDs. If theElements is a Mesh, elements of highest dimension are duplicated
theGroupName	- a name of group to contain the generated elements. If a group with such a name already exists, the new elements are added to the existng group, else a new group is created. If theGroupName is empty, new elements are not added in any group.

Returns

a group where the new elements are added. None if theGroupName == "".

References Mesh.GetIDSource().

def DoubleNodes	(		self,
			theNodes,
			theModifiedElems
	)

Create a hole in a mesh by doubling the nodes of some particular elements.

Parameters

theNodes	identifiers of nodes to be doubled
theModifiedElems	identifiers of elements to be updated by the new (doubled) nodes. If list of element identifiers is empty then nodes are doubled but they not assigned to elements

Returns

TRUE if operation has been completed successfully, FALSE otherwise

def DoubleNode	(		self,
			theNodeId,
			theModifiedElems
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theNodeId	identifiers of node to be doubled
theModifiedElems	identifiers of elements to be updated

Returns

TRUE if operation has been completed successfully, FALSE otherwise

def DoubleNodeGroup	(		self,
			theNodes,
			theModifiedElems,
			theMakeGroup = False
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theNodes	group of nodes to be doubled
theModifiedElems	group of elements to be updated.
theMakeGroup	forces the generation of a group containing new nodes.

Returns

TRUE or a created group if operation has been completed successfully, FALSE or None otherwise

def DoubleNodeGroups	(		self,
			theNodes,
			theModifiedElems,
			theMakeGroup = False
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theNodes	list of groups of nodes to be doubled
theModifiedElems	list of groups of elements to be updated.
theMakeGroup	forces the generation of a group containing new nodes.

Returns

TRUE if operation has been completed successfully, FALSE otherwise

def DoubleNodeElem	(		self,
			theElems,
			theNodesNot,
			theAffectedElems
	)

Create a hole in a mesh by doubling the nodes of some particular elements.

Parameters

theElems	- the list of elements (edges or faces) to be replicated The nodes for duplication could be found from these elements
theNodesNot	- list of nodes to NOT replicate
theAffectedElems	- the list of elements (cells and edges) to which the replicated nodes should be associated to.

Returns

TRUE if operation has been completed successfully, FALSE otherwise

def DoubleNodeElemInRegion	(		self,
			theElems,
			theNodesNot,
			theShape
	)

Create a hole in a mesh by doubling the nodes of some particular elements.

Parameters

theElems	- the list of elements (edges or faces) to be replicated The nodes for duplication could be found from these elements
theNodesNot	- list of nodes to NOT replicate
theShape	- shape to detect affected elements (element which geometric center located on or inside shape). The replicated nodes should be associated to affected elements.

Returns

TRUE if operation has been completed successfully, FALSE otherwise

References Mesh.DoubleNodeElemGroup().

def DoubleNodeElemGroup	(		self,
			theElems,
			theNodesNot,
			theAffectedElems,
			theMakeGroup = False,
			theMakeNodeGroup = False
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theElems	- group of of elements (edges or faces) to be replicated
theNodesNot	- group of nodes not to replicated
theAffectedElems	- group of elements to which the replicated nodes should be associated to.
theMakeGroup	forces the generation of a group containing new elements.
theMakeNodeGroup	forces the generation of a group containing new nodes.

Returns

TRUE or created groups (one or two) if operation has been completed successfully, FALSE or None otherwise

def DoubleNodeElemGroupInRegion	(		self,
			theElems,
			theNodesNot,
			theShape
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theElems	- group of of elements (edges or faces) to be replicated
theNodesNot	- group of nodes not to replicated
theShape	- shape to detect affected elements (element which geometric center located on or inside shape). The replicated nodes should be associated to affected elements.

References Mesh.DoubleNodeElemGroups().

def DoubleNodeElemGroups	(		self,
			theElems,
			theNodesNot,
			theAffectedElems,
			theMakeGroup = False,
			theMakeNodeGroup = False
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theElems	- list of groups of elements (edges or faces) to be replicated
theNodesNot	- list of groups of nodes not to replicated
theAffectedElems	- group of elements to which the replicated nodes should be associated to.
theMakeGroup	forces the generation of a group containing new elements.
theMakeNodeGroup	forces the generation of a group containing new nodes.

Returns

TRUE or created groups (one or two) if operation has been completed successfully, FALSE or None otherwise

def DoubleNodeElemGroupsInRegion	(		self,
			theElems,
			theNodesNot,
			theShape
	)

Create a hole in a mesh by doubling the nodes of some particular elements This method provided for convenience works as DoubleNodes() described above.

Parameters

theElems	- list of groups of elements (edges or faces) to be replicated
theNodesNot	- list of groups of nodes not to replicated
theShape	- shape to detect affected elements (element which geometric center located on or inside shape). The replicated nodes should be associated to affected elements.

Returns

TRUE if operation has been completed successfully, FALSE otherwise

def AffectedElemGroupsInRegion	(		self,
			theElems,
			theNodesNot,
			theShape
	)

Identify the elements that will be affected by node duplication (actual duplication is not performed.

This method is the first step of DoubleNodeElemGroupsInRegion.

Parameters

theElems	- list of groups of elements (edges or faces) to be replicated
theNodesNot	- list of groups of nodes not to replicated
theShape	- shape to detect affected elements (element which geometric center located on or inside shape). The replicated nodes should be associated to affected elements.

Returns

groups of affected elements

def DoubleNodesOnGroupBoundaries	(		self,
			theDomains,
			createJointElems,
			onAllBoundaries = False
	)

Double nodes on shared faces between groups of volumes and create flat elements on demand.

The list of groups must describe a partition of the mesh volumes. The nodes of the internal faces at the boundaries of the groups are doubled. In option, the internal faces are replaced by flat elements. Triangles are transformed in prisms, and quadrangles in hexahedrons.

Parameters

theDomains	- list of groups of volumes
createJointElems	- if TRUE, create the elements
onAllBoundaries	- if TRUE, the nodes and elements are also created on the boundary between theDomains and the rest mesh

Returns

TRUE if operation has been completed successfully, FALSE otherwise

def CreateFlatElementsOnFacesGroups	(		self,
			theGroupsOfFaces
	)

Double nodes on some external faces and create flat elements.

Flat elements are mainly used by some types of mechanic calculations.

Each group of the list must be constituted of faces. Triangles are transformed in prisms, and quadrangles in hexahedrons.

Parameters

theGroupsOfFaces

- list of groups of faces

Returns

TRUE if operation has been completed successfully, FALSE otherwise