StructurePlot

StructurePlot рисует всю конструкцию, вписанную в ширину своего контейнера: стержни, шарниры, опоры, нагрузки, реакции, эпюры N, V и M и деформированную схему. Передайте ему решатель или полученную из него простую модель и укажите, что рисовать.

Vue
<StructurePlot :solver="solver" :layers="['members', 'supports', 'loads', 'reactions', 'M']" />

Все свойства с типами и значениями по умолчанию перечислены в API компонентов.

Рисунок ниже — это StructurePlot с включёнными слоями nodeLabels и dimensions, со свойством hover и с принятым на этом сайте форматом чисел (четыре значащие цифры). Переключайте результаты и наведите указатель на стержень, чтобы увидеть его значения.

П-образная рама: шарнирные опоры стоек, 10 кН/м на ригеле, 15 кН в узле B9,231−50,7729,236 м4 м15 кНq = 10 кН/м2,3082012,6940ABCD
П-образная рама: шарнирные опоры стоек, 10 кН/м на ригеле, 15 кН в узле BОткрыть в EduBeam

Слои

Рисунок состоит из слоёв. Они рисуются в фиксированном порядке, в каком бы порядке вы их ни перечислили:

СлойЧто рисует
membersстержни; шарниры — маленькими кружками
supportsусловное обозначение каждой опоры, у наклонных опор — повёрнутое
loadsузловые нагрузки и нагрузки на стержни, температурные воздействия и осадки опор с их значениями
reactionsреакции — стрелками и дуговыми стрелками со значениями; или, с reactionLabels: 'names', как неизвестные с обозначениями в упражнении
nodesкаждый узел — маленьким кружком
nodeLabelsобозначения узлов
dimensionsразмерные цепочки, как на листе с условием задачи: все участки между узлами и сосредоточенными силами под конструкцией, все этажи справа от неё и общий размер на второй линии
N, V, Mэпюры продольных сил, поперечных сил и изгибающих моментов
wдеформированную схему

Без layers рисунок показывает стержни, опоры, нагрузки и реакции и ещё один результат, выбранный по типу конструкции: M для балок и рам, N для фермы и w, если усилий нет нигде, как в балке, которая может свободно удлиняться при нагреве.

Эпюры выглядят так же, как в приложении EduBeam: эпюры N и V заштрихованы поперёк стержня, а эпюра M откладывается со стороны растянутых волокон, поэтому положительный момент у балки оказывается снизу. С :moment-on-tension-side="false" эпюра M строится со стороны сжатых волокон. В ферме усилие в каждом стержне подписано один раз, вдоль стержня, а цвет показывает его знак.

Рисунки, которые строятся по шагам

В reserve перечисляются слои, для которых нужно оставить место, пока они скрыты. Рисунок с самого начала размещает все зарезервированные слои, поэтому включённый слой плавно появляется на своём месте, а всё остальное остаётся неподвижным:

Vue
<script setup lang="ts">
import type { PlotLayer } from '@edubeam/plot'

const stages: PlotLayer[][] = [
  ['nodes', 'nodeLabels', 'dimensions'],
  ['nodeLabels', 'members', 'supports'],
  ['nodeLabels', 'members', 'supports', 'loads'],
  ['members', 'supports', 'loads', 'reactions'],
  ['members', 'supports', 'reactions', 'M'],
]
const all = [...new Set(stages.flat())]
// `frame` — рассчитанный решатель, `step` — текущий шаг; весь компонент приведён на странице «Слайды и конспекты»
</script>

<template>
  <StructurePlot :solver="frame" :layers="stages[step]" :reserve="all" />
</template>

Со свойством animate, которое включено по умолчанию, слои появляются плавно, а стержни прорисовываются от одного конца к другому. При prefers-reduced-motion анимации нет. На странице Слайды и конспекты этот рисунок встроен в презентацию.

Значения на эпюрах

