API-Referenz

Was @edubeam/fem 0.3 exportiert, gruppiert nach dem Zweck. Die Einheiten sind durchgehend SI: m, N, N·m, N/m, Pa, K und rad. Bezeichnungen (LabelType) sind string | number und werden als Strings gespeichert. Methoden, die hier nicht aufgeführt sind, sind intern: Sie sind in TypeScript nur deshalb öffentlich, weil die Klassen des Solvers sie untereinander aufrufen.

Exporte

ExportArtAbschnitt
LinearStaticSolverKlasseBerechnungen
Solverabstrakte KlasseBerechnungen
DomainKlasseDomain
NodeKlasseNode
Beam2D, ElementKlassenElemente
Material, CrossSectionKlassenMaterialien und Querschnitte
LoadCaseKlasseLasten
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadKlassenLasten
DofIDEnumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParametersTypen

Berechnungen

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
Eigenschaft/MethodeTypBeschreibung
domainDomainDas Modell
loadCasesLoadCase[]Enthält anfangs einen Lastfall, 'DefaultLC'. Weitere fügen Sie mit new LoadCase(label, solver.domain) hinzu: Lastfälle.
solve()voidNummeriert die Gleichungen, falls nötig, assembliert und löst alle Lastfälle. Kann bei einem Mechanismus einen Fehler werfen, tut es aber nicht immer. Ab 0.3.1 ohne Konsolenausgabe; 0.3.0 protokollierte die Rechenzeit.
codeNumberGeneratedbooleanAuf false setzen, nachdem Knoten oder Stäbe hinzugefügt oder entfernt oder Lager geändert wurden: warum
neq, pneqnumberAnzahl der freien und der gelagerten Freiheitsgrade, nach einer Berechnung
kmathjs-MatrixDie assemblierte globale Steifigkeitsmatrix, nach einer Berechnung
getNodeDofIDs(label)number[]Die Freiheitsgrade eines Knotens, nach einer Berechnung

EigenValueDynamicSolver existiert im Quellcode, wird aber nicht exportiert.

Domain

solver.domain hält das Modell in vier Maps, deren Schlüssel die Bezeichnung als String ist: nodes, elements, materials, crossSections. Methoden zum Entfernen gibt es nicht: domain.nodes.delete(label) und domain.elements.delete(label) entfernen einen Knoten oder einen Stab, danach muss neu nummeriert werden.

MethodeRückgabeBeschreibung
createNode(label, coords?, bcs?)Nodecoords [x, y, z] in m (Standard [0, 0, 0]), bcs die gelagerten DofIDs (Standard: keine)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (Standard [false, false])
createMaterial(label, params?)MaterialSiehe Materialien und Querschnitte
createCrossSection(label, params?)CrossSectionSiehe Materialien und Querschnitte
getNode(label), getElement(label), getMaterial(label), getCS(label)das ObjektWirft bei einer unbekannten Bezeichnung einen RangeError. getElement hat den Typ Element: Schreiben Sie as Beam2D, um Ergebnisse auszulesen.

Ein Objekt mit einer bereits vergebenen Bezeichnung ersetzt das alte.

Node

Eigenschaft/MethodeTypBeschreibung
labelstring
coordsnumber[][x, y, z], m. Ändern Sie den Wert, um den Knoten zu verschieben.
bcsSet<DofID>Gelagerte Freiheitsgrade. Ersetzen Sie das Set, um das Lager zu ändern.
lcsnumber[][] | undefinedDie gedrehten Achsen des Knotens, falls vorhanden
updateLcs({ locx, locy }?)voidDreht die Achsen des Knotens: locx seine x-Achse in globalen Komponenten, locy [0, 1, 0]. Ohne Argument werden sie zurückgesetzt.
hasLcs()booleanOb die Achsen gedreht sind
getUnknowns(lc, dofs)Matrix, oder number für einen FreiheitsgradVerschiebungen (m) und Verdrehungen (rad), in den Achsen des Knotens
getReactions(lc, global?){ dofs, values }Auflagerreaktionen an den gelagerten Freiheitsgraden, in der Reihenfolge von bcs: N, N·m. values ist eine mathjs-Matrix bei mehreren, ein Array mit einem Element bei einem, [] bei einem freien Knoten. Mit global true an einem gedrehten Knoten: alle drei Freiheitsgrade in globalen Achsen, dofs [0, 2, 4], values ein Array mit 0, wo nichts gehalten wird. Mehr zum Auslesen.

Elemente

Beam2D

Ein Timoshenko-Balken mit zwei Knoten in der x-z-Ebene, drei Freiheitsgrade pro Knoten (Dx, Dz, Ry). x ist in Metern ab dem ersten Knoten angegeben; n ist eine Anzahl von Abschnitten und ergibt n + 1 Punkte.

