Per iniziare

La libreria @edubeam/plot disegna in SVG una trave, un telaio o una travatura reticolare piana insieme ai suoi risultati: aste, vincoli, carichi, reazioni, diagrammi di N, V e M e deformata, con lo stesso aspetto delle figure di questo sito. Riceve un modello risolto con @edubeam/fem, il solutore di EduBeam, e pensa da sé all’impaginazione, alla scala e alla posizione di ogni valore.

I docenti la usano per esercizi e compiti generati a partire da un seme (valore iniziale del generatore casuale), per slide in cui la figura si costruisce un clic alla volta e per le figure delle dispense, in una pagina web o come file per LaTeX e Word. Con questa libreria sono fatti anche gli Esercizi di statica e il generatore di compiti di questo sito.

Installazione

Terminal
npm install @edubeam/plot @edubeam/fem vue

Vue 3.5 o successivo e il solutore sono peer dependencies, così la tua app ne tiene una sola copia ciascuno. Il pacchetto è solo ESM, include i propri tipi e non richiede alcun foglio di stile. Funziona con Node 20.19 o successivo; per eseguire direttamente uno script scritto in TypeScript, con node script.ts, serve Node 22.18 o successivo.

Disegnare un modello risolto

Bastano due file. Il primo, beams.ts, costruisce e risolve una trave con @edubeam/fem. È una semplice funzione, quindi lo stesso modello può alimentare una pagina, una slide e uno script:

beams.ts
import { DofID, LinearStaticSolver } from '@edubeam/fem'

/** Trave semplicemente appoggiata, lunga `span` m, con `q` kN/m: risolta. Il solutore lavora in unità SI. */
export const simpleBeam = (span: number, q: number): LinearStaticSolver => {
  const solver = new LinearStaticSolver()
  const { domain } = solver
  domain.createMaterial(1, { e: 210e9, g: 81e9 }) // acciaio, Pa
  domain.createCrossSection(1, { a: 28.5e-4, iy: 1943e-8, h: 0.2, k: 1e32 }) // IPE 200, senza deformazione a taglio
  domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // cerniera
  domain.createNode('B', [span, 0, 0], [DofID.Dz]) // carrello
  domain.createBeam2D(1, ['A', 'B'], 1, 1)
  solver.loadCases[0].createBeamElementUniformEdgeLoad(1, [0, q * 1e3], true) // N/m, +z verso il basso
  solver.solve()
  return solver
}

Il secondo, BeamFigure.vue, passa il solutore a StructurePlot e indica che cosa disegnare:

BeamFigure.vue
<script setup lang="ts">
import { StructurePlot } from '@edubeam/plot'
import { simpleBeam } from './beams'

const beam = simpleBeam(6, 12)
</script>

<template>
  <StructurePlot :solver="beam" :layers="['members', 'supports', 'loads', 'reactions', 'M']" />
</template>

Ecco tutta la figura: la trave sui suoi vincoli, il carico di 12 kN/m, le due reazioni da 36 kN e il momento flettente,  kNm in mezzeria, disegnato dal lato teso:

Ciò che disegna BeamFigure.vue: una campata di 6 m con 12 kN/m54q = 12 kN/m3636
Ciò che disegna BeamFigure.vue: una campata di 6 m con 12 kN/mApri in EduBeam

La figura occupa tutta la larghezza del contenitore e stabilisce da sé la propria altezza. Testi, simboli e spessori delle linee mantengono la loro dimensione in pixel qualunque sia la dimensione della struttura, così la figura resta leggibile anche su uno smartphone. Se ometti layers, è la figura a scegliere il risultato: M per travi e telai, N per una travatura reticolare. Tutti i livelli sono descritti con StructurePlot; come costruire i modelli è spiegato nella documentazione del solutore.

Quando il modello cambia

Una figura legge il solutore che le passi, ma non lo osserva. Quando qualcosa cambia, risolvi di nuovo e passa il nuovo solutore. È esattamente ciò che fa una computed:

LoadSlider.vue
<script setup lang="ts">
import { computed, ref } from 'vue'
import { StructurePlot } from '@edubeam/plot'
import { simpleBeam } from './beams'

const q = ref(12) // kN/m
const beam = computed(() => simpleBeam(6, q.value))
</script>

<template>
  <input v-model.number="q" type="range" min="1" max="30" />
  <StructurePlot :solver="beam" :layers="['members', 'supports', 'loads', 'reactions', 'M']" />
</template>

Una trave come questa si risolve in circa un millisecondo, quindi la figura segue il cursore mentre si sposta. Hai invece modificato un solutore esistente? Incrementa la prop revision e la figura lo rilegge.

Salvarla come file

Per una figura da inserire in LaTeX, Word o Inkscape, structureSvg scrive lo stesso disegno come file SVG autonomo, con colori fissi. Non servono né Vue né un browser, basta Node. Salva questo file come beam-svg.ts accanto a beams.ts:

beam-svg.ts
import { writeFileSync } from 'node:fs'
import { modelFromSolver, structureSvg } from '@edubeam/plot'
import { simpleBeam } from './beams.ts'

const svg = structureSvg(modelFromSolver(simpleBeam(6, 12)), {
  layers: ['members', 'supports', 'loads', 'reactions', 'M'],
})
writeFileSync('beam.svg', svg)

Eseguilo con node beam-svg.ts (Node 22.18 o successivo; con le versioni precedenti, npx tsx beam-svg.ts). Le opzioni, e come inserire il file in LaTeX e Word, sono descritte in Un file SVG autonomo.

La figura con i diagrammi in colonna

DiagramStack disegna la figura di ogni libro di statica: una trave rettilinea con i suoi carichi e, sotto, sullo stesso asse x, il taglio V(x), il momento flettente M(x) e la freccia w(x). Con v-model:load-at il lettore può trascinare un carico concentrato lungo la trave e vedere i diagrammi seguirlo:

Vue
<DiagramStack v-model:load-at="at" :solver="solveWithLoadAt(at)" />

L’esempio completo è nella pagina DiagramStack.

Usarla ovunque

Per registrare entrambi i componenti a livello globale, invece di importarli dove li usi:

main.ts
import { createApp } from 'vue'
import { EduBeamPlot } from '@edubeam/plot'
import App from './App.vue'

createApp(App).use(EduBeamPlot).mount('#app') // <StructurePlot> e <DiagramStack> in ogni template

Con gli import nominali il bundle resta più leggero: una pagina che importa solo StructurePlot non riceve né DiagramStack né il plugin. Entrambi i componenti vengono renderizzati anche lato server, in Nuxt o VitePress: vedi Integrazione.

Dove andare ora