Funkce

Všechno, co komponenty kreslí, vychází z čistých funkcí, ve kterých není žádné Vue. Zapíší obrázek jako soubor SVG, přesně odečtou výsledky, připraví data předem a poslouží ke stavbě vlastních obrázků. Díky pojmenovaným importům zůstane bundle malý: stránka, která importuje jen modelFromSolver, nedostane žádný kód komponent.

Všechny hodnoty jsou v SI, pokud jednotka neříká jinak; poloha na prvku je vzdálenost v metrech od jeho počátečního uzlu.

Samostatný soubor SVG

Obrázek na stránce bere barvy z CSS proměnných (custom properties) stránky, takže <svg> z něj zkopírované žádné barvy nemá. structureSvg proto zapíše obrázek jako text samostatného souboru .svg: s pevnými barvami, bez stylů a bez skriptů, rozvržený stejným kódem jako StructurePlot. Word, PowerPoint, Inkscape, CairoSVG i nástroje pro LaTeX ho vykreslí stejně jako stránka.

to-svg.ts
import { writeFileSync } from 'node:fs'
import { modelFromSolver, structureSvg } from '@edubeam/plot'
import { portalFrame } from './frame.ts' // () => spočtený LinearStaticSolver, jako na stránce Prezentace a skripta

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

Dvoukloubový rám jako samostatný soubor SVG vykreslený pomocí CairoSVG: zatížení, reakce 20 a 40 nahoru a 2,3 a 12,7 vodorovně a ohybový moment od −50,7 v C po 29,3 na příčli

VolbaVýchozíCo dělá
layersmembers, supports, loads, reactions a výsledek, který by zvolil StructurePlotCo se kreslí
width640Šířka v px, tedy v uživatelských jednotkách SVG
heightpodle výkresuPevná výška, px
maxHeightmax(320, 0.75 × width)Horní mez automatické výšky
padding6Okraj kolem výkresu, px
fontSize13, compact 11.5Velikost písma, px
fontFamilyHelvetica, Arial, sans-serifPísma, která má program otevírající soubor k dispozici
colorsPRINT_COLORSKterékoli z tónů, jako pevné barvy
backgroundtrueVyplní pozadí barvou paper; false ho nechá průhledné
titležádnýZapíše se jako <title> souboru SVG
reserve, reserveLabelModes, reserveReactionLabelsžádnéVrstvy, styly popisků a styly popisků reakcí, pro které se kromě vykreslených nechá místo, aby soubory postupně přibývajícího obrázku lícovaly: Postupně přibývající obrázek v Beameru
units, numberFormat, compact, diagramSize, deformedSize, momentOnTensionSide, resultLabelMode, reactionLabelsjako StructurePlotStejný význam jako props komponenty

PRINT_COLORS jsou barvy aplikace EduBeam na bílém podkladu: kresba #16182b, normálová síla #2222ff, posouvající síla #00af00, ohybový moment #ff2222, zatížení #ff8700, reakce #a020f0. Každý popisek je zapsán dvakrát, pod textem ještě jednou jako lem v barvě pozadí, protože ne každý program pro SVG rozumí paint-order. Dolní index, jako v názvech reakcí Ax, je tspan s obyčejnými čísly, která Word i Inkscape přečtou. Bez reserve se soubor přizpůsobí vrstvám, které kreslí.

Jak soubor použít:

  • Word a PowerPoint (2019 a Microsoft 365): Vložení › Obrázky.
  • LaTeX: převeďte ho do PDF pomocí CairoSVG (cairosvg frame.svg -o frame.pdf) nebo Inkscapu a vložte přes \includegraphics, případně použijte \includesvg z balíčku svg, který Inkscape zavolá za vás. Obrázek široký 640 jednotek, vysázený na šířku sloupce 16 cm, má popisky velké 9 pt.
  • Webová stránka bez Vue: vložte text přímo do HTML. Viz Bez Vue.

Stránka Příklady a písemky zapíše pro příklad každého studenta soubor se zadáním a soubor s klíčem řešení.

Z řešiče

ExportSignaturaCo dělá
modelFromSolver(solver: Solver, options?: FromSolverOptions) => PlotModelPřevede řešič na prostá data modelu pro vykreslení; výsledky jen pro spočtený zatěžovací stav
FromSolverOptionstype{ loadCase?: number }, index do solver.loadCases

Polynomy po částech

Výsledky prvku jsou hodnoty typu Piecewise: seznamy úseků { x0, x1, c }, popsané na stránce Model pro vykreslení. side volí hodnotu těsně před ('left') nebo těsně za ('right', výchozí) bodem, ve kterém se dva úseky stýkají.

