Исследования

Откуда в игре взялись числа и модели: обзоры литературы, разборы паспортов крыльев, прототипы и расчётные опыты. Документы подключены как есть, из папок docs/research/ и tools/research/ репозитория. Сжатая сводка выводов — в реестре выводов; рассказ «что пробовали и что выбрали» — на странице «Подходы и результаты»; планы — в разделе «Планы».

Исследования закрыты (статус closed в шапке документа), кроме обзора физики воздуха — он живой. Если документ на сайт не подключён, ссылка ведёт в репозиторий на GitHub.

Ветер, термики, модель воздуха

Документ	О чём
Физика воздуха над рельефом: обзор	Уравнения и масштабы, пограничный слой, обтекание, стратификация, седловины, термики, турбулентность; наш решатель и его границы. Вывод: решатель на сетке 400 м занижает разгон на бровке на 15–20 %; главная ошибка профиля притока над горами — торможение (+2,3 м/с), линейная теория его не даёт. Статус — активен.
Обтекание склона ветром	Что было в игре (формулы), как в жизни, что можно сделать; основа плана модели воздуха.
Модели термиков, склонового подъёма и подветренных потоков	Конвективный слой, профиль термика по радиусу (Гедеон), формулы, реализованные в `scripts/atmosphere/`.
Калибровка по схеме Professor	Подгонка параметров модели воздуха под измерения Askervein и Perdigão.
Чувствительность модели воздуха: отбор по Моррису	Модель мягкая по переключателям и α, жёсткая от данных и вырожденная (λ/h ≈ α ≈ порядок переноса ≈ local_k); найдены ошибки в числе Прандтля, выхолаживании и высоте слоя — исправлены.
Каталог экспериментальных данных, табличные данные для калибровки	Какие наборы данных есть, где лежат, что дают.
Параметры поверхности по классам покрова	Альбедо, отношение Боуэна, шероховатость по классам покрова.
Размер поля воздуха и кеш вариантов запуска	Поле одного варианта — 23,5 МБ сырым; вариантов в меню на старт — 57 564; вывод: полный кеш нереален, нужен ленивый кеш на диске.
Визуальные признаки для пилота	Что должно быть видно в симуляторе: птицы, пыль, трава на ветру.

Прототипы и расчётные опыты

2D-прототип «нагрев → плавучесть → поток» — клеточный автомат тепла и массы на разрезе хребта, пять сценариев и шесть сравнительных опытов (линейность, метод Пикара, матрицы перехода, ADI, ядро струи): какой способ считать установившееся поле быстрее и без потери физики. Итог — out/summary.md.
3D-эталон на рельефе Онгудая — перенос выбранного метода (Пикар) на реальный рельеф: время, память, сходимость по клетке, размеры полей. Итог — summary.md.
Измерения Askervein — полевые данные обтекания холма (Zenodo 4095052, CC BY 4.0) для калибровки разгона ветра на бровке.
Остальные паспорта исследований — каталоги с кодом, таблицами и воспроизведением команд (ссылки ведут на GitHub): разведка перед А2, Моррис, калибровка и перекалибровка Askervein, Б1: Askervein + Perdigão, случай Perdigão, термики из поля, возмущения из поля, стык уровней клипмапа, пересчёт поля в полёте, воздух у старта, базовые цифры, сравнение полей main и ветки модели воздуха.

Нейросеть вместо решателя

Пилот air-nn: может ли малая сеть заменить решатель — код и отчёты пилотов П-1, П-2, П-3.
WindNinja как независимый эталон — сравнение на 21 случае в 6 местах: разгон на гребнях совпадает, торможение массивом WindNinja не даёт.
Планы и итоги — план air-nn, П-3, air-onnx; разбор — «Подходы и результаты».

Крылья и полёт

Документ	О чём
Масса пилота и поляра дельтаплана	Как масса пилота меняет скорости, снижение и качество.
Открытые источники характеристик и поляр	Готовой базы поляр современных дельтапланов в открытом доступе нет.
Паспорта крыльев → конфиги	Что изменено в `configs/wings/*.json`, источники и противоречия; при расхождении приоритет у DHV.
Список моделей дельтапланов и сводный набор паспортов	Данные паспортов DHV и производителей; крылья игры — в разделе «Модели аппаратов».
ТЗ на 3D-модели крыльев по паспортам	Раздел на крыло, самодостаточный для исполнителя.
Источники по моделям дельтапланов, «Атлас» (СССР), Ордоди «Дельтапланеризм» (1984), гл. 3.2	Где искать внешний вид и характеристики; данные по учебному «Атласу»; конструкция.
Референсы трапеции и вида с места пилота	Для процедурных моделей трапеции.
Проверка физики крыльев	Данные и инструменты проверки поляр по паспортам.

Мир, звук, игра

Документ	О чём
Источники рельефа и карт	Что проверено запросами и откуда берутся высоты и покров.
Эталоны маршрутных XC-полётов, правила маршрутных соревнований	Ориентиры для бота и заданий; формула GAP, геометрия заданий.
Звук: ассеты и процедурный синтез, звук вариометров 1990-х	51 файл, 8,2 МБ; тембр вариометра — меандр до 11-й гармоники и резонанс 3,2 кГц.
Сетевая игра через itch.io	У itch нет сетевого функционала; вариант без сервера — ПК пилота поверх Tailscale/ZeroTier; отложено.
Состав OsmAnd OBF региона, замер офлайн-пакета (Словения)	Опыты к плану офлайн-данных мира.

Как воспроизвести прототипы

Прототипы — отдельные Python-скрипты вне игры (свой venv, GPU через CuPy); команды — в README каждого каталога:

cd tools/research/heat_ca
uv venv .venv && uv pip install --python .venv/bin/python -r requirements.txt
.venv/bin/python run.py all              # все сценарии 2D
.venv/bin/python study.py cells          # сходимость по клетке

cd tools/research/air3d
PY=../heat_ca/.venv/bin/python
$PY study.py conv && $PY study.py matrix && $PY study.py cells   # 3D на рельефе Онгудая
$PY report.py figs && $PY report.py tables

Подробности и флаги — heat_ca/README.md и air3d/README.md.

Служебное

Реестр выводов — тема, вывод с числами, источник, где применено.
Точка входа во всю документацию репозитория — docs/INDEX.md (на GitHub): путь, тип, статус и краткое содержание каждого документа.
Все исследования docs/research/ списком.