fers_calculations
The engine of FERS: structural finite-element analysis (3D frames, trusses, plates, Eurocode 3 checks) for engineers and AI agents. It takes a model as JSON and returns the solved document: displacements, reactions, member forces, buckling and modal results, and unity checks. It is compiled Rust and runs on your machine.
Most people want pip install FERS, the
Python SDK and fers command, which installs this engine and writes the model
JSON for you. Install this package alone to drive the engine with JSON you
produce some other way.
pip install fers_calculations # wheels for Windows, macOS and Linux (x86_64, aarch64)
Usage
import json
import fers_calculations
from fers_core import create_beam # pip install FERS: the SDK that writes the model
model = create_beam(5.0, "IPE180", udl=5000.0) # 5 m span, 5 kN/m; SI units: m, N
document = json.loads(fers_calculations.calculate_from_json(json.dumps(model.to_dict(include_results=False))))
case = document["results"]["loadcases"]["Load"]
assert case["solver_diagnostics"]["converged"] and not case["errors_and_warnings"]["errors"]
print(f"mid-span deflection {case['displacement_nodes']['5']['dy'] * 1000:.2f} mm")
print(f"reaction {case['reaction_nodes']['1']['nodal_forces']['fy'] / 1000:.2f} kN")
mid-span deflection -14.92 mm
reaction 12.50 kN
The document is the input plus results: loadcases and loadcombinations
by name, each with displacement_nodes, reaction_nodes and member_results
keyed by id, plus unity_check_results, solve_failures and
load_case_failures. Before using a number, check that its result set has no
errors_and_warnings.errors and that solver_diagnostics.converged is true:
a mechanism, for instance, is reported as a singular_model error. The engine
raises RuntimeError when it refuses a model outright.
calculate_to_file(json_data, path) writes the document to a file instead of
returning it, for results too large to hold as one string.
Premium licensing and timeouts
Without a key or token the engine runs at Free-tier limits (100 members) and makes no network call. Two ways unlock Premium limits:
solve_token=...: a short-lived token signed by FERS Cloud and checked offline, for a machine that cannot reach ferscloud.com. An expired or invalid token raisesRuntimeError.api_key=...: checked online with ferscloud.com once per solve.
Because a licence check is a network call, it is bounded. If ferscloud.com does
not answer within license_timeout seconds (default 30) the call raises
fers_calculations.FersTimeoutError before the solve starts, so retrying is
always safe:
import fers_calculations
try:
fers_calculations.calculate_to_file(
json_data, "results.json", api_key=KEY, license_timeout=60
)
except fers_calculations.FersTimeoutError:
... # transient — retry or skip this model
FersTimeoutError subclasses the built-in TimeoutError, so except TimeoutError
catches it too. A definitive failure — an invalid key, a non-premium account, an
unreachable host — raises RuntimeError instead, since retrying those is pointless.
license_timeout bounds the licence handshake only, not the solve. To put a
hard ceiling on a whole solve, run it in a killable subprocess.
Two environment variables are read (real process environment only — .env files
are loaded by the CLI binary, never by this extension module):
| Variable | Purpose | Default |
|---|---|---|
FERS_LICENSE_TIMEOUT |
Default license_timeout, in seconds |
30 |
FERS_CLOUD_URL |
Base URL of the licence API | https://ferscloud.com |
Licence
From 0.2.70 the engine is licensed under the PolyForm Strict License 1.0.0
(see LICENSE). It is free for any noncommercial purpose: study, teaching,
research, hobby projects, and use by schools, charities and public bodies.
Models of more than 100 members need Premium limits.
Commercial use, at any model size, needs a paid FERS Cloud plan, which includes the commercial licence. The licence does not allow modifying or redistributing the package.
1 maintainer
Metadata
1 maintainer
Release files for fers-calculations 0.2.73
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| fers_calculations-0.2.73-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| fers_calculations-0.2.73-cp39-abi3-musllinux_1_2_x86_64.whl | CPython 3.9 | abi3 | Linux musl 1.2+ x86-64 | Details |
| fers_calculations-0.2.73-cp39-abi3-musllinux_1_2_aarch64.whl | CPython 3.9 | abi3 | Linux musl 1.2+ ARM64 | Details |
| fers_calculations-0.2.73-cp39-abi3-manylinux_2_28_aarch64.whl | CPython 3.9 | abi3 | Linux glibc 2.28+ ARM64 | Details |
| fers_calculations-0.2.73-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.9 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| fers_calculations-0.2.73-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl | CPython 3.9 | abi3 | macOS 10.12+ x86-64, macOS 11.0+ ARM64, macOS 10.12+ universal2 (ARM64, x86-64) | Details |
Total release size: 21.4 MB
Release files / fers_calculations-0.2.73-cp39-abi3-win_amd64.whl
| Download URL | fers_calculations-0.2.73-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
33aae4a0f3f699ec3a1062ac14319f634933aa5a28bd406e056c2e6bbe533b2a
|
|
BLAKE2b-256 checksum How to use checksums |
bc94bf3369f2a99d159303a952b82b0f9e24474f79781b187492262bb6c5f8ad
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.73-cp39-abi3-musllinux_1_2_x86_64.whl
| Download URL | fers_calculations-0.2.73-cp39-abi3-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 3.4 MB |
| Tags | CPython 3.9 Linux musl 1.2+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
3b2b58daa29896a3f96f98f802592e1d9511e43b2bc741d96c4f9fde05d28930
|
|
BLAKE2b-256 checksum How to use checksums |
38d758fb33455d3b4724e37dd4f1d741af480eaecef3a6dcd2b01dd56c184f97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.73-cp39-abi3-musllinux_1_2_aarch64.whl
| Download URL | fers_calculations-0.2.73-cp39-abi3-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.9 Linux musl 1.2+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
9d324be839d0f1ccc98bc71eed9da3b4335f3c951a1837995b705097b8553a61
|
|
BLAKE2b-256 checksum How to use checksums |
71970a4a466f8ab9378baa3bee55e32fdab2548e93901f8c08b5ea9811186b99
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.73-cp39-abi3-manylinux_2_28_aarch64.whl
| Download URL | fers_calculations-0.2.73-cp39-abi3-manylinux_2_28_aarch64.whl |
|---|---|
| Size | 2.9 MB |
| Tags | CPython 3.9 Linux glibc 2.28+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
1be3adc48792c7a5215378a69435abe7efd46850722a56268d5cb9c3d7806b46
|
|
BLAKE2b-256 checksum How to use checksums |
37f1e1bc6ccb5f0f2f4edee32020d9486aee4f275b78251f995bfd004f8ef3f0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.73-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | fers_calculations-0.2.73-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 3.2 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
a736276b55bab6317179ff07546b27162eb6ac44753ec0fae464478b3407859f
|
|
BLAKE2b-256 checksum How to use checksums |
786a1dad7756bfc033146061d60ab64dbaac85c89af5603d052cc7f48ea7a9f9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.73-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
| Download URL | fers_calculations-0.2.73-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl |
|---|---|
| Size | 5.7 MB |
| Tags | CPython 3.9 abi3 macOS 10.12+ universal2 (ARM64, x86-64) macOS 10.12+ x86-64 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
aec08d6b17008366520752cc84d0ca2798a2b52409f76e8d19b8045a979be861
|
|
BLAKE2b-256 checksum How to use checksums |
51c76fa66a2df4dfba893fed95b98d5131f888e4628760476d613411f7b4c7cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Security for fers-calculations 0.2.73
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
