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.
3.5 KiB
Проверка достоверности
Результат, который красиво выглядит, не обязательно верен. Здесь три разных вопроса.
| Понятие | Вопрос | Чем отвечаем |
|---|---|---|
| Verification | правильно ли реализованы алгоритмы | аналитические задачи, golden-хеши, дифференциальные тесты CPU |
| Validation | описывает ли модель реальный механизм | сравнение с измерениями реальной сборки |
| Qualification | достаточно ли проверена модель для конкретного применения | область применимости каждой модели, записанная в её описании |
Verification
Консольная балка, маятник, RC-цепь, теплопроводность, масса и инерция простых тел
(TESTING.md). Для CPU: riscv-tests и сравнение со Spike или QEMU. Для детерминизма:
golden-хеши (DETERMINISM.md).
Validation и калибровка
- Собрать реальный механизм или узел.
- Измерить массу, момент инерции, токи, напряжения, температуры, траектории.
- Прогнать то же самое в Fabrilis.
- Сравнить и записать расхождения.
- Подправить параметры модели (трение, КПД, сопротивления) и записать допуски.
Калибровка не заменяет Monte Carlo: Monte Carlo показывает разброс, а калибровка находит систематическое смещение.
Неопределённость
Допуски размеров, материалов, номиналов, шумов датчиков. Результат несёт оценку чувствительности к параметрам и оценку доверия, а не только число.
Диагностика достоверности
Движок сообщает, когда результату нельзя верить:
- решатель не сошёлся;
- меш не замкнут или не ориентирован;
- модель работает вне области применимости (скорость, температура, деформация);
- шаг был уменьшен откатом;
- эффективный шаг больше допустимого.
Диагностика попадает в отчёт сценария, а не только в лог.
Проверка меша перед расчётом массы
Каждое ребро принадлежит двум треугольникам, ориентация согласована, вырожденных треугольников нет, объём положителен. Единицы заданы явно (COORDINATES.md). Иначе импорт возвращает ошибку: масса по теореме Гаусса на дырявой сетке бессмысленна.
Версионирование
Сценарий хранит хеш конструкции, версию движка и версии моделей. Результаты с несовпадающими версиями помечаются как несравнимые.