Referensi API

Semua yang diekspor @edubeam/fem 0.3, dikelompokkan menurut kegunaannya. Seluruhnya dalam satuan SI: m, N, N·m, N/m, Pa, K, dan rad. Label (LabelType) bertipe string | number dan disimpan sebagai string. Metode yang tidak tercantum di sini bersifat internal: metode itu bersifat public di TypeScript hanya karena dipanggil oleh kelas-kelas solver sendiri.

Ekspor

EksporJenisBagian
LinearStaticSolverkelasAnalisis
Solverkelas abstrakAnalisis
DomainkelasDomain
NodekelasNode
Beam2D, ElementkelasElemen
Material, CrossSectionkelasMaterial dan penampang
LoadCasekelasBeban
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadkelasBeban
DofIDenumDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParameterstipe

Analisis

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
Properti / metodeTipeKeterangan
domainDomainModelnya
loadCasesLoadCase[]Dimulai dengan satu kasus beban, 'DefaultLC'. Tambahkan yang lain dengan new LoadCase(label, solver.domain): Kasus beban.
solve()voidMenomori persamaan jika perlu, merakit dan menyelesaikan semua kasus beban. Dapat memunculkan exception pada mekanisme, tetapi tidak selalu. Sejak 0.3.1 tidak menulis apa pun ke konsol; 0.3.0 mencetak waktu hitungnya.
codeNumberGeneratedbooleanAtur ke false setelah menambah atau menghapus joint atau batang, atau mengubah tumpuan: alasannya
neq, pneqnumberJumlah DOF bebas dan DOF yang ditahan, setelah perhitungan
kMatrix mathjsMatriks kekakuan global yang sudah dirakit, setelah perhitungan
getNodeDofIDs(label)number[]DOF yang dimiliki sebuah joint, setelah perhitungan

EigenValueDynamicSolver ada di kode sumber, tetapi tidak diekspor.

Domain

solver.domain menyimpan model dalam empat Map dengan kunci berupa label sebagai string: nodes, elements, materials, crossSections. Tidak ada metode untuk menghapus: domain.nodes.delete(label) dan domain.elements.delete(label) menghapus joint atau batang, lalu diikuti penomoran ulang.

MetodeMengembalikanKeterangan
createNode(label, coords?, bcs?)Nodecoords [x, y, z] dalam m (bawaan [0, 0, 0]), bcs daftar DofID yang ditahan (bawaan tidak ada)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes [first, second], hinges [atFirst, atSecond] (bawaan [false, false])
createMaterial(label, params?)MaterialLihat Material dan penampang
createCrossSection(label, params?)CrossSectionLihat Material dan penampang
getNode(label), getElement(label), getMaterial(label), getCS(label)objeknyaMemunculkan RangeError untuk label yang tidak dikenal. getElement bertipe Element: tulis as Beam2D untuk membaca hasil.

Membuat objek dengan label yang sudah dipakai akan menggantikan objek yang lama.

Node

Properti / metodeTipeKeterangan
labelstring
coordsnumber[][x, y, z], m. Ubah untuk memindahkan joint.
bcsSet<DofID>DOF yang ditahan. Ganti untuk mengubah tumpuan.
lcsnumber[][] | undefinedSumbu joint yang diputar, jika ada
updateLcs({ locx, locy }?)voidMemutar sumbu joint: locx sumbu x-nya dalam komponen global, locy [0, 1, 0]. Tanpa argumen, sumbunya dikembalikan ke semula.
hasLcs()booleanApakah sumbunya diputar
getUnknowns(lc, dofs)Matrix, atau number untuk satu DOFPerpindahan (m) dan rotasi (rad), dalam sumbu joint
getReactions(lc, global?){ dofs, values }Reaksi pada DOF yang ditahan, dalam urutan bcs: N, N·m. values berupa Matrix mathjs jika lebih dari satu, array berisi satu elemen jika hanya satu, [] untuk joint bebas. Dengan global true pada joint yang diputar: ketiga DOF dalam sumbu global, dofs [0, 2, 4], values berupa array dengan 0 di DOF yang tidak ditahan. Cara membacanya.

Elemen

Beam2D

Balok Timoshenko dengan dua joint di bidang x–z, tiga DOF per joint (Dx, Dz, Ry). x dinyatakan dalam meter dari joint pertama; n adalah jumlah segmen, yang menghasilkan n + 1 titik.

