API 参考

@edubeam/fem 0.3 导出的内容,按用途分组。单位一律为 SI:m、N、N·m、N/m、Pa、K 和 rad。标签(LabelType)为 string | number,以字符串保存。此处未列出的方法都是内部方法:它们在 TypeScript 中是公开的,只是因为求解器自身的类要调用它们。

导出

导出类别章节
LinearStaticSolver类分析
Solver抽象类分析
Domain类Domain
Node类Node
Beam2D、Element类单元
Material、CrossSection类材料与截面
LoadCase类荷载
NodalLoad、BeamConcentratedLoad、BeamElementUniformEdgeLoad、BeamElementTrapezoidalEdgeLoad、BeamTemperatureLoad、PrescribedDisplacement、Load、BeamElementLoad类荷载
DofID枚举DofID
LabelType、EnumDictionary、MaterialParameters、CrossSectionParameters类型

分析

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
成员类型说明
domainDomain模型
loadCasesLoadCase[]初始包含一个工况 'DefaultLC'。用 new LoadCase(label, solver.domain) 创建更多工况,再追加到这个数组中,参见荷载工况。
solve()void必要时对方程编号,集成并求解每个荷载工况。遇到机构时可能抛出异常,但不一定。从 0.3.1 版起不输出任何内容;0.3.0 版会打印用时。
codeNumberGeneratedboolean增删节点或杆件、修改支座之后,把它设为 false:原因
neq、pneqnumber求解后,未约束自由度和受约束自由度的个数
kmathjs Matrix求解后,集成好的整体刚度矩阵
getNodeDofIDs(label)number[]求解后,节点具有的自由度

EigenValueDynamicSolver 存在于源代码中,但没有导出。

Domain

solver.domain 用四个 Map 保存模型,键为字符串形式的标签:nodes、elements、materials、crossSections。没有删除方法:用 domain.nodes.delete(label) 和 domain.elements.delete(label) 删除节点或杆件,然后重新编号。

方法返回说明
createNode(label, coords?, bcs?)Nodecoords 为 [x, y, z],单位 m(默认 [0, 0, 0]);bcs 为受约束的 DofID(默认无)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes 为 [first, second],hinges 为 [atFirst, atSecond](默认 [false, false])
createMaterial(label, params?)Material参见材料与截面
createCrossSection(label, params?)CrossSection参见材料与截面
getNode(label)、getElement(label)、getMaterial(label)、getCS(label)对应的对象标签不存在时抛出 RangeError。getElement 的类型为 Element:读取结果前要写 as Beam2D。

用已被占用的标签创建对象,会替换原有对象。

Node

成员类型说明
labelstring
coordsnumber[][x, y, z],单位 m。修改它即可移动节点。
bcsSet<DofID>受约束的自由度。替换它即可改变支座。
lcsnumber[][] | undefined节点旋转后的坐标轴(如有)
updateLcs({ locx, locy }?)void旋转节点坐标轴:locx 为其 x 轴在整体坐标系中的分量,locy 为 [0, 1, 0]。不带参数时复位。
hasLcs()boolean坐标轴是否已旋转
getUnknowns(lc, dofs)Matrix,单个自由度时为 number位移(m)和转角(rad),在节点坐标系中
getReactions(lc, global?){ dofs, values }受约束自由度上的支反力,按 bcs 的顺序:N、N·m。有多个时 values 是 mathjs Matrix,只有一个时是单元素数组,自由节点为 []。对旋转过坐标轴的节点,global 为 true 时:返回整体坐标下的全部三个自由度,dofs 为 [0, 2, 4],values 是数组,未约束处为 0。读取方法。

单元

Beam2D

x–z 平面内的两节点 Timoshenko 梁单元,每个节点三个自由度(Dx、Dz、Ry)。x 为距第一个节点的距离,单位 m;n 为分段数,给出 n + 1 个点。

