Tham chiếu API

Những gì @edubeam/fem 0.3 export, nhóm theo mục đích sử dụng. Mọi đơn vị đều theo SI: m, N, N·m, N/m, Pa, K và rad. Nhãn (LabelType) là string | number, lưu dưới dạng chuỗi. Các phương thức không có trong danh sách này là phương thức nội bộ: chúng là public trong TypeScript chỉ vì các lớp của chính bộ giải cần gọi đến chúng.

Các export

ExportLoạiMục
LinearStaticSolverlớpPhân tích
Solverlớp trừu tượngPhân tích
DomainlớpDomain
NodelớpNode
Beam2D, ElementlớpPhần tử
Material, CrossSectionlớpVật liệu và tiết diện
LoadCaselớpTải trọng
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadlớpTải trọng
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterskiểu

Phân tích

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
Thành viênKiểuMô tả
domainDomainMô hình
loadCasesLoadCase[]Ban đầu có một trường hợp tải, 'DefaultLC'. Thêm trường hợp bằng new LoadCase(label, solver.domain): xem Trường hợp tải.
solve()voidĐánh số phương trình nếu cần, ghép và giải mọi trường hợp tải. Có thể ném lỗi khi gặp hệ biến hình, nhưng không phải lúc nào cũng vậy. Không in gì từ bản 0.3.1; bản 0.3.0 ghi ra thời gian giải.
codeNumberGeneratedbooleanĐặt về false sau khi thêm hoặc xóa nút hay thanh, hoặc đổi gối tựa: lý do
neq, pneqnumberSố bậc tự do không bị chặn và số bậc tự do bị chặn, sau khi giải
kmathjs MatrixMa trận độ cứng tổng thể đã ghép, sau khi giải
getNodeDofIDs(label)number[]Các bậc tự do của một nút, sau khi giải

EigenValueDynamicSolver có trong mã nguồn nhưng không được export.

Domain

solver.domain chứa mô hình trong bốn Map có khóa là nhãn dạng chuỗi: nodes, elements, materials, crossSections. Không có phương thức xóa: domain.nodes.delete(label) và domain.elements.delete(label) xóa một nút hoặc một thanh, sau đó cần đánh số lại.

Phương thứcTrả vềMô tả
createNode(label, coords?, bcs?)Nodecoords là [x, y, z] tính bằng m (mặc định [0, 0, 0]), bcs là các DofID bị chặn (mặc định không có)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes là [first, second], hinges là [atFirst, atSecond] (mặc định [false, false])
createMaterial(label, params?)MaterialXem Vật liệu và tiết diện
createCrossSection(label, params?)CrossSectionXem Vật liệu và tiết diện
getNode(label), getElement(label), getMaterial(label), getCS(label)đối tượng tương ứngNém RangeError khi nhãn không tồn tại. getElement có kiểu Element: viết as Beam2D để đọc kết quả.

Tạo đối tượng với một nhãn đã dùng sẽ thay thế đối tượng cũ.

Node

Thành viênKiểuMô tả
labelstring
coordsnumber[][x, y, z], m. Đổi giá trị này để di chuyển nút.
bcsSet<DofID>Các bậc tự do bị chặn. Thay tập này để đổi gối tựa.
lcsnumber[][] | undefinedHệ trục đã xoay của nút, nếu có
updateLcs({ locx, locy }?)voidXoay hệ trục của nút: locx là trục x của nút theo các thành phần tổng thể, locy là [0, 1, 0]. Không có đối số thì đưa hệ trục về như cũ.
hasLcs()booleanHệ trục có bị xoay hay không
getUnknowns(lc, dofs)Matrix, hoặc number khi chỉ có một bậc tự doChuyển vị (m) và góc xoay (rad), theo hệ trục của nút
getReactions(lc, global?){ dofs, values }Phản lực tại các bậc tự do bị chặn, theo thứ tự của bcs: N, N·m. values là Matrix của mathjs khi có nhiều phản lực, mảng một phần tử khi chỉ có một, [] với nút tự do. Với global là true trên nút đã xoay: cả ba bậc tự do theo hệ trục tổng thể, dofs là [0, 2, 4], values là mảng có 0 ở những chỗ không bị chặn. Cách đọc.

Phần tử

Beam2D

Dầm Timoshenko hai nút trong mặt phẳng x–z, mỗi nút có ba bậc tự do (Dx, Dz, Ry). x tính bằng mét kể từ nút thứ nhất; n là số đoạn chia, cho n + 1 điểm.