Каждое значение подписывается сразу за концом своей ординаты, как это делают в учебниках: на каждом конце стержня с ненулевым значением, в экстремумах между концами, два значения в месте скачка и одно — в жёстком узле рамы. Значения — это числа без единиц, в единицах отображения (кН для N и V, кН·м для M); так же подписаны и реакции, как в приложении EduBeam. Единицы пишутся только у исходных данных: нагрузок, осадок и изменений температуры. Если подпись перекрывает другую подпись, стержень или стрелку, она пробует другие места у той же ординаты, а если свободного места нет, не выводится вовсе, поэтому два числа никогда не накладываются друг на друга. Значения нагрузок и реакций размещаются первыми, так что числа эпюр их не вытесняют. Усилия в стержнях фермы не пропадают никогда: подпись сдвигается вдоль стержня, переходит на другую сторону и лишь в крайнем случае уменьшается.

С result-label-mode="axis" значения поворачиваются вдоль своих ординат, как их пишет приложение EduBeam. Если читатель может переключаться между двумя вариантами, задайте :reserve-label-modes="['horizontal', 'axis']", чтобы рисунок при переключении не смещался.

Реакции как неизвестные

В условии задачи реакции требуется найти, поэтому показывать их нужно без значений. С reaction-labels="names" рисуется стрелка для каждого направления, в котором закреплена опора, и направлена она в положительную сторону: вдоль оси x узла (вправо, если опора не повёрнута), вверх и против часовой стрелки для реактивного момента в заделке. Каждая стрелка обозначена по своему узлу — Ax, Az, MA — курсивом и с настоящим нижним индексом. Так знак каждого ответа задан прямо на рисунке: реакция, действующая в обратную сторону, отрицательна.

Vue
<StructurePlot
  :model="model"
  :layers="['members', 'supports', 'loads', 'reactions', 'nodeLabels', 'dimensions']"
  reaction-labels="names"
/>

Вверху — балка с заделкой и шарнирно-подвижной опорой в виде условия задачи: заделка в A, шарнирно-подвижная опора в B, 40 кН в середине пролёта, размерная цепочка 3 м и 3 м с общим размером 6 м и реакции в виде обозначенных стрелок A_x, A_z, M_A и B_z. Внизу — та же балка с подписями реакций по умолчанию: 27,5 и 12,5 вверх, момент в заделке 45 и эпюра изгибающих моментов от −45 у заделки до 37,5 под силой

Для обозначений результаты расчёта не нужны, поэтому условие можно нарисовать и по нерассчитанной модели. Для ответов оставьте reactionLabels равным 'values'. Обозначения и значения занимают разное место (у нулевой горизонтальной реакции в условии есть обозначение, а в ответах нет стрелки), поэтому рисунок, который переключается между ними, должен оставить место для обоих вариантов: :reserve-reaction-labels="['names', 'values']". Тогда рисунок остаётся на месте и меняются только подписи. Карточка упражнения на странице Упражнения и контрольные работы переключается между ними через свойство answers — так же, как задачи по строительной механике на этом сайте, когда студент просит показать решение.

Миниатюры

Режим compact рассчитан на плитки размером около 400 × 200 px: условные обозначения меньше, текст 11,5 px, не больше двух значений на стержень, а у распределённых нагрузок подписана только величина, без q =.

Vue
<StructurePlot v-for="t in tiles" :key="t.title" :solver="t.solver" compact :height="200" :title="t.title" />

Так нарисована галерея примеров на этом сайте.

Размер

Рисунок измеряет свой контейнер и компонуется под его ширину в реальных пикселях. Без height высота подстраивается под изображение, но не превышает maxHeight, по умолчанию . Пока измерить контейнер нельзя, например на сервере, используется width, по умолчанию 640 px.

СвойствоПо умолчаниюЗадаёт
width640, compact 400ширину компоновки, пока контейнер не измерен, px
heightпо размеру изображенияфиксированную высоту, px
maxHeight, compact нетверхнюю границу автоматической высоты
padding6отступ вокруг изображения, px
fontSize13, compact 11.5размер текста, px
diagramSize48, compact 26длину наибольшей ординаты, px
deformedSize30, compact 18наибольшее перемещение на деформированной схеме, px

Несколько рисунков в одном масштабе

Каждый рисунок масштабирует эпюры по своему наибольшему значению, поэтому момент 20 кН·м выглядит таким же большим, как 80 кН·м. Чтобы рисунки можно было сравнивать, зафиксируйте масштаб в пикселях на единицу СИ с помощью diagramScale:

Vue
<script setup lang="ts">
import { StructurePlot } from '@edubeam/plot'
import { simpleBeam } from './beams' // из «Начала работы»: (пролёт в м, q в кН/м) => рассчитанный решатель

