Memulai

@edubeam/plot menggambar balok, portal atau rangka batang bidang beserta hasilnya sebagai SVG: batang, tumpuan, beban, reaksi, diagram N, V dan M, serta bentuk deformasi, persis seperti gambar-gambar di situs ini. Anda memberikan model yang sudah dihitung oleh @edubeam/fem, solver yang menjadi dasar EduBeam; pustaka ini sendiri yang menentukan tata letak, skala dan posisi setiap angka.

Para dosen memakainya untuk soal latihan dan ujian yang dibangkitkan dari sebuah seed (nilai awal pembangkit bilangan acak), untuk slide yang tersusun klik demi klik, dan untuk gambar catatan kuliah, baik di halaman web maupun sebagai file untuk LaTeX dan Word. Halaman Latihan soal dan Pembuat soal ujian di situs ini juga dibuat dengan pustaka ini.

Instalasi

Terminal
npm install @edubeam/plot @edubeam/fem vue

Vue 3.5 atau yang lebih baru dan solver adalah peer dependencies, sehingga aplikasi Anda hanya menyimpan satu salinan dari masing-masing. Paket ini hanya ESM, menyertakan tipenya sendiri dan tidak memerlukan stylesheet. Paket berjalan di Node 20.19 atau yang lebih baru; untuk menjalankan skrip TypeScript apa adanya dengan node script.ts, diperlukan Node 22.18 atau yang lebih baru.

Menggambar model yang sudah dihitung

Cukup dua file. File pertama, beams.ts, menyusun dan menghitung sebuah balok dengan @edubeam/fem. Isinya fungsi biasa, sehingga model yang sama dapat dipakai untuk halaman web, slide dan skrip:

beams.ts
import { DofID, LinearStaticSolver } from '@edubeam/fem'

/** Balok sederhana sepanjang `span` m dengan beban `q` kN/m, sudah dihitung. Solver bekerja dalam satuan SI. */
export const simpleBeam = (span: number, q: number): LinearStaticSolver => {
  const solver = new LinearStaticSolver()
  const { domain } = solver
  domain.createMaterial(1, { e: 210e9, g: 81e9 }) // baja, Pa
  domain.createCrossSection(1, { a: 28.5e-4, iy: 1943e-8, h: 0.2, k: 1e32 }) // IPE 200, kaku terhadap geser
  domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // sendi
  domain.createNode('B', [span, 0, 0], [DofID.Dz]) // rol
  domain.createBeam2D(1, ['A', 'B'], 1, 1)
  solver.loadCases[0].createBeamElementUniformEdgeLoad(1, [0, q * 1e3], true) // N/m, +z ke bawah
  solver.solve()
  return solver
}

File kedua, BeamFigure.vue, menyerahkan solver itu ke StructurePlot dan menentukan apa yang digambar:

BeamFigure.vue
<script setup lang="ts">
import { StructurePlot } from '@edubeam/plot'
import { simpleBeam } from './beams'

const beam = simpleBeam(6, 12)
</script>

<template>
  <StructurePlot :solver="beam" :layers="['members', 'supports', 'loads', 'reactions', 'M']" />
</template>

Itulah seluruh gambarnya: balok di atas tumpuannya, beban 12 kN/m, kedua reaksi sebesar 36 kN, dan momen lentur, kNm di tengah bentang, yang digambar di sisi tarik:

Hasil BeamFigure.vue: bentang 6 m dengan beban 12 kN/m54q = 12 kN/m3636
Hasil BeamFigure.vue: bentang 6 m dengan beban 12 kN/mBuka di EduBeam

Gambar mengisi lebar wadahnya dan menentukan tingginya sendiri. Teks, simbol dan tebal garis tetap berukuran sama dalam piksel, berapa pun ukuran strukturnya, sehingga gambar tetap terbaca di ponsel. Jika layers tidak diisi, gambar memilih sendiri hasil yang ditampilkan: M untuk balok dan portal, N untuk rangka batang. Semua lapisan tercantum di halaman StructurePlot; cara menyusun model dijelaskan di dokumentasi solver.

Saat model berubah

Gambar membaca solver yang diberikan kepadanya, tetapi tidak memantaunya. Jika ada yang berubah, hitung ulang dan berikan solver yang baru. computed melakukan persis hal itu:

LoadSlider.vue
<script setup lang="ts">
import { computed, ref } from 'vue'
import { StructurePlot } from '@edubeam/plot'
import { simpleBeam } from './beams'

const q = ref(12) // kN/m
const beam = computed(() => simpleBeam(6, q.value))
</script>

<template>
  <input v-model.number="q" type="range" min="1" max="30" />
  <StructurePlot :solver="beam" :layers="['members', 'supports', 'loads', 'reactions', 'M']" />
</template>

Balok seperti ini dihitung dalam sekitar satu milidetik, sehingga gambar mengikuti slider selagi digeser. Jika Anda mengubah solver di tempat, naikkan nilai prop revision, dan gambar akan membacanya lagi.

Menyimpan sebagai file

Untuk gambar di LaTeX, Word atau Inkscape, structureSvg menulis gambar yang sama sebagai file SVG mandiri dengan warna tetap. Fungsi ini tidak memerlukan Vue maupun browser, cukup Node. Simpan skrip berikut sebagai beam-svg.ts di samping beams.ts:

beam-svg.ts
import { writeFileSync } from 'node:fs'
import { modelFromSolver, structureSvg } from '@edubeam/plot'
import { simpleBeam } from './beams.ts'

const svg = structureSvg(modelFromSolver(simpleBeam(6, 12)), {
  layers: ['members', 'supports', 'loads', 'reactions', 'M'],
})
writeFileSync('beam.svg', svg)

Jalankan dengan node beam-svg.ts (Node 22.18 atau yang lebih baru; pada versi lama, npx tsx beam-svg.ts). Semua opsinya, serta cara memasukkan file ke LaTeX dan Word, ada di File SVG mandiri.

Gambar bertumpuk

DiagramStack membuat gambar yang ada di setiap buku ajar statika: balok lurus dengan bebannya, dan di bawahnya V(x), M(x) dan w(x) pada satu sumbu x yang sama. Dengan v-model:load-at, pembaca dapat menyeret beban terpusat sepanjang balok dan melihat diagram mengikutinya:

Vue
<DiagramStack v-model:load-at="at" :solver="solveWithLoadAt(at)" />

Contoh lengkapnya ada di halaman DiagramStack.

Dipakai di seluruh aplikasi

Untuk mendaftarkan kedua komponen secara global, alih-alih mengimpornya di setiap tempat pemakaian:

main.ts
import { createApp } from 'vue'
import { EduBeamPlot } from '@edubeam/plot'
import App from './App.vue'

createApp(App).use(EduBeamPlot).mount('#app') // <StructurePlot> dan <DiagramStack> tersedia di setiap template

Impor bernama membuat bundle lebih kecil: halaman yang hanya mengimpor StructurePlot tidak ikut membawa DiagramStack maupun plugin. Kedua komponen juga dapat dirender di server, di Nuxt atau VitePress: lihat Menyematkan.

Langkah selanjutnya