Початок роботи
@edubeam/plot малює плоску балку, раму чи ферму разом із результатами у форматі SVG: стрижні, опори, навантаження, реакції, епюри N, V і M та деформовану схему — саме так, як виглядають рисунки на цьому сайті. Ви передаєте їй модель, розраховану бібліотекою @edubeam/fem, тим самим розв’язувачем, на якому працює EduBeam, а бібліотека сама вибирає компонування, масштаб і місце для кожного числа.
Викладачі використовують її для вправ і контрольних робіт, які генеруються із зерна (початкового значення генератора випадкових чисел), для слайдів, на яких рисунок доповнюється з кожним клацанням, і для рисунків у конспектах — на вебсторінці або у файлах для LaTeX і Word. На ній побудовано й сторінки Задачі з будівельної механіки та генератор контрольних робіт на цьому сайті.
Встановлення
npm install @edubeam/plot @edubeam/fem vue
Vue (від версії 3.5) і розв’язувач є peer dependencies, тож у вашому застосунку буде лише одна копія кожного з них. Пакет підтримує тільки ESM, містить власні типи й не потребує жодного файлу стилів. Він працює в Node 20.19 і новіших версіях; щоб запускати скрипт на TypeScript без компіляції, командою node script.ts, потрібна версія Node 22.18 або новіша.
Рисунок розрахованої моделі
Знадобляться два файли. Перший, beams.ts, створює й розраховує балку за допомогою @edubeam/fem. Це звичайна функція, тож одну й ту саму модель можна використати на сторінці, у слайді та в скрипті:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
/** Розрахована шарнірно оперта балка прольотом `span` m під навантаженням `q` kN/m. Розв’язувач працює в одиницях СІ. */
export const simpleBeam = (span: number, q: number): LinearStaticSolver => {
const solver = new LinearStaticSolver()
const { domain } = solver
domain.createMaterial(1, { e: 210e9, g: 81e9 }) // сталь, Pa
domain.createCrossSection(1, { a: 28.5e-4, iy: 1943e-8, h: 0.2, k: 1e32 }) // IPE 200, без деформацій зсуву
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // шарнірно-нерухома опора
domain.createNode('B', [span, 0, 0], [DofID.Dz]) // шарнірно-рухома опора
domain.createBeam2D(1, ['A', 'B'], 1, 1)
solver.loadCases[0].createBeamElementUniformEdgeLoad(1, [0, q * 1e3], true) // N/m, +z спрямована вниз
solver.solve()
return solver
}
Другий, BeamFigure.vue, передає розв’язувач компоненту StructurePlot і вказує, що малювати:
<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>
Ось і весь рисунок: балка на опорах, навантаження 12 kN/m, дві реакції по 36 kN та епюра згинальних моментів зі значенням kNm посередині прольоту, побудована з боку розтягнутих волокон:
Рисунок займає всю ширину контейнера, а висоту визначає сам. Текст, символи й товщина ліній зберігають свій розмір у пікселях незалежно від розмірів конструкції, тому рисунок добре читається й на телефоні. Якщо не задати layers, рисунок сам вибере, який результат показати: M для балок і рам, N для ферми. Усі шари описано на сторінці StructurePlot, а як створювати моделі, пояснює документація розв’язувача.
Коли модель змінюється
Рисунок читає переданий йому розв’язувач, але не стежить за ним. Коли щось змінюється, розрахуйте модель знову й передайте новий розв’язувач. Саме це й робить computed:
<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>
Таку балку розв’язувач розраховує приблизно за мілісекунду, тому рисунок встигає за повзунком, поки той рухається. Змінили розв’язувач на місці, без створення нового? Збільште значення пропа revision, і рисунок прочитає його знову.
Збереження у файл
Для рисунка в LaTeX, Word чи Inkscape функція structureSvg записує той самий рисунок як окремий файл SVG зі звичайними кольорами. Їй не потрібні ні Vue, ні браузер, лише Node. Збережіть цей скрипт як beam-svg.ts поруч із beams.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)
Запустіть його командою node beam-svg.ts (Node 22.18 або новіша версія; у старіших версіях npx tsx beam-svg.ts). Параметри та те, як вставити файл у LaTeX і Word, описано в розділі Окремий файл SVG.
Епюри під балкою
DiagramStack малює рисунок, знайомий з кожного підручника будівельної механіки: пряму балку з навантаженням, а під нею на спільній осі x епюри V(x), M(x) і w(x). З v-model:load-at читач може перетягувати зосереджену силу вздовж балки й спостерігати, як змінюються епюри:
<DiagramStack v-model:load-at="at" :solver="solveWithLoadAt(at)" />
Повний приклад наведено на сторінці DiagramStack.
Використання в усьому застосунку
Щоб зареєструвати обидва компоненти глобально, а не імпортувати їх там, де вони потрібні:
import { createApp } from 'vue'
import { EduBeamPlot } from '@edubeam/plot'
import App from './App.vue'
createApp(App).use(EduBeamPlot).mount('#app') // <StructurePlot> і <DiagramStack> у кожному шаблоні
Іменовані імпорти зменшують бандл: сторінка, яка імпортує лише StructurePlot, не отримує ні DiagramStack, ні плагіна. Обидва компоненти рендеряться й на сервері, у Nuxt або VitePress: див. Вбудовування.
Що далі
Вправи та контрольні роботи
Для кожного студента своя вправа із зерна, разом із відповідями, надрукована або збережена для LaTeX.
Слайди та конспекти
Рисунки, що доповнюються з кожним клацанням у Slidev, Vue чи Beamer, і ті самі рисунки для конспектів.
StructurePlot
Шари, розмірні лінії, мініатюри, розмір рисунка, одиниці та зчитування значень курсором.
DiagramStack
Балка над своїми епюрами V, M і w із силою, яку читач може перетягувати.