Glossary
Each term is used in the docs exactly as defined here. Terms written in code are .fea keywords, spelled as the compiler spells them.
Studies and runs
Simulation and study. "Simulation" names the engineering task in page titles and the RunMat agent's replies. "Study" names the .fea construct: a study declaration that binds geometry, mesh, model and analysis steps, and the run that executes it.
Analysis step (procedure). One entry in a study's analysis sequence, such as static, modal, transient, harmonic, buckling, response_spectrum or random_response. Steps can run in order with after and pass state to one another. See the procedure reference.
Physics family. The equations a step solves: structural, thermal, electromagnetic, acoustic, fluid, and the coupled families thermomechanical, electrothermal, conjugate heat transfer and fluid–structure interaction. Which procedures each family runs is listed in the family and procedure matrix.
Case and sweep. A case is one combination of input values. A sweep is a declared set of cases, combined as a product or element by element (zip).
Run and result. A run is one execution of a study. Its result is published, content-addressed and reopenable with its provenance.
runmat check, runmat plan, runmat run. check reports every error in a .fea or .m source without solving. plan shows the resolved execution: mesh, procedures, resources and placement. run executes the study and publishes the result.
Model
Model. The model declaration: material assignments, constraints, loads, excitations, interfaces, connectors and initial conditions.
Region. A named selection of geometry: solids, faces, edges or vertices. Names come from the CAD file itself (select name for STEP and IGES labels, select tag for layers) or from canonical persistent ids. Inside the solver, every region is matched by its canonical id.
Canonical persistent id. The stable identity of a geometric entity, written persistent-entity:sha256:…. It survives re-import of the same CAD revision.
Constraint. A condition on the unknown field: a fixed or prescribed value (essential, or Dirichlet), a symmetry, a periodic pair or a linear equation between degrees of freedom.
Load and excitation. A load is a source term or boundary flux: force, pressure, heat flux, current. An excitation drives a load through time or frequency with a signal.
Signal. A typed function of time, frequency or a parameter, written inline, as a standard waveform, as a table or generated by a .m function.
Interface. A relation between two regions: bonded, contact, a thermal or fluid–structure coupling.
Discretization
Mesh. The finite-element subdivision of the geometry: tetrahedra for solids, triangles for shells, lines for beams.
Element order. Linear (first-order) or quadratic (second-order) shape functions. Tet4 is the 4-node linear tetrahedron and Tet10 the 10-node quadratic tetrahedron.
Degree of freedom (DOF). One scalar unknown in the assembled system, such as one displacement component at one node.
Shape function. The polynomial that interpolates a field from the values at an element's nodes.
Weak form. The integral statement of a boundary-value problem: find such that for all test functions . Each physics reference page states its family's weak form.
Stiffness, mass and damping matrices. , and , assembled from element contributions , and .
Results
Field. A published spatial result at a location: node, element, integration point, face, edge, interface, connector, constraint, reference point, mode or global. It is written analysis.<step>.field.<location>.<quantity>.
Output (observation). An authored reduction of a field to the quantity the study is asked to answer, such as mean, max, interpolate, integral or resultant.
Von Mises stress. The equivalent stress , with the deviatoric stress. It is compared with a yield or allowable stress.
Reaction. The force or moment a constraint exerts to hold its prescribed value. Reactions balance the applied loads.
Receipt. The record behind a number quoted in the docs: example id, result digest, CLI build, mesh and date, and the reference value it was compared with.
Dynamics
Natural frequency and mode shape. The eigenvalues and eigenvectors of .
Rayleigh damping. Damping proportional to mass and stiffness, .
Damping ratio. The fraction of critical damping applied to each mode.
Execution
CPU reference path. The CPU execution provider, reported as cpu_reference. A study that asks for a GPU runs here when the GPU path can't run it, and reports a fallback diagnostic. accelerators = required makes such a study fail instead.
Not yet in the current release. A marker on a feature the docs describe but the current release does not include yet. Each marker names an id listed on the release status page.