const spans = [4, 6, 8].map((L) => ({ L, solver: simpleBeam(L, 10) }))
// 0.5 px на кН·м (0.5e-3 px на Н·м): 80 кН·м пролёта 8 м рисуются глубиной 40 px, 20 кН·м пролёта 4 м — 10 px
const scale = { M: 0.5e-3 }
</script>

<template>
  <figure v-for="s in spans" :key="s.L">
    <StructurePlot :solver="s.solver" :layers="['members', 'supports', 'M']" :diagram-scale="scale" />
    <figcaption>L = {{ s.L }} m</figcaption>
  </figure>
</template>

Единицы и числа

Внутри все величины хранятся в СИ и пересчитываются только для отображения; по умолчанию это kN, kNm, kN/m, m, mm, mrad и K. Любую единицу можно заменить, задав обозначение и множитель: отображаемое значение = значение в СИ × множитель:

Vue
<StructurePlot :solver="solver" :units="{ force: { symbol: 'N', scale: 1 } }" />

Числа форматируются через Intl.NumberFormat; по умолчанию это английский формат с не более чем одним знаком после запятой. Чтобы числа соответствовали языку страницы, передайте свой формат:

Vue
<StructurePlot :solver="solver" :number-format="new Intl.NumberFormat('cs', { maximumFractionDigits: 2 })" />

Для русской страницы подойдёт new Intl.NumberFormat('ru', …) с десятичной запятой, а русские обозначения единиц задаются через units, например { force: { symbol: 'кН', scale: 1e-3 } }. Минус выводится настоящим знаком минуса (−), а значение, которое округляется до нуля, никогда не показывается как −0. Единицы называются force, moment, distributed, length, displacement, rotation и temperature; в качестве отправной точки экспортируются KN_UNITS и SI_UNITS.

Считывание значений

Со свойством hover рисунок считывает показанные результаты в точке стержня под указателем. Каждое значение отмечается там, где оно нарисовано: точкой на конце ординаты каждой видимой эпюры (в месте скачка — на обоих концах) или на деформированной схеме, а в плашке выводится список значений, например M = 54 kNm или, по обе стороны скачка, V = 13.3 → −6.7 kN. Указатель захватывает стержень в любом месте над его эпюрой, а не только на самом стержне. Кроме того, рисунок передаёт значения как данные:

Vue
<script setup lang="ts">
import { ref } from 'vue'
import { StructurePlot, type Readout } from '@edubeam/plot'
import { portalFrame } from './frame' // со страницы «Слайды и конспекты»: () => рассчитанный решатель

const frame = portalFrame()
const reading = ref<Readout | null>(null)
</script>

<template>
  <StructurePlot :solver="frame" :layers="['members', 'supports', 'M']" hover @readout="reading = $event" />
  <p v-if="reading">
    Member {{ reading.member }}, {{ reading.x.toFixed(2) }} m from its start:
    M = {{ (reading.values.M.left / 1e3).toFixed(1) }} kNm
  </p>
</template>

Показания (readout) имеют вид { member, x, px, py, values, u }: стержень, положение на нём в метрах, точка на экране в px, { left, right } для каждой из величин N, V, M и w в единицах СИ и продольное перемещение u. Когда указатель уходит с рисунка, передаётся null. Живые рисунки на этом сайте используют hover — наведите указатель на любой из них.

Без hover рисунок вообще не подключает обработчики событий, поэтому страница прокручивается поверх него, а касание рисунка внутри ссылки открывает ссылку. С hover рисунок слушает только события указателя (pointer events), и на сенсорных экранах вертикальная прокрутка и масштабирование двумя пальцами продолжают работать.

Доступность

Каждый рисунок — это <svg role="img">, доступное имя которого задаёт свойство title, а без него — описание того, что показано, например «Structure with its loads, reactions, bending moment». Это описание по умолчанию английское; сайт или приложение может заменить его текстом на своём языке через ключ внедрения PLOT_TEXTS из @edubeam/plot, поэтому на русских страницах этого сайта рисунки называются, например, «Конструкция: нагрузки, реакции и эпюра изгибающих моментов». Свойство title важнее и того и другого. Скрытые зарезервированные слои помечены aria-hidden.