Memulai
@edubeam/fem adalah solver metode elemen hingga di balik EduBeam: setiap diagram, reaksi, dan lendutan yang ditampilkan aplikasi berasal darinya. Dengan pustaka ini Anda dapat menghitung balok, portal, dan rangka batang bidang dari kode Anda sendiri, di browser maupun di Node: membuat soal latihan beserta jawabannya, memeriksa tugas, menjalankan studi parametrik, atau memasang solver di balik sebuah halaman web.
Pustaka ini ditulis dalam TypeScript, sudah menyertakan tipenya sendiri, dan merupakan perangkat lunak bebas berlisensi GPL-3.0. Pustaka ini dibuat oleh Bořek Patzák dan dikembangkan bersama Jan Voříšek serta para kontributor.
Instalasi
npm install @edubeam/fem
Pustaka ini dapat dipakai dengan import maupun require, di browser dan di Node 18 atau yang lebih baru, dan hanya membawa satu dependensi, mathjs. Sampai versi 0.3.0 pustaka ini dipasang dari GitHub dengan nama ts-fem: jika Anda memakainya, ganti import Anda menjadi @edubeam/fem. Selain itu tidak ada yang berubah.
Untuk mencoba contoh di bawah dari folder kosong, jadikan folder itu proyek yang memakai import, lalu pasang pustakanya:
npm init -y
npm pkg set type=module
npm install @edubeam/fem
Tanpa "type": "module" di package.json contoh ini tetap berjalan, tetapi Node lebih dulu menampilkan peringatan.
Balok pertama Anda
Balok baja IPE 200 sepanjang 6 m di atas tumpuan sendi dan tumpuan rol, dengan beban merata 12 kN/m:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// Seluruhnya dalam satuan SI: m, N, Pa. Baja dan IPE 200.
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// Joint di [x, y, z] dalam meter, beserta DOF yang ditahan tumpuannya
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // sendi
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // rol
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 12 kN/m searah sumbu z lokal batang: ke bawah pada balok yang digambar dari kiri ke kanan
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // N·m di tengah bentang
console.log(beam.computeShearForceAt(lc, 0)) // N di A
console.log(beam.computeLocalDefl(lc, 2).w[1]) // m di tengah bentang
Simpan sebagai beam.ts dan jalankan node beam.ts: Node 22.18 dan yang lebih baru menjalankan TypeScript apa adanya. File ini tidak memiliki anotasi tipe, jadi pada Node yang lebih lama cukup simpan sebagai beam.mjs. Program menampilkan:
54000
36000
0.04990940552616746
Itulah nilai dari buku teks, kNm dan kN. Berikut balok yang sama, dihitung di browser Anda oleh solver yang sama:
Lendutannya, 49,91 mm, lebih besar 0,28 mm daripada nilai Euler–Bernoulli mm. Ini bukan kesalahan: batangnya adalah balok Timoshenko, dan 0,28 mm itu adalah , deformasi geser balok ini. Beri k nilai yang sangat besar, misalnya 1e32, dan selisih itu hilang: lihat Deformasi geser.
Apa yang dilakukan kode ini
Buat solver
new LinearStaticSolver() sudah dilengkapi domain kosong, yang menampung model, dan satu kasus beban, solver.loadCases[0].
Deskripsikan model
Material dan penampang, joint beserta tumpuannya, lalu batang di antara joint. Setiap objek memiliki label, berupa string atau angka, yang dipakai bagian model lainnya untuk merujuknya. Lihat Joint dan tumpuan, Material dan penampang, serta Batang dan sendi.
Bebani model
Setiap beban termasuk dalam suatu kasus beban: gaya di joint, beban di sepanjang batang, suhu, dan penurunan tumpuan. Lihat Beban joint dan beban batang.
Hitung
solver.solve() merakit dan menyelesaikan semua kasus beban. Lihat Perhitungan.
Baca hasilnya
Gaya dalam di titik mana pun pada batang, lendutan, gaya ujung, perpindahan joint, dan reaksi. Lihat Membaca hasil, dan Menggambar hasil untuk diagramnya.
Satuan dan tanda secara singkat
Masukan dalam satuan SI, hasil pun dalam SI. Model terletak di bidang x–z dengan sumbu z mengarah ke bawah, jadi fz positif mendorong ke bawah dan puncak kolom setinggi 4 m berada di . Posisi pada batang dinyatakan dalam meter dari joint pertamanya. Momen positif menarik serat bawah. Daftar lengkapnya ada di Satuan dan tanda.
Enam hal yang sering menjebak
- Sumbu z mengarah ke bawah. Beban gravitasi bernilai positif, dan apa pun yang berada di atas tumpuan memiliki z negatif. Lihat Sumbu.
- Arah batang menentukan tanda M dan w. Definisikan balok dari kiri ke kanan dan kolom dari bawah ke atas, maka tandanya sama seperti di buku teks. Lihat Arah batang.
- Parameter yang terlupa menghasilkan
NaNatau angka yang tidak masuk akal, bukan pesan kesalahan. Penampang memerlukana,iy, dank; material memerlukane, dan jugagkecualiksangat besar. Lihat Material dan penampang. - Setelah menambah joint atau batang, atau mengubah tumpuan, atur
solver.codeNumberGenerated = falsesebelum menghitung lagi. Lihat Menghitung ulang setelah perubahan. - Reaksi dikembalikan sebagai matriks mathjs atau sebagai array, dengan urutan DOF tumpuan seperti saat diberikan. Lihat Reaksi.
- Mekanisme tidak selalu memunculkan exception. Perpindahan sebesar m berarti struktur dapat bergerak bebas. Lihat Jika perhitungan gagal.
Langkah selanjutnya
Contoh program
Program lengkap yang sudah diperiksa: balok, portal, rangka batang, lembar soal beserta kunci jawabannya, dan server HTTP kecil.
Gambar hasilnya
Serahkan model yang sudah dihitung ke @edubeam/plot dan dapatkan diagramnya sebagai SVG, di Vue atau dari skrip Node.
Referensi API
Setiap kelas, metode, dan argumen, lengkap dengan satuan dan nilai yang dikembalikan.
Teorinya
Elemen balok, matriks kekakuan dan matriks transformasinya, di manual teori EduBeam.