graphlow.core.MeshTopology.face_block

MeshTopology.face_block(face_type: CellType, boundary_only: bool = False) → FaceBlock | None

Return face block for specified face type.

Advanced API: returns a FaceBlock on the host and touches the face block cache. Use when you need face connectivity data.

Parameters:

face_typepv.CellType

VTK cell type ID to extract faces.

boundary_onlybool

If True, only return boundary faces. If False, return all faces including internal faces.

Returns:

FaceBlock | None

If the corresponding face does not exist, return None. If the face is a fixed-length face, return FixedFaceBlock. If the face is a variable-length face, return JaggedFaceBlock.