geometry.inspect — Inspect file format and byte count without importing a geometry asset.
geometry.inspect(path) asynchronously reads bytes and reports the detected format and byte count in a host geometry.InspectResult object.
Syntax
info = geometry.inspect(path)Inputs
path- Type
StringScalar- Required
- Yes
- Default
- —
- Description
- Scalar path to the geometry file.
Returns
info- Type
Any- Description
- geometry.InspectResult with format and byte_count.
Errors
RunMat:geometry:inspect:InvalidPath- When
- The path is not scalar string text or a character row.
- Message
geometry.inspect: invalid path
RunMat:geometry:inspect:IoFailure- When
- The geometry file cannot be read.
- Message
geometry.inspect: failed to read geometry file
RunMat:geometry:inspect:OperationFailed- When
- The geometry inspection operation fails.
- Message
geometry.inspect: operation failed
File inspection
The path is scalar text. The operation reads the entire file, identifies its format from path and content, and returns format and byte_count; it does not build a mesh or load CAD topology. The byte count is a numeric metadata property, not an integer array input.
The asynchronous filesystem read may suspend and requires an available filesystem service. It does not use a numeric accelerator. Browser execution depends on a filesystem bridge; native registration is not proof of access to browser-local files.
Example
Inspect a triangle STL
info = geometry.inspect('part.stl');
info.formatExpected output:
ans = stlUsing geometry.inspect with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how geometry.inspect changes the result.
Run a small geometry.inspect example, explain the result, then change one input and compare the output.
FAQ
Does inspect import the geometry?⌄
No. It reads bytes to detect format and size; use geometry.load to build an asset.
Related Geometry functions
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.inspect is executed, line by line, in Rust.
- View the source for geometry.inspect 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.