Your first model, step by step.

Install the pinned release

Use Python 3.10 or newer. Install QF Solver 0.2.11 from PyPI and pin the version for reproducibility. The matching source and wheel are also available from GitHub.

python -m pip install "qf-solver==0.2.11"
qf-solver --version

Download and inspect the input

The supplied tet4_static.json contains four nodes and one TET4 element. It uses isotropic steel (E = 210 GPa, ν = 0.3, density = 7,800 kg/m³), fixes all translations on three nodes, and applies 1,000 N along UX at node 1. It is a minimal API example, not a mesh-convergence benchmark.

Save the downloaded file as examples/tet4_static.json in your working directory, matching the commands below.

Inspect the versioned input ↗

Check the mesh, then solve

Run both commands from the working directory that contains the examples folder. Stop if the mesh report fails.

qf-solver check-mesh --input examples/tet4_static.json
qf-solver solve --input examples/tet4_static.json --output results/tet4.json

Or use the public Python API

The API route uses the same input and explicit mesh gate before solving.

from qf_solver import check_mesh, load_model, save_result, solve_model

model = load_model("examples/tet4_static.json")
report = check_mesh(model)
if report.status == "FAIL":
    raise RuntimeError(report.errors)

result = solve_model(model)
save_result(result, "results/tet4.json")

Read the diagnostics and scope

check_mesh returns PASS, WARNING or FAIL, with errors, warnings and details. Stop on FAIL. Investigate warnings, then inspect the reported residual and reaction balance. Retain the input, settings and result together. These commands run in your Python environment; this website does not run the FEM solve.

The Code_Aster fixture uses its own frozen load case. The one-element smoke example above is not that correlation run. Published maturity statuses remain tied to registry 0.2.8.