calculix-fem

name	calculix-fem
description	Workflow skill for driving the CalculiX MCP server over .inp decks — model inspection, in-place design-variable edits, ccx solve, .dat result reading, and result_mesh.json export for the viewer. Use when an agent must run an open-source linear-static FEM analysis on CalculiX, tune section/material/load parameters, or produce a viewer-renderable result.

CalculiX FEM

CalculiX (ccx) is an open-source FEM solver (GPLv2, no license). It reads Abaqus-style .inp decks and writes text .dat results plus .frd field output. ccx returns exit code 0 even on *ERROR, so never judge success by the exit code — the solver layer checks stdout for *ERROR and requires a data row in the .sta.

When to Use

Use this skill when an agent must run an open-source linear-static FEA analysis on CalculiX: parse/inspect a .inp deck, tune section/material/load parameters, solve with ccx, read .dat results, or export a viewer-renderable result. For commercial solvers (Abaqus/Ansys), use those solvers' own skills instead.

Workflow

1. fea_health — confirm meshio is available and ccx is detected.
2. parse_inp — inspect the .inp (nodes, elements, sections, materials, loads).
3. list_design_vars_tool — list tunable variables; each carries a var_id.
4. modify_card_tool — change a variable by var_id (pure-text, in place).
5. run_solver_tool — submit the deck to ccx.
6. read_results_tool — read max von Mises (self-computed), max |U|, volume, mass.
7. export_results_tool — write result_mesh.json for the viewer.

Rules

• Units follow the .inp working system (commonly mm-t-s-MPa). Report them.
• .dat has no von Mises column and no total volume/mass — these are derived.
• Never rewrite a deck with meshio.write (it drops cards and corrupts element types). Use modify_card_tool.
• For the deck to produce both text results and the field output the viewer needs, include *NODE PRINT/*EL PRINT (for .dat) and *NODE FILE/*EL FILE (for .frd).

Example

MCP/CalculiX/examples/cantilever.inp is a public cantilever benchmark (steel C3D8 solid bar, clamped end, transverse tip load). Hand-calc targets at P = 100 N: tip deflection ≈ 0.8 mm, root stress ≈ 140 MPa.