빠른 시작

@edubeam/fem 라이브러리는 EduBeam의 계산을 맡은 유한요소 솔버입니다. 앱이 보여 주는 다이어그램, 반력, 처짐은 모두 이 솔버가 계산합니다. 직접 작성한 코드에서 이 라이브러리로 평면 보, 라멘, 트러스를 풀 수 있습니다. 브라우저와 Node 어디서나 동작하므로 정답이 딸린 연습 문제를 만들거나, 과제를 채점하거나, 매개변수 연구를 하거나, 웹 페이지의 백엔드에서 솔버를 돌릴 수 있습니다.

TypeScript로 작성되었고 타입 정의를 함께 제공하며, GPL-3.0 라이선스로 배포되는 자유 소프트웨어입니다. Bořek Patzák이 만들었고, Jan Voříšek 및 여러 기여자와 함께 개발하고 있습니다.

설치

Terminal
npm install @edubeam/fem

import와 require 모두 쓸 수 있고, 브라우저와 Node 18 이상에서 동작합니다. 의존성은 mathjs 하나뿐입니다. 0.3.0 이전에는 GitHub에서 ts-fem이라는 이름으로 설치했습니다. 그 패키지를 쓰고 있었다면 import 경로를 @edubeam/fem으로 바꾸세요. 그 밖에 바뀐 것은 없습니다.

아래 예제를 빈 폴더에서 실행해 보려면, 먼저 그 폴더를 import를 쓰는 프로젝트로 만든 다음 설치합니다.

Terminal
npm init -y
npm pkg set type=module
npm install @edubeam/fem

package.json에 "type": "module"이 없어도 예제는 실행되지만, Node가 먼저 경고를 출력합니다.

첫 번째 보

길이 6 m의 강재 보(IPE 200)를 힌지 지점과 롤러 지점으로 받치고, 12 kN/m의 등분포하중을 가합니다.

beam.ts
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입니다. 아래 그림은 같은 보를 같은 솔버가 브라우저에서 푼 결과입니다.

위의 보: 6 m, IPE 200, 12 kN/m54q = 12 kN/m3636AB
위의 보: 6 m, IPE 200, 12 kN/mEduBeam에서 열기

처짐 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)입니다. 정모멘트(하연 인장)가 양수입니다. 전체 목록은 단위 및 부호에 있습니다.

자주 실수하는 여섯 가지

  1. z축은 아래쪽입니다. 중력 방향 하중은 양수이고, 지점보다 위에 있는 것은 z가 음수입니다. 좌표축을 참고하세요.
  2. 부재의 방향이 M과 w의 부호를 정합니다. 보는 왼쪽에서 오른쪽으로, 기둥은 아래에서 위로 정의하면 부호가 교과서와 같아집니다. 부재 방향을 참고하세요.
  3. 매개변수가 빠지면 오류 대신 NaN이나 엉뚱한 값이 나옵니다. 단면에는 a, iy, k가 필요합니다. 재료에는 e가 필요하고, k가 아주 크지 않다면 g도 필요합니다. 재료 및 단면을 참고하세요.
  4. 절점이나 부재를 추가했거나 지점을 바꿨다면 다시 풀기 전에 solver.codeNumberGenerated = false로 설정하세요. 변경 후 다시 풀기를 참고하세요.
  5. 반력은 mathjs 행렬 또는 배열로 반환됩니다. 순서는 지점의 자유도를 지정한 순서입니다. 반력을 참고하세요.
  6. 메커니즘이라고 해서 항상 오류가 나지는 않습니다. 변위가 m 정도로 나오면 구조물이 자유롭게 움직일 수 있다는 뜻입니다. 해석이 실패할 때를 참고하세요.

다음 단계