Erste Schritte
@edubeam/fem ist der Finite-Elemente-Solver hinter EduBeam: Jeder Schnittgrößenverlauf, jede Auflagerreaktion und jede Durchbiegung, die die App anzeigt, stammt von ihm. Mit ihm berechnen Sie ebene Träger, Rahmen und Fachwerke aus Ihrem eigenen Code, im Browser oder in Node: Sie erzeugen Übungsaufgaben samt Lösungen, prüfen Hausaufgaben, führen Parameterstudien durch oder setzen einen Solver hinter eine Webseite.
Die Bibliothek ist in TypeScript geschrieben, bringt ihre eigenen Typen mit und ist freie Software unter der GPL-3.0. Geschrieben hat sie Bořek Patzák; er entwickelt sie gemeinsam mit Jan Voříšek und weiteren Mitwirkenden weiter.
Installation
npm install @edubeam/fem
Sie funktioniert mit import und require, im Browser und in Node 18 oder neuer, und hat genau eine Abhängigkeit, mathjs. Bis zur Version 0.3.0 wurde sie als ts-fem von GitHub installiert. Falls Sie sie so verwendet haben, ändern Sie Ihre Imports auf @edubeam/fem; sonst hat sich nichts geändert.
Um das Beispiel unten in einem leeren Ordner auszuprobieren, machen Sie daraus ein Projekt, das import verwendet, und installieren dann:
npm init -y
npm pkg set type=module
npm install @edubeam/fem
Ohne "type": "module" in der package.json läuft das Beispiel trotzdem, Node gibt aber zuerst eine Warnung aus.
Ihr erster Träger
Ein Stahlträger IPE 200 mit 6 m Spannweite auf einem Festlager und einem Loslager, belastet mit 12 kN/m:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// Durchgehend SI-Einheiten: m, N, Pa. Stahl und ein IPE 200.
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// Knoten bei [x, y, z] in Metern, mit den Freiheitsgraden, die ihr Lager hält
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // Festlager
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // Loslager
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 12 kN/m in Richtung der lokalen z-Achse des Stabs: nach unten, wenn der Träger von links nach rechts definiert ist
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // N·m in Feldmitte
console.log(beam.computeShearForceAt(lc, 0)) // N in A
console.log(beam.computeLocalDefl(lc, 2).w[1]) // m in Feldmitte
Speichern Sie es als beam.ts und starten Sie es mit node beam.ts: Node ab Version 22.18 führt TypeScript direkt aus. Die Datei enthält keine Typannotationen; mit einem älteren Node speichern Sie sie einfach als beam.mjs. Ausgegeben wird:
54000
36000
0.04990940552616746
Das sind die Werte aus dem Lehrbuch, kNm und kN. Hier ist derselbe Träger, berechnet von demselben Solver direkt in Ihrem Browser:
Die Durchbiegung von 49,91 mm liegt 0,28 mm über dem Euler-Bernoulli-Wert mm. Das ist kein Fehler: Der Stab ist ein Timoshenko-Balken, und 0,28 mm sind , die Schubverformung dieses Trägers. Setzen Sie k auf einen riesigen Wert wie 1e32, und der Unterschied verschwindet: siehe Schubverformung.
Was der Code macht
Solver erzeugen
new LinearStaticSolver() bringt eine leere domain mit, die das Modell aufnimmt, und einen Lastfall, solver.loadCases[0].
Modell beschreiben
Materialien und Querschnitte, Knoten mit ihren Lagern, dann die Stäbe zwischen den Knoten. Alles hat eine Bezeichnung, einen String oder eine Zahl, über die der Rest des Modells darauf verweist. Siehe Knoten und Lager, Materialien und Querschnitte und Stäbe und Gelenke.
Belasten
Lasten gehören zu einem Lastfall: Kräfte an Knoten, Lasten entlang von Stäben, Temperatur und Auflagersenkungen. Siehe Knoten- und Stablasten.
Berechnen
solver.solve() assembliert und löst alle Lastfälle. Siehe Berechnung.
Ergebnisse auslesen
Schnittgrößen an jeder Stelle eines Stabs, Durchbiegungen, Stabendkräfte, Knotenverschiebungen und Auflagerreaktionen. Siehe Ergebnisse auslesen und für Diagramme Ergebnisse zeichnen.
Einheiten und Vorzeichen in Kürze
SI-Einheiten hinein, SI-Einheiten heraus. Das Modell liegt in der x-z-Ebene, und z zeigt nach unten: Ein positives fz wirkt nach unten, und der Kopf einer 4 m hohen Stütze liegt bei . Positionen entlang eines Stabs werden in Metern ab seinem ersten Knoten gemessen. Ein Moment mit Zug unten ist positiv. Die vollständige Übersicht steht unter Einheiten und Vorzeichen.
Sechs typische Stolpersteine
- z zeigt nach unten. Lasten infolge Schwerkraft sind positiv, und alles oberhalb der Lager hat ein negatives z. Siehe Achsen.
- Die Richtung eines Stabs bestimmt das Vorzeichen von M und w. Definieren Sie Träger von links nach rechts und Stützen von unten nach oben, dann stimmen die Vorzeichen mit dem Lehrbuch überein. Siehe Stabrichtung.
- Ein fehlender Parameter ergibt
NaNoder Unsinn, aber keinen Fehler. Ein Querschnitt brauchta,iyundk; ein Material brauchteund außerdemg, sofernknicht riesig ist. Siehe Materialien und Querschnitte. - Nachdem Sie Knoten oder Stäbe hinzugefügt oder Lager geändert haben, setzen Sie vor der nächsten Berechnung
solver.codeNumberGenerated = false. Siehe Erneut berechnen nach einer Änderung. - Auflagerreaktionen kommen als mathjs-Matrix oder als Array zurück, in der Reihenfolge, in der die Freiheitsgrade des Lagers angegeben wurden. Siehe Auflagerreaktionen.
- Ein Mechanismus führt nicht immer zu einem Fehler. Eine Verschiebung von m bedeutet, dass sich das Tragwerk frei bewegen kann. Siehe Wenn die Berechnung scheitert.
Wie es weitergeht
Beispielprogramme
Vollständige, geprüfte Programme: Träger, Rahmen, Fachwerke, ein Übungsblatt mit Lösungsblatt und ein kleiner HTTP-Server.
Ergebnisse zeichnen
Übergeben Sie ein berechnetes Modell an @edubeam/plot und erhalten Sie seine Diagramme als SVG, in Vue oder aus einem Node-Skript.
API-Referenz
Alle Klassen, Methoden und Argumente, mit Einheiten und dem, was sie zurückgeben.
Die Theorie
Das Balkenelement, seine Steifigkeitsmatrix und Transformation im Theoriehandbuch von EduBeam.