ExportSignaturaCo dělá
valueAt(pw, x, side?) => numberHodnota v x; za koncem hodnota na bližším konci
slopeAt(pw, x, side?) => numberDerivace, v jednotkách hodnoty na metr
extremes(pw) => { max: Extreme; min: Extreme } | nullNejvětší a nejmenší hodnota, přesně, každá jako { x, value, side }
maxAbs(pw) => numberNejvětší absolutní hodnota
innerBreaks(pw) => number[]Místa, kde se úseky stýkají, bez obou konců
isZero(pw) => booleanZda je výsledek všude nulový
evalPiece(piece, x) => numberHodnota jednoho úseku
evalPieceSlope(piece, x) => numberSměrnice jednoho úseku
pieceExtrema(piece) => number[]Místa, kde je směrnice úseku nulová, m
pieceDegree(piece) => number | nullStupeň úseku; null, je-li úsek nulový
cleanPiecewise(pw, tolerance) => PiecewiseZahodí koeficienty menší než tolerance, tedy zaokrouhlovací chyby spočteného modelu
fitPiece(f, x0, x1, degree) => PiecePolynom daného stupně proložený hodnotami funkce f na (x0, x1)
pieceToBeziers(piece, segments?) => CubicSegment[]Úsek jako kubické Bézierovy křivky v souřadnicích (x, hodnota): do třetího stupně přesně, jinak segments křivek, výchozí 4

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

Jednotky a čísla

ExportSignaturaCo dělá
KN_UNITSUnitskN, kNm, kN/m, m, mm, mrad, K: výchozí
SI_UNITSUnitsN, N·m, N/m, m, m, rad, K
resolveUnits(units?: Partial<Units>) => UnitsKN_UNITS s vašimi změnami
DEFAULT_NUMBER_FORMATIntl.NumberFormatAnglický formát, nejvýše jedno desetinné místo
formatNumber(value, format?) => stringČíslo se skutečným znaménkem minus, nikdy −0
formatQuantity(si, unit, format?) => string"36 kN": hodnota v SI převedená na jednotku, s úzkou nezlomitelnou mezerou

Unit je { symbol, scale }, kde zobrazená hodnota = hodnota v SI × scale. Units obsahuje jednu jednotku pro každý UnitKind: force, moment, distributed, length, displacement, rotation a temperature.

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

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

Odečítání hodnot

ExportSignaturaCo dělá
readMember(results: MemberResults, x, snap?) => { x, u, values }N, V, M a w v x, každá jako { left, right }, a osové posunutí u; přichytí se ke skoku vzdálenému nejvýše snap m
readoutAt(model, transform, px, py, reach) => Readout | nullPrvek nejbližší bodu na obrazovce, nejvýše reach px daleko, a jeho výsledky v tomto místě
readoutMarks(model, transform, readout, shown, k, side) => ReadoutMark[]Kde se odečtené hodnoty vyznačí: konec pořadnice každého zobrazeného průběhu (u skoku oba) a bod na deformovaném tvaru
formatReadout(readout, quantity, units, format?) => string"M = 54 kNm", u skoku "V = 13.3 → −6.7 kN"

k je počet px na jednotku SI pro každý výsledek a side strana, na kterou se který průběh kreslí; obojí vracejí diagramScales a diagramSide níže. Typy: Readout, ReadoutMark ({ tone, from, to } v px), ReadoutQuantity ('N' \| 'V' \| 'M' \| 'w'), SidedValue.

Nosník v jedné linii

Stavební kameny komponenty DiagramStack, ze kterých sestavíte vlastní obrázek s průběhy pod sebou.

ExportSignaturaCo dělá
beamLine(model, ids?) => BeamLinePrvky jako jedna vodorovná linie zleva doprava; pro cokoli jiného vyhodí výjimku
lineDiagram(model, line, row) => PiecewiseJeden výsledek po celé linii, v souřadnici x linie
rowRange(pw) => [number, number]Rozsah, na který se řádek škáluje, vždy včetně nuly
rowPeaks(pw) => RowPeak[]Extrémy, které stojí za to do řádku napsat
rowBreaks(pw) => number[]Kde se průběh láme: podpory, styčníky a osamělé síly
rowOutline(pw, sx, sy, close) => stringData cesty SVG s obrysem řádku, pro zadaná zobrazení z m a z hodnoty na px
rowOrdinates(pw, sx, sy, spacing) => stringData cesty SVG se šrafovacími pořadnicemi po spacing px
lineModel(model, line, omit?) => PlotModelModel zúžený na linii, případně bez jednoho zatížení
pointLoadAt(model, line, at) => PlotLoad | undefinedOsamělá síla v poloze at na linii

Typy: BeamLine, LineMember, RowPeak, StackRow.

Stránka DiagramStack používá beamLine, lineDiagram a rowRange, aby měl každý řádek stejné měřítko pro všechny polohy pohyblivého zatížení.

Geometrie a podpory

