Початок роботи

@edubeam/plot малює плоску балку, раму чи ферму разом із результатами у форматі SVG: стрижні, опори, навантаження, реакції, епюри N, V і M та деформовану схему — саме так, як виглядають рисунки на цьому сайті. Ви передаєте їй модель, розраховану бібліотекою @edubeam/fem, тим самим розв’язувачем, на якому працює EduBeam, а бібліотека сама вибирає компонування, масштаб і місце для кожного числа.

Викладачі використовують її для вправ і контрольних робіт, які генеруються із зерна (початкового значення генератора випадкових чисел), для слайдів, на яких рисунок доповнюється з кожним клацанням, і для рисунків у конспектах — на вебсторінці або у файлах для LaTeX і Word. На ній побудовано й сторінки Задачі з будівельної механіки та генератор контрольних робіт на цьому сайті.

Встановлення

Terminal
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. Це звичайна функція, тож одну й ту саму модель можна використати на сторінці, у слайді та в скрипті:

beams.ts
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 і вказує, що малювати:

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>

Ось і весь рисунок: балка на опорах, навантаження 12 kN/m, дві реакції по 36 kN та епюра згинальних моментів зі значенням kNm посередині прольоту, побудована з боку розтягнутих волокон:

Що малює BeamFigure.vue: проліт 6 m під навантаженням 12 kN/m54q = 12 kN/m3636
Що малює BeamFigure.vue: проліт 6 m під навантаженням 12 kN/mВідкрити в EduBeam

Рисунок займає всю ширину контейнера, а висоту визначає сам. Текст, символи й товщина ліній зберігають свій розмір у пікселях незалежно від розмірів конструкції, тому рисунок добре читається й на телефоні. Якщо не задати layers, рисунок сам вибере, який результат показати: M для балок і рам, N для ферми. Усі шари описано на сторінці StructurePlot, а як створювати моделі, пояснює документація розв’язувача.

Коли модель змінюється

Рисунок читає переданий йому розв’язувач, але не стежить за ним. Коли щось змінюється, розрахуйте модель знову й передайте новий розв’язувач. Саме це й робить computed:

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>

Таку балку розв’язувач розраховує приблизно за мілісекунду, тому рисунок встигає за повзунком, поки той рухається. Змінили розв’язувач на місці, без створення нового? Збільште значення пропа revision, і рисунок прочитає його знову.

Збереження у файл

Для рисунка в LaTeX, Word чи Inkscape функція structureSvg записує той самий рисунок як окремий файл SVG зі звичайними кольорами. Їй не потрібні ні Vue, ні браузер, лише Node. Збережіть цей скрипт як beam-svg.ts поруч із 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)

Запустіть його командою 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 читач може перетягувати зосереджену силу вздовж балки й спостерігати, як змінюються епюри:

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

Повний приклад наведено на сторінці DiagramStack.

Використання в усьому застосунку

Щоб зареєструвати обидва компоненти глобально, а не імпортувати їх там, де вони потрібні:

main.ts
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: див. Вбудовування.

Що далі