31.8 MeshFace object

The MeshFace object refers to an element face. It has no constructor or members. A MeshFace object can be accessed via a MeshFaceArray or a repository on a part or part instance.

Access
import part
mdb.models[name].parts[name].elementFaces[i]
mdb.models[name].parts[name].elemFaces[i]
import assembly
mdb.models[name].rootAssembly.allinstances.elementFaces[i]
mdb.models[name].rootAssembly.allinstances.elemFaces[i]
mdb.models[name].rootAssembly.instances[name].elementFaces[i]
mdb.models[name].rootAssembly.instances[name].elemFaces[i]


31.8.1 getElemEdges()

This method returns a tuple of unique element edges on the element face.

Arguments

None.

Return value

A tuple of MeshEdge objects.

Exceptions

None.


31.8.2 getElements()

This method returns a tuple of elements that share the element face.

Arguments

None.

Return value

A tuple of MeshElement objects.

Exceptions

None.


31.8.3 getNodes()

This method returns a tuple of nodes on the element face.

Arguments

None.

Return value

A tuple of MeshNode objects.

Exceptions

None.


31.8.4 getNodesByFaceAngle(...)

This method returns an array of mesh node objects that are obtained by recursively finding adjacent element faces that are at an angle of less than or equal to the specified angle.

Required argument

angle

A float specifying the value of the face angle.

Optional arguments

None.

Return value

A MeshNodeArray object, which is a sequence of MeshNode objects.

Exceptions

None.


31.8.5 getNormal(...)

This method returns the normal direction for the element face.

Required arguments

None.

Optional arguments

None.

Return value

A tuple of 3 floats representing the unit normal vector. If the element face is collapsed such that a normal cannot be computed, a zero-length vector is returned.

Exceptions

None.


31.8.6 getElemFacesByFaceAngle(...)

This method returns an array of element face objects that are obtained by recursively finding adjacent element faces that are at an angle of less than or equal to the specified angle.

Required argument

angle

A float specifying the value of the face angle.

Optional arguments

None.

Return value

A MeshFaceArray object, which is a sequence of MeshFace objects.

Exceptions

None.


31.8.7 getElemEdgesByFaceAngle(...)

This method returns an array of element edge objects that are obtained by recursively finding adjacent element edges that are at an angle of less than or equal to the specified face angle.

Required argument

angle

A float specifying the value of the face angle in degrees.

Optional arguments

None.

Return value

A MeshEdgeArray object, which is a sequence of MeshEdge objects.

Exceptions

None.


31.8.8 getElementsByFaceAngle(...)

This method returns an array of mesh Element objects that are obtained by recursively finding adjacent element faces that are at an angle of less than or equal to the specified angle.

Required argument

angle

A float specifying the value of the face angle.

Optional arguments

None.

Return value

A MeshElementArray object, which is a sequence of MeshElement objects.

Exceptions

None.


31.8.9 getElemFacesByLimitingAngle(...)

This method returns an array of element edge objects that are obtained by recursively finding adjacent element faces that are at an angle of less than or equal to the specified face angle with the seed face.

Required argument

angle

A float specifying the value of the face angle in degrees.

Optional arguments

None.

Return value

A MeshFaceArray object, which is a sequence of MeshFace objects.

Exceptions

None.


31.8.10 getElementsViaTopology()

This method returns an array of mesh Element objects that are obtained by recursively finding adjacent elements via topology.

Arguments

None.

Return value

A MeshElementArray object, which is a sequence of MeshElement objects.

Exceptions

None.


31.8.11 getElemFacesByLayer()

This method returns an array of element face objects, obtained by traversing shell elements or the exterior of a solid mesh, and recursively finding adjacent element faces by layer.

Required argument

numLayers

A int specifying the value of the number of layers.

Optional arguments

None.

Return value

A MeshFaceArray object, which is a sequence of MeshFace objects.

Exceptions

None.


31.8.12  Members

The MeshFace object has the following members:

label

An Int specifying an Int specifying the element label.

face

An Int specifying a symbolic constant specifying the side of the element.