docs / capabilities / Finite element analysis

Finite element analysis

run_fea runs a linear-static structural study for a script-declared or inline material, support, and load. It returns stress, displacement, safety-factor evidence, per-region hot spots, mesh-trust information, equilibrium residuals, and optional heatmap images. fea_summary reads a stored result and reports solver availability and the material table without running a solve.

When CalculiX and Gmsh are installed, the external solver can produce a quadratic-tetrahedron result. Otherwise the automatic path uses an in-process voxel solver and marks its mesh as untrusted; that result is an estimate, not a verified pass. The tool does not provide a bare yes/no answer without the measurements and trust fields.

This is a linear-static model of the supplied loads and supports. It does not certify fatigue, impact, buckling, material defects, manufacturing quality, or physical acceptance. Inspect the solver and mesh trust fields before relying on a result.