Referencia de la API

Lo que exporta @edubeam/fem 0.3, agrupado según para qué se usa. Las unidades son SI en todo: m, N, N·m, N/m, Pa, K y rad. Las etiquetas (LabelType) son string | number y se guardan como cadenas. Los métodos que no aparecen aquí son internos: son públicos en TypeScript solo porque los llaman las propias clases del solver.

Exportaciones

ExportaciónTipoSección
LinearStaticSolverclaseAnálisis
Solverclase abstractaAnálisis
DomainclaseDomain
NodeclaseNode
Beam2D, ElementclasesElementos
Material, CrossSectionclasesMateriales y secciones
LoadCaseclaseCargas
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadclasesCargas
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterstipos

Análisis

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
MiembroTipoDescripción
domainDomainEl modelo
loadCasesLoadCase[]Empieza con un caso, 'DefaultLC'. Añade más con new LoadCase(label, solver.domain): Casos de carga.
solve()voidNumera las ecuaciones si hace falta, ensambla y resuelve todos los casos de carga. Puede lanzar una excepción ante un mecanismo, pero no siempre lo hace. No escribe nada desde la 0.3.1; la 0.3.0 mostraba su tiempo.
codeNumberGeneratedbooleanPonlo a false después de añadir o eliminar nodos o barras, o de cambiar apoyos: por qué
neq, pneqnumberNúmero de GDL libres y de GDL impedidos, después de resolver
kMatrix de mathjsLa matriz de rigidez global ensamblada, después de resolver
getNodeDofIDs(label)number[]Los GDL que tiene un nodo, después de resolver

EigenValueDynamicSolver existe en el código fuente, pero no se exporta.

Domain

solver.domain guarda el modelo en cuatro Map cuya clave es la etiqueta como cadena: nodes, elements, materials, crossSections. No hay métodos para eliminar: domain.nodes.delete(label) y domain.elements.delete(label) eliminan un nodo o una barra, y después hay que renumerar.

MétodoDevuelveDescripción
createNode(label, coords?, bcs?)Nodecoords [x, y, z] en m (por defecto [0, 0, 0]), bcs los DofID impedidos (por defecto ninguno)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (por defecto [false, false])
createMaterial(label, params?)MaterialConsulta Materiales y secciones
createCrossSection(label, params?)CrossSectionConsulta Materiales y secciones
getNode(label), getElement(label), getMaterial(label), getCS(label)el objetoLanza un RangeError si la etiqueta no existe. getElement tiene el tipo Element: escribe as Beam2D para leer resultados.

Crear un objeto con una etiqueta que ya está en uso sustituye al anterior.

Node

MiembroTipoDescripción
labelstring
coordsnumber[][x, y, z], m. Cámbialo para mover el nodo.
bcsSet<DofID>GDL impedidos. Sustitúyelo para cambiar el apoyo.
lcsnumber[][] | undefinedLos ejes girados del nodo, si los tiene
updateLcs({ locx, locy }?)voidGira los ejes del nodo: locx es su eje x en componentes globales, locy es [0, 1, 0]. Sin argumento, los restablece.
hasLcs()booleanSi los ejes están girados
getUnknowns(lc, dofs)Matrix, o un number para un solo GDLDesplazamientos (m) y giros (rad), en los ejes del nodo
getReactions(lc, global?){ dofs, values }Reacciones en los GDL impedidos, en el orden de bcs: N, N·m. values es una Matrix de mathjs si hay varias, un array de un elemento si hay una, y [] en un nodo libre. Con global igual a true en un nodo girado: los tres GDL en ejes globales, dofs [0, 2, 4], values un array con 0 donde no hay nada impedido. Cómo leerlas.

Elementos

Beam2D

Una viga de Timoshenko de dos nodos en el plano x–z, con tres GDL por nodo (Dx, Dz, Ry). x se da en metros desde el primer nodo; n es un número de segmentos, que da n + 1 puntos.

