gives a list {r0,r1,…} of regions such that rd has dimension d for a mesh region mr.
DimensionalMeshComponents
gives a list {r0,r1,…} of regions such that rd has dimension d for a mesh region mr.
Details and Options
- DimensionalMeshComponents is also known as stratification.
- The length of the returned list is given by n+1 where n is RegionEmbeddingDimension[mr].
- When there is no component of dimension d, rd will be represented by EmptyRegion[n].
Examples
open all close allBasic Examples (2)
Separate parts of a mesh that have different dimensional elements:
mr = DiscretizeGraphics[Graphics[{Circle[{-1, 0}], Disk[{1, 0}]}]]ml = DimensionalMeshComponents[mr]The geometric dimensions of each component with cells are different:
Map[RegionDimension, ml]The embedding dimension is the same:
Map[RegionEmbeddingDimension, ml]Separate dimensional components in 3D:
mr = MeshRegion[{{0, 0, 0}, {1, 0, 0}, {2, 0, 0}, {3, 0, -1 / 2}, {3, 0, 1 / 2}, {4, -1 / 2, 0}, {4, 1 / 2, 0}}, {Point[1], Line[{2, 3}], Triangle[{3, 4, 5}], Tetrahedron[{4, 6, 5, 7}]}]ml = DimensionalMeshComponents[mr]The geometric dimensions of each component with cells are different:
Map[RegionDimension, ml]The embedding dimension is the same:
Map[RegionEmbeddingDimension, ml]Scope (3)
A MeshRegion in 1D can have components that are 0D or 1D:
mr = MeshRegion[{{0}, {1}, {2}}, {Point[{1}], Line[{2, 3}]}]ml = DimensionalMeshComponents[mr]The RegionDimension of each component:
RegionDimension /@ mlA MeshRegion in 2D can have components that are 0D, 1D, or 2D:
mr = MeshRegion[{{0, 0}, {1, 0}, {2, 0}, {3, -1 / 2}, {3, 1 / 2}}, {Point[{1}], Line[{2, 3}], Polygon[{3, 4, 5}]}]ml = DimensionalMeshComponents[mr]The RegionDimension of each component:
RegionDimension /@ mlA MeshRegion in 3D can have components that are 0D, 1D, 2D, or 3D:
mr = MeshRegion[{{0, 0, 0}, {1, 0, 0}, {2, 0, 0}, {3, 0, -1 / 2}, {3, 0, 1 / 2}, {4, -1 / 2, 0}, {4, 1 / 2, 0}}, {Point[1], Line[{2, 3}], Triangle[{3, 4, 5}], Tetrahedron[{4, 6, 5, 7}]}]ml = DimensionalMeshComponents[mr]The RegionDimension of each component:
RegionDimension /@ mlProperties & Relations (5)
Every element of DimensionalMeshComponents will be a MeshRegion or an EmptyRegion:
mr = MeshRegion[{{1, 0}, {2, 0}, {3, -1 / 2}, {3, 1 / 2}}, {Line[{1, 2}], Polygon[{2, 3, 4}]}]This mesh has components in dimensions 1 and 2 but not 0:
ml = DimensionalMeshComponents[mr]The 0D component is EmptyRegion, while the 1D and 2D components are MeshRegion:
MeshRegionQ /@ mlA BoundaryMeshRegion has only a full-dimensional component:
bmr = ConvexHullMesh[RandomReal[1, {10, 2}]]The lower-dimensional components are EmptyRegion:
DimensionalMeshComponents[bmr]The output of DelaunayMesh has only a full-dimensional component:
mr = DelaunayMesh[RandomReal[1, {10, 2}]]DimensionalMeshComponents[mr]The output of VoronoiMesh has only a full-dimensional component:
mr = VoronoiMesh[RandomReal[1, {10, 2}]]DimensionalMeshComponents[mr]The output of TriangulateMesh has only a full-dimensional component:
mr = MeshRegion[{{1, 0}, {2, 0}, {3, -1 / 2}, {3, 1 / 2}}, {Line[{1, 2}], Polygon[{2, 3, 4}]}]The lower-dimensional components are ignored when triangulating:
mr2 = TriangulateMesh[mr]
So only a full-dimensional component remains:
DimensionalMeshComponents[mr2]Related Guides
History
Text
Wolfram Research (2014), DimensionalMeshComponents, Wolfram Language function, https://reference.wolfram.com/language/ref/DimensionalMeshComponents.html.
CMS
Wolfram Language. 2014. "DimensionalMeshComponents." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/DimensionalMeshComponents.html.
APA
Wolfram Language. (2014). DimensionalMeshComponents. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DimensionalMeshComponents.html
BibTeX
@misc{reference.wolfram_2026_dimensionalmeshcomponents, author="Wolfram Research", title="{DimensionalMeshComponents}", year="2014", howpublished="\url{https://reference.wolfram.com/language/ref/DimensionalMeshComponents.html}", note=[Accessed: 12-June-2026]}
BibLaTeX
@online{reference.wolfram_2026_dimensionalmeshcomponents, organization={Wolfram Research}, title={DimensionalMeshComponents}, year={2014}, url={https://reference.wolfram.com/language/ref/DimensionalMeshComponents.html}, note=[Accessed: 12-June-2026]}