Riferimento API

Ciò che @edubeam/fem 0.3 esporta, raggruppato per uso. Le unità sono SI ovunque: m, N, N·m, N/m, Pa, K e rad. Le etichette (LabelType) sono string | number, memorizzate come stringhe. I metodi non elencati qui sono interni: sono pubblici in TypeScript solo perché le classi del solutore li chiamano.

Export

ExportTipoDove
LinearStaticSolverclasseAnalisi
Solverclasse astrattaAnalisi
DomainclasseDomain
NodeclasseNode
Beam2D, ElementclassiElementi
Material, CrossSectionclassiMateriali e sezioni
LoadCaseclasseCarichi
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadclassiCarichi
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterstipi

Analisi

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
NomeTipoDescrizione
domainDomainIl modello
loadCasesLoadCase[]Parte con un caso, 'DefaultLC'. Aggiungine altri con new LoadCase(label, solver.domain): Casi di carico.
solve()voidNumera le equazioni se serve, assembla e risolve ogni caso di carico. Può lanciare un errore in presenza di un meccanismo, ma non sempre lo fa. Silenzioso dalla 0.3.1; la 0.3.0 stampava il tempo impiegato.
codeNumberGeneratedbooleanImpostalo a false dopo aver aggiunto o rimosso nodi o aste, o modificato i vincoli: perché
neq, pneqnumberNumero di GdL liberi e di GdL vincolati, dopo il calcolo
kmathjs MatrixLa matrice di rigidezza globale assemblata, dopo il calcolo
getNodeDofIDs(label)number[]I GdL di un nodo, dopo il calcolo

EigenValueDynamicSolver esiste nel sorgente, ma non è esportato.

Domain

solver.domain contiene il modello in quattro Map che hanno come chiave l’etichetta in forma di stringa: nodes, elements, materials, crossSections. Non esistono metodi di rimozione: domain.nodes.delete(label) e domain.elements.delete(label) rimuovono un nodo o un’asta, e poi serve la rinumerazione.

MetodoRestituisceDescrizione
createNode(label, coords?, bcs?)Nodecoords [x, y, z] in m (predefinito [0, 0, 0]), bcs i DofID vincolati (predefinito nessuno)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (predefinito [false, false])
createMaterial(label, params?)MaterialVedi Materiali e sezioni
createCrossSection(label, params?)CrossSectionVedi Materiali e sezioni
getNode(label), getElement(label), getMaterial(label), getCS(label)l’oggettoLancia un RangeError per un’etichetta sconosciuta. getElement ha il tipo Element: scrivi as Beam2D per leggerne i risultati.

Creare un oggetto con un’etichetta già in uso sostituisce quello precedente.

Node

NomeTipoDescrizione
labelstring
coordsnumber[][x, y, z], m. Cambialo per spostare il nodo.
bcsSet<DofID>GdL vincolati. Sostituiscilo per cambiare il vincolo.
lcsnumber[][] | undefinedGli assi ruotati del nodo, se presenti
updateLcs({ locx, locy }?)voidRuota gli assi del nodo: locx è il suo asse x in componenti globali, locy è [0, 1, 0]. Senza argomenti li ripristina.
hasLcs()booleanSe gli assi sono ruotati
getUnknowns(lc, dofs)Matrix, o un number per un solo GdLSpostamenti (m) e rotazioni (rad), negli assi del nodo
getReactions(lc, global?){ dofs, values }Reazioni nei GdL vincolati, nell’ordine di bcs: N, N·m. values è una Matrix di mathjs se le reazioni sono più di una, un array di un elemento se è una sola, [] per un nodo libero. Con global true su un nodo ruotato: tutti e tre i GdL negli assi globali, dofs [0, 2, 4], values un array con 0 dove nulla è bloccato. Come leggerle.

Elementi

Beam2D

Una trave di Timoshenko a due nodi nel piano x–z, con tre GdL per nodo (Dx, Dz, Ry). x è in metri dal primo nodo; n è un numero di segmenti, che dà n + 1 punti.

