Funções

Tudo o que os componentes desenham vem de funções puras, sem nada de Vue. Elas escrevem uma figura como arquivo SVG, leem resultados de forma exata, preparam dados com antecedência e montam figuras próprias. Importações nomeadas deixam o bundle pequeno: uma página que importa só modelFromSolver não recebe nenhum código de componente.

Todos os valores estão em SI, a menos que uma unidade diga o contrário; as posições ao longo de uma barra são metros a partir do seu nó inicial.

Um arquivo SVG independente

Uma figura numa página busca as suas cores nas propriedades personalizadas CSS da página, então um <svg> copiado dela fica sem cores. structureSvg, por sua vez, escreve a figura como o texto de um arquivo .svg independente: cores fixas, sem folha de estilos, sem scripts, composto pela mesma rotina do StructurePlot. O Word, o PowerPoint, o Inkscape, o CairoSVG e as cadeias de ferramentas do LaTeX o desenham como a página.

to-svg.ts
import { writeFileSync } from 'node:fs'
import { modelFromSolver, structureSvg } from '@edubeam/plot'
import { portalFrame } from './frame.ts' // () => um LinearStaticSolver resolvido, como na página Slides e notas de aula

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

O pórtico como arquivo SVG independente, renderizado pelo CairoSVG: as cargas, as reações, 20 e 40 para cima e 2,3 e 12,7 na horizontal, e o momento fletor de −50,7 em C a 29,3 na viga

OpçãoPadrãoO que faz
layersbarras, apoios, cargas, reações e o resultado que o StructurePlot escolheriaO que desenhar
width640Largura em px, as unidades de usuário do SVG
heightacompanha o desenhoUma altura fixa, px
maxHeightmax(320, 0.75 × width)O limite superior da altura automática
padding6Espaço em volta do desenho, px
fontSize13, compact 11.5Tamanho do texto, px
fontFamilyHelvetica, Arial, sans-serifUma lista de fontes disponíveis no programa que abre o arquivo
colorsPRINT_COLORSQualquer um dos tons, como cores fixas
backgroundtruePinta o fundo na cor paper; false o deixa transparente
titlenenhumEscrito como o <title> do SVG
reserve, reserveLabelModes, reserveReactionLabelsnenhumCamadas, estilos de rótulo e estilos de rótulo das reações para os quais se reserva espaço além dos desenhados, para que os arquivos de uma figura em etapas fiquem alinhados: Uma figura em etapas no Beamer
units, numberFormat, compact, diagramSize, deformedSize, momentOnTensionSide, resultLabelMode, reactionLabelscomo no StructurePlotO mesmo significado das props do componente

PRINT_COLORS são as cores do aplicativo EduBeam sobre branco: traço #16182b, esforço normal #2222ff, esforço cortante #00af00, momento fletor #ff2222, cargas #ff8700, reações #a020f0. Cada rótulo é escrito duas vezes, com um halo na cor do fundo sob o texto, porque nem todo programa de SVG entende paint-order, e um subscrito, como nos nomes das reações Ax, é um tspan com números simples que o Word e o Inkscape leem. Sem reserve, um arquivo é ajustado às camadas que desenha.

Para usar o arquivo:

  • Word e PowerPoint (2019 e Microsoft 365): Inserir › Imagens.
  • LaTeX: converta-o para PDF com o CairoSVG (cairosvg frame.svg -o frame.pdf) ou o Inkscape e depois use \includegraphics; ou use o \includesvg do pacote svg, que chama o Inkscape por você. Com 640 unidades de largura, uma figura ajustada a uma coluna de texto de 16 cm tem rótulos de 9 pt.
  • Uma página web sem Vue: cole o texto no HTML. Veja Sem Vue.

Exercícios e provas escreve um arquivo para o exercício e o gabarito de cada aluno.

A partir de um solver

ExportaçãoAssinaturaO que faz
modelFromSolver(solver: Solver, options?: FromSolverOptions) => PlotModelConverte um solver no modelo de desenho, em dados simples; resultados só para um caso de carga resolvido
FromSolverOptionstipo{ loadCase?: number }, um índice em solver.loadCases

Polinômios por trechos

Os resultados de uma barra são valores Piecewise: listas de trechos { x0, x1, c }, explicadas em Modelo de desenho. side escolhe o valor logo antes ('left') ou logo depois ('right', o padrão) de um ponto onde dois trechos se encontram.

