Referência da API

O que o @edubeam/fem 0.3 exporta, agrupado pelo uso. As unidades são sempre SI: m, N, N·m, N/m, Pa, K e rad. Os rótulos (LabelType) são string | number, guardados como strings. Os métodos que não aparecem aqui são internos: são públicos no TypeScript só porque as próprias classes do solver os chamam.

Exportações

ExportaçãoTipoVer em
LinearStaticSolverclasseAnálises
Solverclasse abstrataAnálises
DomainclasseDomain
NodeclasseNode
Beam2D, ElementclassesElementos
Material, CrossSectionclassesMateriais e seções
LoadCaseclasseCargas
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadclassesCargas
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterstipos

Análises

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
MembroTipoDescrição
domainDomainO modelo
loadCasesLoadCase[]Começa com um caso, 'DefaultLC'. Adicione outros com new LoadCase(label, solver.domain): Casos de carga.
solve()voidNumera as equações, se necessário, monta e resolve todos os casos de carga. Pode lançar uma exceção diante de um mecanismo, mas nem sempre lança. Silencioso a partir da 0.3.1; a 0.3.0 registrava o tempo no console.
codeNumberGeneratedbooleanDefina como false depois de adicionar ou remover nós ou barras, ou de mudar apoios: por quê
neq, pneqnumberNúmero de GLs livres e de GLs restringidos, após o cálculo
kMatrix do mathjsA matriz de rigidez global montada, após o cálculo
getNodeDofIDs(label)number[]Os GLs que um nó tem, após o cálculo

EigenValueDynamicSolver existe no código-fonte, mas não é exportado.

Domain

solver.domain guarda o modelo em quatro Maps cuja chave é o rótulo como string: nodes, elements, materials, crossSections. Não há métodos de remoção: domain.nodes.delete(label) e domain.elements.delete(label) removem um nó ou uma barra, e depois é preciso renumerar.

MétodoRetornaDescrição
createNode(label, coords?, bcs?)Nodecoords [x, y, z] em m (padrão [0, 0, 0]), bcs os DofIDs restringidos (padrão: nenhum)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (padrão [false, false])
createMaterial(label, params?)MaterialVeja Materiais e seções
createCrossSection(label, params?)CrossSectionVeja Materiais e seções
getNode(label), getElement(label), getMaterial(label), getCS(label)o objetoLança um RangeError para um rótulo desconhecido. getElement é tipado como Element: escreva as Beam2D para ler resultados.

Criar um objeto com um rótulo que já está em uso substitui o antigo.

Node

MembroTipoDescrição
labelstring
coordsnumber[][x, y, z], m. Altere-o para mover o nó.
bcsSet<DofID>GLs restringidos. Substitua-o para mudar o apoio.
lcsnumber[][] | undefinedOs eixos girados do nó, se houver
updateLcs({ locx, locy }?)voidGira os eixos do nó: locx é o seu eixo x em componentes globais, locy é [0, 1, 0]. Sem argumento, restaura os eixos.
hasLcs()booleanSe os eixos estão girados
getUnknowns(lc, dofs)Matrix, ou um number para um só GLDeslocamentos (m) e rotações (rad), nos eixos do nó
getReactions(lc, global?){ dofs, values }Reações nos GLs restringidos, na ordem de bcs: N, N·m. values é uma Matrix do mathjs quando há várias, um array de um elemento quando há uma só, e [] para um nó livre. Com global igual a true num nó girado: os três GLs em eixos globais, dofs [0, 2, 4], values um array com 0 onde nada é restringido. Como lê-las.

Elementos

Beam2D

Uma viga de Timoshenko de dois nós no plano x–z, com três GLs por nó (Dx, Dz, Ry). x é dado em metros a partir do primeiro nó; n é um número de segmentos, que dá n + 1 pontos.

