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

Terminal
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 :

Terminal
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 :

beam.ts
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 :

Sortie
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 poutre ci-dessus : 6 m, IPE 200, 12 kN/m54q = 12 kN/m3636AB
La poutre ci-dessus : 6 m, IPE 200, 12 kN/mOuvrir dans EduBeam

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

  1. 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.
  2. 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.
  3. Un paramètre manquant donne NaN ou un résultat absurde, pas une erreur. Une section a besoin de a, iy et k ; un matériau a besoin de e, et de g sauf si k est énorme. Voir Matériaux et sections.
  4. Après avoir ajouté des nœuds ou des barres, ou modifié des appuis, mettez solver.codeNumberGenerated = false avant de relancer le calcul. Voir Recalculer après une modification.
  5. 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.
  6. 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