Properti / metodeMengembalikanKeterangan
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Pelepasan momen di joint pertama dan kedua
computeNormalForceAt(lc, x)numberN, tarik positif
computeShearForceAt(lc, x)numberV, positif jika M bertambah sepanjang x lokal
computeBendingMomentAt(lc, x)numberM, positif jika sisi +z lokal tertarik
computeNormalForce(lc, n){ x, N }N di n + 1 titik
computeShearForce(lc, n){ x, V }V di n + 1 titik
computeBendingMoment(lc, n){ x, M }M di n + 1 titik
computeLocalDefl(lc, n){ u, w }Perpindahan searah dan tegak lurus batang, sumbu lokal, m
computeGlobalDefl(lc, n){ u, w }Sama, dalam x dan z global
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21], gaya yang diberikan joint pada batang, sumbu lokal
computeEndDisplacement(lc)MatrixPerpindahan ujung dalam sumbu lokal, termasuk rotasi di sendi
computeGeo(){ l, dx, dz }Panjang dan proyeksinya, m
computeT()MatrixMatriks transformasi 6 × 6, dari global ke lokal
computeLocalStiffnessMtrx(){ answer }answer: matriks kekakuan lokal 6 × 6, sendi sudah dikondensasi
computeStiffness()MatrixMatriks kekakuan global 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

Tepat di titik beban terpusat, metode …At mengembalikan nilai sesaat sesudahnya. Element adalah kelas dasar abstrak dari Beam2D; tipe inilah yang dipakai domain.elements dan getElement.

Material dan penampang

MaterialParametersSatuanBawaanDipakai untuk
ePa1kekakuan
gPa1kekakuan geser
alpha1/K1beban suhu
dkg/m³1tidak dipakai dalam statika
CrossSectionParametersSatuanBawaanDipakai untuk
am²tidak ada, wajibkekakuan aksial dan kekakuan geser
iym⁴tidak ada, wajibkekakuan lentur
k–tidak ada, wajibkekakuan geser ; 1e32 untuk meniadakannya
hmtidak adaselisih (gradien) suhu (NaN tanpa parameter ini)
iz, dyz, jm⁴tidak adatidak dipakai oleh Beam2D

Parameter material yang tidak diisi bernilai 1, bukan nilai yang lazim; a, iy, atau k yang tidak diisi membuat setiap hasil menjadi NaN. Dalam kedua kasus tidak muncul exception. Kedua kelas memiliki metode change(params) yang mengatur parameter yang diberikan, dan menyimpannya sebagai properti dengan nama yang sama.

Beban

LoadCase

MetodeMengembalikanNilai
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; lcs (bawaan false) true: dalam sumbu joint yang diputar
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadN/m di sepanjang seluruh batang
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadN/m di joint pertama dan kedua, linear di antaranya
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadN, N, N·m, sejauh a m dari joint pertama
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadK: titik berat, serat bawah, serat atas
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } pada DOF yang ditahan, dalam sumbu joint; diabaikan pada DOF bebas

Untuk beban batang, lcs true berarti sumbu lokal (x sepanjang batang, z tegak lurus batang), false berarti sumbu global. Beban garis dinyatakan per meter panjang batang. Contohnya ada di Beban joint dan beban batang.

Properti / metodeTipeKeterangan
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Beban batang dan beban suhu
prescribedBCPrescribedDisplacement[]
solvedbooleantrue setelah perhitungan berhasil
getElementLoadsOnElement(el)BeamElementLoad[]Beban pada satu batang

Objek beban menyimpan nilainya dalam properti public, yang dapat Anda ubah sebelum menghitung lagi: values (dan lcs) pada NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad, dan BeamTemperatureLoad; startValues dan endValues pada BeamElementTrapezoidalEdgeLoad; prescribedValues pada PrescribedDisplacement. Masing-masing memiliki target, yaitu label objek tempat beban bekerja.

DofID

NamaNilaiDipakai oleh Beam2D
Dx0ya
Dy1tidak
Dz2ya
Rx3tidak
Ry4ya
Rz5tidak

Hasil

Hasil dibaca dari Beam2D (gaya dalam, lendutan, gaya ujung) dan dari Node (perpindahan, reaksi), selalu untuk LoadCase tertentu, setelah solve(): lihat kedua tabel di atas, dan Membaca hasil untuk contoh dan tandanya. Ringkasnya:

Untuk mendapatkanPanggilan
Reaksi, N dan N·mnode.getReactions(lc)
Perpindahan, m, dan rotasi, radnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V, atau M di satu titik, N dan N·mbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V, atau M di sepanjang batangbeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Bentuk deformasi, mbeam.computeLocalDefl(lc, n), computeGlobalDefl
Gaya ujung, N dan N·mbeam.computeEndForces(lc)
Gambar semua hasil ituStructurePlot atau structureSvg dari @edubeam/plot