Справочник API

Всё, что экспортирует @edubeam/fem 0.3, сгруппировано по назначению. Единицы везде СИ: м, Н, Н·м, Н/м, Па, К и рад. Метки (LabelType) имеют тип string | number и хранятся как строки. Методы, которых здесь нет, внутренние: в TypeScript они публичны лишь потому, что их вызывают собственные классы решателя.

Экспорт

ЭкспортВидРаздел
LinearStaticSolverклассВиды расчёта
Solverабстрактный классВиды расчёта
DomainклассDomain
NodeклассNode
Beam2D, ElementклассыЭлементы
Material, CrossSectionклассыМатериалы и сечения
LoadCaseклассНагрузки
NodalLoad, BeamConcentratedLoad, BeamElementUniformEdgeLoad, BeamElementTrapezoidalEdgeLoad, BeamTemperatureLoad, PrescribedDisplacement, Load, BeamElementLoadклассыНагрузки
DofIDперечислениеDofID
LabelType, EnumDictionary, MaterialParameters, CrossSectionParametersтипы

Виды расчёта

LinearStaticSolver

TypeScript
const solver = new LinearStaticSolver()
Свойство или методТипОписание
domainDomainМодель
loadCasesLoadCase[]Изначально содержит один случай, 'DefaultLC'. Новые добавляйте через new LoadCase(label, solver.domain): Случаи нагружения.
solve()voidПри необходимости нумерует уравнения, собирает и решает все случаи нагружения. Для механизма может выбросить исключение, но не всегда. Начиная с версии 0.3.1 ничего не выводит; версия 0.3.0 печатала время расчёта.
codeNumberGeneratedbooleanПрисвойте false после добавления или удаления узлов или стержней или изменения опор: почему
neq, pneqnumberЧисло свободных и закреплённых степеней свободы, после расчёта
kmathjs MatrixСобранная глобальная матрица жёсткости, после расчёта
getNodeDofIDs(label)number[]Степени свободы узла, после расчёта

EigenValueDynamicSolver есть в исходном коде, но не экспортируется.

Domain

solver.domain хранит модель в четырёх Map с меткой в виде строки в качестве ключа: nodes, elements, materials, crossSections. Методов удаления нет: узел или стержень удаляют domain.nodes.delete(label) и domain.elements.delete(label), после чего нужна перенумерация.

МетодВозвращаетОписание
createNode(label, coords?, bcs?)Nodecoords — [x, y, z] в м (по умолчанию [0, 0, 0]), bcs — закреплённые опорой DofID (по умолчанию нет)
createBeam2D(label, nodes, mat, cs, hinges?)Beam2Dnodes — [first, second], hinges — [atFirst, atSecond] (по умолчанию [false, false])
createMaterial(label, params?)MaterialСм. Материалы и сечения
createCrossSection(label, params?)CrossSectionСм. Материалы и сечения
getNode(label), getElement(label), getMaterial(label), getCS(label)сам объектДля неизвестной метки выбрасывает RangeError. getElement имеет тип Element: чтобы читать результаты, напишите as Beam2D.

Создание объекта с уже занятой меткой заменяет старый объект.

Node

Свойство или методТипОписание
labelstring
coordsnumber[][x, y, z], м. Измените, чтобы переместить узел.
bcsSet<DofID>Закреплённые степени свободы. Замените, чтобы изменить опору.
lcsnumber[][] | undefinedПовёрнутые оси узла, если они заданы
updateLcs({ locx, locy }?)voidПоворачивает оси узла: locx — его ось x в глобальных составляющих, locy — [0, 1, 0]. Без аргумента возвращает исходные оси.
hasLcs()booleanПовёрнуты ли оси
getUnknowns(lc, dofs)Matrix или number для одной степени свободыПеремещения (м) и углы поворота (рад), в осях узла
getReactions(lc, global?){ dofs, values }Реакции по закреплённым степеням свободы в порядке bcs: Н, Н·м. values — матрица mathjs Matrix, если реакций несколько, массив из одного элемента, если реакция одна, и [] для свободного узла. Если global равен true и оси узла повёрнуты: все три степени свободы в глобальных осях, dofs — [0, 2, 4], values — массив с 0 там, где ничего не закреплено. Как их читать.

Элементы

Beam2D

Двухузловая балка Тимошенко в плоскости x–z, три степени свободы в каждом узле (Dx, Dz, Ry). x задаётся в метрах от первого узла; n — число участков, что даёт n + 1 точек.

