geometry.revolve — Sweep a face profile around an axis to make a solid of revolution.
feature = geometry.revolve(profile, axis, origin, angle) returns a geometry.Feature for the rotation of profile by angle radians about the line through origin along axis.
Syntax
feature = geometry.revolve(profile, axis, origin, angle)Inputs
profile- Type
Any- Required
- Yes
- Default
- —
- Description
- geometry.Feature whose result is a face or sheet.
axis- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Finite nonzero three-element rotation-axis direction.
origin- Type
NumericArray- Required
- Yes
- Default
- —
- Description
- Point on the rotation axis, in meters.
angle- Type
NumericScalar- Required
- Yes
- Default
- —
- Description
- Sweep angle in radians, in (0, 2*pi].
Returns
feature- Type
Any- Description
- geometry.Feature for the rotational sweep of profile.
Errors
RunMat:geometry:revolve:InvalidInput- When
- The wrong number of arguments is passed. profile is not a geometry.Feature, axis or origin is not a finite three-element real vector, or angle is not a real numeric scalar. A value violates the feature-graph contract.
- Message
geometry.revolve: invalid input
Behavior
axis is a nonzero three-element direction and origin is a point on the axis in meters. angle is in radians, must be positive, and may be at most 2*pi for a full revolution. Construction checks that the angle is positive; the 2*pi upper bound is checked when the graph is realized.
The profile must realize as a face or sheet; revolving a face produces a solid. A solid profile, such as a box, is accepted at construction but rejected at realization. The programmatic builder does not yet provide sketch or planar-face constructors.
The call records construction intent only. It appends one operation to an immutable, content-addressed feature graph and returns a new geometry.Feature; it does not run a CAD kernel, tessellate, or touch the filesystem. The graph is realized as exact B-rep topology when a .fea geometry declaration that imports the generating function is materialized for meshing or analysis.
All lengths are meters and all angles are radians; there is no unit option. Scalars accept double, single, or an exactly representable integer-class scalar. Vector arguments must be real, finite, non-integer-class numeric arrays with the stated element count; row and column orientation are both accepted.
Every failure, including the wrong number of arguments, a value of the wrong kind, and a value that violates the feature-graph contract (a nonpositive or non-finite length, radius, depth, distance, or angle, or an all-zero direction), raises the builtin's own RunMat:geometry:<name>:InvalidInput identifier, and no value is returned. Feature identities are derived from a digest of each operation, so repeating the same construction yields the same feature identity.
Use in a study
Return the finished part from a pure .m function: geometry.finish(feature) turns the final feature into a geometry.Generated product, and geometry.withRegion publishes typed selections under names. A .fea geometry declaration written as generated by function.<name> calls that function, realizes the exact geometry, and exposes each named selection as output.region.<name> for meshing, material assignment, constraints, and loads.
geometry.facesIntroducedBy(revolution) selects the swept faces, for example the outer surface of a turned part.
Errors
RunMat:geometry:revolve:InvalidInput reports every failure of the call: the wrong number of arguments, a profile that is not a geometry.Feature, an axis or origin that is not a finite three-element real vector, or an angle that cannot be converted, or a value that violates the feature-graph contract, such as a zero or negative dimension, a non-finite value, or an all-zero direction. A failed call returns nothing, and earlier values are unchanged because builder values are immutable.
Examples
Record a half revolution about the y axis
profile = geometry.box(10e-3, 1e-3, 20e-3);
turned = geometry.revolve(profile, [0 1 0], [-20e-3 0 0], pi);
class(turned)A negative angle is rejected
profile = geometry.box(10e-3, 1e-3, 20e-3);
turned = geometry.revolve(profile, [0 1 0], [0 0 0], -pi);Using geometry.revolve with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how geometry.revolve changes the result.
Run a small geometry.revolve example, explain the result, then change one input and compare the output.
FAQ
Is the angle in degrees?⌄
No. It is in radians; use deg2rad(90) or pi/2 for a quarter turn.
How do I enter millimeter dimensions?⌄
Convert to meters before the call, for example geometry.box(80e-3, 50e-3, 8e-3). When the function is called from a .fea declaration, length inputs already arrive in meters.
Related Geometry functions
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.solid · geometry.sphere · geometry.subtract · geometry.transform · geometry.union · geometry.withRegion
Related guides
Source you can read
Every RunMat function's source is public. Read exactly how geometry.revolve is executed, line by line, in Rust.
- View the source for geometry.revolve 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.