Thành viênTrả vềMô tả
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Giải phóng mô men tại nút thứ nhất và nút thứ hai
computeNormalForceAt(lc, x)numberN, kéo là dương
computeShearForceAt(lc, x)numberV, dương khi M tăng dọc theo trục x địa phương
computeBendingMomentAt(lc, x)numberM, dương khi căng thớ phía +z địa phương
computeNormalForce(lc, n){ x, N }N tại n + 1 điểm
computeShearForce(lc, n){ x, V }V tại n + 1 điểm
computeBendingMoment(lc, n){ x, M }M tại n + 1 điểm
computeLocalDefl(lc, n){ u, w }Chuyển vị dọc và vuông góc với thanh, trong hệ trục địa phương, m
computeGlobalDefl(lc, n){ u, w }Như trên, theo x và z tổng thể
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], lực mà các nút tác dụng lên thanh, trong hệ trục địa phương
computeEndDisplacement(lc)MatrixChuyển vị đầu thanh trong hệ trục địa phương, kể cả góc xoay tại khớp
computeGeo(){ l, dx, dz }Chiều dài và các hình chiếu, m
computeT()MatrixMa trận biến đổi 6 × 6, từ hệ trục tổng thể sang địa phương
computeLocalStiffnessMtrx(){ answer }answer: ma trận độ cứng địa phương 6 × 6, đã ngưng tụ bậc tự do tại khớp
computeStiffness()MatrixMa trận độ cứng tổng thể 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

Tại vị trí lực tập trung, các phương thức …At trả về giá trị ngay sau lực. Element là lớp cơ sở trừu tượng của Beam2D; đó là kiểu mà domain.elements và getElement dùng.

Vật liệu và tiết diện

MaterialParametersĐơn vịMặc địnhDùng cho
ePa1độ cứng
gPa1độ cứng chống cắt
alpha1/K1tải nhiệt độ
dkg/m³1không dùng trong phân tích tĩnh
CrossSectionParametersĐơn vịMặc địnhDùng cho
am²không có, bắt buộcđộ cứng dọc trục và độ cứng chống cắt
iym⁴không có, bắt buộcđộ cứng chống uốn
k–không có, bắt buộcđộ cứng chống cắt ; 1e32 để bỏ qua biến dạng trượt
hmkhông cóchênh lệch nhiệt độ (thiếu thì ra NaN)
iz, dyz, jm⁴không cóBeam2D không dùng

Tham số vật liệu bị thiếu nhận giá trị 1, không phải giá trị điển hình; thiếu a, iy hoặc k thì mọi kết quả là NaN. Cả hai trường hợp đều không ném lỗi. Cả hai lớp đều có phương thức change(params) để đặt các tham số được truyền vào, và lưu các tham số thành thuộc tính cùng tên.

Tải trọng

LoadCase

Phương thứcTrả vềGiá trị
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (mặc định false): true nghĩa là theo hệ trục đã xoay của nút
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m trên toàn bộ thanh
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m tại nút thứ nhất và nút thứ hai, tuyến tính ở giữa
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, cách nút thứ nhất a m
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: trọng tâm, thớ dưới, thớ trên
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } trên các bậc tự do bị chặn, theo hệ trục của nút; bị bỏ qua trên bậc tự do không bị chặn

Với tải trên thanh, lcs là true nghĩa là hệ trục địa phương (x dọc thanh, z vuông góc với thanh), false là hệ trục tổng thể. Tải phân bố tính trên mỗi mét chiều dài thanh. Trang Tải trọng có ví dụ.

Thành viênKiểuMô tả
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Tải trên thanh và tải nhiệt độ
prescribedBCPrescribedDisplacement[]
solvedbooleantrue sau khi giải thành công
getElementLoadsOnElement(el)BeamElementLoad[]Các tải trọng trên một thanh

Các đối tượng tải trọng giữ giá trị trong những thuộc tính public mà bạn có thể đổi trước khi giải lại: values (và lcs) trên NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad và BeamTemperatureLoad; startValues và endValues trên BeamElementTrapezoidalEdgeLoad; prescribedValues trên PrescribedDisplacement. Mỗi đối tượng có một target, là nhãn của nút hoặc thanh mà tải tác dụng lên.

DofID

TênGiá trịBeam2D dùng
Dx0có
Dy1không
Dz2có
Rx3không
Ry4có
Rz5không

Kết quả

Kết quả được đọc từ Beam2D (nội lực, độ võng, nội lực đầu phần tử) và từ Node (chuyển vị, phản lực), luôn cho một LoadCase cụ thể, sau solve(): xem hai bảng ở trên, và trang Đọc kết quả để có ví dụ và quy ước dấu. Tóm tắt:

Cần lấyLệnh gọi
Phản lực, N và N·mnode.getReactions(lc)
Chuyển vị, m, và góc xoay, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V hoặc M tại một điểm, N và N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V hoặc M dọc theo thanhbeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Đường đàn hồi, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Nội lực đầu phần tử, N và N·mbeam.computeEndForces(lc)
Hình vẽ của tất cả các kết quả trênStructurePlot hoặc structureSvg từ @edubeam/plot