Premiers pas
@edubeam/fem est le solveur aux éléments finis sur lequel repose EduBeam : chaque diagramme, chaque réaction et chaque flèche affichés par l’application en proviennent. Il vous permet de calculer des poutres, des portiques et des treillis plans depuis votre propre code, dans le navigateur ou dans Node : générer des exercices avec leurs solutions, vérifier des devoirs, mener des études paramétriques ou placer un solveur derrière une page web.
La bibliothèque est écrite en TypeScript, fournit ses propres types et est un logiciel libre sous licence GPL-3.0. Créée par Bořek Patzák, elle est développée avec Jan Voříšek et d’autres contributeurs.
Installation
npm install @edubeam/fem
La bibliothèque fonctionne avec import comme avec require, dans le navigateur et dans Node 18 ou plus récent, et n’apporte qu’une dépendance, mathjs. Jusqu’à la version 0.3.0, elle s’installait depuis GitHub sous le nom ts-fem : si vous l’utilisiez ainsi, remplacez vos imports par @edubeam/fem. Rien d’autre n’a changé.
Pour essayer l’exemple ci-dessous dans un dossier vide, faites-en un projet qui utilise import, puis installez la bibliothèque :
npm init -y
npm pkg set type=module
npm install @edubeam/fem
Sans "type": "module" dans package.json, l’exemple fonctionne quand même, mais Node affiche d’abord un avertissement.
Votre première poutre
Une poutre en acier de 6 m, un IPE 200, sur une articulation et un appui simple, sous 12 kN/m :
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// Unités SI partout : m, N, Pa. De l'acier et un IPE 200.
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// Nœuds en [x, y, z], en mètres, avec les DDL bloqués par leur appui
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // articulation
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // appui simple
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 12 kN/m selon l'axe z local de la barre : vers le bas sur une poutre dessinée de gauche à droite
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // N·m à mi-portée
console.log(beam.computeShearForceAt(lc, 0)) // N en A
console.log(beam.computeLocalDefl(lc, 2).w[1]) // m à mi-portée
Enregistrez-le sous beam.ts et lancez node beam.ts : Node 22.18 et versions ultérieures exécutent le TypeScript tel quel. Le fichier ne contient aucune annotation de type ; avec un Node plus ancien, enregistrez-le donc plutôt sous beam.mjs. Il affiche :
54000
36000
0.04990940552616746
Ce sont les valeurs des manuels, kNm et kN. Voici la même poutre, calculée dans votre navigateur par le même solveur :
La flèche, 49,91 mm, dépasse de 0,28 mm celle d’Euler–Bernoulli, mm. Ce n’est pas une erreur : la barre est une poutre de Timoshenko, et ces 0,28 mm valent , la déformation d’effort tranchant de cette poutre. Donnez à k une valeur énorme, par exemple 1e32, et l’écart disparaît : voir Déformation d’effort tranchant.
Ce que fait le code
Créer un solveur
new LinearStaticSolver() crée un domain vide, qui contient le modèle, et un cas de charge, solver.loadCases[0].
Décrire le modèle
Les matériaux et les sections, les nœuds avec leurs appuis, puis les barres entre les nœuds. Chaque objet porte une étiquette, une chaîne ou un nombre, par laquelle le reste du modèle y fait référence. Voir Nœuds et appuis, Matériaux et sections et Barres et rotules.
Le charger
Les charges appartiennent à un cas de charge : forces aux nœuds, charges le long des barres, température et tassements. Voir Charges nodales et charges sur barre.
Le calculer
solver.solve() assemble et résout tous les cas de charge. Voir Résolution.
Lire les résultats
Efforts internes en tout point d’une barre, flèches, efforts d’extrémité, déplacements nodaux et réactions. Voir Lire les résultats et, pour les diagrammes, Dessiner les résultats.
Unités et signes en bref
Unités SI en entrée, unités SI en sortie. Le modèle se trouve dans le plan x–z, avec z dirigé vers le bas : un fz positif pousse vers le bas, et la tête d’un poteau de 4 m se trouve en . Les positions le long d’une barre se mesurent en mètres depuis son premier nœud. Un moment qui tend la fibre inférieure est positif. La page Unités et signes donne la liste complète.
Six pièges fréquents
- z est dirigé vers le bas. Les charges de pesanteur sont positives, et tout ce qui se trouve au-dessus des appuis a un z négatif. Voir Axes.
- Le sens d’une barre fixe le signe de M et de w. Définissez les poutres de gauche à droite et les poteaux de bas en haut : les signes se lisent alors comme dans un manuel. Voir Sens de la barre.
- Un paramètre manquant donne
NaNou un résultat absurde, pas une erreur. Une section a besoin dea,iyetk; un matériau a besoin dee, et degsauf sikest énorme. Voir Matériaux et sections. - Après avoir ajouté des nœuds ou des barres, ou modifié des appuis, mettez
solver.codeNumberGenerated = falseavant de relancer le calcul. Voir Recalculer après une modification. - Les réactions sont renvoyées sous forme de matrice mathjs ou de tableau, dans l’ordre où les DDL de l’appui ont été donnés. Voir Réactions.
- Un mécanisme ne lève pas toujours d’exception. Un déplacement de m signifie que la structure peut se déplacer librement. Voir Quand le calcul échoue.
Pour aller plus loin
Exemples complets
Des programmes complets et vérifiés : poutres, portiques, treillis, une feuille d’exercices avec son corrigé, un petit serveur HTTP.
Dessiner les résultats
Passez un modèle calculé à @edubeam/plot et obtenez ses diagrammes en SVG, dans Vue ou depuis un script Node.
Référence de l’API
Chaque classe, méthode et argument, avec les unités et ce qui est renvoyé.
La théorie
L’élément poutre, sa matrice de rigidité et sa matrice de passage, dans le manuel théorique d’EduBeam.