NomeRestituisceDescrizione
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Svincoli del momento al primo e al secondo nodo
computeNormalForceAt(lc, x)numberN, positivo se di trazione
computeShearForceAt(lc, x)numberV, positivo dove M cresce lungo la x locale
computeBendingMomentAt(lc, x)numberM, positivo con trazione sul lato +z locale
computeNormalForce(lc, n){ x, N }N in n + 1 punti
computeShearForce(lc, n){ x, V }V in n + 1 punti
computeBendingMoment(lc, n){ x, M }M in n + 1 punti
computeLocalDefl(lc, n){ u, w }Spostamenti lungo l’asta e trasversali, negli assi locali, m
computeGlobalDefl(lc, n){ u, w }Gli stessi in x e z globali
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], le forze che i nodi esercitano sull’asta, negli assi locali
computeEndDisplacement(lc)MatrixSpostamenti di estremità negli assi locali, comprese le rotazioni delle cerniere
computeGeo(){ l, dx, dz }Lunghezza e proiezioni, m
computeT()MatrixTrasformazione 6 × 6, da globale a locale
computeLocalStiffnessMtrx(){ answer }answer: rigidezza locale 6 × 6, con le cerniere condensate
computeStiffness()MatrixRigidezza globale 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

In corrispondenza di un carico concentrato, i metodi …At restituiscono il valore subito dopo il carico. Element è la classe base astratta di Beam2D; è il tipo usato da domain.elements e da getElement.

Materiali e sezioni

MaterialParametersUnitàPredefinitoServe per
ePa1rigidezza
gPa1rigidezza a taglio
alpha1/K1carichi termici
dkg/m³1niente, in statica
CrossSectionParametersUnitàPredefinitoServe per
am²nessuno, obbligatoriorigidezza assiale e a taglio
iym⁴nessuno, obbligatoriorigidezza flessionale
k–nessuno, obbligatoriorigidezza a taglio ; 1e32 per escluderla
hmnessunogradienti termici (NaN senza)
iz, dyz, jm⁴nessunonon usati da Beam2D

Un parametro del materiale mancante vale 1, non un valore tipico; un a, iy o k mancante rende NaN ogni risultato. In nessuno dei due casi compare un errore. Entrambe le classi hanno un metodo change(params) che imposta i parametri forniti, e li conservano come proprietà con gli stessi nomi.

Carichi

LoadCase

MetodoRestituisceValori
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (predefinito false) true: negli assi ruotati del nodo
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m su tutta l’asta
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m al primo e al secondo nodo, lineare tra i due
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, a a m dal primo nodo
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: baricentro, fibra inferiore, fibra superiore
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } sui GdL vincolati, negli assi del nodo; ignorato sui GdL liberi

Per i carichi sulle aste, lcs true significa assi locali (x lungo l’asta, z trasversale), false assi globali. I carichi distribuiti sono per metro di lunghezza dell’asta. La pagina Carichi contiene degli esempi.

NomeTipoDescrizione
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Carichi sulle aste e carichi termici
prescribedBCPrescribedDisplacement[]
solvedbooleantrue dopo un calcolo riuscito
getElementLoadsOnElement(el)BeamElementLoad[]I carichi su un’asta

Gli oggetti carico conservano i valori in proprietà pubbliche, che puoi modificare prima di risolvere di nuovo: values (e lcs) su NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad e BeamTemperatureLoad; startValues ed endValues su BeamElementTrapezoidalEdgeLoad; prescribedValues su PrescribedDisplacement. Ognuno ha un target, l’etichetta dell’oggetto su cui agisce.

DofID

NomeValoreUsato da Beam2D
Dx0sì
Dy1no
Dz2sì
Rx3no
Ry4sì
Rz5no

Risultati

I risultati si leggono da un Beam2D (forze interne, frecce, forze di estremità) e da un Node (spostamenti, reazioni), sempre per un dato LoadCase, dopo solve(): vedi le due tabelle qui sopra e, per esempi e segni, Lettura dei risultati. In breve:

Per ottenereChiamata
Reazioni, N e N·mnode.getReactions(lc)
Spostamenti, m, e rotazioni, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V o M in un punto, N e N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V o M lungo un’astabeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Deformata, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Forze di estremità, N e N·mbeam.computeEndForces(lc)
Una figura di tutto questoStructurePlot o structureSvg di @edubeam/plot