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' 하나. 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로 주면 전체 좌표계의 자유도 3개 모두: dofs는 [0, 2, 4], values는 구속하지 않은 자유도에 0을 넣은 배열. 반력 읽기

요소

Beam2D

x–z 평면의 2절점 Timoshenko 보로, 절점마다 자유도가 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, 국부 x 방향으로 M이 증가하면 양수
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[]부재 하나에 작용하는 하중

하중 객체는 값을 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(변위, 반력)에서 읽습니다. 위의 두 표를 보고, 예제와 부호는 결과 읽기를 참고하세요. 요약하면 다음과 같습니다.

구할 값호출
반력(N, N·m)node.getReactions(lc)
변위(m)와 회전각(rad)node.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
한 점의 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