ExportaçãoAssinaturaO que faz
valueAt(pw, x, side?) => numberO valor em x; além das extremidades, o valor da extremidade mais próxima
slopeAt(pw, x, side?) => numberA derivada, em unidades do valor por metro
extremes(pw) => { max: Extreme; min: Extreme } | nullO maior e o menor valor, exatos, cada um { x, value, side }
maxAbs(pw) => numberO maior valor absoluto
innerBreaks(pw) => number[]Onde os trechos se encontram, sem as duas extremidades
isZero(pw) => booleanSe o resultado é nulo em todo o comprimento
evalPiece(piece, x) => numberO valor de um trecho
evalPieceSlope(piece, x) => numberA inclinação de um trecho
pieceExtrema(piece) => number[]Onde a inclinação de um trecho se anula, m
pieceDegree(piece) => number | nullO grau de um trecho; null quando ele é nulo
cleanPiecewise(pw, tolerance) => PiecewiseDescarta coeficientes abaixo de tolerance, o erro de arredondamento de um modelo resolvido
fitPiece(f, x0, x1, degree) => PieceO polinômio do grau dado ajustado a uma função em (x0, x1)
pieceToBeziers(piece, segments?) => CubicSegment[]O trecho como curvas de Bézier cúbicas em (x, valor): exato até polinômios cúbicos; acima disso, segments curvas, 4 por padrão

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

Unidades e números

ExportaçãoAssinaturaO que faz
KN_UNITSUnitskN, kNm, kN/m, m, mm, mrad, K: o padrão
SI_UNITSUnitsN, N·m, N/m, m, m, rad, K
resolveUnits(units?: Partial<Units>) => UnitsKN_UNITS com as suas substituições
DEFAULT_NUMBER_FORMATIntl.NumberFormatInglês, no máximo uma casa decimal
formatNumber(value, format?) => stringO número com um sinal de menos de verdade, nunca −0
formatQuantity(si, unit, format?) => string"36 kN": um valor SI numa unidade, com um espaço estreito inseparável

Uma Unit é { symbol, scale }, com valor exibido = valor SI × scale. Units tem uma para cada UnitKind: force, moment, distributed, length, displacement, rotation e temperature.

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

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

Leitura de valores

ExportaçãoAssinaturaO que faz
readMember(results: MemberResults, x, snap?) => { x, u, values }N, V, M e w em x, cada um { left, right }, e o deslocamento axial u; a menos de snap m de um salto, lê no próprio salto
readoutAt(model, transform, px, py, reach) => Readout | nullA barra mais próxima de um ponto da tela, a menos de reach px, e os seus resultados ali
readoutMarks(model, transform, readout, shown, k, side) => ReadoutMark[]Onde os valores lidos são desenhados: a extremidade da ordenada de cada diagrama exibido (as duas num salto), o ponto na deformada
formatReadout(readout, quantity, units, format?) => string"M = 54 kNm", ou "V = 13.3 → −6.7 kN" num salto

k é a escala em px por unidade SI de cada resultado, e side o lado em que cada diagrama é desenhado, obtidos de diagramScales e diagramSide, mais abaixo. Tipos: Readout, ReadoutMark ({ tone, from, to } em px), ReadoutQuantity ('N' \| 'V' \| 'M' \| 'w'), SidedValue.

Linhas de viga

As peças do DiagramStack, para montar uma figura empilhada própria.

ExportaçãoAssinaturaO que faz
beamLine(model, ids?) => BeamLineAs barras como uma única linha horizontal, da esquerda para a direita; lança um erro para qualquer outra coisa
lineDiagram(model, line, row) => PiecewiseUm resultado ao longo de toda a linha, no x da linha
rowRange(pw) => [number, number]O intervalo para o qual uma linha é escalada, sempre incluindo o zero
rowPeaks(pw) => RowPeak[]Os extremos que vale a pena escrever numa linha
rowBreaks(pw) => number[]Onde o resultado se interrompe: apoios, ligações entre barras e cargas concentradas
rowOutline(pw, sx, sy, close) => stringOs dados de path SVG do contorno de uma linha, dadas as transformações de m e de valor para px
rowOrdinates(pw, sx, sy, spacing) => stringOs dados de path SVG das ordenadas da hachura, espaçadas de spacing px
lineModel(model, line, omit?) => PlotModelO modelo reduzido à linha, opcionalmente sem uma das cargas
pointLoadAt(model, line, at) => PlotLoad | undefinedA força concentrada na posição at da linha

Tipos: BeamLine, LineMember, RowPeak, StackRow.

A página DiagramStack usa beamLine, lineDiagram e rowRange para manter a escala de cada linha em todas as posições de uma carga móvel.

Geometria e apoios

