meshing.elements — Return solver-mesh tetrahedron identifiers, connectivity, order, and regions.
elements = meshing.elements(mesh) returns a struct describing every volume element of a meshing.Mesh: identifiers, node connectivity, element order, and owning region.
Syntax
elements = meshing.elements(mesh)Inputs
mesh- Type
Any- Required
- Yes
- Default
- —
- Description
- meshing.Mesh from meshing.generate or meshing.load.
Returns
elements- Type
Any- Description
- Struct with ids, connectivity (uint64), order, and region_ids.
Errors
RunMat:meshing:InvalidInput- When
- A meshing object, path, option, artifact, or evidence contract is invalid, or meshing cannot produce a result that satisfies the request.
- Message
meshing operation failed
Behavior
ids is an E-by-1 uint64 column of element identifiers. connectivity is an E-by-4 (tet4) or E-by-10 (tet10) uint64 matrix of node identifiers from meshing.nodes, one row per element. order is "tet4" or "tet10". region_ids is an E-by-1 cell of text giving each element's physical region, matching the id field of meshing.regions.
Rows are aligned across all fields. Node identifiers are exact uint64 values; map them to rows of meshing.nodes rather than assuming they are 1:N. A mesh that mixes connectivity widths is rejected.
Use in a study
Use the connectivity to post-process element results, export the mesh, or count elements per region to confirm that every material region was meshed.
Errors
Every failure reports RunMat:meshing:InvalidInput, with a message that names the operation and the specific cause.
The input must be a meshing.Mesh.
Example
Read tetrahedron connectivity
part = geometry.load('box.brep', 'Units', 'm');
solverMesh = meshing.generate(part, 'TargetSize', 0.5, 'MaximumDeviation', 0.05, 'ElementOrder', 'tet4', 'Seed', 42);
elements = meshing.elements(solverMesh);
size(elements.connectivity)Using meshing.elements with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how meshing.elements changes the result.
Run a small meshing.elements example, explain the result, then change one input and compare the output.
FAQ
In what order are Tet10 nodes listed?⌄
The first four columns are the corner nodes; the remaining six are midside nodes. meshing.quality uses the first four columns as the element corners.
Related Meshing functions
meshing.boundaryFaces · meshing.evidence · meshing.generate · meshing.load · meshing.nodes · meshing.quality · meshing.regions · meshing.save
Related guides
Source you can read
Every RunMat function's source is public. Read exactly how meshing.elements is executed, line by line, in Rust.
- View the source for meshing.elements in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is a runtime that executes MATLAB-syntax code fast on any GPU. The runtime is free for individuals, including freelancers; students and faculty at an academic institution, for teaching or research there; contributors to an open-source project, for work on that project; organizations with 250 or fewer people and US$10M or less in annual revenue; and anyone, for non-production use. See runmat.com/license.
- RunMat automatically optimizes your math for GPU execution on Apple, Nvidia, and AMD hardware. No code changes needed. Simulations that took hours now take minutes.
- Start running code in seconds. RunMat runs in the browser, on the desktop, or from the CLI. No license server, no IT ticket.