Erste Schritte
Die Zeichenbibliothek @edubeam/plot stellt einen ebenen Träger, einen Rahmen oder ein Fachwerk samt Ergebnissen als SVG dar: Stäbe, Lager, Lasten, Auflagerreaktionen, die Verläufe von N, V und M und die Verformungsfigur, genau so, wie die Abbildungen auf dieser Website aussehen. Sie übergeben ein Modell, das mit @edubeam/fem berechnet wurde, dem Solver hinter EduBeam; Anordnung, Maßstab und die Position jeder Zahl ermittelt die Bibliothek selbst.
Lehrende erstellen damit Übungsaufgaben und Klausuren, die aus einem Seed (Startwert des Zufallsgenerators) erzeugt werden, Folien, auf denen die Abbildung Klick für Klick wächst, und Abbildungen für das Skript, auf einer Webseite oder als Dateien für LaTeX und Word. Auch die Übungsaufgaben und der Klausurgenerator dieser Website beruhen auf ihr.
Installation
npm install @edubeam/plot @edubeam/fem vue
Vue ab Version 3.5 und der Solver sind Peer Dependencies, Ihre Anwendung enthält also von beiden nur eine Kopie. Das Paket ist reines ESM, bringt eigene Typen mit und braucht kein Stylesheet. Es läuft ab Node 20.19; um ein in TypeScript geschriebenes Skript direkt mit node script.ts auszuführen, brauchen Sie Node 22.18 oder neuer.
Ein berechnetes Modell zeichnen
Sie brauchen zwei Dateien. Die erste, beams.ts, erstellt einen Träger mit @edubeam/fem und berechnet ihn. Sie enthält nur eine gewöhnliche Funktion, sodass dasselbe Modell einer Seite, einer Folie und einem Skript dienen kann:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
/** Ein Einfeldträger, `span` m lang, unter `q` kN/m: berechnet. Der Solver rechnet in SI-Einheiten. */
export const simpleBeam = (span: number, q: number): LinearStaticSolver => {
const solver = new LinearStaticSolver()
const { domain } = solver
domain.createMaterial(1, { e: 210e9, g: 81e9 }) // Stahl, Pa
domain.createCrossSection(1, { a: 28.5e-4, iy: 1943e-8, h: 0.2, k: 1e32 }) // IPE 200, schubstarr
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // Festlager
domain.createNode('B', [span, 0, 0], [DofID.Dz]) // Loslager
domain.createBeam2D(1, ['A', 'B'], 1, 1)
solver.loadCases[0].createBeamElementUniformEdgeLoad(1, [0, q * 1e3], true) // N/m, +z zeigt nach unten
solver.solve()
return solver
}
Die zweite, BeamFigure.vue, übergibt den Solver an StructurePlot und legt fest, was gezeichnet wird:
<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>
Das ist schon die ganze Abbildung: der Träger auf seinen Lagern, die Last von 12 kN/m, die beiden Auflagerkräfte von je 36 kN und das Biegemoment, in Feldmitte kNm, auf der Zugseite angetragen:
Die Grafik füllt die Breite ihres Containers und bestimmt ihre Höhe selbst. Text, Symbole und Linienstärken behalten ihre Größe in Pixeln, unabhängig von der Größe des Tragwerks, sodass eine Abbildung auch auf dem Smartphone lesbar bleibt. Lassen Sie layers weg, wählt die Grafik das Ergebnis selbst: M für Träger und Rahmen, N für ein Fachwerk. Alle Ebenen sind bei StructurePlot aufgeführt; wie Sie Modelle erstellen, beschreibt die Solver-Dokumentation.
Wenn sich das Modell ändert
Eine Grafik liest den Solver, den sie erhält, beobachtet ihn aber nicht. Ändert sich etwas, berechnen Sie neu und übergeben den neuen Solver. Genau das leistet ein 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>
Ein solcher Träger ist in etwa einer Millisekunde berechnet, die Abbildung folgt dem Schieberegler also, während er sich bewegt. Haben Sie stattdessen einen vorhandenen Solver direkt verändert? Erhöhen Sie die Prop revision, dann liest die Grafik ihn erneut.
Als Datei speichern
Für eine Abbildung in LaTeX, Word oder Inkscape schreibt structureSvg dieselbe Zeichnung als eigenständige SVG-Datei mit festen Farben. Dafür brauchen Sie weder Vue noch einen Browser, nur Node. Speichern Sie dieses Skript als beam-svg.ts neben 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)
Führen Sie es mit node beam-svg.ts aus (ab Node 22.18; in älteren Versionen mit npx tsx beam-svg.ts). Die Optionen und wie Sie die Datei in LaTeX und Word einbinden, stehen unter Eine eigenständige SVG-Datei.
Verläufe untereinander
DiagramStack zeichnet die Abbildung, die in jedem Statiklehrbuch steht: einen geraden Träger mit seinen Lasten und darunter, auf einer gemeinsamen x-Achse, seine Verläufe V(x), M(x) und w(x). Mit v-model:load-at können Lesende eine Einzellast am Träger entlangziehen und zusehen, wie die Verläufe folgen:
<DiagramStack v-model:load-at="at" :solver="solveWithLoadAt(at)" />
Das vollständige Beispiel finden Sie unter DiagramStack.
Überall verwenden
So registrieren Sie beide Komponenten global, statt sie dort zu importieren, wo Sie sie verwenden:
import { createApp } from 'vue'
import { EduBeamPlot } from '@edubeam/plot'
import App from './App.vue'
createApp(App).use(EduBeamPlot).mount('#app') // <StructurePlot> und <DiagramStack> in jedem Template
Benannte Importe halten das Bundle kleiner: Eine Seite, die nur StructurePlot importiert, bekommt weder DiagramStack noch das Plugin. Beide Komponenten lassen sich auch auf dem Server rendern, in Nuxt oder VitePress: siehe Einbinden.
Wie geht es weiter?
Übungsaufgaben und Klausuren
Für alle Studierenden eine eigene Aufgabe aus einem Seed, mit Lösungsblatt, gedruckt oder als Datei für LaTeX.
Folien und Skripte
Abbildungen, die Klick für Klick wachsen, in Slidev, Vue oder Beamer, und dieselben Abbildungen für das Skript.
StructurePlot
Ebenen, Bemaßung, Vorschaubilder, Größen, Einheiten und das Ablesen von Werten mit dem Zeiger.
DiagramStack
Ein Träger über seinen Verläufen V, M und w, mit einer Last, die Lesende verschieben können.