ExportaçãoAssinaturaO que faz
nodeMap(model) => ReadonlyMap<string, PlotNode>Os nós por id
memberFrame(model, member, nodes?) => MemberFrameO início de uma barra, a tangente unitária, o z local unitário e o comprimento
memberFrames(model) => Map<string, MemberFrame>O mesmo para todas as barras, por id
pointAlong(frame, at) => { x, z }O ponto a at metros ao longo de uma barra
supportKind(fixity) => SupportKind'fixed', 'pin', 'roller', 'slider', 'rotation' ou 'none'
supportPlacement(model, node) => SupportPlacementO símbolo de um nó e o seu giro no sentido horário, em graus
supportGlyph(kind) => readonly GlyphPart[]As linhas do símbolo, em px
glyphReach(kind, rotation, x, z) => numberAté onde um símbolo girado chega numa direção, px

Desenho

O desenho é feito em três passos. buildStructureScene transforma um modelo em itens de cena: pontos do modelo com deslocamentos em pixels de tela. fitScene encontra a escala e o deslocamento que os fazem caber num contêiner. resolveScene os transforma em dados de path SVG, em círculos e nos rótulos que têm espaço. layoutStructure executa os três passos como o StructurePlot e o structureSvg fazem, de modo que uma figura própria é composta como as deles.

ExportaçãoAssinaturaO que faz
layoutStructure(model, options, box, shown?, labelModes?) => StructureLayoutA composição completa: ajusta com todos os rótulos, descarta os rótulos amontoados e ajusta de novo. Retorna { fit, items, resolved }
structureSvg(model, options?) => stringUm arquivo .svg independente: acima
buildStructureScene(model, options: StructureSceneOptions) => SceneItem[]O desenho das camadas escolhidas numa escala, em px por metro
fitScene(items, box: FitBox) => FitA escala e o deslocamento para caber num contêiner { width, height?, maxHeight?, padding, fontSize }
resolveScene(items, transform, options: ResolveOptions) => ResolvedScene{ paths, circles, texts } em px, com os rótulos que cabem
placeLabels(items, transform, options: ResolveOptions) => Map<SceneText, SceneText>Quais rótulos manter, e onde
alternativeResultGroups(shown) => ReadonlySet<string>As camadas de resultado mostradas uma de cada vez, cujos rótulos cedem lugar aos demais, mas não uns aos outros
sceneBounds(items, scale, fontSize) => BoundsA extensão de uma cena, px
project(transform, anchor) => [number, number]Um ponto da cena na tela, px
defaultResultLayer(model) => ResultLayer | nullO resultado que uma figura mostra quando nenhum é pedido
diagramScales(model, options) => Record<ResultLayer, number>A escala em px por unidade SI de cada resultado
diagramSide(q, momentOnTensionSide) => 1 | -1Em que lado de uma barra um valor positivo é desenhado
isBarStructure(model, memberResults) => booleanSe N é escrito como números ao longo das barras (uma treliça) em vez de desenhado como diagrama
tipPlacements(tip, out, mode, gaps?) => TextPlacement[]As posições que um valor pode ocupar além da extremidade de uma ordenada
PLOT_LAYERSreadonly PlotLayer[]Todas as camadas, na ordem de pintura
RESULT_LAYERS['N', 'V', 'M', 'w']As camadas de resultado
HATCH_SPACING_PX7O espaçamento das ordenadas dos diagramas, px
DEFAULT_COLORSPlotColorsA cor padrão de cada tom, como CSS: Temas e cores
PRINT_COLORSRecord<Tone | 'paper', string>Cores fixas para um arquivo, as do aplicativo sobre branco
toneVars(colors?) => Record<string, string>As propriedades personalizadas que uma figura define na sua raiz
PLOT_CSSstringAs regras CSS embutidas em cada figura

ResolveOptions são { fontSize, viewport?, exclude?, alternativeGroups?, shields? }: shields são os grupos cujas linhas afastam os rótulos (os diagramas exibidos), todos eles quando a opção é omitida. Em layoutStructure, options.layers são as camadas a compor (tudo o que pode ser exibido, como em reserve), shown as que estão visíveis e labelModes os estilos de rótulo para os quais se reserva espaço.

Tipos: StructureSceneOptions, StructureLayout, StructureSvgOptions, SceneItem, SceneText, TextPlacement, ResolvedScene, ResolvedPath, ResolvedText, ResolvedCircle, ResolveOptions, Bounds, Anchor, Transform, Fit, FitBox, Tone, PlotLayer, ResultLayer, ResultLabelMode, ReactionLabels, SupportKind, SupportPlacement, GlyphPart e os tipos de modelo de Modelo de desenho.