Skip to content

Results

Results are read the same way whatever solver produced them. A step asks for result fields before the solve; after it, each field answers questions: the value at a node, the extremes, every result in a frame. The rows sit in a results database on your machine, in xfea’s own form, so a script reading results doesn’t change when the solver does.

A solid arch under self-weight, coloured by von Mises stress: highest where the arch meets its footings

A solid arch under self-weight, coloured by von Mises stress: the peaks are where the arch meets its footings.

disp = DisplacementFieldResults() # x, y, z and rotations xx, yy, zz at the nodes
react = ReactionFieldResults() # forces and moments at the supported nodes
stress = StressFieldResults() # s11 ... s23 at the elements' integration points
step.add_field_outputs([disp, react, stress])
Field Where Components
DisplacementFieldResults nodes x, y, z, xx, yy, zz
ReactionFieldResults supported nodes forces x, y, z, moments xx, yy, zz
StressFieldResults elements s11 to s23, von Mises and principal stresses
TemperatureFieldResults nodes T
ContactForcesFieldResults contact pairs the total normal and tangential force on each
ContactStressFieldResults contact nodes pressure, opening, slip, shear

A field that wasn’t asked for isn’t there to read: ask for what answers the question.

tip = disp.get_result_at(tip_node).z # one node
sag = disp.get_min_result("z").z # the most negative z: downward deflection
peak = max(r.von_mises_stress for r in stress.results)
total = sum(r.z for r in react.results) # the reactions add up to the loads

Every read is at the end of the step unless a frame is asked: a nonlinear step keeps one frame per increment (disp.frames_in_step()). Modal and buckling steps give their frequencies and factors, and each mode’s shape.

  • Reactions are the first check. They must add up to the loads: if they don’t, a load or a support isn’t where you think.
  • A stress peak at a corner is a singularity, not a result: it grows as the mesh is refined. Refine twice and compare; read stresses a little away from corners, supports and point loads.
  • Von Mises for ductile metals, principal stresses for brittle ones.
problem.record_result("tip deflection", tip, "mm", note="L/250 = 8 mm")

The numbers that answer the question go into the solve’s run record and its one-page report, next to the convergence, the model’s make-up and the warnings: one page to open or send. See Checking a model.

The result as a picture, the deformed shape coloured by any field, comes from show_results (your AI assistant draws it), and the results in 3D from the viewer, in your browser. See Viewers, and open any example in 3D.

Results goes through reading them in detail; the API reference has every field and method. How results are stored is in Results schema and readers.

© 2026 Francesco Ranaudo · Text and pictures CC BY 4.0 · Code Elastic License 2.0 · how to reuse them