FERS_calculations
FERS_calculations is a high-performance library for Rust-backed calculations in mechanical engineering. It can process JSON input files to deliver fast and accurate results. While it can be run as a standalone tool, integration with FERS_core simplifies input creation and workflow management.
Features
- Standalone Functionality: Run directly by providing a valid JSON input file.
- Rust-Powered Performance: Designed for speed and reliability in computational tasks.
- Python Integration: Seamless integration with
FERS_corefor easy preprocessing and result handling. - Engineer-Friendly Design: Minimal coding effort required for complex structural engineering calculations.
Installation
pip install fers_calculations
This installs the pre-built Rust bindings -- no Rust toolchain required.
Usage
Standalone (Python)
You can call fers_calculations directly from Python without FERS_core:
import fers_calculations
# Load your JSON input
with open("001_cantilever_with_end_load.json") as f:
json_data = f.read()
# Run the analysis
results_json = fers_calculations.calculate_from_json(json_data)
# Save the results
with open("results.json", "w") as f:
f.write(results_json)
Premium licensing and timeouts
Passing api_key unlocks Premium model limits. That is the only thing that makes
the library contact the network — omit it and no request is ever sent.
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 |
With FERS_core (recommended)
For a more ergonomic workflow, install FERS_core which handles model creation, calling the Rust engine, and post-processing / visualisation:
pip install fers-core
from fers_core import FERS
model = FERS.from_json("001_cantilever_with_end_load.json")
model.calculate()
model.plot_results_3d()
See FERS_core on PyPI for full documentation.
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 a Pro solve token.
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.70
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| fers_calculations-0.2.70-cp39-abi3-win_amd64.whl | CPython 3.9 | abi3 | Windows x86-64 | Details |
| fers_calculations-0.2.70-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.70-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: 20.7 MB
Release files / fers_calculations-0.2.70-cp39-abi3-win_amd64.whl
| Download URL | fers_calculations-0.2.70-cp39-abi3-win_amd64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | CPython 3.9 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
ee6dc19158fe217f311538dd7dd75ed66d456e8f4e287ca18bedca3a50db4b46
|
|
BLAKE2b-256 checksum How to use checksums |
86c63d0d87e2915add1804939e92499e27827c8e234469cdbee138a82736522a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.70-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | fers_calculations-0.2.70-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 11.5 MB |
| Tags | CPython 3.9 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
cb4f4cd674ed73be66c247f2639e0782c1e6f93a65efc40aa58d614b8fcb3f91
|
|
BLAKE2b-256 checksum How to use checksums |
455ef8b1766850aaa6aa1fbab1e1ce477c912ff7a11bc8e120771aaedfd279e5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
Release files / fers_calculations-0.2.70-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
| Download URL | fers_calculations-0.2.70-cp39-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl |
|---|---|
| Size | 6.1 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 |
00a143d315205dd7df2226334657176e706b73e0dc74bc51ff9ae9059ba1cd3f
|
|
BLAKE2b-256 checksum How to use checksums |
27889d9089d44330d3fdb3c3489afc4b2e549a6eeb477793df9ddffbdf3817e3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
maturin/1.15.0
|
