Het FERS Python-pakket installeren

1. Het pakket installeren

Het pakket staat op PyPI als FERS. Het bevat de Python-modelleerlaag en de gecompileerde solver-wheel, dus er valt verder niets te bouwen.

pip install FERS

Vereist Python 3.11 of nieuwer. Er worden wheels gepubliceerd voor Windows, macOS en Linux — voor installatie is geen Rust-toolchain nodig.

2. De installatie controleren

Importeer de kernobjecten en maak een leeg model. Loopt dit zonder fout door, dan is de gecompileerde solver correct geladen.

from fers_core import FERS, Node, Member, Section, Material, NodalSupport, NodalLoad

# Quick smoke-test
model = FERS()
print("FERS installed successfully")

3. Inloggen bij de cloud (optioneel)

Dit is alleen nodig voor de Pro-grenzen, om modellen in uw account op te slaan en voor de gehoste REST- en MCP-eindpunten. Er zijn twee manieren, afhankelijk van hoe u zich hebt aangemeld.

1. Optie A — account met e-mail en wachtwoord — Wissel uw inloggegevens via POST /api/sdk/token in voor een Bearer-token van één uur. Werkt alleen voor accounts die met e-mail en wachtwoord zijn aangemaakt.
2. Optie B — Google- of GitHub-account (voor iedereen aanbevolen) — Maak een permanente API-sleutel aan op uw profielpagina → API Keys. Geen wachtwoord nodig, werkt voor elke aanmeldmethode en is altijd in te trekken.

Optie A: kortlevend Bearer-token

Het token is een uur geldig. Haal na afloop een nieuw token in plaats van het op te slaan.

import requests

resp = requests.post("https://ferscloud.com/api/sdk/token", json={
    "email": "you@example.com",
    "password": "your_password",
})
token = resp.json()["token"]

Optie B: permanente API-sleutel

Een API-sleutel heeft de vorm <keyId>.<secret> en wordt maar één keer getoond, bij het aanmaken. Zet hem in een omgevingsvariabele en houd hem serverzijdig — nooit in browsercode of in een ingecheckt bestand.

import os
os.environ["FERS_API_KEY"] = "<keyId>.<secret>"

Cloudauthenticatie is alleen nodig voor de Pro-grenzen, om modellen op te slaan en voor de gehoste eindpunten. Lokaal rekenen met run_analysis() werkt zonder enige inloggegevens.

Wat u zonder te betalen krijgt

Het gratis abonnement is bedoeld voor niet-commercieel gebruik: het rekent modellen tot 100 staven, zonder account en zonder sleutel. Pro dekt commercieel gebruik, verhoogt de grens naar 10,000 staven en voegt cloudopslag van modellen toe.

Op geen enkel kanaal geldt een rekenquotum of een prijs per berekening: het pakket, de opdracht fers en de lokale MCP-server rekenen op uw machine, en de webwerkruimte rekent in uw browser. Pro kost € 19.95 per maand.

Volgende stappen

• Een model bouwen en rekenen — de kernobjecten en een eerste berekening.
• Uitgewerkte voorbeelden — uitkraging, ligger op twee steunpunten, raamwerk en een toetsing volgens EN 1993-1-1, elk met handberekening.
• Waarom een berekening scripten — de argumenten voor de Python-route.