MembroRetornaDescrição
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Liberação do momento no primeiro e no segundo nó
computeNormalForceAt(lc, x)numberN, positivo na tração
computeShearForceAt(lc, x)numberV, positivo onde M cresce ao longo do x local
computeBendingMomentAt(lc, x)numberM, positivo com tração no lado +z local
computeNormalForce(lc, n){ x, N }N em n + 1 pontos
computeShearForce(lc, n){ x, V }V em n + 1 pontos
computeBendingMoment(lc, n){ x, M }M em n + 1 pontos
computeLocalDefl(lc, n){ u, w }Deslocamentos ao longo da barra e perpendiculares a ela, em eixos locais, m
computeGlobalDefl(lc, n){ u, w }O mesmo em x e z globais
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], as forças que os nós exercem sobre a barra, em eixos locais
computeEndDisplacement(lc)MatrixDeslocamentos das extremidades em eixos locais, incluindo as rotações nas rótulas
computeGeo(){ l, dx, dz }Comprimento e projeções, m
computeT()MatrixTransformação 6 × 6, dos eixos globais para os locais
computeLocalStiffnessMtrx(){ answer }answer: rigidez local 6 × 6, com as rótulas condensadas
computeStiffness()MatrixRigidez global 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

No ponto de uma carga concentrada, os métodos …At retornam o valor logo depois dela. Element é a classe base abstrata de Beam2D; é o tipo que domain.elements e getElement usam.

Materiais e seções

MaterialParametersUnidadePadrãoUsado para
ePa1rigidez
gPa1rigidez ao cisalhamento
alpha1/K1cargas térmicas
dkg/m³1nada na estática
CrossSectionParametersUnidadePadrãoUsado para
am²nenhum, obrigatóriorigidez axial e ao cisalhamento
iym⁴nenhum, obrigatóriorigidez à flexão
k–nenhum, obrigatóriorigidez ao cisalhamento ; 1e32 para desprezá-la
hmnenhumgradientes térmicos (NaN sem ele)
iz, dyz, jm⁴nenhumnão usados pelo Beam2D

Um parâmetro de material omitido vale 1, e não um valor típico; omitir a, iy ou k faz todos os resultados darem NaN. Nenhum dos casos lança erro. As duas classes têm um método change(params), que define os parâmetros informados, e guardam os parâmetros como propriedades com os mesmos nomes.

Cargas

LoadCase

MétodoRetornaValores
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (padrão false) igual a true: nos eixos girados do nó
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m em toda a barra
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m no primeiro e no segundo nó, linear entre eles
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, a a m do primeiro nó
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: centroide, fibra inferior, fibra superior
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } em GLs restringidos, nos eixos do nó; ignorado em GLs livres

Para cargas nas barras, lcs igual a true significa eixos locais (x ao longo da barra, z perpendicular a ela), e false, eixos globais. As cargas distribuídas são por metro do comprimento da barra. Cargas nodais e nas barras traz exemplos.

MembroTipoDescrição
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Cargas nas barras e cargas térmicas
prescribedBCPrescribedDisplacement[]
solvedbooleantrue depois de um cálculo bem-sucedido
getElementLoadsOnElement(el)BeamElementLoad[]As cargas de uma barra

Os objetos de carga guardam os seus valores em propriedades públicas, que você pode alterar antes de resolver de novo: values (e lcs) em NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad e BeamTemperatureLoad; startValues e endValues em BeamElementTrapezoidalEdgeLoad; prescribedValues em PrescribedDisplacement. Cada um tem um target, o rótulo do objeto em que atua.

DofID

NomeValorUsado pelo Beam2D
Dx0sim
Dy1não
Dz2sim
Rx3não
Ry4sim
Rz5não

Resultados

Os resultados são lidos de um Beam2D (esforços internos, flechas, esforços de extremidade) e de um Node (deslocamentos, reações), sempre para um LoadCase dado, depois de solve(): veja as duas tabelas acima e Leitura dos resultados para exemplos e sinais. Em resumo:

Para obterChamada
Reações, N e N·mnode.getReactions(lc)
Deslocamentos, m, e rotações, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V ou M num ponto, N e N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V ou M ao longo de uma barrabeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Deformada, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Esforços de extremidade, N e N·mbeam.computeEndForces(lc)
Uma figura de tudo issoStructurePlot ou structureSvg do @edubeam/plot