MiembroDevuelveDescripción
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Liberación del momento en el primer y en el segundo nodo
computeNormalForceAt(lc, x)numberN, positivo en tracción
computeShearForceAt(lc, x)numberV, positivo donde M crece según el x local
computeBendingMomentAt(lc, x)numberM, positivo con tracción en el lado +z local
computeNormalForce(lc, n){ x, N }N en n + 1 puntos
computeShearForce(lc, n){ x, V }V en n + 1 puntos
computeBendingMoment(lc, n){ x, M }M en n + 1 puntos
computeLocalDefl(lc, n){ u, w }Desplazamientos según la barra y perpendiculares a ella, en ejes locales, m
computeGlobalDefl(lc, n){ u, w }Lo mismo en x y z globales
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], las fuerzas que los nodos ejercen sobre la barra, en ejes locales
computeEndDisplacement(lc)MatrixDesplazamientos de los extremos en ejes locales, incluidos los giros de las rótulas
computeGeo(){ l, dx, dz }Longitud y proyecciones, m
computeT()MatrixTransformación de 6 × 6, de ejes globales a locales
computeLocalStiffnessMtrx(){ answer }answer: rigidez local de 6 × 6, con las rótulas condensadas
computeStiffness()MatrixRigidez global de 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

En una carga puntual, los métodos …At devuelven el valor justo después de ella. Element es la clase base abstracta de Beam2D; es el tipo que usan domain.elements y getElement.

Materiales y secciones

MaterialParametersUnidadPor defectoSe usa para
ePa1la rigidez
gPa1la rigidez a cortante
alpha1/K1las cargas térmicas
dkg/m³1nada en estática
CrossSectionParametersUnidadPor defectoSe usa para
am²ninguno, obligatoriola rigidez axil y a cortante
iym⁴ninguno, obligatoriola rigidez a flexión
k–ninguno, obligatoriola rigidez a cortante ; 1e32 para despreciar la deformación por cortante
hmningunolos gradientes térmicos (NaN sin él)
iz, dyz, jm⁴ningunono los usa Beam2D

Un parámetro de material que falta vale 1, no un valor típico; si falta a, iy o k, todos los resultados son NaN. Ninguno de los dos casos lanza un error. Las dos clases tienen un método change(params) que fija los parámetros dados, y los guardan como propiedades con los mismos nombres.

Cargas

LoadCase

MétodoDevuelveValores
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (por defecto false) igual a true: en los ejes girados del nodo
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m en toda la barra
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m en el primer y en el segundo nodo, con variación lineal entre ellos
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, a a m del primer nodo
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: centro de gravedad, fibra inferior, fibra superior
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } en GDL impedidos, en los ejes del nodo; se ignora en GDL libres

En las cargas en barras, lcs igual a true significa ejes locales (x según la barra, z perpendicular a ella), y false, ejes globales. Las cargas lineales son por metro de longitud de la barra. Cargas nodales y en barras tiene ejemplos.

MiembroTipoDescripción
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Cargas en barras y cargas térmicas
prescribedBCPrescribedDisplacement[]
solvedbooleantrue tras un cálculo correcto
getElementLoadsOnElement(el)BeamElementLoad[]Las cargas sobre una barra

Los objetos de carga guardan sus valores en propiedades públicas, que puedes cambiar antes de volver a resolver: values (y lcs) en NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad y BeamTemperatureLoad; startValues y endValues en BeamElementTrapezoidalEdgeLoad; prescribedValues en PrescribedDisplacement. Cada uno tiene un target, la etiqueta del objeto sobre el que actúa.

DofID

NombreValorLo usa Beam2D
Dx0sí
Dy1no
Dz2sí
Rx3no
Ry4sí
Rz5no

Resultados

Los resultados se leen de un Beam2D (esfuerzos, flechas, fuerzas en los extremos) y de un Node (desplazamientos, reacciones), siempre para un LoadCase dado y después de solve(): consulta las dos tablas anteriores, y Lectura de resultados para ver ejemplos y los signos. En resumen:

Para obtenerLlamada
Reacciones, N y N·mnode.getReactions(lc)
Desplazamientos, m, y giros, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V o M en un punto, N y N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V o M a lo largo de una barrabeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Deformada, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Fuerzas en los extremos, N y N·mbeam.computeEndForces(lc)
Una figura con todo elloStructurePlot o structureSvg, de @edubeam/plot