ExportSignaturaCo dělá
nodeMap(model) => ReadonlyMap<string, PlotNode>Uzly podle id
memberFrame(model, member, nodes?) => MemberFramePočátek prvku, jednotkový tečný vektor, jednotkový vektor lokální osy z a délka
memberFrames(model) => Map<string, MemberFrame>Totéž pro všechny prvky, podle id
pointAlong(frame, at) => { x, z }Bod ve vzdálenosti at metrů od počátku prvku
supportKind(fixity) => SupportKind'fixed', 'pin', 'roller', 'slider', 'rotation' nebo 'none'
supportPlacement(model, node) => SupportPlacementZnačka podpory v uzlu a její pootočení po směru hodinových ručiček, ve stupních
supportGlyph(kind) => readonly GlyphPart[]Čáry značky, v px
glyphReach(kind, rotation, x, z) => numberJak daleko pootočená značka sahá v daném směru, px

Kreslení

Kreslení probíhá ve třech krocích. buildStructureScene převede model na položky scény: body modelu s odsazením v pixelech obrazovky. fitScene najde měřítko a posun, se kterými se položky vejdou do zadaného obdélníku. resolveScene z nich udělá data cest SVG, kružnice a ty popisky, na které zbylo místo. layoutStructure spustí všechny tři kroky stejně jako StructurePlot a structureSvg, takže vlastní obrázek bude rozvržený stejně jako jejich.

ExportSignaturaCo dělá
layoutStructure(model, options, box, shown?, labelModes?) => StructureLayoutCelé rozvržení: umístění se všemi popisky, vypuštění popisků, které se nevejdou, a nové umístění. Vrací { fit, items, resolved }
structureSvg(model, options?) => stringSamostatný soubor .svg: viz výše
buildStructureScene(model, options: StructureSceneOptions) => SceneItem[]Výkres zvolených vrstev v daném měřítku, px na metr
fitScene(items, box: FitBox) => FitMěřítko a posun, aby se scéna vešla do obdélníku { width, height?, maxHeight?, padding, fontSize }
resolveScene(items, transform, options: ResolveOptions) => ResolvedScene{ paths, circles, texts } v px, s popisky, které se vejdou
placeLabels(items, transform, options: ResolveOptions) => Map<SceneText, SceneText>Které popisky zůstanou a kde
alternativeResultGroups(shown) => ReadonlySet<string>Vrstvy výsledků, které se zobrazují po jedné; jejich popisky ustupují ostatním, ale ne sobě navzájem
sceneBounds(items, scale, fontSize) => BoundsRozměry scény, px
project(transform, anchor) => [number, number]Bod scény na obrazovce, px
defaultResultLayer(model) => ResultLayer | nullVýsledek, který obrázek ukáže, když žádný nezadáte
diagramScales(model, options) => Record<ResultLayer, number>px na jednotku SI pro každý výsledek
diagramSide(q, momentOnTensionSide) => 1 | -1Na kterou stranu prvku se vynáší kladná hodnota
isBarStructure(model, memberResults) => booleanZda se N píše jako čísla podél prutů (příhradová konstrukce), místo aby se kreslil průběh
tipPlacements(tip, out, mode, gaps?) => TextPlacement[]Místa za koncem pořadnice, kam lze hodnotu napsat
PLOT_LAYERSreadonly PlotLayer[]Všechny vrstvy v pořadí kreslení
RESULT_LAYERS['N', 'V', 'M', 'w']Vrstvy výsledků
HATCH_SPACING_PX7Rozteč pořadnic průběhů, px
DEFAULT_COLORSPlotColorsVýchozí barva každého tónu jako CSS: Motivy a barvy
PRINT_COLORSRecord<Tone | 'paper', string>Pevné barvy pro soubor, barvy aplikace na bílém podkladu
toneVars(colors?) => Record<string, string>CSS proměnné, které obrázek nastaví na svém kořenovém elementu
PLOT_CSSstringPravidla CSS vložená do každého obrázku

ResolveOptions jsou { fontSize, viewport?, exclude?, alternativeGroups?, shields? }: shields jsou skupiny, jejichž čáry k sobě nepustí popisky (zobrazené průběhy); když je vynecháte, platí to pro všechny. V layoutStructure jsou options.layers vrstvy, které se rozvrhnou (všechno, co se může zobrazit, podobně jako u reserve), shown ty, které jsou zobrazené, a labelModes styly popisků, pro které se má nechat místo.

Typy: StructureSceneOptions, StructureLayout, StructureSvgOptions, SceneItem, SceneText, TextPlacement, ResolvedScene, ResolvedPath, ResolvedText, ResolvedCircle, ResolveOptions, Bounds, Anchor, Transform, Fit, FitBox, Tone, PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, SupportKind, SupportPlacement, GlyphPart a typy modelu ze stránky Model pro vykreslení.