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.
9.1 KiB
9.1 KiB
Что читать
Не копировать целиком и не тянуть в зависимости, а искать конкретные алгоритмы и решения. Ссылки проверены 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: конструкция как параметризованные данные — посмотреть на текстовый формат.