Funktionen

Alles, was die Komponenten zeichnen, stammt aus reinen Funktionen ohne Vue. Sie schreiben eine Abbildung als SVG-Datei, lesen Ergebnisse exakt ab, bereiten Daten im Voraus auf und bauen eigene Abbildungen. Benannte Importe halten das Bundle klein: Eine Seite, die nur modelFromSolver importiert, bekommt überhaupt keinen Komponentencode.

Alle Werte sind in SI, sofern keine Einheit etwas anderes angibt; Positionen entlang eines Stabs sind Meter ab seinem Anfangsknoten.

Eine eigenständige SVG-Datei

Eine Grafik auf einer Seite übernimmt ihre Farben aus den CSS-Variablen der Seite; ein daraus kopiertes <svg> hat also keine. structureSvg schreibt die Abbildung stattdessen als Text einer eigenständigen .svg-Datei: feste Farben, kein Stylesheet, keine Skripte, angeordnet von derselben Routine wie bei StructurePlot. Word, PowerPoint, Inkscape, CairoSVG und LaTeX-Toolchains stellen sie genauso dar wie die Seite.

to-svg.ts
import { writeFileSync } from 'node:fs'
import { modelFromSolver, structureSvg } from '@edubeam/plot'
import { portalFrame } from './frame.ts' // () => ein berechneter LinearStaticSolver, wie auf der Seite „Folien und Skripte“

const frame = modelFromSolver(portalFrame())
writeFileSync('frame.svg', structureSvg(frame, { layers: ['members', 'supports', 'loads', 'reactions', 'M'] }))

Der Portalrahmen als eigenständige SVG-Datei, gerendert mit CairoSVG: die Lasten, die Auflagerreaktionen, 20 und 40 nach oben und 2,3 und 12,7 horizontal, und das Biegemoment von −50,7 in C bis 29,3 im Riegel

OptionStandardWirkung
layersStäbe, Lager, Lasten, Auflagerreaktionen und das Ergebnis, das StructurePlot wählen würdeWas gezeichnet wird
width640Breite in px, den Benutzereinheiten des SVG
heightfolgt der ZeichnungEine feste Höhe, px
maxHeightmax(320; 0,75 × width)Die Obergrenze der automatischen Höhe
padding6Abstand um die Zeichnung, px
fontSize13, kompakt 11.5Schriftgröße, px
fontFamilyHelvetica, Arial, sans-serifEin Font-Stack, den das Programm hat, das die Datei öffnet
colorsPRINT_COLORSBeliebige Farbtöne, als feste Farben
backgroundtrueDen Hintergrund in paper füllen; false lässt ihn transparent
titlekeinerWird als <title> des SVG geschrieben
reserve, reserveLabelModes, reserveReactionLabelskeineEbenen, Beschriftungsmodi und Beschriftungsarten der Reaktionen, für die zusätzlich zu den gezeichneten Platz freigehalten wird, damit die Dateien eines schrittweisen Aufbaus deckungsgleich sind: Schrittweiser Aufbau in Beamer
units, numberFormat, compact, diagramSize, deformedSize, momentOnTensionSide, resultLabelMode, reactionLabelswie bei StructurePlotDieselbe Bedeutung wie die Props der Komponente

PRINT_COLORS sind die Farben der EduBeam-App auf Weiß: Text und Linien #16182b, Normalkraft #2222ff, Querkraft #00af00, Biegemoment #ff2222, Lasten #ff8700, Auflagerreaktionen #a020f0. Jede Beschriftung wird zweimal geschrieben, einmal davon als Rand in der Hintergrundfarbe unter dem Text, weil nicht jedes SVG-Programm paint-order versteht; und ein Index, wie in den Reaktionsnamen Ax, ist ein tspan mit einfachen Zahlenwerten, den Word und Inkscape lesen können. Ohne reserve wird eine Datei an die Ebenen angepasst, die sie zeichnet.