Свойство или методВозвращаетОписание
label, nodes, mat, csstring, string[], string, string
hinges[boolean, boolean]Шарниры (снятие момента) у первого и второго узла
computeNormalForceAt(lc, x)numberN, растяжение положительно
computeShearForceAt(lc, x)numberV, положительна там, где M растёт вдоль локальной оси x
computeBendingMomentAt(lc, x)numberM, положителен при растяжении со стороны локальной оси +z
computeNormalForce(lc, n){ x, N }N в n + 1 точках
computeShearForce(lc, n){ x, V }V в n + 1 точках
computeBendingMoment(lc, n){ x, M }M в n + 1 точках
computeLocalDefl(lc, n){ u, w }Перемещения вдоль и поперёк стержня, в локальных осях, м
computeGlobalDefl(lc, n){ u, w }То же в глобальных осях x и z
computeEndForces(lc)Matrix[X12, Z12, M12, X21, Z21, M21] — силы, с которыми узлы действуют на стержень, в локальных осях
computeEndDisplacement(lc)MatrixПеремещения концов в локальных осях, включая повороты в шарнирах
computeGeo(){ l, dx, dz }Длина и проекции, м
computeT()MatrixМатрица преобразования 6 × 6, из глобальных осей в локальные
computeLocalStiffnessMtrx(){ answer }answer — локальная матрица жёсткости 6 × 6, шарниры исключены конденсацией
computeStiffness()MatrixГлобальная матрица жёсткости 6 × 6
computeShearFactor()number
getMaterial(), getCS()Material, CrossSection

В точке приложения сосредоточенной силы методы …At возвращают значение сразу за ней. Element — абстрактный базовый класс Beam2D; этот тип используют domain.elements и getElement.

Материалы и сечения

MaterialParametersЕдиницаПо умолчаниюДля чего
eПа1жёсткость
gПа1сдвиговая жёсткость
alpha1/К1температурные нагрузки
dкг/м³1в статике не используется
CrossSectionParametersЕдиницаПо умолчаниюДля чего
aм²нет, обязателенпродольная и сдвиговая жёсткость
iyм⁴нет, обязателенизгибная жёсткость
k—нет, обязателенсдвиговая жёсткость ; 1e32 — без деформаций сдвига
hмнеттемпературный перепад (без него NaN)
iz, dyz, jм⁴нетBeam2D не использует

Пропущенный параметр материала равен 1, а не типичному значению; пропущенные a, iy или k превращают все результаты в NaN. Ни то, ни другое не вызывает ошибки. У обоих классов есть метод change(params), который задаёт переданные параметры, а сами параметры хранятся в одноимённых свойствах.

Нагрузки

LoadCase

МетодВозвращаетЗначения
createNodalLoad(node, values, lcs?)NodalLoad{ [DofID.Dx]: N, [DofID.Dz]: N, [DofID.Ry]: N·m }; при lcs, равном true (по умолчанию false), — в повёрнутых осях узла
createBeamElementUniformEdgeLoad(el, [fx, fz], lcs)BeamElementUniformEdgeLoadН/м по всей длине стержня
createBeamElementTrapezoidalEdgeLoad(el, [fx1, fz1], [fx2, fz2], lcs)BeamElementTrapezoidalEdgeLoadН/м в первом и втором узле, линейно между ними
createBeamConcentratedLoad(el, [fx, fz, my, a], lcs)BeamConcentratedLoadН, Н, Н·м, на расстоянии a м от первого узла
createBeamTemperatureLoad(el, [dTc, dTb, dTt])BeamTemperatureLoadК: центр тяжести, нижние волокна, верхние волокна
createPrescribedDisplacement(node, values)PrescribedDisplacement{ [DofID.Dz]: m, … } по закреплённым степеням свободы, в осях узла; для свободных игнорируется

Для нагрузок на стержни lcs, равный true, означает локальные оси (x вдоль стержня, z поперёк), false — глобальные. Погонные нагрузки задаются на метр длины стержня. Примеры — на странице Узловые нагрузки и нагрузки на стержни.

Свойство или методТипОписание
labelstring
nodalLoadListNodalLoad[]
elementLoadListBeamElementLoad[]Нагрузки на стержни и температурные нагрузки
prescribedBCPrescribedDisplacement[]
solvedbooleantrue после успешного расчёта
getElementLoadsOnElement(el)BeamElementLoad[]Нагрузки на один стержень

Объекты нагрузок хранят значения в публичных свойствах, которые можно изменить перед новым расчётом: values (и lcs) у NodalLoad, BeamElementUniformEdgeLoad, BeamConcentratedLoad и BeamTemperatureLoad; startValues и endValues у BeamElementTrapezoidalEdgeLoad; prescribedValues у PrescribedDisplacement. У каждой нагрузки есть target — метка объекта, на который она действует.

DofID

ИмяЗначениеИспользуется в Beam2D
Dx0да
Dy1нет
Dz2да
Rx3нет
Ry4да
Rz5нет

Результаты

Результаты читаются из Beam2D (внутренние усилия, прогибы, концевые усилия) и из Node (перемещения, реакции), всегда для заданного LoadCase и после solve(): см. две таблицы выше, а примеры и правила знаков — на странице Чтение результатов. Кратко:

Что нужноВызов
Реакции, Н и Н·мnode.getReactions(lc)
Перемещения, м, и углы поворота, радnode.getUnknowns(lc, [DofID.Dx, DofID.Dz, DofID.Ry])
N, V или M в точке, Н и Н·мbeam.computeNormalForceAt(lc, x), computeShearForceAt, computeBendingMomentAt
N, V или M вдоль стержняbeam.computeNormalForce(lc, n), computeShearForce, computeBendingMoment
Деформированная схема, мbeam.computeLocalDefl(lc, n), computeGlobalDefl
Концевые усилия, Н и Н·мbeam.computeEndForces(lc)
Рисунок всего этогоStructurePlot или structureSvg из @edubeam/plot