API リファレンス

@edubeam/fem 0.3 がエクスポートするものを、用途別にまとめます。単位はすべて SI(m、N、N·m、N/m、Pa、K、rad)です。ラベル(LabelType)は string | number で、文字列として保存されます。ここに載っていないメソッドは内部用です。TypeScript で public になっているのは、ソルバー自身のクラスから呼び出すためにすぎません。

エクスポート

エクスポート種類セクション
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' が 1 つ。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 は、モデルを 4 つの 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、自由度 1 つなら number変位(m)と回転角(rad)。節点の座標軸で表す
getReactions(lc, global?){ dofs, values }拘束された自由度の反力(bcs の順、N、N·m)。values は複数なら mathjs の Matrix、1 つなら要素 1 個の配列、自由な節点なら []。座標軸を回転させた節点で global を true にすると、3 つの自由度すべてをグローバル座標系で返す。dofs は [0, 2, 4]、values は拘束していない自由度を 0 とした配列。読み出し方

要素

Beam2D

x–z 平面内の 2 節点ティモシェンコ梁で、節点あたり 3 つの自由度(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()Matrixグローバル座標系の 6 × 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)BeamElementUniformEdgeLoad部材全長にわたる N/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 ならグローバル座標系です。線荷重は部材長 1 m あたりの値です。例は節点荷重と部材荷重にあります。

名前型説明
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]部材荷重と温度荷重
prescribedBCPrescribedDisplacement[]
solvedboolean解析が成功すると true
getElementLoadsOnElement(el)BeamElementLoad[]1 つの部材にかかる荷重

荷重オブジェクトは値を public なプロパティに保持していて、解き直す前に変更できます。NodalLoad、BeamElementUniformEdgeLoad、BeamConcentratedLoad、BeamTemperatureLoad では values(と lcs)、BeamElementTrapezoidalEdgeLoad では startValues と endValues、PrescribedDisplacement では prescribedValues です。どの荷重にも、作用する対象のラベルを表す target があります。

DofID

名前値Beam2D で使用
Dx0する
Dy1しない
Dz2する
Rx3しない
Ry4する
Rz5しない

結果

結果は、solve() の後に、必ず LoadCase を指定して、Beam2D(断面力、たわみ、材端力)と Node(変位、反力)から読み出します。上の 2 つの表と、例と符号については結果の読み出しを参照してください。要点は次のとおりです。

求めるもの呼び出し
反力(N、N·m)node.getReactions(lc)
変位(m)と回転角(rad)node.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
1 点での N、V、M(N、N·m)beam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
部材に沿った N、V、Mbeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
変位図(m)beam.computeLocalDefl(lc, n), computeGlobalDefl
材端力(N、N·m)beam.computeEndForces(lc)
すべてを図にする@edubeam/plot の StructurePlot または structureSvg