FAQ
Access and privacy
Section titled “Access and privacy”Do I need an account?
Section titled “Do I need an account?”Only to solve. Installing xfea, building, meshing, checking and showing models, and reading results you already have need no account. Solving needs the plugin for your solver, which you subscribe to on your account on app.xfea.ai, free during early access; your API key gives access to it. See What’s free, what needs an account.
Does my model leave my machine?
Section titled “Does my model leave my machine?”Its definition does, without its mesh: materials, sections, supports, loads, steps and the names of its sets go to xfea’s conversion service, which returns how to write the solver’s input. Node coordinates, element connectivity and results stay on your machine, where the solver runs. See One language for any solver.
Can I write a plugin?
Section titled “Can I write a plugin?”Meshing, results database, viewer and results reader plugins are open: see Plugins. A solver plugin (the conversion for a solver) is xfea’s own: to bring xfea to another solver, write to us through the contact form.
Solving
Section titled “Solving”Why can’t xfea reach the conversion service?
Section titled “Why can’t xfea reach the conversion service?”The solve stopped with “No conversion service at https://app.xfea.ai”: check your network, and
XFEA_CONVERT_URL if you set one to use another service. See
Installation › Solvers.
Why is my API key missing or refused?
Section titled “Why is my API key missing or refused?”“No API key for the conversion service”: set XFEA_API_KEY, or put the key in the file ~/.xfea/api_key.
“The conversion service refused the API key”: the key is unknown or was revoked; your account page on
app.xfea.ai issues a new one.
Why does xfea backends list nothing?
Section titled “Why does xfea backends list nothing?”That is normal. It lists solver plugins installed locally with a licence, which only firms with an on-premises agreement have. With none, solving goes through the conversion service: see What’s free, what needs an account.
Modelling
Section titled “Modelling”How do I make the mesh finer near a hole, or along an edge?
Section titled “How do I make the mesh finer near a hole, or along an edge?”Pick what you mean with a selection and refine there: MeshingSettings(max=10, refine=[Refine(Select.holes(), size=1.5)]), or Refine(Select.edges(near=(x, y, z)), size=2) for the edge nearest a point. Check what a selection
picks with xfea.meshing.describe(path, select=...). See Meshing.
Why are my results off by a factor of a thousand, or a million?
Section titled “Why are my results off by a factor of a thousand, or a million?”xfea does not check units, so a mixed set goes through unnoticed. The usual cause is mass or stiffness: in N and mm, density is in t/mm³ (steel 7.85e-9) and moduli in MPa (steel 210 000), while the material grade recipes are in Pa and kg/m³. See Units and conventions.
Why is the total load several times what I meant?
Section titled “Why is the total load several times what I meant?”step.add_uniform_forcefield puts the full value on every node it is given. For a total F over n nodes, give F / n,
or use a line or surface load. Compare the sum of the reactions with the load you meant to apply.
Why is my beam much too flexible, or too stiff?
Section titled “Why is my beam much too flexible, or too stiff?”Check its orientation: it is the beam’s local y axis, the axis the section’s Ixx is about. On a beam along x with
orientation=[0, 1, 0], the section’s h is vertical. Check also the number of elements: one beam element per
member is noticeably stiff. See Materials and sections.
Results
Section titled “Results”Where are the results?
Section titled “Where are the results?”In the folder given to analyse_and_extract(path=...): each problem has a folder of its own, with the solver’s
input, the results database <problem>-results.db, the run record run.json and the report report.html. The
model is saved as model.pkl in that folder, next to the problems’ folders. See
Results.
Can I read the results without solving again?
Section titled “Can I read the results without solving again?”Yes: Model.from_pickle("output/model.pkl"), then read the fields of its problems’ steps. See
Saving and loading.
Why doesn’t the viewer return?
Section titled “Why doesn’t the viewer return?”viewer.run() serves the page and waits until you press Ctrl+C. Keep it out of scripts that must finish on their
own; your AI assistant opens viewers with its own tools instead.
© 2026 Francesco Ranaudo · Text and pictures CC BY 4.0 · Code Elastic License 2.0 · how to reuse them