成员返回说明
label、nodes、mat、csstring、string[]、string、string
hinges[boolean, boolean]第一个和第二个节点处的弯矩释放
computeNormalForceAt(lc, x)numberN,受拉为正
computeShearForceAt(lc, x)numberV,M 沿局部 x 增大处为正
computeBendingMomentAt(lc, x)numberM,局部 +z 一侧受拉为正
computeNormalForce(lc, n){ x, N }n + 1 个点上的 N
computeShearForce(lc, n){ x, V }n + 1 个点上的 V
computeBendingMoment(lc, n){ x, M }n + 1 个点上的 M
computeLocalDefl(lc, n){ u, w }沿杆轴和垂直杆轴的位移,局部坐标,单位 m
computeGlobalDefl(lc, n){ u, w }同上,整体 x 和 z 方向
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21],节点作用在杆件上的力,局部坐标
computeEndDisplacement(lc)Matrix局部坐标下的杆端位移,包括铰处的转角
computeGeo(){ l, dx, dz }杆长和投影,单位 m
computeT()Matrix6 × 6 坐标转换矩阵,从整体到局部
computeLocalStiffnessMtrx(){ answer }answer:6 × 6 局部刚度矩阵,已凝聚掉铰端的转角
computeStiffness()Matrix6 × 6 整体刚度矩阵
computeShearFactor()number
getMaterial()、getCS()Material、CrossSection

在集中荷载处,…At 方法返回紧接其后的值。Element 是 Beam2D 的抽象基类,domain.elements 和 getElement 使用的就是这个类型。

材料与截面

MaterialParameters单位默认值用途
ePa1刚度
gPa1剪切刚度
alpha1/K1温度荷载
dkg/m³1静力分析中不使用
CrossSectionParameters单位默认值用途
am²无,必填轴向刚度和剪切刚度
iym⁴无,必填弯曲刚度
k–无,必填剪切刚度 ;取 1e32 即不计剪切变形
hm无温度梯度(缺少时为 NaN)
iz、dyz、jm⁴无Beam2D 不使用

缺少的材料参数取 1,而不是某个典型值;缺少 a、iy 或 k 会使所有结果为 NaN。两种情况都不会抛出异常。两个类都有 change(params) 方法,用来设置传入的参数,参数保存为同名属性。

荷载

LoadCase

方法返回数值
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m };lcs(默认 false)为 true 时:在节点旋转后的坐标系中
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m,布满整根杆件
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoad第一个和第二个节点处的 N/m,其间线性变化
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN、N、N·m,作用在距第一个节点 a m 处
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK:形心、下缘纤维、上缘纤维
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … },作用在受约束的自由度上,节点坐标系;对未约束的自由度忽略

对杆件荷载,lcs 为 true 表示局部坐标(x 沿杆轴,z 垂直杆轴),false 表示整体坐标。线荷载按杆长每米计。示例见荷载。

成员类型说明
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]杆件荷载和温度荷载
prescribedBCPrescribedDisplacement[]
solvedboolean成功求解后为 true
getElementLoadsOnElement(el)BeamElementLoad[]某一根杆件上的荷载

荷载对象把数值保存在公开属性中,重新求解前可以修改:NodalLoad、BeamElementUniformEdgeLoad、BeamConcentratedLoad 和 BeamTemperatureLoad 上的 values(以及 lcs);BeamElementTrapezoidalEdgeLoad 上的 startValues 和 endValues;PrescribedDisplacement 上的 prescribedValues。每个荷载对象都有一个 target,即它所作用对象的标签。

DofID

名称值Beam2D 是否使用
Dx0是
Dy1否
Dz2是
Rx3否
Ry4是
Rz5否

结果

结果在 solve() 之后,针对指定的 LoadCase,从 Beam2D(内力、挠度、杆端力)和 Node(位移、支反力)读取:参见上面两个表格;示例和符号约定见读取结果。简言之:

要得到调用
支反力,N 和 N·mnode.getReactions(lc)
位移(m)和转角(rad)node.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
某一点的 N、V 或 M,N 和 N·mbeam.computeNormalForceAt(lc, x)、computeShearForceAt、computeBendingMomentAt
沿杆件的 N、V 或 Mbeam.computeNormalForce(lc, n)、computeShearForce、computeBendingMoment
变形曲线,mbeam.computeLocalDefl(lc, n)、computeGlobalDefl
杆端力,N 和 N·mbeam.computeEndForces(lc)
把这一切画成图@edubeam/plot 的 StructurePlot 或 structureSvg