So verwenden Sie die Datei:

  • Word und PowerPoint (2019 und Microsoft 365): Einfügen › Bilder.
  • LaTeX: Konvertieren Sie sie mit CairoSVG (cairosvg frame.svg -o frame.pdf) oder Inkscape in PDF und binden Sie sie dann mit \includegraphics ein; oder verwenden Sie \includesvg aus dem Paket svg, das Inkscape für Sie aufruft. Bei 640 Einheiten Breite hat eine Abbildung in einer Textspalte von 16 cm Beschriftungen in 9 pt.
  • Eine Webseite ohne Vue: Fügen Sie den Text in das HTML ein. Siehe Ohne Vue.

Unter Übungsaufgaben und Klausuren entsteht für die Aufgabe und die Lösung jeder Studentin und jedes Studenten eine Datei.

Aus einem Solver

ExportSignaturWirkung
modelFromSolver(solver: Solver, options?: FromSolverOptions) => PlotModelLiest einen Solver in das einfache Zeichenmodell ein; Ergebnisse nur für einen berechneten Lastfall
FromSolverOptionsTyp{ loadCase?: number }, ein Index in solver.loadCases

Stückweise Polynome

Die Ergebnisse eines Stabs sind Piecewise-Werte: Listen von Abschnitten { x0, x1, c }, erklärt unter Zeichenmodell. side wählt den Wert unmittelbar vor ('left') oder unmittelbar nach ('right', der Standard) einer Stelle, an der zwei Abschnitte zusammentreffen.

ExportSignaturWirkung
valueAt(pw, x, side?) => numberDer Wert bei x; jenseits der Enden der Wert am nächstgelegenen Ende
slopeAt(pw, x, side?) => numberDie Ableitung, Werteinheit pro Meter
extremes(pw) => { max: Extreme; min: Extreme } | nullDer größte und der kleinste Wert, exakt, jeweils { x, value, side }
maxAbs(pw) => numberDer größte Absolutwert
innerBreaks(pw) => number[]Wo Abschnitte zusammentreffen, ohne die beiden Enden
isZero(pw) => booleanOb das Ergebnis überall null ist
evalPiece(piece, x) => numberDer Wert eines Abschnitts
evalPieceSlope(piece, x) => numberDie Neigung eines Abschnitts
pieceExtrema(piece) => number[]Wo die Neigung eines Abschnitts null ist, m
pieceDegree(piece) => number | nullDer Grad eines Abschnitts; null, wenn er null ist
cleanPiecewise(pw, tolerance) => PiecewiseVerwirft Koeffizienten unter tolerance, das Rundungsrauschen eines berechneten Modells
fitPiece(f, x0, x1, degree) => PieceDas Polynom vom Grad degree durch eine Funktion auf (x0, x1)
pieceToBeziers(piece, segments?) => CubicSegment[]Der Abschnitt als kubische Bézierkurven in (x, Wert): exakt bis zu kubischen Polynomen, sonst segments Stück davon, standardmäßig 4

Typen: Piece, Piecewise, Side ('left' \| 'right'), Extreme, CubicSegment.

Einheiten und Zahlen

ExportSignaturWirkung
KN_UNITSUnitskN, kNm, kN/m, m, mm, mrad, K: der Standard
SI_UNITSUnitsN, N·m, N/m, m, m, rad, K
resolveUnits(units?: Partial<Units>) => UnitsKN_UNITS mit Ihren Abweichungen
DEFAULT_NUMBER_FORMATIntl.NumberFormatenglisch, höchstens eine Nachkommastelle
formatNumber(value, format?) => stringDie Zahl mit echtem Minuszeichen, nie −0
formatQuantity(si, unit, format?) => string"36 kN": ein SI-Wert in einer Einheit, mit schmalem geschütztem Leerzeichen

Eine Unit ist { symbol, scale }, Anzeigewert = SI-Wert × scale. Units enthält eine für jede UnitKind: force, moment, distributed, length, displacement, rotation und temperature.

TypeScript
import { formatQuantity, KN_UNITS } from '@edubeam/plot'

formatQuantity(-37500, KN_UNITS.moment) // "−37.5 kNm"

Werte ablesen

