Reference API

Přehled toho, co @edubeam/fem 0.3 exportuje, seřazený podle toho, k čemu to použijete. Všude se používají jednotky SI: m, N, N·m, N/m, Pa, K a rad. Označení (LabelType) jsou string | number a ukládají se jako řetězce. Metody, které tu nejsou uvedené, jsou interní: v TypeScriptu jsou veřejné jen proto, že je volají vlastní třídy řešiče.

Exporty

ExportDruhOddíl
LinearStaticSolvertřídaVýpočty
Solverabstraktní třídaVýpočty
DomaintřídaDomain
NodetřídaNode
Beam2D, ElementtřídyPrvky
Material, CrossSectiontřídyMateriály a průřezy
LoadCasetřídaZatížení
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadtřídyZatížení
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterstypy

Výpočty

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
ČlenTypPopis
domainDomainModel
loadCasesLoadCase[]Na začátku obsahuje jeden stav, 'DefaultLC'. Další přidáte pomocí new LoadCase(label, solver.domain): Zatěžovací stavy.
solve()voidV případě potřeby očísluje rovnice, sestaví a vyřeší všechny zatěžovací stavy. U mechanismu může vyhodit chybu, ale ne vždy. Od verze 0.3.1 nic nevypisuje; verze 0.3.0 vypisovala dobu výpočtu.
codeNumberGeneratedbooleanPo přidání nebo odebrání uzlů či prvků nebo po změně podpor ho nastavte na false: proč
neq, pneqnumberPočet volných a podepřených stupňů volnosti, po výpočtu
kmathjs MatrixSestavená globální matice tuhosti, po výpočtu
getNodeDofIDs(label)number[]Stupně volnosti uzlu, po výpočtu

EigenValueDynamicSolver ve zdrojovém kódu existuje, ale exportovaný není.

Domain

solver.domain uchovává model ve čtyřech objektech Map s klíčem, kterým je označení převedené na řetězec: nodes, elements, materials, crossSections. Metody pro odebrání nemá: uzel nebo prvek odeberete pomocí domain.nodes.delete(label) a domain.elements.delete(label) a poté znovu očíslujete.

MetodaVracíPopis
createNode(label, coords?, bcs?)Nodecoords [x, y, z] v m (výchozí [0, 0, 0]), bcs podepřené DofID (výchozí žádné)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (výchozí [false, false])
createMaterial(label, params?)MaterialViz Materiály a průřezy
createCrossSection(label, params?)CrossSectionViz Materiály a průřezy
getNode(label), getElement(label), getMaterial(label), getCS(label)objektPro neznámé označení vyhodí RangeError. getElement má typ Element: chcete-li číst výsledky, napište as Beam2D.

Vytvoření objektu s označením, které už je použité, nahradí původní objekt.

Node

ČlenTypPopis
labelstring
coordsnumber[][x, y, z], m. Jeho změnou uzel posunete.
bcsSet<DofID>Podepřené stupně volnosti. Jeho nahrazením změníte podporu.
lcsnumber[][] | undefinedPootočené osy uzlu, pokud nějaké má
updateLcs({ locx, locy }?)voidPootočí osy uzlu: locx je jeho osa x v globálních složkách, locy [0, 1, 0]. Bez argumentu osy vrátí do výchozí polohy.
hasLcs()booleanZda jsou osy pootočené
getUnknowns(lc, dofs)Matrix, nebo number pro jeden stupeň volnostiPosuny (m) a pootočení (rad) v osách uzlu
getReactions(lc, global?){ dofs, values }Reakce v podepřených stupních volnosti v pořadí bcs: N, N·m. values je pro více reakcí matice mathjs Matrix, pro jednu jednoprvkové pole, pro volný uzel []. S global true u pootočeného uzlu: všechny tři stupně volnosti v globálních osách, dofs [0, 2, 4], values pole s nulou tam, kde podpora nic nedrží. Jak je číst.

Prvky

Beam2D

Dvouuzlový Timošenkův nosníkový prvek v rovině x–z se třemi stupni volnosti v každém uzlu (Dx, Dz, Ry). x je vzdálenost v metrech od prvního uzlu; n je počet úseků, bodů je tedy n + 1.

