Начало работы
@edubeam/fem — это решатель метода конечных элементов, на котором работает EduBeam: все эпюры, реакции и прогибы, которые показывает приложение, вычислены им. С его помощью можно рассчитывать плоские балки, рамы и фермы из собственного кода, в браузере или в Node: генерировать задачи вместе с ответами, проверять домашние задания, проводить параметрические исследования или сделать решатель расчётным ядром веб-страницы.
Библиотека написана на TypeScript, поставляется со своими типами и распространяется как свободное ПО по лицензии GPL-3.0. Её создал Борек Пацак, а развивает он вместе с Яном Воржишеком и другими участниками.
Установка
npm install @edubeam/fem
Библиотека работает и с import, и с require, в браузере и в Node 18 и новее, и имеет одну зависимость — mathjs. До версии 0.3.0 её устанавливали с GitHub под именем ts-fem: если вы ставили её оттуда, замените импорты на @edubeam/fem. Больше ничего не изменилось.
Чтобы опробовать пример ниже в пустой папке, сделайте из неё проект, который использует import, и установите пакет:
npm init -y
npm pkg set type=module
npm install @edubeam/fem
Без "type": "module" в package.json пример тоже запустится, но Node сначала выведет предупреждение.
Первая балка
Стальная балка IPE 200 пролётом 6 м на шарнирно-неподвижной и шарнирно-подвижной опорах под нагрузкой 12 кН/м:
import { DofID, LinearStaticSolver } from '@edubeam/fem'
const solver = new LinearStaticSolver()
const { domain } = solver
// Везде единицы СИ: m, N, Pa. Сталь и IPE 200.
domain.createMaterial('steel', { e: 210e9, g: 81e9 })
domain.createCrossSection('IPE200', { a: 28.5e-4, iy: 1943e-8, k: 5 / 6 })
// Узлы в точках [x, y, z] в метрах и степени свободы, которые закрепляет их опора
domain.createNode('A', [0, 0, 0], [DofID.Dx, DofID.Dz]) // шарнирно-неподвижная
domain.createNode('B', [6, 0, 0], [DofID.Dz]) // шарнирно-подвижная
const beam = domain.createBeam2D(1, ['A', 'B'], 'steel', 'IPE200')
// 12 kN/m вдоль локальной оси z стержня: у балки, заданной слева направо, вниз
const lc = solver.loadCases[0]
lc.createBeamElementUniformEdgeLoad(1, [0, 12e3], true)
solver.solve()
console.log(beam.computeBendingMomentAt(lc, 3)) // N·m в середине пролёта
console.log(beam.computeShearForceAt(lc, 0)) // N в A
console.log(beam.computeLocalDefl(lc, 2).w[1]) // m в середине пролёта
Сохраните код в файл beam.ts и запустите node beam.ts: Node 22.18 и более новые версии выполняют TypeScript напрямую. Аннотаций типов в файле нет, поэтому для более старого Node достаточно сохранить его как beam.mjs. Программа выведет:
54000
36000
0.04990940552616746
Это значения из учебника: кН·м и кН. Вот та же балка, рассчитанная тем же решателем прямо в вашем браузере:
Прогиб 49,91 мм на 0,28 мм больше, чем по формуле Эйлера — Бернулли мм. Это не ошибка: стержень здесь — балка Тимошенко, а 0,28 мм — это , вклад деформации сдвига этой балки. Задайте очень большое k, например 1e32, и разница исчезнет: см. Деформация сдвига.
Что делает этот код
Создайте решатель
new LinearStaticSolver() создаётся с пустым domain, в котором хранится модель, и с одним случаем нагружения, solver.loadCases[0].
Опишите модель
Материалы и сечения, узлы с опорами, затем стержни между узлами. У каждого объекта есть метка — строка или число, — по которой на него ссылается остальная модель. См. Узлы и опоры, Материалы и сечения и Стержни и шарниры.
Приложите нагрузки
Нагрузки принадлежат случаю нагружения: силы в узлах, нагрузки вдоль стержней, температура и осадки опор. См. Узловые нагрузки и нагрузки на стержни.
Выполните расчёт
solver.solve() собирает и решает все случаи нагружения. См. Расчёт.
Прочитайте результаты
Внутренние усилия в любой точке стержня, прогибы, концевые усилия, перемещения узлов и реакции. См. Чтение результатов, а для эпюр — Отрисовка результатов.
Единицы и знаки вкратце
На входе единицы СИ, на выходе тоже СИ. Модель лежит в плоскости x–z, и ось z направлена вниз, поэтому положительная нагрузка fz действует вниз, а верх стойки высотой 4 м находится в точке . Положение на стержне задаётся в метрах от его первого узла. Положителен момент, растягивающий нижние волокна. Полный список — на странице Единицы и знаки.
Шесть частых ошибок
- Ось z направлена вниз. Нагрузки от силы тяжести положительны, а у всего, что выше опор, координата z отрицательна. См. Оси.
- Направление стержня определяет знак M и w. Задавайте балки слева направо, а стойки снизу вверх, и знаки будут как в учебнике. См. Направление стержня.
- Пропущенный параметр даёт
NaNили бессмыслицу, а не ошибку. Сечению нужныa,iyиk; материалу —e, а такжеg, если толькоkне задан очень большим. См. Материалы и сечения. - После добавления узлов или стержней или изменения опор перед новым расчётом присвойте
solver.codeNumberGenerated = false. См. Повторный расчёт после изменений. - Реакции возвращаются как матрица mathjs или как массив, в том порядке, в котором были перечислены степени свободы опоры. См. Реакции.
- Механизм не всегда вызывает исключение. Перемещение порядка м означает, что конструкция может свободно двигаться. См. Если расчёт не удался.
Что дальше
Примеры программ
Готовые проверенные программы: балки, рамы, фермы, набор задач с ответами и небольшой HTTP-сервер.
Отрисовка результатов
Передайте рассчитанную модель в @edubeam/plot и получите её эпюры в SVG — во Vue или из скрипта Node.
Справочник API
Все классы, методы и аргументы, с единицами и с тем, что они возвращают.
Теория
Балочный элемент, его матрица жёсткости и преобразование — в теоретическом разделе документации EduBeam.