ExportSignaturWirkung
readMember(results: MemberResults, x, snap?) => { x, u, values }N, V, M und w bei x, jeweils { left, right }, und die Längsverschiebung u; rastet näher als snap m an einem Sprung dort ein
readoutAt(model, transform, px, py, reach) => Readout | nullDer Stab, der einem Bildschirmpunkt am nächsten liegt, innerhalb von reach px, und seine Ergebnisse an dieser Stelle
readoutMarks(model, transform, readout, shown, k, side) => ReadoutMark[]Wo die abgelesenen Werte markiert werden: an der Ordinatenspitze jedes angezeigten Verlaufs (an einem Sprung an beiden), am Punkt auf der Verformungsfigur
formatReadout(readout, quantity, units, format?) => string"M = 54 kNm" oder an einem Sprung "V = 13.3 → −6.7 kN"

k ist der Maßstab in px pro SI-Einheit für jedes Ergebnis und side die Seite, auf der jeder Verlauf gezeichnet wird, aus diagramScales und diagramSide weiter unten. Typen: Readout, ReadoutMark ({ tone, from, to } in px), ReadoutQuantity ('N' \| 'V' \| 'M' \| 'w'), SidedValue.

Trägerlinien

Die Bausteine von DiagramStack, um selbst eine Abbildung mit untereinander angeordneten Verläufen zu bauen.

ExportSignaturWirkung
beamLine(model, ids?) => BeamLineDie Stäbe als eine horizontale Linie, von links nach rechts; bei allem anderen ein Fehler
lineDiagram(model, line, row) => PiecewiseEin Ergebnis entlang der ganzen Linie, in der x-Koordinate der Linie
rowRange(pw) => [number, number]Der Bereich, auf den eine Zeile skaliert wird, immer einschließlich null
rowPeaks(pw) => RowPeak[]Die Extremwerte, die es wert sind, an einer Zeile angeschrieben zu werden
rowBreaks(pw) => number[]Wo das Ergebnis einen Knick oder Sprung hat: Lager, Knoten und Einzellasten
rowOutline(pw, sx, sy, close) => stringSVG-Pfaddaten des Umrisses einer Zeile, gegeben die Abbildungen von m und Wert auf px
rowOrdinates(pw, sx, sy, spacing) => stringSVG-Pfaddaten der Schraffur-Ordinaten im Abstand von spacing px
lineModel(model, line, omit?) => PlotModelDas auf die Linie reduzierte Modell, wahlweise ohne eine Last
pointLoadAt(model, line, at) => PlotLoad | undefinedDie Einzelkraft an der Position at der Linie

Typen: BeamLine, LineMember, RowPeak, StackRow.

Die Seite DiagramStack verwendet beamLine, lineDiagram und rowRange, um den Maßstab jeder Zeile über alle Stellungen einer wandernden Last beizubehalten.

Geometrie und Lager

ExportSignaturWirkung
nodeMap(model) => ReadonlyMap<string, PlotNode>Knoten nach ID
memberFrame(model, member, nodes?) => MemberFrameAnfangspunkt, Tangenteneinheitsvektor, Einheitsvektor der lokalen z-Achse und Länge eines Stabs
memberFrames(model) => Map<string, MemberFrame>Dasselbe für jeden Stab, nach ID
pointAlong(frame, at) => { x, z }Der Punkt at Meter entlang eines Stabs
supportKind(fixity) => SupportKind'fixed', 'pin', 'roller', 'slider', 'rotation' oder 'none'
supportPlacement(model, node) => SupportPlacementDas Symbol für einen Knoten und seine Drehung im Uhrzeigersinn, in Grad
supportGlyph(kind) => readonly GlyphPart[]Die Linien des Symbols, in px
glyphReach(kind, rotation, x, z) => numberWie weit ein gedrehtes Symbol in eine Richtung reicht, px

Zeichnen

