Per iniziare
@edubeam/fem è il solutore agli elementi finiti su cui si basa EduBeam: tutti i diagrammi, le reazioni e le frecce che l’app mostra vengono da questa libreria. Con essa puoi risolvere travi, telai e travature reticolari piane dal tuo codice, nel browser o in Node: generare esercizi con le soluzioni, correggere gli esercizi per casa, svolgere studi parametrici o usarla come motore di calcolo di una pagina web.
È scritta in TypeScript, include le proprie definizioni dei tipi ed è software libero con licenza GPL-3.0. L’ha creata Bořek Patzák, e la sviluppa insieme a Jan Voříšek e ad altri collaboratori.
Installazione
npm install @edubeam/fem
Funziona sia con import sia con require, nel browser e in Node 18 o successivi, e porta con sé una sola dipendenza, mathjs. Fino alla versione 0.3.0 si installava da GitHub con il nome ts-fem: se la usavi così, cambia gli import in @edubeam/fem. Nient’altro è cambiato.
Per provare l’esempio qui sotto partendo da una cartella vuota, trasformala in un progetto che usa import, poi installa la libreria:
npm init -y
npm pkg set type=module
npm install @edubeam/fem
Senza "type": "module" in package.json l’esempio funziona lo stesso, ma prima Node stampa un avviso.
La tua prima trave
Una trave in acciaio di 6 m, un IPE 200, su una cerniera e un carrello, con un carico di 12 kN/m:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// Unità SI ovunque: m, N, Pa. Acciaio e un IPE 200.
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// Nodi in [x, y, z], in metri, con i GdL bloccati dal loro vincolo
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // cerniera
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // carrello
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 12 kN/m lungo la z locale dell'asta: verso il basso su una trave disegnata da sinistra a destra
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // N·m in mezzeria
console.log(beam.computeShearForceAt(lc, 0)) // N in A
console.log(beam.computeLocalDefl(lc, 2).w[1]) // m in mezzeria
Salvalo come beam.ts ed eseguilo con node beam.ts: Node 22.18 e successivi eseguono TypeScript così com’è. Il file non contiene annotazioni di tipo, quindi con un Node più vecchio salvalo invece come beam.mjs. Il programma stampa:
54000
36000
0.04990940552616746
Sono i valori del libro di testo, kNm e kN. Ecco la stessa trave, calcolata nel tuo browser dallo stesso solutore:
La freccia, 49,91 mm, supera di 0,28 mm quella di Eulero–Bernoulli, mm. Non è un errore: l’asta è una trave di Timoshenko, e 0,28 mm è , la deformazione a taglio di questa trave. Assegna a k un valore enorme, ad esempio 1e32, e la differenza scompare: vedi Deformazione a taglio.
Che cosa fa il codice
Crea un solutore
new LinearStaticSolver() nasce con un domain vuoto, che contiene il modello, e con un caso di carico, solver.loadCases[0].
Descrivi il modello
Materiali e sezioni, nodi con i loro vincoli, poi le aste tra i nodi. Ogni oggetto ha un’etichetta, una stringa o un numero, con cui il resto del modello vi fa riferimento. Vedi Nodi e vincoli, Materiali e sezioni e Aste e cerniere.
Applica i carichi
I carichi appartengono a un caso di carico: forze nei nodi, carichi lungo le aste, variazioni di temperatura e cedimenti. Vedi Carichi.
Risolvi
solver.solve() assembla e risolve tutti i casi di carico. Vedi Calcolo.
Leggi i risultati
Forze interne in qualsiasi punto di un’asta, frecce, forze di estremità, spostamenti nodali e reazioni. Vedi Lettura dei risultati e, per i diagrammi, Disegnare i risultati.
Unità e segni in breve
Unità SI in ingresso, unità SI in uscita. Il modello giace nel piano x–z con z rivolto verso il basso: un fz positivo spinge verso il basso e la testa di una colonna alta 4 m si trova a . Le posizioni lungo un’asta si misurano in metri dal suo primo nodo. Un momento che tende le fibre inferiori è positivo. La pagina Unità e segni riporta l’elenco completo.
Sei errori frequenti
- z è rivolto verso il basso. I carichi gravitazionali sono positivi, e tutto ciò che sta sopra i vincoli ha coordinata z negativa. Vedi Assi.
- Il verso di un’asta decide il segno di M e w. Definisci le travi da sinistra a destra e le colonne dal basso verso l’alto: i segni si leggono allora come sul libro di testo. Vedi Verso dell’asta.
- Un parametro mancante dà
NaNo valori assurdi, non un errore. Una sezione richiedea,iyek; un materiale richiedee, e anchega meno cheksia enorme. Vedi Materiali e sezioni. - Dopo aver aggiunto nodi o aste, o modificato i vincoli, imposta
solver.codeNumberGenerated = falseprima di risolvere di nuovo. Vedi Risolvere di nuovo dopo una modifica. - Le reazioni tornano come matrice mathjs o come array, nell’ordine in cui sono stati indicati i GdL del vincolo. Vedi Reazioni.
- Un meccanismo non sempre genera un errore. Uno spostamento di m significa che la struttura può muoversi liberamente. Vedi Quando il calcolo non riesce.
Per proseguire
Programmi di esempio
Programmi completi e verificati: travi, telai, travature reticolari, un foglio di esercizi con le soluzioni, un piccolo server HTTP.
Disegna i risultati
Passa un modello risolto a @edubeam/plot e ottieni i suoi diagrammi in SVG, in Vue o da uno script Node.
Riferimento API
Ogni classe, metodo e argomento, con le unità e ciò che restituisce.
La teoria
L’elemento trave, la sua matrice di rigidezza e la trasformazione, nel manuale teorico di EduBeam.