fabrilis/docs/COORDINATES.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

37 lines
2.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Системы координат и единицы
## Мировая система
Правая, Z вверх, X вперёд, Y влево (как в робототехнике, ROS REP-103). Единицы СИ.
Углы в радианах (`Radians`); градусы только в интерфейсе и при импорте.
## Системы
| Система | Назначение |
|---|---|
| world | неподвижная система мира |
| body | связана с деталью; для инерции начало в центре масс |
| joint | ось шарнира направлена вдоль локальной Z |
| sensor | датчик, задаётся преобразованием от body |
| render | только для рендера, получается в конце цепочки |
Преобразования это `Transform` (кватернион и вектор, f64). Сцена хранит цепочку как
граф; матрицы для рендера собираются в конце.
## Вращения
Единичные кватернионы с контролем дрейфа нормы. Углы Эйлера только для ввода и
вывода. Нормализация около нуля и вырожденные матрицы обрабатываются явно: ошибка,
а не NaN.
## Импорт: единицы и оси
| Формат | Единицы | Оси | Политика |
|---|---|---|---|
| STL | не заданы | не заданы | проект задаёт единицы (по умолчанию мм) |
| OBJ | не заданы | не заданы | проект задаёт единицы |
| glTF | метры | Y вверх, правая | оси пересчитываются в Z вверх |
Материалы: плотность в кг/м³, прочность в Па; в файлах материалов единицы указаны
явно суффиксом и конвертируются при импорте. Единицы источника записываются в
конструкцию.
## Большие миры
Симуляция в f64. Для рендера и f32-компонентов начало координат переносится (origin
rebasing).