Primeiros passos
O @edubeam/fem é o solver de elementos finitos por trás do EduBeam: todos os diagramas, reações e flechas que o aplicativo mostra vêm dele. Com ele você resolve vigas, pórticos e treliças planas a partir do seu próprio código, no navegador ou no Node: pode gerar exercícios com as respostas, corrigir exercícios para casa, fazer estudos paramétricos ou colocar um solver por trás de uma página web.
A biblioteca é escrita em TypeScript, traz seus próprios tipos e é software livre sob a licença GPL-3.0. Foi criada por Bořek Patzák e é desenvolvida com Jan Voříšek e outros colaboradores.
Instalação
npm install @edubeam/fem
Funciona com import e com require, no navegador e no Node 18 ou posterior, e tem uma única dependência, o mathjs. Até a versão 0.3.0 ela era instalada a partir do GitHub com o nome ts-fem: se você a usava assim, troque seus imports para @edubeam/fem. Nada mais mudou.
Para testar o exemplo abaixo a partir de uma pasta vazia, transforme-a em um projeto que usa import e depois instale o pacote:
npm init -y
npm pkg set type=module
npm install @edubeam/fem
Sem "type": "module" no package.json o exemplo também roda, mas o Node mostra um aviso antes.
Sua primeira viga
Uma viga de aço IPE 200 com 6 m de vão, sobre um apoio fixo e um apoio móvel, com uma carga de 12 kN/m:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// Unidades SI em tudo: m, N, Pa. Aço e um IPE 200.
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// Nós em [x, y, z], em metros, com os GLs que o apoio restringe
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // apoio fixo
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // apoio móvel
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 12 kN/m no eixo z local da barra: para baixo numa viga desenhada da esquerda para a direita
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // N·m no meio do vão
console.log(beam.computeShearForceAt(lc, 0)) // N em A
console.log(beam.computeLocalDefl(lc, 2).w[1]) // m no meio do vão
Salve o código como beam.ts e execute node beam.ts: o Node 22.18 e posteriores executam TypeScript diretamente. O arquivo não tem anotações de tipo, então, num Node mais antigo, basta salvá-lo como beam.mjs. A saída é:
54000
36000
0.04990940552616746
São os valores dos livros, kNm e kN. Aqui está a mesma viga, resolvida no seu navegador pelo mesmo solver:
A flecha, 49,91 mm, é 0,28 mm maior que a de Euler–Bernoulli, mm. Não é erro: a barra é uma viga de Timoshenko, e esses 0,28 mm são , a deformação por cisalhamento desta viga. Dê a k um valor enorme, como 1e32, e a diferença desaparece: veja Deformação por cisalhamento.
O que o código faz
Crie um solver
new LinearStaticSolver() já vem com um domain vazio, que guarda o modelo, e com um caso de carga, solver.loadCases[0].
Descreva o modelo
Materiais e seções, nós com seus apoios e, depois, barras entre os nós. Tudo tem um rótulo, uma string ou um número, pelo qual o resto do modelo se refere a ele. Veja Nós e apoios, Materiais e seções e Barras e rótulas.
Aplique as cargas
As cargas pertencem a um caso de carga: forças nos nós, cargas ao longo das barras, temperatura e recalques. Veja Cargas nodais e nas barras.
Resolva
solver.solve() monta e resolve todos os casos de carga. Veja Cálculo.
Leia os resultados
Esforços internos em qualquer ponto de uma barra, flechas, esforços de extremidade, deslocamentos nodais e reações. Veja Leitura dos resultados e, para os diagramas, Desenho dos resultados.
Unidades e sinais em resumo
Unidades SI na entrada, unidades SI na saída. O modelo fica no plano x–z com o eixo z para baixo, então uma fz positiva empurra para baixo e o topo de um pilar de 4 m fica em . As posições ao longo de uma barra são medidas em metros a partir do seu primeiro nó. O momento positivo traciona a fibra inferior. Unidades e sinais traz a lista completa.
Seis armadilhas comuns
- O eixo z aponta para baixo. As cargas gravitacionais são positivas, e tudo o que está acima dos apoios tem z negativo. Veja Eixos.
- A orientação da barra define o sinal de M e de w. Defina as vigas da esquerda para a direita e os pilares de baixo para cima, e os sinais saem como nos livros. Veja Orientação da barra.
- Um parâmetro que falta dá
NaNou um resultado absurdo, não um erro. Uma seção precisa dea,iyek; um material precisa dee, e também deg, a menos quekseja enorme. Veja Materiais e seções. - Depois de adicionar nós ou barras, ou de mudar apoios, defina
solver.codeNumberGenerated = falseantes de resolver de novo. Veja Resolver de novo após uma alteração. - As reações vêm como uma matriz do mathjs ou como um array, na ordem em que os GLs do apoio foram informados. Veja Reações.
- Um mecanismo nem sempre lança uma exceção. Um deslocamento de m significa que a estrutura pode se mover livremente. Veja Quando o cálculo falha.
Próximos passos
Programas de exemplo
Programas completos e conferidos: vigas, pórticos, treliças, uma lista de exercícios com o gabarito e um pequeno servidor HTTP.
Desenhe os resultados
Passe um modelo resolvido ao @edubeam/plot e obtenha seus diagramas em SVG, no Vue ou a partir de um script Node.
Referência da API
Todas as classes, métodos e argumentos, com as unidades e o que cada um retorna.
A teoria
O elemento de viga, sua matriz de rigidez e sua transformação, no manual teórico do EduBeam.