Die Zeichnung entsteht in drei Schritten. buildStructureScene macht aus einem Modell Szenenelemente: Modellpunkte mit Versätzen in Bildschirmpixeln. fitScene ermittelt Maßstab und Verschiebung, mit denen sie in einen Container passen. resolveScene wandelt sie in SVG-Pfaddaten, Kreise und die Beschriftungen um, für die Platz ist. layoutStructure führt alle drei so aus wie StructurePlot und structureSvg, sodass eine eigene Abbildung genauso angeordnet wird wie ihre.

ExportSignaturWirkung
layoutStructure(model, options, box, shown?, labelModes?) => StructureLayoutDie ganze Anordnung: mit allen Beschriftungen einpassen, Beschriftungen an zu vollen Stellen weglassen, erneut einpassen. Gibt { fit, items, resolved } zurück
structureSvg(model, options?) => stringEine eigenständige .svg-Datei: siehe oben
buildStructureScene(model, options: StructureSceneOptions) => SceneItem[]Die Zeichnung der gewählten Ebenen in einem Maßstab, px pro Meter
fitScene(items, box: FitBox) => FitMaßstab und Verschiebung zum Einpassen in einen Container { width, height?, maxHeight?, padding, fontSize }
resolveScene(items, transform, options: ResolveOptions) => ResolvedScene{ paths, circles, texts } in px, mit den Beschriftungen, die Platz finden
placeLabels(items, transform, options: ResolveOptions) => Map<SceneText, SceneText>Welche Beschriftungen bleiben, und wo
alternativeResultGroups(shown) => ReadonlySet<string>Die Ergebnisebenen, die jeweils einzeln angezeigt werden; ihre Beschriftungen weichen allen anderen aus, aber nicht einander
sceneBounds(items, scale, fontSize) => BoundsDie Ausdehnung einer Szene, px
project(transform, anchor) => [number, number]Ein Szenenpunkt auf dem Bildschirm, px
defaultResultLayer(model) => ResultLayer | nullDas Ergebnis, das eine Grafik zeigt, wenn keines verlangt ist
diagramScales(model, options) => Record<ResultLayer, number>px pro SI-Einheit für jedes Ergebnis
diagramSide(q, momentOnTensionSide) => 1 | -1Auf welcher Seite eines Stabs ein positiver Wert gezeichnet wird
isBarStructure(model, memberResults) => booleanOb N als Zahlen entlang der Stäbe geschrieben (ein Fachwerk) statt als Verlauf gezeichnet wird
tipPlacements(tip, out, mode, gaps?) => TextPlacement[]Die Plätze, die ein Wert hinter der Spitze einer Ordinate einnehmen darf
PLOT_LAYERSreadonly PlotLayer[]Alle Ebenen, in Zeichenreihenfolge
RESULT_LAYERS['N', 'V', 'M', 'w']Die Ergebnisebenen
HATCH_SPACING_PX7Der Abstand der Ordinaten eines Verlaufs, px
DEFAULT_COLORSPlotColorsDie Standardfarbe jedes Farbtons als CSS: Farben und Farbschemata
PRINT_COLORSRecord<Tone | 'paper', string>Feste Farben für eine Datei, die der App auf Weiß
toneVars(colors?) => Record<string, string>Die CSS-Variablen, die eine Grafik auf ihrem Wurzelelement setzt
PLOT_CSSstringDie CSS-Regeln, die direkt in jeder Grafik stehen

ResolveOptions sind { fontSize, viewport?, exclude?, alternativeGroups?, shields? }: shields sind die Gruppen, deren Linien Beschriftungen fernhalten (die angezeigten Verläufe), ohne Angabe alle. In layoutStructure sind options.layers die anzuordnenden Ebenen (alles, was angezeigt werden kann, wie bei reserve), shown die angezeigten und labelModes die Beschriftungsmodi, für die Platz freigehalten wird.

Typen: StructureSceneOptions, StructureLayout, StructureSvgOptions, SceneItem, SceneText, TextPlacement, ResolvedScene, ResolvedPath, ResolvedText, ResolvedCircle, ResolveOptions, Bounds, Anchor, Transform, Fit, FitBox, Tone, PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, SupportKind, SupportPlacement, GlyphPart und die Modelltypen aus Zeichenmodell.