Primeiros passos

A biblioteca de desenho @edubeam/plot desenha em SVG uma viga, um pórtico ou uma treliça plana com os seus resultados: barras, apoios, cargas, reações, os diagramas de N, V e M e a deformada, com a mesma aparência das figuras deste site. Você entrega um modelo resolvido com o @edubeam/fem, o solver por trás do EduBeam, e a biblioteca decide a composição, a escala e onde fica cada número.

Os professores a usam para exercícios e provas gerados a partir de uma semente (o valor inicial do gerador aleatório), para slides em que a figura se completa a cada clique e para as figuras das notas de aula, numa página web ou como arquivos para LaTeX e Word. A página Exercícios de estática e o gerador de provas deste site foram feitos com ela.

Instalação

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

O Vue 3.5 ou posterior e o solver são peer dependencies, de modo que o seu app mantém uma única cópia de cada um. O pacote é somente ESM, traz os próprios tipos e não precisa de folha de estilos. Ele roda no Node 20.19 ou posterior; para executar um script escrito em TypeScript diretamente, com node script.ts, você precisa do Node 22.18 ou posterior.

Desenhar um modelo resolvido

Bastam dois arquivos. O primeiro, beams.ts, monta e resolve uma viga com o @edubeam/fem. É uma função comum, então o mesmo modelo pode alimentar uma página, um slide e um script:

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

/** Uma viga biapoiada de `span` m sob `q` kN/m, já resolvida. O solver trabalha em unidades SI. */
export const simpleBeam = (span: number, q: number): LinearStaticSolver => {
  const solver = new LinearStaticSolver()
  const { domain } = solver
  domain.createMaterial(1, { e: 210e9, g: 81e9 }) // aço, Pa
  domain.createCrossSection(1, { a: 28.5e-4, iy: 1943e-8, h: 0.2, k: 1e32 }) // IPE 200, rígido ao cisalhamento
  domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // apoio fixo
  domain.createNode('B', [span, 0, 0], [DofID.Dz]) // apoio móvel
  domain.createBeam2D(1, ['A', 'B'], 1, 1)
  solver.loadCases[0].createBeamElementUniformEdgeLoad(1, [0, q * 1e3], true) // N/m, +z para baixo
  solver.solve()
  return solver
}

O segundo, BeamFigure.vue, passa o solver ao StructurePlot e diz o que desenhar:

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>

Essa é a figura inteira: a viga sobre os apoios, a carga de 12 kN/m, as duas reações de 36 kN e o momento fletor,  kNm no meio do vão, desenhado do lado tracionado:

O que BeamFigure.vue desenha: um vão de 6 m sob 12 kN/m54q = 12 kN/m3636
O que BeamFigure.vue desenha: um vão de 6 m sob 12 kN/mAbrir no EduBeam

A figura ocupa toda a largura do contêiner e define a própria altura. Textos, símbolos e espessuras de linha mantêm o tamanho em pixels, seja qual for o tamanho da estrutura, então a figura continua legível num celular. Se você omitir layers, a figura escolhe o resultado sozinha: M para vigas e pórticos, N para uma treliça. Todas as camadas estão descritas em StructurePlot; a montagem de modelos é explicada na documentação do solver.

Quando o modelo muda

A figura lê o solver que recebe, mas não o observa. Quando algo muda, resolva de novo e passe o novo solver. Um computed faz exatamente isso:

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>

Uma viga como essa é resolvida em cerca de um milissegundo, então a figura acompanha o controle deslizante enquanto ele se move. Alterou um solver diretamente, sem criar outro? Incremente a prop revision e a figura o lê de novo.

Salvar como arquivo

Para uma figura no LaTeX, no Word ou no Inkscape, structureSvg escreve o mesmo desenho como um arquivo SVG independente, com cores fixas. Ele não precisa do Vue nem de um navegador, só do Node. Salve isto como beam-svg.ts, ao lado de 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)

Execute-o com node beam-svg.ts (Node 22.18 ou posterior; em versões anteriores, npx tsx beam-svg.ts). As opções, e como levar o arquivo para o LaTeX e o Word, estão em Um arquivo SVG independente.

A figura empilhada

DiagramStack desenha a figura de todo livro de estática: uma viga reta com as suas cargas e, embaixo, no mesmo eixo x, V(x), M(x) e w(x). Com v-model:load-at, o leitor pode arrastar uma carga concentrada ao longo da viga e ver os diagramas acompanharem:

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

O exemplo completo está em DiagramStack.

Usar em todo o app

Para registrar os dois componentes globalmente, em vez de importá-los onde forem usados:

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> em todos os templates

Importações nomeadas deixam o bundle menor: uma página que importa só StructurePlot não recebe nem DiagramStack nem o plugin. Os dois componentes também são renderizados no servidor, no Nuxt ou no VitePress: veja Incorporação.

Próximos passos