Référence de l’API

Ce qu’exporte @edubeam/fem 0.3, regroupé par usage. Les unités sont partout celles du SI : m, N, N·m, N/m, Pa, K et rad. Les étiquettes (LabelType) sont de type string | number et stockées comme chaînes. Les méthodes absentes de cette page sont internes : elles ne sont publiques en TypeScript que parce que les classes du solveur les appellent entre elles.

Exports

ExportNatureSection
LinearStaticSolverclasseCalculs
Solverclasse abstraiteCalculs
DomainclasseDomain
NodeclasseNode
Beam2D, ElementclassesÉléments
Material, CrossSectionclassesMatériaux et sections
LoadCaseclasseCharges
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadclassesCharges
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterstypes

Calculs

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
Propriété ou méthodeTypeDescription
domainDomainLe modèle
loadCasesLoadCase[]Contient au départ un cas, 'DefaultLC'. Ajoutez-en d’autres avec new LoadCase(label, solver.domain) : Cas de charge.
solve()voidNumérote les équations si nécessaire, assemble et résout tous les cas de charge. Peut lever une exception sur un mécanisme, mais pas toujours. Silencieux depuis la 0.3.1 ; la 0.3.0 affichait sa durée.
codeNumberGeneratedbooleanÀ mettre à false après l’ajout ou la suppression de nœuds ou de barres, ou une modification des appuis : pourquoi
neq, pneqnumberNombres de DDL libres et de DDL bloqués, après un calcul
kMatrix mathjsLa matrice de rigidité globale assemblée, après un calcul
getNodeDofIDs(label)number[]Les DDL d’un nœud, après un calcul

EigenValueDynamicSolver existe dans le code source, mais n’est pas exporté.

Domain

solver.domain contient le modèle dans quatre Map dont les clés sont les étiquettes sous forme de chaînes : nodes, elements, materials, crossSections. Il n’y a pas de méthode de suppression : domain.nodes.delete(label) et domain.elements.delete(label) suppriment un nœud ou une barre, ce qui impose ensuite une renumérotation.

MéthodeRenvoieDescription
createNode(label, coords?, bcs?)Nodecoords [x, y, z] en m (par défaut [0, 0, 0]), bcs les DofID bloqués (par défaut aucun)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (par défaut [false, false])
createMaterial(label, params?)MaterialVoir Matériaux et sections
createCrossSection(label, params?)CrossSectionVoir Matériaux et sections
getNode(label), getElement(label), getMaterial(label), getCS(label)l’objetLève une RangeError pour une étiquette inconnue. getElement est typé Element : écrivez as Beam2D pour lire des résultats.

Créer un objet avec une étiquette déjà utilisée remplace l’ancien.

Node

Propriété ou méthodeTypeDescription
labelstring
coordsnumber[][x, y, z], m. Modifiez-le pour déplacer le nœud.
bcsSet<DofID>DDL bloqués. Remplacez-le pour changer l’appui.
lcsnumber[][] | undefinedLes axes tournés du nœud, s’il y en a
updateLcs({ locx, locy }?)voidTourne les axes du nœud : locx son axe x en composantes globales, locy [0, 1, 0]. Sans argument, remet les axes d’origine.
hasLcs()booleanIndique si les axes sont tournés
getUnknowns(lc, dofs)Matrix, ou un number pour un seul DDLDéplacements (m) et rotations (rad), dans les axes du nœud
getReactions(lc, global?){ dofs, values }Réactions sur les DDL bloqués, dans l’ordre de bcs : N, N·m. values est une Matrix mathjs s’il y en a plusieurs, un tableau à un élément s’il n’y en a qu’une, [] pour un nœud libre. Avec global à true sur un nœud tourné : les trois DDL en axes globaux, dofs [0, 2, 4], values un tableau avec 0 là où rien n’est bloqué. Comment les lire.

Éléments

Beam2D

Une poutre de Timoshenko à deux nœuds dans le plan x–z, avec trois DDL par nœud (Dx, Dz, Ry). x est en mètres depuis le premier nœud ; n est un nombre de segments, qui donne n + 1 points.