ČlenVracíPopis
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Uvolnění momentu v prvním a druhém uzlu
computeNormalForceAt(lc, x)numberN, tah kladný
computeShearForceAt(lc, x)numberV, kladná tam, kde M roste ve směru lokální osy x
computeBendingMomentAt(lc, x)numberM, kladný při tahu na straně lokální +z
computeNormalForce(lc, n){ x, N }N v n + 1 bodech
computeShearForce(lc, n){ x, V }V v n + 1 bodech
computeBendingMoment(lc, n){ x, M }M v n + 1 bodech
computeLocalDefl(lc, n){ u, w }Posuny ve směru prvku a kolmo na něj, v lokálních osách, m
computeGlobalDefl(lc, n){ u, w }Totéž v globálních osách x a z
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], síly, kterými uzly působí na prvek, v lokálních osách
computeEndDisplacement(lc)MatrixKoncové posuny v lokálních osách, včetně pootočení v kloubech
computeGeo(){ l, dx, dz }Délka a průměty, m
computeT()MatrixTransformační matice 6 × 6 z globálních do lokálních os
computeLocalStiffnessMtrx(){ answer }answer: lokální matice tuhosti 6 × 6 s kondenzovanými klouby
computeStiffness()MatrixGlobální matice tuhosti 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

V místě osamělé síly vracejí metody …At hodnotu těsně za ní. Element je abstraktní základní třída Beam2D; tento typ používají domain.elements a getElement.

Materiály a průřezy

MaterialParametersJednotkaVýchozíK čemu slouží
ePa1tuhost
gPa1smyková tuhost
alpha1/K1změna teploty
dkg/m³1ve statice se nepoužívá
CrossSectionParametersJednotkaVýchozíK čemu slouží
am²není, povinnýosová a smyková tuhost
iym⁴není, povinnýohybová tuhost
k–není, povinnýsmyková tuhost ; 1e32 smykovou deformaci vypne
hmnenínerovnoměrné oteplení (bez něj NaN)
iz, dyz, jm⁴neníBeam2D je nepoužívá

Chybějící parametr materiálu má hodnotu 1, ne nějakou typickou hodnotu; chybějící a, iy nebo k způsobí, že všechny výsledky jsou NaN. Ani v jednom případě nevznikne chyba. Obě třídy mají metodu change(params), která nastaví zadané parametry, a uchovávají je ve vlastnostech se stejnými názvy.

Zatížení

LoadCase

MetodaVracíHodnoty
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (výchozí false) true: v pootočených osách uzlu
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m po celém prvku
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m v prvním a druhém uzlu, mezi nimi lineárně
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, ve vzdálenosti a m od prvního uzlu
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: těžiště, dolní vlákna, horní vlákna
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } v podepřených stupních volnosti, v osách uzlu; ve volných stupních volnosti se ignoruje

U prvkových zatížení znamená lcs true lokální osy (x ve směru prvku, z kolmo na něj) a false globální osy. Spojitá zatížení se vztahují na metr délky prvku. Příklady najdete na stránce Uzlová a prvková zatížení.

ČlenTypPopis
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Prvková a teplotní zatížení
prescribedBCPrescribedDisplacement[]
solvedbooleantrue po úspěšném výpočtu
getElementLoadsOnElement(el)BeamElementLoad[]Zatížení na jednom prvku

Objekty zatížení uchovávají své hodnoty ve veřejných vlastnostech, které můžete před dalším výpočtem změnit: values (a lcs) u NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad a BeamTemperatureLoad; startValues a endValues u BeamElementTrapezoidalEdgeLoad; prescribedValues u PrescribedDisplacement. Každý má target, označení objektu, na který působí.

DofID

NázevHodnotaPoužívá Beam2D
Dx0ano
Dy1ne
Dz2ano
Rx3ne
Ry4ano
Rz5ne

Výsledky

Výsledky se čtou z Beam2D (vnitřní síly, průhyby, koncové síly) a z Node (posuny, reakce), vždy pro zvolený LoadCase a po solve(): viz obě tabulky výše a stránku Čtení výsledků, kde jsou příklady a znaménka. Ve zkratce:

Co chcete získatVolání
Reakce, N a N·mnode.getReactions(lc)
Posuny, m, a pootočení, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V nebo M v bodě, N a N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V nebo M podél prvkubeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Deformovaný tvar, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Koncové síly, N a N·mbeam.computeEndForces(lc)
Obrázek toho všehoStructurePlot nebo structureSvg z @edubeam/plot