Source code for abaqus.Mesh.MeshFaceArray

from .MeshFace import MeshFace


class MeshFaceArray(list[MeshFace]):
    """The MeshFaceArray is a sequence of MeshFace objects.

    Notes
    -----
    This object can be accessed by:

    .. code-block:: python

        import part
        mdb.models[name].parts[name].elementFaces
        import assembly
        mdb.models[name].rootAssembly.allInstances[name].elementFaces
        mdb.models[name].rootAssembly.instances[name].elementFaces

    """

    def __init__(self, elemFaces: list[MeshFace]):
        """This method creates a MeshFaceArray object.

        Notes
        -----
        This function can be accessed by:

        .. code-block:: python

            mesh.MeshFaceArray
        
        Parameters
        ----------
        elemFaces
            A list of MeshFace objects. 

        Returns
        -------
            A MeshFaceArray object.
        """
        super().__init__()

    def getSequenceFromMask(self, mask: str):
        """This method returns the objects in the MeshFaceArray identified using the specified
        *mask*. When large number of objects are involved, this method is highly efficient.
        
        Parameters
        ----------
        mask
            A String specifying the object or objects. 

        Returns
        -------
            A MeshFaceArray object. 

        Raises
        ------
            - An exception occurs if the resulting sequence is empty. 
              Error: The mask results in an empty sequence 
        """
        pass

    def getMask(self):
        """This method returns a string specifying the object or objects.

        Returns
        -------
            A String specifying the object or objects.
        """
        pass