Eigenschaft/MethodeRückgabeBeschreibung
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Momentenfreigaben am ersten und zweiten Knoten
computeNormalForceAt(lc, x)numberN, Zug positiv
computeShearForceAt(lc, x)numberV, positiv, wo M entlang der lokalen x-Achse wächst
computeBendingMomentAt(lc, x)numberM, positiv bei Zug auf der Seite der lokalen +z-Achse
computeNormalForce(lc, n){ x, N }N an n + 1 Punkten
computeShearForce(lc, n){ x, V }V an n + 1 Punkten
computeBendingMoment(lc, n){ x, M }M an n + 1 Punkten
computeLocalDefl(lc, n){ u, w }Verschiebungen entlang und quer zum Stab, lokale Achsen, m
computeGlobalDefl(lc, n){ u, w }Dasselbe in globalem x und z
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], die Kräfte, die die Knoten auf den Stab ausüben, lokale Achsen
computeEndDisplacement(lc)MatrixStabendverschiebungen in lokalen Achsen, einschließlich der Gelenkverdrehungen
computeGeo(){ l, dx, dz }Länge und Projektionen, m
computeT()Matrix6 × 6 Transformationsmatrix, global nach lokal
computeLocalStiffnessMtrx(){ answer }answer: 6 × 6 lokale Steifigkeitsmatrix, Gelenke herauskondensiert
computeStiffness()Matrix6 × 6 globale Steifigkeitsmatrix
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

An einer Einzellast liefern die Methoden …At den Wert direkt dahinter. Element ist die abstrakte Basisklasse von Beam2D; diesen Typ verwenden domain.elements und getElement.

Materialien und Querschnitte

MaterialParametersEinheitStandardVerwendet für
ePa1Steifigkeit
gPa1Schubsteifigkeit
alpha1/K1Temperaturlasten
dkg/m³1nichts in der Statik
CrossSectionParametersEinheitStandardVerwendet für
am²keiner, erforderlichDehn- und Schubsteifigkeit
iym⁴keiner, erforderlichBiegesteifigkeit
k–keiner, erforderlichSchubsteifigkeit ; 1e32 für keine Schubverformung
hmkeinerTemperaturunterschiede (NaN ohne ihn)
iz, dyz, jm⁴keinervon Beam2D nicht verwendet

Ein fehlender Materialparameter ist 1, kein typischer Wert; ein fehlendes a, iy oder k macht jedes Ergebnis zu NaN. In keinem Fall wird ein Fehler geworfen. Beide Klassen haben eine Methode change(params), die die übergebenen Parameter setzt, und speichern die Parameter als gleichnamige Eigenschaften.

Lasten

LoadCase

MethodeRückgabeWerte
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (Standard false) true: in den gedrehten Achsen des Knotens
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m über den ganzen Stab
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m am ersten und zweiten Knoten, linear dazwischen
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, in a m Abstand vom ersten Knoten
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: Schwerpunkt, untere Faser, obere Faser
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } an gelagerten Freiheitsgraden, in den Achsen des Knotens; an freien Freiheitsgraden ignoriert

Bei Stablasten bedeutet lcs true lokale Achsen (x entlang des Stabs, z quer dazu), false globale Achsen. Streckenlasten gelten pro Meter Stablänge. Beispiele finden Sie unter Knoten- und Stablasten.

Eigenschaft/MethodeTypBeschreibung
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Stab- und Temperaturlasten
prescribedBCPrescribedDisplacement[]
solvedbooleantrue nach einer erfolgreichen Berechnung
getElementLoadsOnElement(el)BeamElementLoad[]Die Lasten auf einem Stab

Die Lastobjekte halten ihre Werte in öffentlichen Eigenschaften, die Sie vor einer erneuten Berechnung ändern können: values (und lcs) bei NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad und BeamTemperatureLoad; startValues und endValues bei BeamElementTrapezoidalEdgeLoad; prescribedValues bei PrescribedDisplacement. Jedes hat ein target, die Bezeichnung dessen, worauf es wirkt.

DofID

NameWertVon Beam2D verwendet
Dx0ja
Dy1nein
Dz2ja
Rx3nein
Ry4ja
Rz5nein

Ergebnisse

Ergebnisse werden an einem Beam2D (Schnittgrößen, Durchbiegungen, Stabendkräfte) und an einem Node (Verschiebungen, Auflagerreaktionen) ausgelesen, immer für einen bestimmten LoadCase und nach solve(): siehe die beiden Tabellen oben und Ergebnisse auslesen für Beispiele und Vorzeichen. Kurz gefasst:

GesuchtAufruf
Auflagerreaktionen, N und N·mnode.getReactions(lc)
Verschiebungen, m, und Verdrehungen, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V oder M an einer Stelle, N und N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V oder M entlang eines Stabsbeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Biegelinie, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Stabendkräfte, N und N·mbeam.computeEndForces(lc)
Eine Abbildung von allemStructurePlot oder structureSvg aus @edubeam/plot