fea.runOptions — Create family-specific typed FEA run options.
fea.runOptions(solver, Name, Value, ...) creates a fea.RunOptions object whose schema is selected by the solver family.
Syntax
options = fea.runOptions(solver, Name, Value, ...)Inputs
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
solver | StringScalar | Yes | — | FEA solver family. |
Name, Value | Any | Variadic | — | Family-specific structural, tolerance, timing, precision, and quality options. |
Returns
| Name | Type | Description |
|---|---|---|
result | Any | FEA object or operation result. |
Errors
| Identifier | When | Message |
|---|---|---|
RunMat:fea:LoadFailed | A .fea document cannot be read, parsed, or resolved. | fea: failed to load FEA document |
RunMat:fea:InvalidInput | A builtin receives an unsupported argument pattern or object type. | fea: invalid input |
RunMat:fea:OperationFailed | A validation, planning, run, result-query, comparison, or trend operation fails. | fea: operation failed |
RunMat:fea:Internal | An FEA object or operation result cannot be converted to a RunMat value. | fea: internal error |
How fea.runOptions works
- Supported solver families are
linear_static,modal,acoustic,thermal,transient,cfd,cht,fsi,nonlinear, andelectromagnetic. - Count and iteration fields are nonnegative exact structural scalars at construction. All eight integer classes and ordinary integral doubles are accepted exactly; fractional, nonfinite, negative, out-of-range, nonscalar, and resident controls reject. Solver-specific positivity checks run before execution.
- Tolerance, time, scale, ratio, exponent, frequency, and residual fields are real physical scalars. Integer inputs cross once into binary64 after kind, field, and scalar-shape validation; solver-specific finiteness and range checks run before execution.
- Logical controls require logical scalars.
PrecisionMode,PreconditionerMode,QualityPolicy,PrepArtifactId, andPrepCalibrationProfileare text. PublicPrepContextinjection is rejected because prep context is internal runtime state. - Unknown or duplicate normalized options reject before object construction. Structural option properties remain exact typed integers; true floating options remain double.
Example
Configure an exact transient step count
opts = fea.runOptions("transient", "StepCount", uint32(20), "TimeStepS", 5e-4);Using fea.runOptions with coding agents
Open a RunMat example with live inputs, then ask the agent to explain how fea.runOptions changes the result.
Run a small fea.runOptions example, explain the result, then change one input and compare the output.
FAQ
Why is an integer accepted for a tolerance?⌄
It is accepted as a finite real scalar and converted once to the option's binary64 physics field; count fields instead remain exact integers.
Related Fea functions
fea.boundaryCondition · fea.compare · fea.domain · fea.field · fea.interface · fea.loadCase · fea.material · fea.materialAssignment · fea.model · fea.plan · fea.plot · fea.results · fea.run · fea.step · fea.study · fea.sweep · fea.trends · fea.validate
Open-source implementation
Unlike proprietary runtimes, every RunMat function is open-source. Read exactly how fea.runOptions is executed, line by line, in Rust.
- View the source for fea.runOptions in Rust on GitHub
- Learn how the RunMat runtime works
- Found a bug? Open an issue with a minimal reproduction.
About RunMat
RunMat is an open-source runtime that executes MATLAB-syntax code blazing on any GPU. It is licensed under the Apache 2.0 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.