fabrilis/docs/REFERENCES.md
loki5512344 878d144b77 Initial commit: Fabrilis docs, rules and deterministic core
Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
2026-11-16 23:06:29 +01:00

9.1 KiB
Raw Permalink Blame History

Что читать

Не копировать целиком и не тянуть в зависимости, а искать конкретные алгоритмы и решения. Ссылки проверены 16.11.2026.

Ориентиры по режимам: Renode ближе всего к Bench, MuJoCo — к World, SOFA — к Lab и FEM.

Локальные клоны

Исходники этих проектов лежат в ref/ — папка в .gitignore и не проверяется правилами кода. Клоны неполные (история не нужна): читаем код, не собираем. Создать или дополнить: tools/fetch_refs.sh. Обновить один проект: git -C ref/<имя> pull. Удалить: rm -rf ref/<имя>.

Категория В ref/
Эмуляция железа renode, mini-rv32ima
Физика mujoco, jolt, box2d
FEM и прочность calculix, sofa, scikit-fem
Электроника ngspice, circuitjs
Мир и сенсоры gazebo
Робототехника и сценарии cheetah, opencat, carla-scenario-runner
UI и форматы imgui, egui, openscad

Библиотеки, которые мы используем (Rapier, wgpu, winit, rhai, fontdue), сюда не клонируются: их исходники и так лежат в ~/.cargo/registry.

Первая очередь

  • Renode — виртуальное железо, периферия, временная модель, сценарии.
  • MuJoCo — динамика механизмов, контакты, культура воспроизводимости.
  • SOFA — FEM и компонентная архитектура.
  • Rapier — наша текущая физика.
  • QEMU — CPU, MMU, SoC и устройства.
  • ngspice — MNA и всё, что вокруг transient-анализа.

Связь подсистем и эмуляция железа

  • Renode: эмуляция SoC, периферия, временная модель, сценарии. Ближайший аналог режима Bench.
  • FMI: стандарт co-simulation; словарь для bridge и точек синхронизации.
  • OpenModelica: мультидоменная модель уравнениями; полезно понять, где граница между нами и «системой уравнений».
  • QEMU: RISC-V target, MMU, исключения, virtio. Обязательное чтение перед M8 и M11.
  • TinyEMU: RV32/RV64, Linux и virtio в малом объёме кода; главный референс для этапов CPU и Linux.
  • mini-rv32ima: крошечный RV32, удобен для эмуляции МК по тактам.
  • Spike и riscv-tests: эталонная модель ISA и тесты для дифференциальной проверки.
  • xv6-riscv: простая ОС для интеграционных тестов до полноценного Linux.
  • Verilator: на будущее, если дойдём до логического уровня.
  • Wokwi: UX-референс «МК + схема + симуляция в одном месте».

Физика и детерминизм

  • MuJoCo: динамика механизмов, articulated bodies, контакты, воспроизводимость.
  • Jolt Physics: режим детерминизма и его тесты в CI — образец оформления golden-тестов физики.
  • Box2D: солвер ограничений, эталон читаемости перед своим backend'ом.
  • Rapier и руководство по детерминизму: границы enhanced-determinism, поведение f32.
  • Project Chrono: многотельная механика и мехатроника.
  • Rigs of Rods и идея BeamNG: модель «узлы и балки» для разрушения в World.
  • Fix Your Timestep: фиксированный шаг и интерполяция рендера.
  • Overwatch GDC 2017: ECS, реплей и перемотка — схема, близкая к нашим снимкам.

FEM и прочность

  • SOFA: компонентная архитектура деформируемых моделей.
  • CalculiX: балки, тетраэдры, контакт; смотреть постановки и верификационные кейсы.
  • FreeCAD FEM: инженерный workflow «геометрия → сетка → условия → решатель → результат».
  • scikit-fem: маленькая FEM-библиотека, которую можно прочитать целиком.
  • anastruct и PyNite: рамные и балочные расчёты — масштаб, который реально осилить.
  • Gmsh: генерация сеток и форматы.
  • fTetWild и TetGen: оценить, сколько стоит тетраэдризация меша.
  • OpenFOAM: CFD и граничные условия, если дойдём до честных воздушных потоков.

Электроника

  • ngspice: штампы MNA, Newton, контроль шага, breakpoints, gmin и source stepping.
  • CircuitJS: читаемая реализация MNA.
  • ahkab: компактный SPICE на Python.
  • KiCad: плата как данные; посмотреть текстовые форматы до того, как замораживать свои RON-схемы.

Мир и рендер

  • CDLOD: статья и код Strugar'а; clipmap-террейн проще понимать через CDLOD.
  • Gazebo: как разведены мир, сенсоры и контроллер.
  • Webots: архитектура сенсоров, плагинов и миров.
  • Bevy: ECS, asset pipeline и организация рендера; движок не берём, идеи смотрим.

Робототехника и сценарии

  • Cheetah-Software: открытый стек походки и стабилизации.
  • Stanford Doggo: реальные массы и моменты для приводов.
  • Open Dynamic Robot Initiative: открытые приводы и ноги как источник реалистичных цифр и BOM.
  • Petoi OpenCat: «МК + серво + четвероногое» в масштабе, близком к Bench и World.
  • CARLA scenario_runner: DSL сценариев, метрики и pass/fail — почти наша задача «сценарий как опыт».

UI и данные

  • ShapeUI blueprint (локальная копия ref/shapeui-blueprint_v0.2_revised_ru.md): контракты shape-aware UI. Берём только идеи — event-driven redraw, command list, glyph atlas, capability-модель (см. UI.md), не архитектуру.
  • Dear ImGui: ID-стеки, клиппинг, батчинг — минимальная архитектура виджетов перед своим UI.
  • egui: только читать, зависимость не берём (D20).
  • OpenSCAD: конструкция как параметризованные данные — посмотреть на текстовый формат.