Propriété ou méthodeRenvoieDescription
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Libérations du moment au premier et au second nœud
computeNormalForceAt(lc, x)numberN, positif en traction
computeShearForceAt(lc, x)numberV, positif là où M croît le long de x local
computeBendingMomentAt(lc, x)numberM, positif quand le côté +z local est tendu
computeNormalForce(lc, n){ x, N }N en n + 1 points
computeShearForce(lc, n){ x, V }V en n + 1 points
computeBendingMoment(lc, n){ x, M }M en n + 1 points
computeLocalDefl(lc, n){ u, w }Déplacements le long de la barre et perpendiculairement à elle, axes locaux, m
computeGlobalDefl(lc, n){ u, w }Les mêmes en x et z globaux
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], les forces que les nœuds exercent sur la barre, axes locaux
computeEndDisplacement(lc)MatrixDéplacements d’extrémité en axes locaux, rotations des rotules comprises
computeGeo(){ l, dx, dz }Longueur et projections, m
computeT()MatrixMatrice de passage 6 × 6, des axes globaux aux axes locaux
computeLocalStiffnessMtrx(){ answer }answer : matrice de rigidité locale 6 × 6, rotules éliminées par condensation
computeStiffness()MatrixMatrice de rigidité globale 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

Au droit d’une charge ponctuelle, les méthodes …At renvoient la valeur juste après celle-ci. Element est la classe de base abstraite de Beam2D ; c’est le type qu’utilisent domain.elements et getElement.

Matériaux et sections

MaterialParametersUnitéPar défautSert à
ePa1la rigidité
gPa1la rigidité à l’effort tranchant
alpha1/K1les charges thermiques
dkg/m³1rien en statique
CrossSectionParametersUnitéPar défautSert à
am²aucune, obligatoireles rigidités axiale et à l’effort tranchant
iym⁴aucune, obligatoirela rigidité en flexion
k–aucune, obligatoirela rigidité à l’effort tranchant  ; 1e32 pour négliger la déformation d’effort tranchant
hmaucuneles différences de température (NaN sans ce paramètre)
iz, dyz, jm⁴aucuneinutilisés par Beam2D

Un paramètre de matériau manquant vaut 1, et non une valeur courante ; un a, un iy ou un k manquant donne NaN pour tous les résultats. Aucun des deux cas ne lève d’exception. Les deux classes ont une méthode change(params), qui fixe les paramètres donnés, et conservent ceux-ci comme propriétés de mêmes noms.

Charges

LoadCase

MéthodeRenvoieValeurs
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m } ; lcs (par défaut false) à true : dans les axes tournés du nœud
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m sur toute la barre
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m au premier et au second nœud, linéaire entre les deux
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, à a m du premier nœud
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK : centre de gravité, fibre inférieure, fibre supérieure
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } sur des DDL bloqués, dans les axes du nœud ; ignoré sur les DDL libres

Pour les charges sur barre, lcs à true signifie axes locaux (x le long de la barre, z perpendiculaire), false axes globaux. Les charges linéiques sont données par mètre de longueur de barre. La page Charges nodales et charges sur barre donne des exemples.

Propriété ou méthodeTypeDescription
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Charges sur barre et charges thermiques
prescribedBCPrescribedDisplacement[]
solvedbooleantrue après un calcul réussi
getElementLoadsOnElement(el)BeamElementLoad[]Les charges d’une barre

Les objets de charge conservent leurs valeurs dans des propriétés publiques, que vous pouvez modifier avant de relancer le calcul : values (et lcs) pour NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad et BeamTemperatureLoad ; startValues et endValues pour BeamElementTrapezoidalEdgeLoad ; prescribedValues pour PrescribedDisplacement. Chacun a une propriété target, l’étiquette de l’objet sur lequel il agit.

DofID

NomValeurUtilisé par Beam2D
Dx0oui
Dy1non
Dz2oui
Rx3non
Ry4oui
Rz5non

Résultats

Les résultats se lisent sur un Beam2D (efforts internes, flèches, efforts d’extrémité) et sur un Node (déplacements, réactions), toujours pour un LoadCase donné, après solve() : voir les deux tableaux ci-dessus, et Lire les résultats pour des exemples et les signes. En bref :

Pour obtenirAppel
Réactions, N et N·mnode.getReactions(lc)
Déplacements, m, et rotations, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V ou M en un point, N et N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V ou M le long d’une barrebeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Déformée, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Efforts d’extrémité, N et N·mbeam.computeEndForces(lc)
Une figure de l’ensembleStructurePlot ou structureSvg de @edubeam/plot