빠른 시작
@edubeam/fem 라이브러리는 EduBeam의 계산을 맡은 유한요소 솔버입니다. 앱이 보여 주는 다이어그램, 반력, 처짐은 모두 이 솔버가 계산합니다. 직접 작성한 코드에서 이 라이브러리로 평면 보, 라멘, 트러스를 풀 수 있습니다. 브라우저와 Node 어디서나 동작하므로 정답이 딸린 연습 문제를 만들거나, 과제를 채점하거나, 매개변수 연구를 하거나, 웹 페이지의 백엔드에서 솔버를 돌릴 수 있습니다.
TypeScript로 작성되었고 타입 정의를 함께 제공하며, GPL-3.0 라이선스로 배포되는 자유 소프트웨어입니다. Bořek Patzák이 만들었고, Jan Voříšek 및 여러 기여자와 함께 개발하고 있습니다.
설치
npm install @edubeam/fem
import와 require 모두 쓸 수 있고, 브라우저와 Node 18 이상에서 동작합니다. 의존성은 mathjs 하나뿐입니다. 0.3.0 이전에는 GitHub에서 ts-fem이라는 이름으로 설치했습니다. 그 패키지를 쓰고 있었다면 import 경로를 @edubeam/fem으로 바꾸세요. 그 밖에 바뀐 것은 없습니다.
아래 예제를 빈 폴더에서 실행해 보려면, 먼저 그 폴더를 import를 쓰는 프로젝트로 만든 다음 설치합니다.
npm init -y
npm pkg set type=module
npm install @edubeam/fem
package.json에 "type": "module"이 없어도 예제는 실행되지만, Node가 먼저 경고를 출력합니다.
첫 번째 보
길이 6 m의 강재 보(IPE 200)를 힌지 지점과 롤러 지점으로 받치고, 12 kN/m의 등분포하중을 가합니다.
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// 단위는 모두 SI: m, N, Pa. 강재와 IPE 200
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// 절점 좌표 [x, y, z](m)와 지점이 구속하는 자유도
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // 힌지 지점
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // 롤러 지점
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 부재의 국부 z 방향으로 12 kN/m: 왼쪽에서 오른쪽으로 그린 보에서는 아래쪽
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // 경간 중앙의 휨모멘트, N·m
console.log(beam.computeShearForceAt(lc, 0)) // A의 전단력, N
console.log(beam.computeLocalDefl(lc, 2).w[1]) // 경간 중앙의 처짐, m
beam.ts로 저장하고 node beam.ts로 실행합니다. Node 22.18 이상은 TypeScript를 그대로 실행합니다. 이 파일에는 타입 표기가 없으므로, 그보다 오래된 Node에서는 beam.mjs로 저장하세요. 출력은 다음과 같습니다.
54000
36000
0.04990940552616746
교과서 값과 같은 kNm, kN입니다. 아래 그림은 같은 보를 같은 솔버가 브라우저에서 푼 결과입니다.
처짐 49.91 mm는 Euler–Bernoulli 보의 공식 mm보다 0.28 mm 큽니다. 오류가 아닙니다. 이 부재는 Timoshenko 보이고, 0.28 mm는 이 보의 전단 변형 입니다. k를 1e32처럼 아주 큰 값으로 바꾸면 이 차이는 사라집니다. 전단 변형을 참고하세요.
코드가 하는 일
솔버 만들기
new LinearStaticSolver()로 만든 솔버에는 모델을 담는 빈 domain과 하중조건 하나, solver.loadCases[0]이 들어 있습니다.
모델 정의하기
재료와 단면, 지점이 있는 절점, 그리고 절점 사이의 부재를 차례로 만듭니다. 모든 객체에는 레이블(문자열 또는 숫자)이 있고, 모델의 나머지 부분은 이 레이블로 그 객체를 가리킵니다. 절점 및 지점, 재료 및 단면, 부재 및 힌지를 참고하세요.
하중 가하기
하중은 하중조건에 속합니다. 절점에 작용하는 힘, 부재를 따라 작용하는 하중, 온도하중, 지점 침하가 있습니다. 절점하중 및 부재하중을 참고하세요.
풀기
solver.solve()는 모든 하중조건에 대해 강성 행렬을 조립하고 풉니다. 해석을 참고하세요.
결과 읽기
부재 위 임의 위치의 부재력, 처짐, 단부력, 절점 변위, 반력을 읽을 수 있습니다. 결과 읽기를 참고하고, 다이어그램은 결과 그리기를 참고하세요.
단위와 부호 요약
SI 단위로 넣으면 SI 단위로 나옵니다. 모델은 x–z 평면에 있고 z축은 아래쪽을 향합니다. 따라서 양의 fz는 아래로 누르고, 높이 4 m 기둥의 상단은 에 있습니다. 부재 위의 위치는 첫 번째 절점에서 잰 거리(m)입니다. 정모멘트(하연 인장)가 양수입니다. 전체 목록은 단위 및 부호에 있습니다.
자주 실수하는 여섯 가지
- z축은 아래쪽입니다. 중력 방향 하중은 양수이고, 지점보다 위에 있는 것은 z가 음수입니다. 좌표축을 참고하세요.
- 부재의 방향이 M과 w의 부호를 정합니다. 보는 왼쪽에서 오른쪽으로, 기둥은 아래에서 위로 정의하면 부호가 교과서와 같아집니다. 부재 방향을 참고하세요.
- 매개변수가 빠지면 오류 대신
NaN이나 엉뚱한 값이 나옵니다. 단면에는a,iy,k가 필요합니다. 재료에는e가 필요하고,k가 아주 크지 않다면g도 필요합니다. 재료 및 단면을 참고하세요. - 절점이나 부재를 추가했거나 지점을 바꿨다면 다시 풀기 전에
solver.codeNumberGenerated = false로 설정하세요. 변경 후 다시 풀기를 참고하세요. - 반력은 mathjs 행렬 또는 배열로 반환됩니다. 순서는 지점의 자유도를 지정한 순서입니다. 반력을 참고하세요.
- 메커니즘이라고 해서 항상 오류가 나지는 않습니다. 변위가 m 정도로 나오면 구조물이 자유롭게 움직일 수 있다는 뜻입니다. 해석이 실패할 때를 참고하세요.