geometry.listRegions — List regions retained by an imported geometry asset.
geometry.listRegions(asset) projects the imported regions into a scalar host struct with a regions field.
Syntax
regions = geometry.listRegions(asset)Inputs
asset- Type
Any- Required
- Yes
- Default
- —
- Description
- A host geometry.Asset returned by geometry.load.
Returns
regions- Type
Any- Description
- Scalar struct with a regions field.
Errors
RunMat:geometry:inspect:OperationFailed- When
- The geometry inspection operation fails.
- Message
geometry.inspect: operation failed
RunMat:geometry:inspect:Internal- When
- The inspection result cannot be converted to a RunMat value.
- Message
geometry.inspect: internal error
RunMat:geometry:listRegions:TooManyOutputs- When
- More than one output is requested.
- Message
geometry.listRegions: too many output arguments
Asset metadata
The receiver must be a typed geometry.Asset; arbitrary structs or resident numeric arrays are not accepted. The returned scalar struct contains the asset's imported region records. Its region collection shape and fields depend on file contents, not on the static receiver class alone.
The method form asset.listRegions() dispatches to the same canonical builtin. It reads the retained host asset payload but performs no filesystem read or numeric provider work. Invalid payload and conversion errors retain their underlying cause.
Example
List imported STL regions
asset = geometry.load('part.stl');
regions = geometry.listRegions(asset);
regions.regions.region_idExpected output:
ans = region_defaultUsing geometry.listRegions with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how geometry.listRegions changes the result.
Run a small geometry.listRegions example, explain the result, then change one input and compare the output.
FAQ
Does this reread the geometry file?⌄
No. It projects region records from the supplied geometry.Asset.
Related Geometry functions
Assets
geometry.inspect · geometry.load · geometry.meshes · geometry.region
Triangulation
DelaunayTri · DelaunayTri.freeBoundary · DelaunayTri.nearestNeighbor · DelaunayTri.pointLocation · freeBoundary · nearestNeighbor · pointLocation
Construction
geometry.box · geometry.chamfer · geometry.cylinder · geometry.edges · geometry.edgesIntroducedBy · geometry.extrude · geometry.faces · geometry.facesIntroducedBy · geometry.fillet · geometry.finish · geometry.hole · geometry.instance · geometry.intersect · geometry.pocket · geometry.revolve · geometry.solid · geometry.sphere · geometry.subtract · geometry.transform · geometry.union · geometry.withRegion
Source you can read
Every RunMat function's source is public. Read exactly how geometry.listRegions is executed, line by line, in Rust.
- View the source for geometry.listRegions 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.